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

この関数は、date を含む月の初日の最初のミリ秒のタイムスタンプに対応する値を返します。デフォルトの出力形式は、スクリプトに設定されている DateFormat です。

構文:

MonthStart(date[, period\_no])

**戻り値データ型：**デュアル

引数：

MonthStart 引数

| 引数 | 説明 |
| --- | --- |
| date | 評価する日付。 |
| period\_no | period\_no は整数であり、0 が指定された場合または省略された場合、 date を含む月を示します。period\_no の値が負の場合は過去の月を、正の場合は将来の月を示します。 |

例と結果:

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

例1：

`monthstart('19/10/2001')`

01/10/2001 を返します。

例2：

`monthstart('19/10/2001', -1)`

01/09/2001 を返します。

例3：

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

この例では、テーブルの各請求書日付の月の開始日を取得します。period\_no に 4 が指定されているので base\_date は 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 *,` `MonthStart(InvDate, 4) AS MthStart` `Resident TempTable;`

`Drop table TempTable;`

結果テーブルには、元の日付と、monthstart() 関数の戻り値の列が含まれています。チャート プロパティで書式を指定すると、タイムスタンプ全体を表示できます。

例 3 の結果

| InvDate | MthStart |
| --- | --- |
| 28/03/2012 | 01/07/2012 |
| 10/12/2012 | 01/04/2013 |
| 5/2/2013 | 01/06/2013 |
| 31/3/2013 | 01/07/2013 |
| 19/5/2013 | 01/09/2013 |
| 15/9/2013 | 01/01/2014 |
| 11/12/2013 | 01/04/2014 |
| 2/3/2014 | 01/07/2014 |
| 14/5/2014 | 01/09/2014 |
| 13/6/2014 | 01/10/2014 |
| 7/7/2014 | 01/11/2014 |
| 4/8/2014 | 01/12/2014 |