JavaScript

Date.UTC() メソッド

 編集:2022.12.05 by T.A.

[Edge]。→

協定世界時(UTC)での 1970 年 1 月 1 日 0 時 0 分 0 秒から指定日時(分割指定)までの経過時間をミリ秒で表す数値で返します。

構文

ECMAScript 2017 より:

Date.UTC(year[, month[, day[, hour[, minute[, second[, millisecond]]]]]])

ECMAScript 2016 以前: (month が必須であった)

Date.UTC(year, month[, day[, hour[, minute[, second[, millisecond]]]]])
year 完全な形の「年」

0 から 99 までの年は、20 世紀の年(1900 + year)に変換されます。例えば、95 は 1995 年に変換されます。

month 「月」を表す 0(1 月)から 11(12 月)までの整数値。(ECMAScript 2016 まで、month は必須の引数でした。ES2017 では必須ではなくなりました。)
day 省略可。「日」を表す 1 から 31 までの整数値。省略された場合の既定値は 1 です。
hour 省略可。「時」を表す 0 から 23 までの整数値。省略された場合の既定値は 0 です。
minute 省略可。「分」を表す 0 から 59 までの整数値。省略された場合の既定値は 0 です。
second 省略可。「秒」を表す 0 から 59 までの整数値。省略された場合の既定値は 0 です。
millisecond 省略可。「ミリ秒」を表す 0 から 999 までの整数値。省略された場合の既定値は 0 です。
返り値

数値。

解説/mdn

UTC() はカンマ区切りの日時の引数を取り、協定世界時での 1970 年 1 月 1 日 0 時 0 分 0 秒から指定した日時までの経過時間を表すミリ秒単位の数値を返します。

0 から 99 までの年は、20 世紀の年(1900 + year)に変換されます。例えば、95 は 1995 年に変換されます。

この UTC() メソッドは Date コンストラクターと 2 つの点で異なります。

引数が日時に期待される範囲を超えている場合、UTC() メソッドは指定した値を受け入れるよう他の引数を更新します。例えば 15 が month に使用された場合、年が 1 つ増加し(year + 1)、月には 3 が使われます。

UTC は Date の静的メソッドなので、生成した Date オブジェクトのメソッドとしてではなく、常に Date.UTC() のように使用してください。

Date.UTC の使用

以下の文では、地方時の代わりに UTC を用いて Date オブジェクトを生成します。

let utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0)); //=[object]:Sat Dec 01 2018 09:00:00 GMT+0900 (日本標準時)

テスト