inmonthstodate — funkcja skryptu i funkcja wykresu

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.

Syntax:

InMonths (n_months, timestamp, base_date, period_no[, first_month_of_year ])

Return data type: wartość logiczna

Arguments:

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).
timestamp	Data, która ma być porównana z wartością base_date.
base_date	Data używana do oceny okresu.
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.

W tych przykładach używany jest format daty DD/MM/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

inmonthstodate(4, '25/01/2013', '25/04/2013', 0)

Zwraca wartość True. Ponieważ wartość timestamp, 25/01/2013, przypada w obrębie czteromiesięcznego okresu od 01/01/2013 aż do końca 25/04/2013, który zawiera wartość base_date, 25/04/2013.

inmonthstodate(4, '26/04/2013', '25/04/2006', 0)

Zwraca wartość False. Ponieważ data 26/04/2013 przypada poza tym samym okresem co poprzedni przykład.

inmonthstodate(4, '25/09/2005', '01/02/2006', -1)

Zwraca wartość True. Ponieważ wartość period_no, -1, powoduje przesunięcie okresu wyszukiwania w tył o jeden okres czterech miesięcy (wartość n-months), przez co okres wyszukiwania przypada od 01/09/2012 do 01/02/2012.

inmonthstodate(4, '25/04/2006', '01/06/2006', 0, 3)

Zwraca wartość True. Ponieważ wartość first_month_of_year jest ustawiona na 3, przez co okres wyszukiwania przypada od 01/03/2006 do 01/06/2006, nie od 01/05/2006 do 01/06/2006.

Dodaj skrypt przykładowy do aplikacji i uruchom ją. Następnie dodaj do arkusza w swojej aplikacji co najmniej pola wyszczególnione w kolumnie wyników, aby wyświetlić wynik.

W tym przykładzie sprawdzane jest, czy data faktury w tabeli przypada w części dwumiesięcznego okresu obejmującego datę base_date przesuniętego w przód o cztery dwumiesięczne okresy (poprzez określenie period_no jako 4).

TempTable:

LOAD RecNo() as InvID, * Inline [

InvDate

28/03/2012

10/12/2012

5/2/2013

31/3/2013

19/5/2013

15/9/2013

11/12/2013

2/3/2014

14/5/2014

13/6/2014

7/7/2014

4/8/2014

];

InvoiceData:

LOAD *,

InMonthsToDate(2, InvDate, '15/02/2013', 4) AS InMths2DPlus4

Resident TempTable;

Drop table TempTable;

Otrzymana tabela zawiera pierwotne daty i kolumnę ze zwracaną wartością funkcji InMonths().

Okres wyszukiwania przypada od 01/09/2013 do 15/10/2013, ponieważ wartość base_date jest przesunięta do przodu o osiem miesiące względem wartości w funkcji (15/02/2013).

InvDate	InMths2DPlus4
28/03/2012	0 (False)
10/12/2012	0 (False)
5/2/2013	0 (False)
31/3/2013	0 (False)
19/5/2013	0 (False)
15/9/2013	-1 (True)
11/12/2013	0 (False)
2/3/2014	0 (False)
14/5/2014	0 (False)
13/6/2014	0 (False)
7/7/2014	0 (False)
4/8/2014	0 (False)