Funkcje daty i godziny Qlik Sense umożliwiają przekształcanie i konwertowanie wartości daty i godziny. Wszystkie funkcje mogą być stosowane zarówno w skryptach ładowania danych, jak i wyrażeniach wykresu.
Funkcje te bazują na liczbie kolejnej daty i godziny, wyrażającej liczbę dni od 30 grudnia 1899 r. Wartość całkowita reprezentuje datę, a wartość ułamkowa godzinę.
W aplikacji Qlik Sense używana jest numeryczna wartość parametru, dlatego numer jest prawidłowym parametrem także wówczas, gdy nie jest sformatowany jako data lub godzina. Jeśli parametr nie odpowiada wartości numerycznej, na przykład dlatego, że jest ciągiem znaków, aplikacja Qlik Sense podejmuje próbę interpretacji ciągu znaków zgodnie ze zmiennymi środowiska daty i godziny.
Jeśli używany w parametrze format czasu nie odpowiada formatowi ustawionemu w zmiennych środowiska, aplikacja Qlik Sense nie dokona prawidłowej interpretacji. W takim przypadku trzeba zmienić ustawienia lub użyć funkcji interpretacji.
W przykładach dla każdej funkcji jako domyślne formaty godziny i daty przyjmuje się hh:mm:ss iYYYY-MM-DD (ISO 8601).
Informacja
Podczas przetwarzania znacznika czasu przy użyciu funkcji daty lub godziny program Qlik Sense ignoruje wszelkie parametry czasu letniego, chyba że funkcja daty lub godziny uwzględnia położenie geograficzne.
Na przykład w przypadku zapisu ConvertToLocalTime( filetime('Time.qvd'), 'Paris') czas letni będzie stosowany, a w przypadku zapisu ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00') parametry czasu letniego nie będą stosowane.
Przy każdej funkcji znajduje się pole rozwijane umożliwiające wyświetlenie składni i krótkiego opisu funkcji. Kliknij nazwę funkcji w opisie składni, aby uzyskać więcej informacji.
Wyrażenia godziny w liczbach całkowitych
Ta funkcja zwraca liczbę całkowitą reprezentującą sekundy, gdy ułamek expression jest interpretowany jako czas zgodnie ze standardową interpretacją liczb.
Ta funkcja zwraca liczbę całkowitą reprezentującą minuty, gdy ułamek expression jest interpretowany jako czas zgodnie ze standardową interpretacją liczb.
Ta funkcja zwraca liczbę całkowitą reprezentującą godzinę, gdy ułamek wyrażenia expression jest interpretowany jako czas zgodnie ze standardową interpretacją liczb.
Ta funkcja zwraca liczbę całkowitą reprezentującą dzień, gdy ułamek wyrażenia expression jest interpretowany jako data zgodnie ze standardową interpretacją liczb.
Ta funkcja zwraca liczbę całkowitą reprezentującą numer tygodnia zgodnie z normą ISO 8601. Numer miesiąca jest obliczany na podstawie interpretacji daty z wyrażenia zgodnie ze standardową interpretacją liczb.
Ta funkcja zwraca wartość podwójną z nazwą miesiąca, jak to zostało określone w zmiennej środowiskowej MonthNames, oraz liczbę całkowitą z przedziału 1–12. Miesiąc jest obliczany na podstawie interpretacji daty z wyrażenia zgodnie ze standardową interpretacją liczb.
Ta funkcja zwraca liczbę całkowitą reprezentującą rok, gdy wyrażenie expression jest interpretowane jako data zgodnie ze standardową interpretacją liczb.
Ta funkcja zwraca wartość podwójną: Nazwę dnia zdefiniowaną w zmiennej środowiskowej DayNames. Wartość całkowitą od 0 do 6, która odpowiada nominalnemu dniu tygodnia (0-6).
Ta funkcja sprawdza, czy wejściowy znacznik czasu przypada w roku daty dnia, w którym skrypt został ostatnio załadowany, i zwraca True, jeśli przypada, a False, jeśli nie przypada.
Przekształca znacznik czasu UTC lub GMT na czas lokalny w postaci wartości podwójnej. Parametr place może być dowolnym miastem, miejscem albo strefą czasową z całego świata.
Ta funkcja przyjmuje jako dane wejściowe wartości z pól timestamp, month i year i aktualizuje pole timestamp wartościami year i month określonymi w danych wejściowych.
Ta funkcja zwraca wartość True, jeśli wartość timestamp należy do części roku zawierającego wartość base_date, z dokładnością do ostatniej milisekundy wartości base_date włącznie.
Ta funkcja zwraca wartość True, jeśli wartość timestamp należy do części kwartału zawierającego wartość base_date, z dokładnością do ostatniej milisekundy wartości base_date włącznie.
Zwraca wartość True, jeśli wartość date należy do części miesiąca zawierającego wartość basedate z dokładnością do jednej milisekundy wartości basedate włącznie.
Ta funkcja wyszukuje, czy znacznik czasu przypada w tym samym miesiącu, okresie dwumiesięcznym, kwartale, jednej trzeciej roku lub półroczu co data podstawowa. Można także wyszukać, czy znacznik czasu przypada w okresie poprzednim lub następnym.
Ta funkcja wyszukuje, czy znacznik czasu przypada w części okresu miesiąca, dwóch miesięcy, kwartału, jednej trzeciej roku lub półrocza z dokładnością do jednej milisekundy wartości base_date włącznie. Można także wyszukać, czy znacznik czasu przypada w okresie poprzednim lub następnym.
Ta funkcja zwraca wartość True, jeśli wartość timestamp należy do części tygodnia zawierającego wartość base_date, z dokładnością do ostatniej milisekundy wartości base_date włącznie.
Ta funkcja sprawdza, czy wartość timestamp należy do tygodnia księżycowego zawierającego wartość base_date. Tygodnie księżycowe w Qlik Sense są określane tak, że 1 stycznia jest uznawany za pierwszy dzień tygodnia.
Ta funkcja sprawdza, czy wartość timestamp należy do części tygodnia księżycowego do ostatniej milisekundy wartości base_date włącznie. Tygodnie księżycowe w Qlik Sense są określane tak, że 1 stycznia jest uznawany za pierwszy dzień tygodnia.
Ta funkcja zwraca wartość True, jeśli wartość timestamp należy do części dnia zawierającego wartość base_timestamp, z dokładnością do jednej milisekundy wartości base_timestamp włącznie.
Ta funkcja zwraca znacznik czasu odpowiadający rozpoczęciu się pierwszego dnia roku zawierającego wartość date. Domyślnym formatem wyjściowym będzie format DateFormat skonfigurowany w skrypcie.
yearstart( date [, shift = 0 [, first_month_of_year
= 1]])
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu ostatniej milisekundy ostatniego dnia roku zawierającego wartość date. Domyślnym formatem wyjściowym będzie format DateFormat skonfigurowany w skrypcie.
yearend( date [, shift = 0 [, first_month_of_year
= 1]])
Ta funkcja zwraca rok w zapisie czterocyfrowym jako wartość wyświetlaną z bazową wartością liczbową odpowiadającą znacznikowi czasu pierwszej milisekundy pierwszego dnia roku zawierającego datę date.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu pierwszej milisekundy kwartału zawierającego wartość date. Domyślnym formatem wyjściowym będzie format DateFormat skonfigurowany w skrypcie.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu ostatniej milisekundy kwartału zawierającego wartość date. Domyślnym formatem wyjściowym będzie format DateFormat skonfigurowany w skrypcie.
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.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu pierwszej milisekundy ostatniego dnia miesiąca zawierającego wartość date. Domyślnym formatem wyjściowym będzie format DateFormat skonfigurowany w skrypcie.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu ostatniej milisekundy ostatniego dnia miesiąca zawierającego wartość date. Domyślnym formatem wyjściowym będzie format DateFormat skonfigurowany w skrypcie.
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.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu pierwszej milisekundy okresu miesiąca, dwóch miesięcy, kwartału, jednej trzeciej roku lub półrocza, który zawiera datę bazową. Można także wyszukać znacznik czasu dla okresu poprzedniego lub następnego.
monthsstart(n, date [, shift = 0 [, first_month_of_year
= 1]])
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu ostatniej milisekundy okresu miesiąca, dwóch miesięcy, kwartału, jednej trzeciej roku lub półrocza, który zawiera datę bazową. Można także wyszukać znacznik czasu dla okresu poprzedniego lub następnego.
monthsend(n, date [, shift = 0 [, first_month_of_year
= 1]])
Ta funkcja zwraca wartość reprezentującą zakres miesięcy w okresie (sformatowany zgodnie ze stosowaną w skryptach zmienną MonthNames), a także rok. Bazowa wartość liczbowa odpowiada znacznikowi czasu pierwszej milisekundy okresu miesiąca, dwóch miesięcy, kwartału, jednej trzeciej roku lub półrocza, który zawiera datę bazową.
monthsname(n, date [, shift = 0 [, first_month_of_year = 1]])
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu pierwszej milisekundy pierwszego dnia (poniedziałku) tygodnia kalendarzowego zawierającego datę date. Domyślnym formatem wyjściowym będzie format DateFormat skonfigurowany w skrypcie.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu ostatniej milisekundy ostatniego dnia (niedzieli) tygodnia kalendarzowego zawierającego datę date. Domyślnym formatem wyjściowym będzie format DateFormat ustawiony w skrypcie.
Ta funkcja zwraca wartość pokazującą rok i numer tygodnia z bazową wartością liczbową odpowiadającą znacznikowi czasu pierwszej milisekundy pierwszego dnia tygodnia, który zawiera datę date.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu pierwszej milisekundy tygodnia księżycowego zawierającego wartość date. Tygodnie księżycowe w Qlik Sense są określane tak, że 1 stycznia jest uznawany za pierwszy dzień tygodnia.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu ostatniej milisekundy tygodnia księżycowego zawierającego wartość date. Tygodnie księżycowe w Qlik Sense są określane tak, że 1 stycznia jest uznawany za pierwszy dzień tygodnia.
Ta funkcja zwraca wartość pokazującą rok i numer tygodnia księżycowego odpowiadający znacznikowi czasu pierwszej milisekundy pierwszego dnia tygodnia księżycowego zawierającego wartość date. Tygodnie księżycowe w Qlik Sense są określane tak, że 1 stycznia jest uznawany za pierwszy dzień tygodnia.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu dla pierwszej milisekundy dnia zawartego w argumencie time. Domyślnym formatem wyjściowym będzie format TimestampFormat skonfigurowany w skrypcie.
Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu dla ostatniej milisekundy dnia określonego przez parametr time. Domyślnym formatem wyjściowym będzie format TimestampFormat skonfigurowany w skrypcie.
Ta funkcja zwraca wartość pokazującą datę z bazową wartością liczbową odpowiadającą znacznikowi czasu dla pierwszej milisekundy dnia określonego przez parametr time.
Funkcja networkdays zwraca liczbę dni roboczych (poniedziałek–piątek) od start_date do end_date włącznie z uwzględnieniem opcjonalnych dni wolnych (holiday).
Funkcja firstworkdate zwraca najpóźniejszą datę rozpoczęcia, gdy możliwe jest uzyskanie parametru no_of_workdays (poniedziałek–piątek) z końcem nie później niż w dniu określonym przez parametr end_date oraz z uwzględnieniem wszelkich opcjonalnie wyszczególnionych dni wolnych. Parametry end_date i holiday powinny być poprawnymi datami lub znacznikami czasu.
Funkcja lastworkdate zwraca najwcześniejszą datę zakończenia, gdy możliwe jest uzyskanie parametru no_of_workdays (poniedziałek–piątek) z początkiem w dniu start_date z uwzględnieniem wszelkich opcjonalnie wyszczególnionych dni wolnych (holiday). Parametry start_date i holiday powinny być poprawnymi datami lub znacznikami czasu.
Ta funkcja oblicza numer dnia roku, w którym przypada znacznik czasu. Obliczenie jest wykonywane od pierwszej milisekundy pierwszego dnia roku, ale pierwszy miesiąc może być przesunięty.