inyeartodate - スクリプトおよびチャート関数
この関数は、timestamp が base_date のミリ秒単位まで正確に base_date を含む年の範囲内にある場合、True を返します。
構文:
InYearToDate (timestamp, base_date, period_no[, first_month_of_year])
戻り値データ型:ブール値
引数:
引数 | 説明 |
---|---|
timestamp | base_date と比較する日付。 |
base_date | 年の評価に使用する日付。 |
period_no | 年は period_no によって補正することができます。period_no は整数で、値 0 は base_date を含む年を示します。period_no の値が負の場合は過去の年を、正の場合は将来の年を示します。 |
first_month_of_year | 事業年度が 1 月以外の月に始まる場合は、first_month_of_year で 2 から 12 の間の値を指定します。 |
例1:
inyeartodate ('2013/01/25', '2013/02/01', 0)
True を返します
例2:
inyeartodate ('2012/01/25', '2013/01/01', 0)
False を返します
例3:
inyeartodate ('2012/01/25', '2013/02/01', -1)
True を返します
例4:
inyeartodate ('2012/11/25', '2013/01/31', 0, 4)
True を返します
timestamp の値は、4 番目の月から始まる会計年度かつ base_date の値までの範囲内です。
例5:
inyeartodate ( '2013/3/31', '2013/01/31', 0, 4 )
False を返します
上の例との違いは、timestamp の値が会計年度内ではあるものの base_dateの値の後になることです。そのため、範囲外になります。
例6:
ドキュメントに例のスクリプトを追加して実行します。その後、結果列に含まれている項目をドキュメントのシートに追加して結果を表示します。
この例では、first_month_of_year の値に 4 を指定し、請求書日付が、指定された会計年度内かつ 31/01/2013 の終了時刻以前かどうか確認します。
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 *,
InYearToDate(InvDate, '31/01/2013', 0, 4) AS FinYr2Date
Resident TempTable;
Drop table TempTable;
結果テーブルには、元の日付と、inyeartodate() 関数の戻り値の列が含まれています。
InvDate | FinYr2Date |
---|---|
28/03/2012 | 0 (False) |
10/12/2012 | -1 (True) |
5/2/2013 | 0 (False) |
31/3/2013 | 0 (False) |
19/5/2013 | 0 (False) |
15/9/2013 | 0 (False) |
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) |