daystart - スクリプトおよびチャート関数
この関数は、time 引数に含まれる日の最初のミリ秒のタイムスタンプに対応する値を返します。デフォルトの出力形式は、スクリプトに設定されている TimestampFormat です。
構文:
DayStart(time[, [period_no[, day_start]])
戻り値データ型:デュアル
引数:
引数 | 説明 |
---|---|
time | 評価するタイムスタンプ。 |
period_no | period_no は整数または計算結果が整数になる数式で、値 0 は time を含む日を示します。period_no の値が負の場合は過去の日を、正の場合は将来の日を示します。 |
day_start | 1 日の開始時刻を深夜 0 時以外に設定する場合は、day_start に 1 日未満の長さを補正値として指定します。例えば、0.125 は午前 3 時を意味します。 |
例と結果:
これらの例は、日付書式 DD/MM/YYYY を使用しています。日付書式は、ロード スクリプト上部の SET DateFormat ステートメントで指定されています。必要に応じて、書式を変更してください。
例1:
daystart('25/01/2013 16:45:00')
25/01/2013 00:00:00 を返します。
例2:
daystart('25/01/2013 16:45:00', -1)
24/01/2013 00:00:00 を返します。
例3:
daystart('25/01/2013 16:45:00', 0, 0.5 )
25/01/2013 12:00:00 を返します。
例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 *,
DayStart(InvDate, 1) AS DStart
Resident TempTable;
Drop table TempTable;
結果テーブルには、元の日付と、daystart() 関数の戻り値の列が含まれています。チャート プロパティで書式を指定すると、タイムスタンプ全体を表示できます。
InvDate | DStart |
---|---|
28/03/2012 | 29/03/2012 00:00:00 |
10/12/2012 | 11/12/2012 00:00:00 |
5/2/2013 | 06/02/2013 00:00:00 |
31/3/2013 | 01/04/2013 00:00:00 |
19/5/2013 | 20/05/2013 00:00:00 |
15/9/2013 | 16/09/2013 00:00:00 |
11/12/2013 | 12/12/2013 00:00:00 |
2/3/2014 | 03/03/2014 00:00:00 |
14/5/2014 | 15/05/2014 00:00:00 |
13/6/2014 | 14/06/2014 00:00:00 |
7/7/2014 | 08/07/2014 00:00:00 |
4/8/2014 | 05/08/2014 00:00:00 |