# monthname funkcja skryptu i funkcja wykresu

Ta funkcja zwraca wartość pokazującą miesiąc (sformatowany zgodnie ze stosowaną w skryptach zmienną MonthNames) oraz rok z bazową wartością liczbową odpowiadającą znacznikowi czasu pierwszej milisekundy pierwszego dnia tego miesiąca.

Składnia:

MonthName(date[, period\_no])

Typ zwracanych danych: wartość podwójna

Diagram funkcji monthname

Diagram funkcji monthname

Diagram funkcji monthname ![Przykładowy diagram funkcji monthname, pokazujący, w jaki sposób funkcja zwraca łączny wynik miesiąca i roku, gdy podano określoną datę wejściową.](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-general.png)

Argumenty

| Argument | Opis |
| --- | --- |
| date | Data lub znacznik czasu do oszacowania. |
| period\_no | period\_no jest liczbą całkowitą, która, jeśli ma wartość 0 lub jest pominięta, oznacza miesiąc, który zawiera date. Wartości ujemne parametru period\_no oznaczają miesiące poprzednie, a wartości dodatnie — miesiące następne. |

Przykłady funkcji

| Przykład | Wynik |
| --- | --- |
| `monthname('10/19/2013')` | Zwraca wartość Oct 2013 |
| `monthname('10/19/2013', -1)` | Zwraca wartość Sep 2013 |

## Ustawienia regionalne

Jeżeli nie podano inaczej, w przykładach w tym temacie stosowany jest następujący format daty: MM/DD/YYYY. Format daty jest określony w instrukcji `SET DateFormat` w skrypcie ładowania danych. Domyślny format daty w Twoim systemie może być inny ze względu na ustawienia regionalne i inne czynniki. Formaty zastosowane w przykładach można zmienić, aby dostosować je do własnych wymagań. Zamiast tego można też zmienić formaty w skrypcie ładowania, aby pasowały do tych przykładów. Więcej informacji można znaleźć w temacie [Modyfikowanie ustawień regionalnych na potrzeby aplikacji i skryptów](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/regional-settings-in-apps.htm).

Domyślne ustawienia regionalne w aplikacjach są oparte na profilu użytkownika. Te ustawienia regionalne nie są związane z językiem wyświetlanym w interfejsie użytkownika Qlik Cloud. Interfejs Qlik Cloud będzie wyświetlany w tym samym języku co używana przeglądarka.

Jeżeli jesteś twórcą aplikacji, możesz wybrać domyślny region dla tworzonych przez siebie aplikacji. Więcej informacji zawiera temat [Ustawianie preferowanych ustawień regionalnych do tworzenia aplikacji i skryptów w Analityka Qlik Cloud](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/UserInterface/Languages.htm#Setting).

## Przykład 1 — Przykład podstawowy

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthname.htm)

#### Skrypt ładowania i wyniki

Przegląd

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej sekcji.

Skrypt ładowania zawiera:

* Zestaw danych zawierający zestaw transakcji za rok 2022, który jest ładowany do tabeli o nazwie „`Transactions`”.

* Pole danych w formacie `DateFormat` zmiennej systemowej (MM/DD/RRRR).

* Utworzenie pola `transaction_month` zwracającego miesiąc, w którym miały miejsce transakcje.

Skrypt ładowania

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';
						
Transactions:
    Load
        *,
        monthname(date) as transaction_month
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];
```

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:

* `date`

* `transaction_month`

Tabela wynikowa

| date | transaction\_month |
| --- | --- |
| 1/7/2022 | Jan 2022 |
| 1/19/2022 | Jan 2022 |
| 2/5/2022 | Feb 2022 |
| 2/28/2022 | Feb 2022 |
| 3/16/2022 | Mar 2022 |
| 4/1/2022 | Apr 2022 |
| 5/7/2022 | May 2022 |
| 5/16/2022 | May 2022 |
| 6/15/2022 | Jun 2022 |
| 6/26/2022 | Jun 2022 |
| 7/9/2022 | Jul 2022 |
| 7/22/2022 | Jul 2022 |
| 7/23/2022 | Jul 2022 |
| 7/27/2022 | Jul 2022 |
| 8/2/2022 | Aug 2022 |
| 8/8/2022 | Aug 2022 |
| 8/19/2022 | Aug 2022 |
| 9/26/2022 | Sep 2022 |
| 10/14/2022 | Oct 2022 |
| 10/29/2022 | Oct 2022 |

Pole `transaction_month` jest tworzone w instrukcji ładowania poprzedzającego przez użycie funkcji `monthname()` i przekazanie pola `date` jako argumentu funkcji.

Diagram funkcji monthname, przykład podstawowy

Diagram funkcji monthname, przykład podstawowy

Diagram funkcji monthname, przykład podstawowy ![Diagram przedstawiający wyniki wykorzystania funkcji monthname do określenia miesiąca, w którym miała miejsce transakcja.](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-basic-example.png)

Funkcja `monthname()` identyfikuje, że transakcja 8192 miała miejsce w marcu 2022 r., i zwraca tę wartość przy użyciu zmiennej systemowej `MonthNames`.

## Przykład 2 – period\_no

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthname.htm)

#### Skrypt ładowania i wyniki

Przegląd

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej sekcji.

Skrypt ładowania zawiera:

* Ten sam wbudowany zestaw danych i zastosowanie co w pierwszym przykładzie.

* Utworzenie pola `transaction_previous_month` zwracającego znacznik czasu końca miesiąca przed transakcją.

Skrypt ładowania

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
    Load
        *,
        monthname(date,-1) as transaction_previous_month
        ;
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24
8207,10/29/2022,67.67
];
```

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:

