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

この関数は、タイムスタンプが基準日と同じ月、隔月、四半期、4 か月、または半年のどれに該当するかを調べます。タイムスタンプがその前後の期間に該当するか確認することもできます。

構文:

InMonths(n\_months, timestamp, base\_date, period\_no [, first\_month\_of\_year])

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

引数：

InMonths 引数

| 引数 | 説明 |
| --- | --- |
| n\_months | 期間を定義する月数。整数、または計算結果が整数になる数式で次のうちのいずれかである必要があります: 1 (inmonth() 関数と同機能)、2 (2 か月)、3 (inquarter() 関数と同機能)、4 (4 か月)、6 (半年)。 |
| timestamp | base\_date と比較する日付。 |
| base\_date | 期間の評価に使用する日付。 |
| period\_no | 期間は、period\_no、整数、計算結果が整数になる数式を使用して補正できます。値 0 は base\_date を含む期間を示します。period\_no の値が負の場合は過去の期間を、正の場合は将来の期間を示します。 |
| first\_month\_of\_year | 事業年度が 1 月以外の月に始まる場合は、first\_month\_of\_year で 2 から 12 の間の値を指定します。 |

例と結果:

これらの例は、日付書式 DD/MM/YYYY を使用しています。日付書式は、ロード スクリプト上部の SET DateFormat ステートメントで指定されています。必要に応じて、書式を変更してください。

例1：

`inmonths(4, '25/01/2013', '25/04/2013',   0)`

True を返します。timestamp の値 25/01/2013 は、01/01/2013 から 30/04/2013 までの 4 か月の範囲内です。この期間には、base\_date の値 25/04/2013 も含まれています。

例2：

`inmonths(4, '25/05/2013', '25/04/2013',   0)`

False を返します。25/05/2013 は、上の例の期間の範囲外です。

例3：

`inmonths(4, '25/11/2012', '01/02/2013',   -1 )`

True を返します。period\_no の値に -1 が指定されているので、比較対象の 期間が 4 か月 (n-months の値) 前の 01/09/2012 から 31/12/2012. までの期間にシフトしています。

例4：

`inmonths( 4, '25/05/2006', '01/03/2006',   0, 3)`

True を返します。first\_month\_of\_year の値に 3が設定されており、比較対象の期間は 01/03/2006 から 30/07/2006 までではなく 01/01/2006 から 30/04/2006までになっています。

例5：

ドキュメントに例のスクリプトを追加して実行します。その後、結果列に含まれている項目をドキュメントのシートに追加して結果を表示します。

この例では、テーブルの請求書日付が、base\_date を 1 x 2 か月間 ( period\_no に 1 を指定) 後にシフトした日を含む 2 か月単位の期間の範囲内かどうか確認します。

`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 *,` `InMonths(2, InvDate, '11/02/2013', 1) AS InMthsPlus1` `Resident TempTable;`

`Drop table TempTable;`

結果テーブルには、元の日付と、InMonths() 関数の戻り値の列が含まれています。

base\_date の値が関数の値 (11/02/2013) から 2 か月後にシフトされているので、比較対象の期間は 01/03/2013 から 30/04/2013 までです。

例 5 の結果

| InvDate | InMthsPlus1 |
| --- | --- |
| 28/03/2012 | 0 (False) |
| 10/12/2012 | 0 (False) |
| 5/2/2013 | 0 (False) |
| 31/3/2013 | -1 (True) |
| 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) |