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.
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.
Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:
date
bi_monthly_start
bi_monthly_start_timestamp
Tabela wynikowa
date
bi_monthly_start
bi_monthly_start_timestamp
2/19/2022
01/01/2022
1/1/2022 12:00:00 AM
3/7/2022
03/01/2022
3/1/2022 12:00:00 AM
3/30/2022
03/01/2022
3/1/2022 12:00:00 AM
4/5/2022
03/01/2022
3/1/2022 12:00:00 AM
4/16/2022
03/01/2022
3/1/2022 12:00:00 AM
5/1/2022
05/01/2022
5/1/2022 12:00:00 AM
5/7/2022
05/01/2022
5/1/2022 12:00:00 AM
5/22/2022
05/01/2022
5/1/2022 12:00:00 AM
6/15/2022
05/01/2022
5/1/2022 12:00:00 AM
6/26/2022
05/01/2022
5/1/2022 12:00:00 AM
7/9/2022
07/01/2022
7/1/2022 12:00:00 AM
7/22/2022
07/01/2022
7/1/2022 12:00:00 AM
7/23/2022
07/01/2022
7/1/2022 12:00:00 AM
7/27/2022
07/01/2022
7/1/2022 12:00:00 AM
8/2/2022
07/01/2022
7/1/2022 12:00:00 AM
8/8/2022
07/01/2022
7/1/2022 12:00:00 AM
8/19/2022
07/01/2022
7/1/2022 12:00:00 AM
9/26/2022
09/01/2022
9/1/2022 12:00:00 AM
10/14/2022
09/01/2022
9/1/2022 12:00:00 AM
10/29/2022
09/01/2022
9/1/2022 12:00:00 AM
Pole bi_monthly_start jest tworzone w instrukcji ładowania poprzedzającego przy użyciu funkcji monthsstart(). Pierwszy podany argument to 2, dzielący rok na segmenty dwumiesięczne. Pierwszy podany argument określa, które pole jest oceniane.
Transakcja 8195 ma miejsce 22 maja. Funkcja monthsstart() początkowo dzieli rok na segmenty dwumiesięczne. Transakcja 8195 należy do segmentu od 1 maja do 30 czerwca. W związku z tym funkcja zwraca pierwszą milisekundę tego segmentu, 1 maja 2022 r., godz 00:00:00.
Przykład 2 – 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, prev_bi_monthly_start, które zwraca pierwszą milisekundę dwumiesięcznego segmentu przed zawarciem transakcji.
Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:
date
prev_bi_monthly_start
prev_bi_monthly_start_timestamp
Tabela wynikowa
date
prev_bi_monthly_start
prev_bi_monthly_start_timestamp
2/19/2022
11/01/2021
11/1/2021 12:00:00 AM
3/7/2022
01/01/2022
1/1/2022 12:00:00 AM
3/30/2022
01/01/2022
1/1/2022 12:00:00 AM
4/5/2022
01/01/2022
1/1/2022 12:00:00 AM
4/16/2022
01/01/2022
1/1/2022 12:00:00 AM
5/1/2022
03/01/2022
3/1/2022 12:00:00 AM
5/7/2022
03/01/2022
3/1/2022 12:00:00 AM
5/22/2022
03/01/2022
3/1/2022 12:00:00 AM
6/15/2022
03/01/2022
3/1/2022 12:00:00 AM
6/26/2022
03/01/2022
3/1/2022 12:00:00 AM
7/9/2022
05/01/2022
5/1/2022 12:00:00 AM
7/22/2022
05/01/2022
5/1/2022 12:00:00 AM
7/23/2022
05/01/2022
5/1/2022 12:00:00 AM
7/27/2022
05/01/2022
5/1/2022 12:00:00 AM
8/2/2022
05/01/2022
5/1/2022 12:00:00 AM
8/8/2022
05/01/2022
5/1/2022 12:00:00 AM
8/19/2022
05/01/2022
5/1/2022 12:00:00 AM
9/26/2022
07/01/2022
7/1/2022 12:00:00 AM
10/14/2022
07/01/2022
7/1/2022 12:00:00 AM
10/29/2022
07/01/2022
7/1/2022 12:00:00 AM
Jeśli po podzieleniu roku na segmenty dwumiesięczne do funkcji monthsstart() jako argument period_no przekażemy wartość -1, funkcja ta zwróci ostatnią milisekundę dwumiesięcznego segmentu poprzedzającego ten, w którym zawarto transakcję.
Transakcja 8195 należy do segmentu od maja do czerwca. W związku z tym poprzedni dwumiesięczny segment obejmował okres od 1 marca do 30 kwietnia, więc funkcja zwraca pierwszą milisekundę tego segmentu – 1 marca 2022 r., godz 00:00:00.
Przykład 3 — first_month_of_year
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 bi_monthly_start, które grupuje transakcje w segmenty dwumiesięczne i zwraca początkowy znacznik czasu zestawu dla każdej transakcji.
Jednak w tym przykładzie musimy również ustawić kwiecień jako pierwszy miesiąc roku obrotowego.
Załaduj dane i otwórz arkusz. Utwórz nową tabelę i dodaj te pola jako wymiary:
date
bi_monthly_start
bi_monthly_start_timestamp
Tabela wynikowa
date
bi_monthly_start
bi_monthly_start_timestamp
2/19/2022
02/01/2022
2/1/2022 12:00:00 AM
3/7/2022
02/01/2022
2/1/2022 12:00:00 AM
3/30/2022
02/01/2022
2/1/2022 12:00:00 AM
4/5/2022
04/01/2022
4/1/2022 12:00:00 AM
4/16/2022
04/01/2022
4/1/2022 12:00:00 AM
5/1/2022
04/01/2022
4/1/2022 12:00:00 AM
5/7/2022
04/01/2022
4/1/2022 12:00:00 AM
5/22/2022
04/01/2022
4/1/2022 12:00:00 AM
6/15/2022
06/01/2022
6/1/2022 12:00:00 AM
6/26/2022
06/01/2022
6/1/2022 12:00:00 AM
7/9/2022
06/01/2022
6/1/2022 12:00:00 AM
7/22/2022
06/01/2022
6/1/2022 12:00:00 AM
7/23/2022
06/01/2022
6/1/2022 12:00:00 AM
7/27/2022
06/01/2022
6/1/2022 12:00:00 AM
8/2/2022
08/01/2022
8/1/2022 12:00:00 AM
8/8/2022
08/01/2022
8/1/2022 12:00:00 AM
8/19/2022
08/01/2022
8/1/2022 12:00:00 AM
9/26/2022
08/01/2022
8/1/2022 12:00:00 AM
10/14/2022
10/01/2022
10/1/2022 12:00:00 AM
10/29/2022
10/01/2022
10/1/2022 12:00:00 AM
Kiedy wartość 4 jest używana jako argument first_month_of_year w funkcji monthsstart(), funkcja rozpoczyna rok 1 kwietnia, a następnie dzieli rok na segmenty dwumiesięczne: Apr-May,Jun-Jul,Aug-Sep,Oct-Nov,Dec-Jan,Feb-Mar.
Transakcja 8195 miała miejsce 22 maja i należy do segmentu od 1 kwietnia do 31 maja. W związku z tym funkcja zwraca pierwszą milisekundę tego segmentu, 1 kwietnia 2022 r., godz 00:00:00.
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. Zostają utworzone obliczenia grupujące transakcje w segmenty dwumiesięczne i zwracające początkowy znacznik czasu zestawu dla każdej transakcji 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ące miary:
=monthsstart(2,date)
=timestamp(monthsstart(2,date))
Te obliczenia pobiorą początkowy znacznik czasu dwumiesięcznego segmentu, w którym została zawarta każda transakcja.
Tabela wynikowa
date
=monthsstart(2,date)
=timestamp(monthsstart(2,date))
9/26/2022
09/01/2022
9/1/2022 12:00:00 AM
10/14/2022
09/01/2022
9/1/2022 12:00:00 AM
10/29/2022
09/01/2022
9/1/2022 12:00:00 AM
7/9/2022
07/01/2022
7/1/2022 12:00:00 AM
7/22/2022
07/01/2022
7/1/2022 12:00:00 AM
7/23/2022
07/01/2022
7/1/2022 12:00:00 AM
7/27/2022
07/01/2022
7/1/2022 12:00:00 AM
8/2/2022
07/01/2022
7/1/2022 12:00:00 AM
8/8/2022
07/01/2022
7/1/2022 12:00:00 AM
8/19/2022
07/01/2022
7/1/2022 12:00:00 AM
5/1/2022
05/01/2022
5/1/2022 12:00:00 AM
5/7/2022
05/01/2022
5/1/2022 12:00:00 AM
5/22/2022
05/01/2022
5/1/2022 12:00:00 AM
6/15/2022
05/01/2022
5/1/2022 12:00:00 AM
6/26/2022
05/01/2022
5/1/2022 12:00:00 AM
3/7/2022
03/01/2022
3/1/2022 12:00:00 AM
3/30/2022
03/01/2022
3/1/2022 12:00:00 AM
4/5/2022
03/01/2022
3/1/2022 12:00:00 AM
4/16/2022
03/01/2022
3/1/2022 12:00:00 AM
2/19/2022
01/01/2022
1/1/2021 12:00:00 AM
Transakcja 8195 miała miejsce 22 maja. Funkcja monthsstart() początkowo dzieli rok na segmenty dwumiesięczne. Transakcja 8195 należy do segmentu od 1 maja do 30 czerwca. W związku z tym funkcja zwraca pierwszą milisekundę tego segmentu, 01.05.2022 r., godz 00:00:00.
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 sald kredytów, który jest ładowany do tabeli o nazwie Loans.
Dane zawierające identyfikatory kredytów, saldo na początku miesiąca i prostą stopę procentową naliczaną od każdego kredytu rocznie.
Użytkownik końcowy chciałby, aby obiekt wykresu wyświetlał według identyfikatora pożyczki bieżące odsetki naliczone od każdej pożyczki w wybranym okresie. Rok obrotowy rozpoczyna się w styczniu.
Na początku skryptu ładowania została utworzona zmienna (vPeriod), która zostanie powiązana z kontrolką wejściową zmiennej. Następnie skonfiguruj zmienną jako obiekt niestandardowy w arkuszu.
Wykonaj następujące czynności:
W panelu zasobów kliknij opcję Obiekty niestandardowe.
Wybierz Qlik Dashboard bundle i utwórz obiekt Wprowadzanie zmiennych.
Wprowadź tytuł obiektu wykresu.
W polu Zmienna wybierz vPeriod jako nazwę i ustaw obiekt tak, aby był wyświetlany jako lista rozwijana.
W obszarze Wartości skonfiguruj obiekt tak, aby używał wartości dynamicznych. Wprowadź: ='1~month|2~bi-month|3~quarter|4~tertial|6~half-year'
Następnie utwórz tabelę wyników.
Wykonaj następujące czynności:
Utwórz nową tabelę. Dodaj następujące pola jako wymiary:
Ustaw Formatowanie liczb miary na Waluta. Kliknij przycisk Koniec edycji. Możesz teraz modyfikować dane pokazane w tabeli, dostosowując segment czasu w obiekcie zmiennych.
Tak będzie wyglądać tabela wyników po wybraniu opcji okresu month:
Funkcja monthsstart() przyjmuje dane od użytkownika jako pierwszy argument i bieżącą datę jako drugi argument, po czym zwraca datę początkową okresu wybranego przez użytkownika. Odejmując ten wynik od bieżącej daty, wyrażenie zwraca liczbę dni, które upłynęły do tej pory w tym okresie.
Wartość ta jest następnie mnożona przez stopę procentową i dzielona przez 365, aby uzyskać wysokość odsetek nagromadzonych do tego momentu tygodnia. Wynik jest następnie mnożony przez saldo początkowe pożyczki, aby zwrócić odsetki naliczone do tej pory w tym okresie.
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ć!