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

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

構文:

WeekEnd(date [, period\_no = 0 [, first\_week\_day=0]])

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

引数：

WeekEnd 引数

| 引数 | 説明 |
| --- | --- |
| date | 評価する日付。 |
| period\_no | shift は整数で、値 0 は date を含む週を示します。負の値の shift は過去の週を示し、正の値は将来の週を示します。 |
| first\_week\_day | first\_week\_day が指定されていない場合、変数 FirstWeekDay の値が週の初日として使用されます。<br><br>週の初日として別の曜日を指定する場合は、first\_week\_day を次のように設定します。<br><br><ul> <li>0 - 月曜日</li> <li>1 - 火曜日</li> <li>2 - 水曜日</li> <li>3 - 木曜日</li> <li>4 - 金曜日</li> <li>5 - 土曜日</li> <li>6 - 日曜日</li> </ul><br><br>これで、関数から返された整数は、first\_week\_day (0 が基数) で指定した週の初日を使用するようになります。 |

例と結果:

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

例1：

`weekend('10/01/2013')`

12/01/2013 23:59:59 を返します。

例2：

`weekend('10/01/2013', -1)`

06/01/2013 23:59:59. を返します

例3：

`weekend('10/01/2013', 0, 1)`

14/01/2013 23:59:59 を返します。

例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 *,` `WeekEnd(InvDate, 1) AS WkEnd` `Resident TempTable;`

`Drop table TempTable;`

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

例 4 の結果

| InvDate | WkEnd |
| --- | --- |
| 28/03/2012 | 08/04/2012 |
| 10/12/2012 | 23/12/2012 |
| 5/2/2013 | 17/02/2013 |
| 31/3/2013 | 07/04/2013 |
| 19/5/2013 | 26/05/2013 |
| 15/9/2013 | 22/09/2013 |
| 11/12/2013 | 22/12/2013 |
| 2/3/2014 | 09/03/2014 |
| 14/5/2014 | 25/05/2014 |
| 13/6/2014 | 22/06/2014 |
| 7/7/2014 | 20/07/2014 |
| 4/8/2014 | 17/08/2014 |