Date.UTC()
Date.UTC()メソッドは、コンストラクタと同じ長い形式のパラメーターを受け取り、ユニバーサル時間のJanuary 1, 1970, 00:00:00 (1970年1月1日 0時0分0秒)からのDateオブジェクトのミリ秒の数値を返します。
文法
Date.UTC(year,month[,date[,hrs[,min[,sec[,ms]]]]])
引数 | 説明 |
---|---|
year | 1900年からの経過年数を指定します。 |
month | 月を表す0~11の数値を指定します。 |
date | 月内の日を表す1~31の数値を指定します。 |
hrs | 時間を表す0~23の数値を指定します。 |
min | 分を表す0~59の数値を指定します。 |
sec | 秒を表す0~59の数値を指定します。 |
ms | ミリ秒を表す0~999の数値を指定します。 |
説明
UTCはカンマ区切りの日付パラメーターを受け取り、
January 1, 1970, 00:00:00
(1970年1月1日 0時0分0秒)のユニバーサルタイムと、指定した時間の間のミリ秒の数値を返します。
例えば、1998のような完全な形式の年を指定すべきです。 もし、0~99の数値を指定すると、例えば95が指定されると1995として扱うといったように、 メソッドは年を20世紀(1900 + year)の年に変換します。
UTC
メソッドは、2つのことでDate
コンストラクタと異なります。
-
Date.UTC
は、ローカルタイムの代わりにユニバーサルタイムを使用します。 -
Date.UTC
は、作成したDate
オブジェクトの代わりに数値として時間の値を返します。
もし期待される範囲外のパラメーターが指定されると、 UTCメソッドはその数値に沿って他のパラメーターを更新します。 例えば、もし月に対して15を指定したとすると、年が1つ増加し(year + 1)、 月には3が使用されます。
UTCはDate
の静的メソッドのため、作成したDateオブジェクトのメソッドとしてではなく、
Date.UTC()
として常に使用することが可能です。
例
例: Date.UTCの使用
下記の文はローカルタイムの代わりにUTCを使用して、Dateオブジェクトを作成しています。
var utcDate = new Date(Date.UTC(96, 11, 1, 0, 0, 0));
仕様
ブラウザ互換性
機能 | Chrome | Firefox (Gecko) |
IE | Opera | Safari |
---|---|---|---|---|---|
基本 | ◯ | ◯ | ◯ | ◯ | ◯ |
機能 | Android | Firefox Mobile |
IE Mobile |
Opera Mobile |
Safari Mobile |
---|---|---|---|---|---|
基本 | ? | ? | ? | ? | ? |
関連項目
© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。
- 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
- 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
- MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
- "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。