Date.UTC()

Date.UTC() メソッドは、コンストラクタと同じ最も長い書式の引数を受け入れ、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 からの経過時間を表す Date オブジェクトのミリ秒単位の数値を返します。

構文

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

引数

year
1900 年以降の「年」
month
「月」を表す 0 (1 月) から 11 (12 月) までの整数値。
day
任意。「日」を表す 1 から 31 までの整数値。
hour
任意。「時」を表す 0 から 23 までの整数値。
minute
任意。「分」を表す 0 から 59 までの整数値。
second
任意。「秒」を表す 0 から 59 までの整数値。
millisecond
任意。「ミリ秒」を表す 0 から 999 までの整数値。

戻り値

協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から与えた Date オブジェクトまでの経過時間を表すミリ秒単位の数値を返します。

説明

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

year には完全な年、例えば 1998 と指定すべきです。0 から 99 までの年が指定された場合、このメソッドはその年を 20 世紀の年 (1900 + year) に変換します。例えば、95 を指定すると 1995 年が使われます。

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

  • Date.UTC は地方時ではなく、協定世界時を用います。
  • Date.UTC は Date オブジェクトを作らず、時間値を整数で返します。

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

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

例

Date.UTC の使用

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

var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));

仕様

仕様書 策定状況 備考
ECMAScript Latest Draft (ECMA-262)
Date.UTC の定義		 ドラフト  
ECMAScript 2015 (6th Edition, ECMA-262)
Date.UTC の定義		 標準  
ECMAScript 5.1 (ECMA-262)
Date.UTC の定義		 標準  
ECMAScript 1st Edition (ECMA-262) 標準 初期定義。JavaScript 1.0 で実装。

ブラウザの実装状況

現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから！
機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) (有) (有) (有) (有)
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート ? ? ? ? ? ?

互換性に関する備考

 

引数が 2 つ以下の Date.UTC の挙動

Date.UTC の引数が 2 つ以下の場合、NaN が戻り値として返ってきます。この動作は ECMAScript 2017 の中で規定されています。この動作をサポートしていなかったエンジンも既に対応済みです。  (バグ 1050755, ecma-262 #642)

 

関連情報

関連トピック
  1. Standard built-in objects
  2. Date
  3. プロパティ
    1. Date.prototype
  4. メソッド
    1. Date.UTC()
    2. Date.now()
    3. Date.parse()
    4. Date.prototype.getDate()
    5. Date.prototype.getDay()
    6. Date.prototype.getFullYear()
    7. Date.prototype.getHours()
    8. Date.prototype.getMilliseconds()
    9. Date.prototype.getMinutes()
    10. Date.prototype.getMonth()
    11. Date.prototype.getSeconds()
    12. Date.prototype.getTime()
    13. Date.prototype.getTimezoneOffset()
    14. Date.prototype.getUTCDate()
    15. Date.prototype.getUTCDay()
    16. Date.prototype.getUTCFullYear()
    17. Date.prototype.getUTCHours()
    18. Date.prototype.getUTCMilliseconds()
    19. Date.prototype.getUTCMinutes()
    20. Date.prototype.getUTCMonth()
    21. Date.prototype.getUTCSeconds()
    22. Date.prototype.getYear()
    23. Date.prototype.setDate()
    24. Date.prototype.setFullYear()
    25. Date.prototype.setHours()
    26. Date.prototype.setMilliseconds()
    27. Date.prototype.setMinutes()
    28. Date.prototype.setMonth()
    29. Date.prototype.setSeconds()
    30. Date.prototype.setTime()
    31. Date.prototype.setUTCDate()
    32. Date.prototype.setUTCFullYear()
    33. Date.prototype.setUTCHours()
    34. Date.prototype.setUTCMilliseconds()
    35. Date.prototype.setUTCMinutes()
    36. Date.prototype.setUTCMonth()
    37. Date.prototype.setUTCSeconds()
    38. Date.prototype.setYear()
    39. Date.prototype.toDateString()
    40. Date.prototype.toGMTString()
    41. Date.prototype.toISOString()
    42. Date.prototype.toJSON()
    43. Date.prototype.toLocaleDateString()
    44. Date.prototype.toLocaleFormat()
    45. Date.prototype.toLocaleString()
    46. Date.prototype.toLocaleTimeString()
    47. Date.prototype.toSource()
    48. Date.prototype.toString()
    49. Date.prototype.toTimeString()
    50. Date.prototype.toUTCString()
    51. Date.prototype.valueOf()
    52. Date.prototype[@@toPrimitive]
  5. 継承
  6. Function
  7. プロパティ
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.prototype
    7. Function.name
  8. メソッド
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. プロパティ
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__
    3. Object.prototype.__parent__
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. メソッド
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()