Ta funkcja zwraca wartość pokazującą miesiące kwartału (sformatowane zgodnie ze stosowaną w skryptach zmienną MonthNames) oraz rok z bazową wartością liczbową odpowiadającą znacznikowi czasu pierwszej milisekundy pierwszego dnia tego kwartału.
Składnia:
QuarterName(date[, period_no[, first_month_of_year]])
Typ zwracanych danych: dual
Schemat funkcji quartername()
Funkcja quartername() określa, w którym kwartale wypada data. Następnie zwraca wartość pokazującą pierwszy i ostatni miesiąc tego kwartału, jak również roku. Wartością, na podstawie której został zwrócony ten wynik, jest pierwsza milisekunda kwartału.
| Argument | Opis |
|---|---|
| date | Data lub znacznik czasu do oszacowania. |
| period_no | period_no jest liczbą całkowitą, gdzie 0 oznacza kwartał, który zawiera datę date. Wartości ujemne parametru period_no oznaczają kwartały poprzednie, a wartości dodatnie — kwartały następne. |
| first_month_of_year | Jeśli użytkownik zamierza korzystać z lat (obrotowych), które nie zaczynają się w styczniu, powinien wskazać wartość od 2 do 12 jako parametr first_month_of_year. |
Kiedy używać
Funkcja quartername() jest przydatna, gdy chcesz porównać agregacje według kwartału. Na przykład, jeśli chcesz zobaczyć całkowitą sprzedaż produktów według kwartału.
Tej funkcji można użyć w skrypcie ładowania w celu utworzenia pola w tabeli kalendarza głównego. Ewentualnie można jej użyć bezpośrednio na wykresie jako wymiaru wyliczanego.
W tych przykładach używany jest format daty MM/DD/YYYY. Format daty jest określony w instrukcji SET DateFormat u góry skryptu ładowania danych. Format zastosowany w przykładach można zmienić, aby dostosować go do konkretnych potrzeb.
| Przykład | Wynik |
|---|---|
| quartername('10/29/2013') | Zwraca wartość Oct-Dec 2013. |
| quartername('10/29/2013', -1) | Zwraca wartość Jul-Sep 2013. |
| quartername('10/29/2013', 0, 3) | Zwraca wartość Sep-Nov 2013. |
Ustawienia regionalne
Jeżeli nie podano inaczej, w przykładach w tym temacie stosowany jest następujący format daty: MM/DD/RRRR. 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.
Domyślne ustawienia regionalne w aplikacjach są oparte na regionalnych ustawieniach systemu komputera lub serwera, na którym zainstalowano Qlik Sense. Jeśli serwer Qlik Sense, do którego uzyskujesz dostęp, jest ustawiony na Szwecję, Edytor ładowania danych użyje szwedzkich ustawień regionalnych dla dat, godziny i waluty. Te ustawienia regionalne nie są związane z językiem wyświetlanym w interfejsie użytkownika Qlik Sense. Interfejs Qlik Sense będzie wyświetlany w tym samym języku co używana przeglądarka.
Przykład 1 — data bez dodatkowych argumentów
Przegląd
Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.
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 zmiennej systemowej DateFormat (MM/DD/YYYY).
-
Utworzenie pola transaction_quarter zwracającego kwartał, w którym miały miejsce transakcje.
Dodaj tutaj swój inny tekst, w razie potrzeby, z listami itp.
Skrypt ładowania
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';
Transactions:
Load
*,
quartername(date) as transaction_quarter
;
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_quarter
| date | transaction_quarter |
|---|---|
| 1/7/2022 | Jan-Mar 2022 |
| 1/19/2022 | Jan-Mar 2022 |
| 2/5/2022 | Jan-Mar 2022 |
| 2/28/2022 | Jan-Mar 2022 |
| 3/16/2022 | Jan-Mar 2022 |
| 4/1/2022 | Apr-Jun 2022 |
| 5/7/2022 | Apr-Jun 2022 |
| 5/16/2022 | Apr-Jun 2022 |
| 6/15/2022 | Apr-Jun 2022 |
| 6/26/2022 | Apr-Jun 2022 |
| 7/9/2022 | Jul-Sep 2022 |
| 7/22/2022 | Jul-Sep 2022 |
| 7/23/2022 | Jul-Sep 2022 |
| 7/27/2022 | Jul-Sep 2022 |
| 8/2/2022 | Jul-Sep 2022 |
| 8/8/2022 | Jul-Sep 2022 |
| 8/19/2022 | Jul-Sep 2022 |
| 9/26/2022 | Jul-Sep 2022 |
| 10/14/2022 | Oct-Dec 2022 |
| 10/29/2022 | Oct-Dec 2022 |
Pole „transaction_quarter” jest tworzone w poprzedzającej instrukcji LOAD przez użycie funkcji quartername() i przekazanie pola daty jako jej argumentu.
Funkcja quartername() początkowo identyfikuje kwartał, w którym przypada wartość daty. Następnie zwraca wartość pokazującą pierwszy i ostatni miesiąc tego kwartału, jak również roku.
Diagram funkcji quartername(), przykład bez dodatkowych argumentów
Transakcja 8203 miała miejsca 8 sierpnia 2022 roku. Funkcja quartername() stwierdza, że transakcja miała miejsce w trzecim kwartale, więc zwraca lip-wrz 2022 r. Miesiące są ukazane w takim samym formacie, jak zmienna systemowa MonthNames.
Przykład 2 – data z argumentem period_no
Przegląd
Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.
Skrypt ładowania zawiera:
-
Ten sam zestaw danych i scenariusz co w pierwszym przykładzie.
-
Utworzenie pola previous_quarter zwracającego kwartał poprzedzający ten, 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
*,
quartername(date,-1) as previous_quarter
;
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
-
previous_quarter
| date | previous_quarter |
|---|---|
| 1/7/2022 | Oct-Dec 2021 |
| 1/19/2022 | Oct-Dec 2021 |
| 2/5/2022 | Oct-Dec 2021 |
| 2/28/2022 | Oct-Dec 2021 |
| 3/16/2022 | Oct-Dec 2021 |
| 4/1/2022 | Jan-Mar 2022 |
| 5/7/2022 | Jan-Mar 2022 |
| 5/16/2022 | Jan-Mar 2022 |
| 6/15/2022 | Jan-Mar 2022 |
| 6/26/2022 | Jan-Mar 2022 |
| 7/9/2022 | Apr-Jun 2022 |
| 7/22/2022 | Apr-Jun 2022 |
| 7/23/2022 | Apr-Jun 2022 |
| 7/27/2022 | Apr-Jun 2022 |
| 8/2/2022 | Apr-Jun 2022 |
| 8/8/2022 | Apr-Jun 2022 |
| 8/19/2022 | Apr-Jun 2022 |
| 9/26/2022 | Apr-Jun 2022 |
| 10/14/2022 | Jul-Sep 2022 |
| 10/29/2022 | Jul-Sep 2022 |
W tym przypadku, ponieważ do funkcji quartername() jako argument przesunięcia period_no przekazano wartość -1, funkcja ta najpierw stwierdza, że transakcje miały miejsce w trzecim kwartale. Następnie dokonuje przesunięcia o jeden kwartał wstecz i zwraca wartość pokazującą pierwszy i ostatni miesiąc tego kwartału, jak również roku.
Diagram funkcji quartername(), przykład z argumentem period_no
Transakcja 8203 miała miejsce 8 sierpnia. Funkcja quartername() stwierdza, że kwartał przed datą transakcji obejmował okres od 1 kwietnia do 30 czerwca. W związku z tym zwraca kwi-cze 2022 r.
Przykład 3 – data z argumentem first_week_day
Przegląd
Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.
Skrypt ładowania zawiera ten sam zestaw danych i scenariusz co w pierwszym przykładzie. Jednak w tym przykładzie musimy również ustawić 1 marca jako pierwszy miesiąc roku podatkowego.
Skrypt ładowania
SET DateFormat='MM/DD/YYYY';
SET MonthNames='Jan;Feb;Mar;Apr;May;Jun;Jul;Aug;Sep;Oct;Nov;Dec';
Transactions:
Load
*,
quartername(date,0,3) as transaction_quarter
;
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_quarter
| date | transaction_quarter |
|---|---|
| 1/7/2022 | Gru-lut 2021 |
| 1/19/2022 | Gru-lut 2021 |
| 2/5/2022 | Gru-lut 2021 |
| 2/28/2022 | Gru-lut 2021 |
| 3/16/2022 | Mar-maj 2022 |
| 4/1/2022 | Mar-maj 2022 |
| 5/7/2022 | Mar-maj 2022 |
| 5/16/2022 | Mar-maj 2022 |
| 6/15/2022 | Cze-sie 2022 |
| 6/26/2022 | Cze-sie 2022 |
| 7/9/2022 | Cze-sie 2022 |
| 7/22/2022 | Cze-sie 2022 |
| 7/23/2022 | Cze-sie 2022 |
| 7/27/2022 | Cze-sie 2022 |
| 8/2/2022 | Cze-sie 2022 |
| 8/8/2022 | Cze-sie 2022 |
| 8/19/2022 | Cze-sie 2022 |
| 9/26/2022 | Wrz-lis 2022 |
| 10/14/2022 | Wrz-lis 2022 |
| 10/29/2022 | Wrz-lis 2022 |
W tym przypadku do funkcji quartername() przekazano wartość 3 jako argument first_month_of_year, w efekcie czego początek roku został przesunięty z 1 stycznia na 1 marca. To spowodowało, że kwartały w tym roku zmieniły się na mar-maj, cze-sie, wrz-lis oraz gru-lut.
Diagram funkcji quartername(), przykład z argumentem first_week_day
Transakcja 8203 miała miejsce 8 sierpnia. Funkcja quartername() stwierdza, że to był drugi kwartał obejmujący dni od początku czerwca do końca sierpnia. W związku z tym zwraca cze-sie 2022 r.
Przykład 4 — przykład z obiektem wykresu
Przegląd
Otwórz Edytor ładowania danych i poniżej dodaj skrypt ładowania do nowej karty.
Skrypt ładowania zawiera ten sam zestaw danych i scenariusz co w pierwszym przykładzie.
Jednak w tym przykładzie do aplikacji został załadowany niezmieniony zbiór danych. Obliczenia zwracające znacznik czasu końca kwartału, w którym wystąpiły transakcje, są tworzone jako miara w obiekcie wykresu aplikacji.
Skrypt ładowania
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/022,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ę:
=quartername(date)
| date | =quartername(date) |
|---|---|
| 1/7/2022 | Jan-Mar 2022 |
| 1/19/2022 | Jan-Mar 2022 |
| 2/5/2022 | Jan-Mar 2022 |
| 2/28/2022 | Jan-Mar 2022 |
| 3/16/2022 | Jan-Mar 2022 |
| 4/1/2022 | Apr-Jun 2022 |
| 5/7/2022 | Apr-Jun 2022 |
| 5/16/2022 | Apr-Jun 2022 |
| 6/15/2022 | Apr-Jun 2022 |
| 6/26/2022 | Apr-Jun 2022 |
| 7/9/2022 | Jul-Sep 2022 |
| 7/22/2022 | Jul-Sep 2022 |
| 7/23/2022 | Jul-Sep 2022 |
| 7/27/2022 | Jul-Sep 2022 |
| 8/2/2022 | Jul-Sep 2022 |
| 8/8/2022 | Jul-Sep 2022 |
| 8/19/2022 | Jul-Sep 2022 |
| 9/26/2022 | Jul-Sep 2022 |
| 10/14/2022 | Oct-Dec 2022 |
| 10/29/2022 | Oct-Dec 2022 |
Miarę „transaction_quarter” tworzy się w obiekcie wykresu, używając funkcji quartername() i przekazując pole daty date jako jej argument.
Funkcja quartername() początkowo identyfikuje kwartał, w którym przypada wartość daty. Następnie zwraca wartość pokazującą pierwszy i ostatni miesiąc tego kwartału, jak również roku.
Diagram funkcji quartername(), przykład obiektu wykresu
Transakcja 8203 miała miejsca 8 sierpnia 2022 roku. Funkcja quartername() stwierdza, że transakcja miała miejsce w trzecim kwartale, więc zwraca lip-wrz 2022 r. Miesiące są ukazane w takim samym formacie, jak zmienna systemowa MonthNames.