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.
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.
Argumenty
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łady funkcji
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.
Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:
date
transaction_quarter
Tabela wynikowa
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.
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.
Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:
date
previous_quarter
Tabela wynikowa
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.
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.
Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:
date
transaction_quarter
Tabela wynikowa
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.
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.
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)
Tabela wynikowa
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.
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 5 — scenariusz
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).
Użytkownik końcowy chciałby otrzymać obiekt wykresu przedstawiający łączną sprzedaż w ujęciu kwartalnym dla transakcji. Można to osiągnąć nawet wtedy, gdy ten wymiar nie jest dostępny w modelu danych, używając funkcji quartername() jako wymiaru obliczanego na wykresie.