Przeskocz do zawartości głównej Przejdź do treści uzupełniającej

monthsstart — funkcja skryptu i funkcja wykresu

Ta funkcja zwraca wartość odpowiadającą znacznikowi czasu pierwszej milisekundy okresu miesiąca, dwóch miesięcy, kwartału, czterech miesięcy lub półrocza, który zawiera datę bazową. Można także wyszukać znacznik czasu dla okresu poprzedniego lub następnego.Domyślnym formatem wyjściowym będzie format DateFormat skonfigurowany w skrypcie.

Składnia:  

MonthsStart(n_months, date[, period_no [, first_month_of_year]])

Typ zwracanych danych: dual

Schemat funkcji monthsstart()

Przykładowy diagram pokazujący, jak wszystkie elementy funkcji wspólnie zwracają znacznik czasu w wyniku.

Funkcja monthsstart() dzieli rok na segmenty na podstawie przekazanego argumentu n_months. Następnie sprawdza, do którego segmentu należy każda z przekazanych dat, i zwraca pierwszą milisekundę tego segmentu w formacie daty. Funkcja daje również możliwość zwracania początkowego znacznika czasu z poprzednich lub następnych segmentów, a także redefiniowania pierwszego miesiąca roku.

Następujące segmenty roku są dostępne w funkcji jako argumenty n_month:

Możliwe argumenty n_month
Okresy Liczba miesięcy
miesiąc 1
dwa miesiące 2
kwartał 3
cztery miesiące

4

pół roku 6
Argumenty
Argument Opis
n_months Liczba miesięcy określająca okres. Wartość całkowita lub wyrażenie, którego wynikiem jest jedna z następujących wartości całkowitych: 1 (równoważnik funkcji inmonth()), 2 (dwa miesiące), 3 (równoważnik funkcji inquarter()), 4 (cztery miesiące) lub 6 (pół roku).
date Data lub znacznik czasu do oszacowania.
period_no Okres może być przesunięty o wartość period_no — liczbę całkowitą lub wyrażenie, którego wynikiem jest liczba całkowita, gdzie wartość 0 wskazuje dzień zawierający wartość base_date. Wartości ujemne parametru period_no oznaczają okresy poprzednie, a wartości dodatnie — okresy 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 monthsstart() jest powszechnie używana jako część wyrażenia, gdy użytkownik chce, by w obliczeniach użyto ułamka okresu, który jeszcze nie nastąpił. Można to wykorzystać na przykład do dostarczenia zmiennej wejściowej umożliwiającej użytkownikowi obliczenie sumy odsetek nagromadzonych w miesiącu, kwartale lub półroczu.

Przykłady funkcji
Przykład Wynik
monthsstart(4, '10/19/2013') Zwraca wartość 09/01/2013.
monthsstart(4, '10/19/2013, -1) Zwraca wartość 05/01/2013.
monthsstart(4, '10/19/2013', 0, 2 ) Zwraca 10/01/2013, ponieważ początek roku został zmieniony na miesiąc 2.

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. Więcej informacji można znaleźć w temacie Modyfikowanie ustawień regionalnych na potrzeby aplikacji i skryptów.

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.

Przykład 1 — bez dodatkowych argumentów

Przykład 2 – period_no

Przykład 3 — first_month_of_year

Przykład 4 — przykład z obiektem wykresu

Przykład 5 — scenariusz

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać, co możemy poprawić!