@Adjust (式言語)
指定された日時値を、指定された年、月、日、時、分、秒の数値で調整します。調整する値は、正数でも負数でも指定できます。
構文
@Adjust( dateToAdjust ; years ; months ; days ; hours ; minutes ; seconds ; [DST] )
パラメータ
dateToAdjust
日時または日時リスト。増分する日時値を指定します。値の範囲ではなく必ず 1 つの日時を指定します。
years
数値。増分する年の数値を指定します。
months
数値。増分する月の数値を指定します。
days
数値。増分する日の数値を指定します。
hours
数値。増分する時の数値を指定します。
minutes
数値。増分する分の数値を指定します。
seconds
数値。増分する秒の数値を指定します。
[DST]
キーワード。オプション。日付の境界線をまたがって調整する際にサマータイムが実施されている場合、時刻をサマータイム用にさらに調整するには [INLOCALTIME] を指定します。[INGMT] を指定するかこのパラメータを省略すると、サマータイム用には時刻は調整されません。調整とは、日付を増やすか減らすかして、新たな日付の同じ時刻にすることです。
戻り値
adjustedDate
日時。指定した時間だけ増分された値が返されます。
使用法
最初のパラメータがリストである場合、この関数はリストの各要素ごとに処理され、戻り値は同じ数の要素を持つリストになります。
[DST] キーワードを除くすべての引数を必ず指定します。調整の必要がないパラメータにはゼロを指定します。
引数は、最後から最初の順に適用されます。例えば、@Adjust([2/2/2006]; 0; 2; 28; 0; 0; 0) の場合、[4/30/2006] ではなく、[5/2/2006] が返されます。これは、@Adjust によって最初に 28 日が加算されて [3/2/2006] になり、次の 2 か月が加算されて [5/2/2006] になるためです。最初に 2 カ月を加えた後に 28 日を加える場合は、次のように、@Adjust を 2 回使用します。@Adjust(@Adjust([02/02/2006]; 0; 2; 0; 0; 0; 0); 0; 0; 28; 0; 0; 0)
(date2-date1)/86400
4 が返されます。
期日を計算する
@Adjust の典型的な使用例は、日時のうち月などの構成要素を 1 つだけ調整して、入力日から期日を計算するものです。
例
- 次の例では、09/2/97 が返されます。
@Adjust([06/30/95];2;2;2;0;0;0)
日時値の日の部分が 30、加算日数が 2 であるため、月の値が 1 増えます。次に、月の値に 2、年の値に 2 が加えられます。
- 次の例では、03/20/94 が返されます。
@Adjust([03/30/96];-2;0;-10;0;0;0)
この場合、指定した日付より 2 年と 10 日前の日付が返されます。
- 次の例では、09/1/97 と 09/2/97 が返されます。
@Adjust([06/29/95] : [06/30/95]; 2; 2; 2; 0; 0; 0)
- 次の例では、[Date] というフィールドの日付から 1 ヵ月後の日付が返されます。
@Adjust(Date;0;1;0;0;0;0)
- 次の例では、現在の日時から 1 ヵ月と 1 日後の日付が返されます。
@Adjust(@Now;0;1;1;0;0;0)
- 次の式では、指定した日付の週の最初の日付が返されます。[dueDate] フィールドに保存されている日付が取り出され、直前の月曜日の日付が返されます。例えば、[dueDate] が 06/02/95 の場合、次の式では 05/29/95 が返されます。
@Adjust( dueDate; 0; 0; - ( @Weekday( dueDate ) - 2 ); 0; 0; 0 )
- 次の例では、5/2/2006 が返されます。
@Adjust([2/2/2006]; 0; 2; 28; 0; 0; 0)
- 次の例では、4/30/2006 が返されます。
@Adjust(@Adjust([02/02/2006]; 0; 2; 0; 0; 0; 0); 0; 0; 28; 0; 0; 0)
クロスリファレンス
LotusScript® NotesDateTime クラスの AdjustYear メソッド
Java DateTime クラスの adjustYear メソッド
LotusScript NotesDateTime クラスの AdjustMonth メソッド
Java DateTime クラスの adjustMonth メソッド
LotusScript NotesDateTime クラスの AdjustDay メソッド
Java DateTime クラスの adjustDay メソッド
LotusScript NotesDateTime クラスの AdjustHour メソッド
Java DateTime クラスの adjustHour メソッド
LotusScript NotesDateTime クラスの AdjustMinute メソッド
Java DateTime クラスの adjustMinute メソッド
LotusScript NotesDateTime クラスの AdjustSecond メソッド
Java DateTime クラスの adjustSecond メソッド