日付および時間関数

最終更新日： 2025年4月21日
  • トピック：

変数

now

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

timestamp

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

関数

addSeconds（date; number）

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

例：

  • addSeconds(2016-12-08T15:55:57.536Z;2)

    2016-12-08T15:55:59.536Z を返します。

  • addSeconds(2016-12-08T15:55:57.536Z;-2)

    2016-12-08T15:55:55.536Z を返します。

addMinutes（date; number）

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

例：

  • addMinutes(2016-12-08T15:55:57.536Z;2)

    2016-12-08T15:57:57.536Z を返します。

  • addMinutes(2016-12-08T15:55:57.536Z;-2)

    2016-12-08T15:53:57.536Z を返します。

addHours（date; number）

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

例：

  • addHours(2016-12-08T15:55:57.536Z; 2)

    2016-12-08T17:55:57.536Z を返します。

  • addHours(2016-12-08T15:55:57.536Z;-2)

    2016-12-08T13:55:57.536Z を返します。

addDays (date; number)

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

例：

  • addDays(2016-12-08T15:55:57.536Z;2)

    戻り値：2016-12-10T15:55:57.536Z

  • addDays(2016-12-08T15:55:57.536Z;-2)

    戻り値：2016-12-6T15:55:57.536Z

addMonths（date, number）

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

例：

  • addMonths(2016-08-08T15:55:57.536Z;2)

    2016-10-08T15:55:57.536Z を返します。

  • addMonths(2016-08-08T15:55:57.536Z;-2)

    2016-06-08T15:55:57.536Z を返します。

addYears（date; number）

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

例：

  • addYears(2016-08-08T15:55:57.536Z;2)

    2018-08-08T15:55:57.536Z を返します。

  • addYears(2016-12-08T15:55:57.536Z; -2)

    2014-08-08T15:55:57.536Z を返します。

setSecond（date; number）

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

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

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

例：

  • setSecond(2015-10-07T11:36:39.138Z;10)

    2015-10-07T11:36:10.138Z を返します。

  • setSecond(2015-10-07T11:36:39.138Z; 61)

    2015-10-07T11:37:01.138Z を返します。

setMinute（date; number）

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

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

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

例：

  • setMinute(2015-10-07T11:36:39.138Z;10)

    2015-10-07T11:10:39.138Z を返します。

  • setMinute(2015-10-07T11:36:39.138Z;61)

    2015-10-07T12:01:39.138Z を返します。

setHour（date; number）

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

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

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

例：

  • setHour(2015-08-07T11:36:39.138Z;6)

    戻り値：2015-08-07T06:36:39.138Z

  • setHour(2015-08-07T11:36:39.138;-6)

    戻り値：2015-08-06T18:36:39.138Z

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

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

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

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

例：

  • setDay(2018-06-27T11:36:39.138Z;Monday)

    戻り値：2018-06-25T11:36:39.138Z

  • setDay(2018-06-27T11:36:39.138Z;1)

    戻り値：2018-06-24T11:36:39.138Z

  • setDay(2018-06-27T11:36:39.138Z;7)

    戻り値：2018-06-30T11:36:39.138Z

setDate (date; number)

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

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

例：

  • setDate(2015-08-07T11:36:39.138Z;5)

    戻り値：2015-08-05T11:36:39.138Z

  • setDate(2015-08-07T11:36:39.138Z;32)

    戻り値：2015-09-01T11:36:39.138Z

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

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

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

例：

  • setMonth(2015-08-07T11:36:39.138Z;5)

    戻り値：2015-05-07T11:36:39.138Z

  • setMonth(2015-08-07T11:36:39.138Z;17)

    戻り値：2016-05-07T11:36:39.138Z

  • setMonth(2015-08-07T11:36:39.138Z;january)

    戻り値：2015-01-07T12:36:39.138Z

setYear (date; number)

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

例：

  • setYear(2015-08-07T11:36:39.138Z;2017)

    戻り値：2017-08-07T11:36:39.138Z