* `date`

* `transaction_previous_month`

Tabela wynikowa

| date | transaction\_previous\_month |
| --- | --- |
| 1/7/2022 | Dec 2021 |
| 1/19/2022 | Dec 2021 |
| 2/5/2022 | Jan 2022 |
| 2/28/2022 | Jan 2022 |
| 3/16/2022 | Feb 2022 |
| 4/1/2022 | Mar 2022 |
| 5/7/2022 | Apr 2022 |
| 5/16/2022 | Apr 2022 |
| 6/15/2022 | May 2022 |
| 6/26/2022 | May 2022 |
| 7/9/2022 | Jun 2022 |
| 7/22/2022 | Jun 2022 |
| 7/23/2022 | Jun 2022 |
| 7/27/2022 | Jun 2022 |
| 8/2/2022 | Jul 2022 |
| 8/8/2022 | Jul 2022 |
| 8/19/2022 | Jul 2022 |
| 9/26/2022 | Aug 2022 |
| 10/14/2022 | Sep 2022 |
| 10/29/2022 | Sep 2022 |

W tym przypadku, ponieważ wartości `period_no` -1 użyto jako argumentu przesunięcia w funkcji `monthname()`, funkcja najpierw identyfikuje miesiąc, w którym odbywają się transakcje. Następnie powoduje przesunięcie o miesiąc wcześniej i zwraca nazwę miesiąca oraz rok.

Diagram funkcji monthname, przykład period\_no

Diagram funkcji monthname, przykład period\_no

Diagram funkcji monthname, przykład period\_no ![Diagram przedstawiający wyniki wykorzystania funkcji monthname do określenia miesiąca, w którym miała miejsce transakcja.](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-period-no.png)

Transakcja 8192 miała miejsce 16 marca. Funkcja `monthname()` identyfikuje, że miesiącem poprzedzającym transakcję był luty, i zwraca miesiąc w formacie zmiennej systemowej `MonthNames` wraz z rokiem 2022.

## Przykład 3 — przykład z obiektem wykresu

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/monthname.htm)

#### Skrypt ładowania i wyrażenie wykresu

Przegląd

Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.

Skrypt ładowania zawiera ten sam wbudowany zestaw danych i zastosowanie co w pierwszym przykładzie. Jednak w tym przykładzie do aplikacji został załadowany niezmieniony zbiór danych. Obliczenie zwracające znacznik czasu końca miesiąca, kiedy wystąpiły transakcje, jest tworzone jako miara w obiekcie wykresu aplikacji.

Skrypt ładowania

```
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';

Transactions:
Load
*
Inline
[
id,date,amount
8188,1/7/2022,17.17
8189,1/19/2022,37.23
8190,2/28/2022,88.27
8191,2/5/2022,57.42
8192,3/16/2022,53.80
8193,4/1/2022,82.06
8194,5/7/2022,40.39
8195,5/16/2022,87.21
8196,6/15/2022,95.93
8197,6/26/2022,45.89
8198,7/9/2022,36.23
8199,7/22/2022,25.66
8200,7/23/2022,82.77
8201,7/27/2022,69.98
8202,8/2/2022,76.11
8203,8/8/2022,25.12
8204,8/19/2022,46.23
8205,9/26/2022,84.21
8206,10/14/2022,96.24 
8207,10/29/2022,67.67
];
```

Wyniki

Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj to pole jako wymiar:`date`.

Utwórz następującą miarę:

`=monthname(date)`

Tabela wynikowa

| date | =monthname(date) |
| --- | --- |
| 1/7/2022 | Jan 2022 |
| 1/19/2022 | Jan 2022 |
| 2/5/2022 | Feb 2022 |
| 2/28/2022 | Feb 2022 |
| 3/16/2022 | Mar 2022 |
| 4/1/2022 | Apr 2022 |
| 5/7/2022 | May 2022 |
| 5/16/2022 | May 2022 |
| 6/15/2022 | Jun 2022 |
| 6/26/2022 | Jun 2022 |
| 7/9/2022 | Jul 2022 |
| 7/22/2022 | Jul 2022 |
| 7/23/2022 | Jul 2022 |
| 7/27/2022 | Jul 2022 |
| 8/2/2022 | Aug 2022 |
| 8/8/2022 | Aug 2022 |
| 8/19/2022 | Aug 2022 |
| 9/26/2022 | Sep 2022 |
| 10/14/2022 | Oct 2022 |
| 10/29/2022 | Oct 2022 |

Miarę „`month_name`” tworzy się w obiekcie wykresu, używając funkcji `monthname()` i przekazując pole daty `date` jako jej argument.

Diagram funkcji monthname, przykład obiektu wykresu

Diagram funkcji monthname, przykład obiektu wykresu

Diagram funkcji monthname, przykład obiektu wykresu ![Diagram przedstawiający wyniki wykorzystania funkcji monthname do określenia miesiąca, w którym miała miejsce transakcja.](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Resources/Images/scripting-functions-monthname-chart-object.png)

Funkcja `monthname()` identyfikuje, że transakcja 8192 miała miejsce w marcu 2022 r., i zwraca tę wartość przy użyciu zmiennej systemowej `MonthNames`.