日付/時刻関数

Designer は、1400 年 1 月 1 日より前の日付は処理できません。

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

i: 加算または減算する正または負の整数値。

u: 引用符で囲んで指定した日付時刻単位。years (年)、months (月)、days (日)、hours (時間)、minutes (分)、または seconds (秒)。

DateTimeAdd(DateTimeToday(), -1, "days") は、昨日の日付を返します。

DateTimeAdd(DateTimeFirstOfMonth(), 1, "months") は、次の月の初日を返します。

DateTimeAdd("2016-01-30", 1, "month") は、2016-02-29 を返します (2 月には 30 日がないため、その年の末日である 29 日を返します)。

は、2016-02-29 を返します (2 月には 30 日がないため、その年の末日である 29 日を返します)。

• 期間内の端数は切り捨てられます。例えば、「1.5時間」を追加することはできません。代わりに、「90分」を追加します。
• 単位を追加しても、より小さい単位の値は変更されません。例えば、時間を追加しても分または秒の値は変更されません。月を追加しても、結果の月にそのような日がない場合を除いて、日付または時刻は変更されません。その場合、その月の最後の日が返されます。

: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

DateTimeDay("2017-03-24 11:43:23") は、24 を返します。

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

u: 引用符で囲んで指定した日付時刻単位。years (年)、months (月)、days (日)、hours (時間)、minutes (分)、または seconds (秒)。

DateTimeDiff("2016-02-15 00:00:00", "2016-01-15 00:00:01", "Months") は、1 を返します (開始日と終了日が同じ日であるため)。

DateTimeDiff("2012-02-29","2011-03-01","years") は、0 を返します (2012-02-29 は 2011-03-01 から 365 日後ですが、2 月 29 日は 3 月 1 日より前であるため、「1 年」 はまだ完了していないことになります)。

DateTimeDiff("2016-02-14", "2016-01-15", "Months") は、0 を返します (2 月は 1 月より日数が少ないため)。

DateTimeDiff("2016-02-14 23:59:59", "2016-01-15 00:00:00", "Months") は、0 を返します (必要な日に到達するまでに 1 秒足りないため)。

DateTimeDiff('2017-02-28', '2016-02-29', 'Months') は、11 を返します (28 日が 2017 年 2月 の末日ですが、28 は 29 未満であるため)。

• 月と年の差については、終了日が開始日に達した時点でのみ 1 つの月がカウントされ、1 日の時刻は無視されます。
• 日、時、分、および秒の精度については、結果は正確に計算され、小数部分は四捨五入されずに切り捨てられます。したがって、
  DateTimeDiff(‘2016-01-01 00:59:59’, ‘2016-01-01 00:00:00’, ‘Hours’) は、0 を返します。
  DateTimeDiff(‘2016-01-01 23:59:59’, ‘2016-01-01 00:00:00’, ‘Days’) も、0 を返します。
• 精度の名前は、最初の 3 文字 (sec や min など) に短縮できます。大文字と小文字は区別されません。
• 時間差を秒単位で保存する場合は注意してください。Int32 では、秒で 68 年、分で 4082 年の差のみを保持できます。Double または Int64 を使用して、サポートされているすべての日付間の間隔を保持できます。

: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

f: 書式文字列で表される、データの変換先の形式。

l: 言語パラメーター (オプション)。言語パラメーターは、選択した Designer 言語が既定値となります。例えば、Designer がフランス語に設定されている場合、この関数は、DateTimeParse(dt,f,"Français") を既定で読み込みます。使用可能な言語の値については、言語パラメーター を参照してください。

DateTimeFormat([DateTime_Out],"%d-%m-%Y") は、日付が April 22, 2008 の場合に 22-04-2008 を返します (ISO 形式: 2008-04-22)。

DateTimeFormat([DateTime_Out],"%A","Spanish") は、ISO 日付が 2020-07-14 の場合に "martes" を返します (7 月 14 日は火曜日)。 

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

