日付および時間関数

変数

now

現在の時刻を YYYY-MM-DD-hhss 形式で取得します。

timestamp

現在の時刻を UNIX タイムスタンプとして取得します。

関数

addSeconds (date; number)

指定された秒数を日付に追加した結果として、新しい日付を返します。秒数を減算するには、負の数を入力します。

例：

addMinutes (date; number) addminutes-date-number

指定された分数を日付に追加した結果として、新しい日付を返します。分数を減算するには、負の数を入力します。

例：

addHours (date; number) addhours-date-number

指定した時間数を日付に追加した結果として、新しい日付を返します。時間数を減算するには、負の数を入力します。

例：

addDays (date; number) adddays-date-number

指定した日数を日付に加算した結果を新しい日付として返します。日数を減算するには、負の数を入力します。

例：

addMonths (date; number)

指定された月数を日付に追加した結果として、新しい日付を返します。月数を減算するには、負の数を入力します。

例：

addYears (date; number)

指定された年数を日付に追加した結果として、新しい日付を返します。年数を減算するには、負の数を入力します。

例：

setSecond (date; number)

この関数は、パラメーターで指定された秒数を持つ新しい日付を返します。

0 ～ 59 の数値を指定します。数値がその範囲外にある場合、この関数は、前の分（負の数の場合）または後続の分（正の数の場合）からの秒数を返します。

範囲外の数値を指定する必要がある場合は、前述の addSeconds （date; number）の節で説明されているように、​ addSeconds を使用することをお勧めします。

例：

setMinute (date; number)

この関数は、パラメーターで指定された分数を持つ新しい日付を返します。

0 ～ 59 の数値を指定します。数値がその範囲外にある場合、この関数は、前の時間（負の数の場合）または後続の時間（正の数の場合）の分数を返します。

範囲外の数値を指定する必要がある場合は、上記の addMinutes（date; number）の説明に従って、addMinutes を使用することをお勧めします。

例：

setHour (date; number)

この関数は、パラメーターで指定された時間数を持つ新しい日付を返します。

0 ～ 23 の数値を指定します。数値がこの範囲外にある場合、この関数は、前日（負の数の場合）または翌日（正の数の場合）の時間数を返します。

範囲外の数値を指定する必要がある場合は、上記の addHours（date; number）の説明に従って、addHours を使用することをお勧めします。

例：

setDay (date; number/name of the day in English)

この関数は、パラメーターで指定された日の新しい日付を返します。

この関数を使用して曜日を設定できます。日曜日は 1、土曜日は 7 と指定します。1～7 の数値を指定した場合、結果の日付は現在の（日曜日から土曜日）週の範囲内になります。この数値がその範囲外の場合、前の週（負の数の場合）または次の週（正の数の場合）の日を返します。

範囲外の数値を指定する必要がある場合は、前述の addDays を使用することをお勧めします（addDays (date; number) を参照）。

例：

setDate (date; number)

この関数は、パラメーターで指定された月日の新しい日付を返します。

1～31 の数値を指定します。この範囲外の数値の場合、前の月（負の数の場合）または次の月（正の数の場合）の日を返します。

例：

setMonth (date; number/name of the month in English)

この関数は、パラメーターで指定された月の新しい日付を返します。

1～12 の数値を指定します。この範囲外の数値の場合、前の年（負の数の場合）または次の年（正の数の場合）の月を返します。

例：

setYear (date; number)

パラメーターで指定された年の新しい日付を返します。

例：

formatDate (date; format; [timezone])

この関数は、12-10-2021 20:30 などの日付値を Dec 10, 2021 8:30 PM などのテキスト値として書式設定する場合に使用します。

これは、例えば同じシナリオで 1 つのアプリまたは web サービスの日付形式を、接続されているアプリまたは web サービスの日付形式に変更する必要がある場合に便利です。

詳細については、「 アイテム データの種類」の「日付とテキスト」を参照してください。

パラメーター

異なるタイプを指定した場合、型強制が適用されます。詳細については、「 型強制」を参照してください。

戻り値とタイプ

formatDate 関数は、指定された形式とタイムゾーンに従って、指定された日付値のテキスト表現を返します。データタイプはテキストです。

例： ​シナリオと web タイムゾーンは、これらの例ではどちらも Europe/Prague に設定されています。

parseDate (text; format; [timezone])

日付を表すテキスト値（12-10-2019 20:30 または Aug 18, 2019 10:00 AM）の場合、この関数を使用して、日付値（バイナリマシンが読み取り可能な表現）に変換（解析）する必要があります。詳細については、「 アイテム データの種類」の「日付とテキスト」を参照してください。

パラメーター

2 番目の列は、期待されるタイプを示します。異なるタイプを指定した場合、型強制が適用されます。詳細については、「 型強制」を参照してください。

異なるタイプを指定した場合、型強制が適用されます。詳細については、「 型強制」を参照してください。

戻り値とタイプ

この関数は、指定した形式とタイムゾーンに従って、テキスト文字列を日付に変換します。値のデータタイプは日付です。

例： 次の例では、返される日付値は ISO 8601 に従って表されますが、結果のデータタイプは日付です。

dateDifference (Date1; Date2; Unit)

2 つの日付の差を表す数値を、指定された単位で返します。

Date1 から Date2 が減算されます。

unit パラメーターには、次のいずれかの時刻値を使用します。

単位が指定されていない場合、この関数は差をミリ秒単位で返します。

例：

その他の例

月の n 番目の曜日の計算方法

Exceljet の web ページから Workfront Fusion 向けに調整されたこの節では、月の n 番目の曜日を取得する方法を説明します。

月の n 番目の曜日（例：最初の火曜日、3 番目の金曜日など）に対応する日付を計算する必要がある場合、次の数式を使用できます。

{{addDays(setDate(1.date; 1); 1.n * 7 - formatDate(addDays(setDate(1.date; 1); "-" + 1.dow); "E"))}}

数式には、次の項目が含まれます。

例えば、第 2 水曜日ごとに 1 つの特定のケースのみを計算する場合は、1.n および 2.dow の項目を計算式内で対応する数値に置き換えることができます。現在の月の第 2 水曜日には、次の値を使用します。

説明：

日付間の日数の計算方法

例えば、次の式を使用できます。

{{round((2.value - 1.value) / 1000 / 60 / 60 / 24)}}

月の最終日／ミリ秒の計算方法

日付範囲を指定する場合、例えば、検索モジュールで、範囲が前月の全体にわたりクローズした間隔（両方の制限ポイントを含む間隔）の場合、月の最終日を計算する必要があります。

2019-09-01 ≤ D ≤ 2019-09-30

次の数式は、前月の最終日の計算方法の 1 つを示しています。

{{addDays(setDate(now; 1); -1)}}

場合によっては、月の最後日だけでなく、文字どおり最後のミリ秒も計算する必要があります。

2019-09-01T00:00:00.000Z ≤ D ≤ 2019-09-30T23:59:59.999Z

この数式は、前月の直近ミリ秒を計算する方法の 1 つを示します。

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD"; "UTC") - 1; "x")}}

タイムゾーン設定を使用するのに結果が必要な場合は、UTC 引数を省略します。

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD") - 1; "x")}}

ただし、次のように、翌月の最初の日を指定し、「次よりも小さいか等しい」演算子を「次よりも小さい」に置き換えて、代わりに半開間隔（その制限ポイントを除く間隔）を使用することをお勧めします。

2019-09-01 ≤ D < 2019-10-01

2019-09-01T00:00:00.000Z ≤ D < 2019-10-01T00:00:00.000Z