weekname - スクリプトおよびチャート関数
この関数は、date を含む週の初日の最初のミリ秒のタイムスタンプに対応する数値を基底として、年と週番号を表示する値を返します。
構文:
WeekName(date [, period_no = 0 [, first_week_day=0]])
戻り値データ型:デュアル
引数:
引数 | 説明 |
---|---|
date | 評価する日付。 |
period_no | shift は整数で、値 0 は date を含む週を示します。負の値の shift は過去の週を示し、正の値は将来の週を示します。 |
first_week_day |
first_week_day が指定されていない場合、変数 FirstWeekDay の値が週の初日として使用されます。 週の初日として別の曜日を指定する場合は、first_week_day を次のように設定します。
これで、関数から返された整数は、first_week_day (0 が基数) で指定した週の初日を使用するようになります。 |
例1:
weekname('12/01/2013')
2013/02 を返します。
例2:
weekname('12/01/2013', -1)
2013/01 を返します。
例3:
weekname('12/01/2013', 0, 1)
'2013/02' を返します。
例4:
ドキュメントに例のスクリプトを追加して実行します。その後、結果列に含まれている項目をドキュメントのシートに追加して結果を表示します。
この例では、テーブルの各請求書日付について、週が含まれている年と週番号に基づいて、週名を作成します。period_no に 1 が指定されているので、週番号は 1 週間シフトされています。
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 *,
WeekName(InvDate, 1) AS WkName
Resident TempTable;
Drop table TempTable;
結果テーブルには、元の日付と、weekname() 関数の戻り値の列が含まれています。チャート プロパティで書式を指定すると、タイムスタンプ全体を表示できます。
InvDate | WkName |
---|---|
28/03/2012 | 2012/14 |
10/12/2012 | 2012/51 |
5/2/2013 | 2013/07 |
31/3/2013 | 2013/14 |
19/5/2013 | 2013/21 |
15/9/2013 | 2013/38 |
11/12/2013 | 2013/51 |
2/3/2014 | 2014/10 |
14/5/2014 | 2014/21 |
13/6/2014 | 2014/25 |
7/7/2014 | 2014/29 |
4/8/2014 | 2014/33 |