# inyeartodate - スクリプトおよびチャート関数

この関数は、timestamp が base\_date のミリ秒単位まで正確に base\_date を含む年の範囲内にある場合、True を返します。

構文:

InYearToDate (timestamp, base\_date, period\_no[, first\_month\_of\_year])

**戻り値データ型：**ブール値

引数：

InYearToDate 引数

| 引数 | 説明 |
| --- | --- |
| 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() 関数の戻り値の列が含まれています。

例 6 の結果

| 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) |