DateTimeHour("2017-03-24 11:43:23") は、11 を返します。

DateTimeHour("2017-03-24") は、0 を返します。日付とともに時刻が指定されていない場合は、想定される時間が真夜中となるためです。

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

DateTimeMinutes("2017-03-24 11:43:23") は、43 を返します。

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

DateTimeMonth("2017-03-24 11:43:23") は、3 を返します。

DateTimeMonth("11:43:23") は、入力データが有効でないため、[Null] を返します。

dt: 選択したフィールドまたは引用符で囲んだ日付/時刻文字列として表される日付/時刻文字列データ。入力データは、文字列データ型である必要があり、f パラメーターで指定した形式と一致する場合は、任意の日付/時刻形式にすることができます。

f: 変換する入力日付文字列データの形式であり、引用符で囲んだ形式文字列で表されます。

l: (オプション) 変換する入力日付文字列データの言語。言語パラメーターは、選択した Designer 言語が既定値となります。例えば、Designer がフランス語に設定されている場合、この関数は、DateTimeParse(dt,f,"Français") を既定で読み込みます。使用可能な言語の値については、言語パラメーター を参照してください。

DateTimeParse("2016/28-03","%Y/%d-%m") は、2016-03-28 を返します。

DateTimeParse([DateTimeNow],"%A %d %B %Y", "Français") は、入力日付文字列が "mardi 14 juillet 2020" (2020 年 7 月 14 日 火曜日) の場合、2020-07-14 を返します。

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

名前にもかかわらず、DateTimeToday() は時刻値を返しません。代わりに、現在の日付だけが返されます。DateTimeToday() 関数を ToDateTime() 関数でラップすると、現在の日付の午前 0 時に設定された日付/時刻値を返すことができます。

ToDateTime(DateTimeToday())

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

DateTimeToLocal('2014-08-01 20:01:25') は、ローカルシステムのタイムゾーン (山岳部標準時) を 2014-08-01 14:01:25 として返します。

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

DateTimeToUTC(DateTimeNow()) は、ワークフロー実行時に協定世界時 2014-08-01 20:01:25 を返します (ローカルの山岳部標準時が 2014-08-01 14:01:25 の場合)。

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

t: トリミングするタイプを選択します。オプションには以下が含まれます:

• Firstofmonth:: 該当月の初日にトリミング (month と同じ)。
• lastofmonth: 該当月の末日の終わり 1 秒前にトリミング。
• year: 1 月 1 日の午前 0 時にトリミング。
• month: 該当月の初日の午前 0 時にトリミング。
• day: 該当日の午前 0 時にトリミング。これは、日付時刻を該当日の 0 時 (日付ではない) に変換します。
• hour: 該当する時 (hour) にトリミング。
• minute: 該当する分 (minutes) にトリミング。

日付時刻をトリミングしても、返される値は四捨五入されません。例えば、時 (hour) にトリミングされた時刻15:59:59は、16:00:00 ではなく 15:00:00 になります。

DateTimeTrim("2016-12-07 16:03:00","year") は、2016-01-01 00:00:00 を返します。

dt: 選択した列または引用符で囲んで指定した日付/時刻値として表される日付/時刻データ。

DateTimeYear("2017-03-24 11:43:23") は、2017 を返します。

ToDate(2020-10-31) は、日付として 2020-10-31 を返します。

ToDate(7000) は、日付として 1919-03-01 を返します。

ToDate(2020-10-31 12:00:00) は、日付として 2020-10-31 を返します。

ToDateTime(2020-10-31) は、日付/時刻として 2020-10-31 00:00:00 を返します。

ToDateTime(7000.354167) は、日付/時刻として 1919-03-01 08:30:00 を返します。

ToDateTime(2020-10-31 12:00:00) は、日付/時刻として 2020-10-31 12:00:00 を返します。