Get to know MDN better
このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
JavaScript の Date オブジェクトは、単一の瞬間の時刻をプラットフォームに依存しない形式で表します。Date オブジェクトは、1970 年 1 月 1 日午前 0 時 (UTC)（元期）からのミリ秒を表す整数値をカプセル化しています。
JavaScript の日付は基本的に、元期として定義される UTC の 1970 年 1 月 1 日午前 0 時（UNIX 元期と同じ）から経過したミリ秒単位の時刻を指定します。このタイムスタンプはタイムゾーンに依存せず、歴史の一瞬を固有のものとして定義します。
メモ: Date オブジェクトの中核となる時刻の値は UTC ですが、日時やその部品を取得する基本的なメソッドは、すべてローカル（つまりホストシステム）のタイムゾーンとオフセットで動作します。
Date オブジェクトで表現できるタイムスタンプの最大値は、安全な整数の最大値（Number.MAX_SAFE_INTEGER、9,007,199,254,740,991）よりもわずかに小さくなります。Date オブジェクトは、元期に対して最大 ±8,640,000,000,000,000 ミリ秒、つまり±100,000,000（1 億）日を表します。これは紀元前 271821 年 4 月 20 日から西暦 275760 年 9 月 13 日までの範囲です。この範囲外の時刻を表そうとすると、Date オブジェクトは NaN のタイムスタンプ値を持ち、"Invalid Date" （無効な日時）となります。
Date に格納されるタイムスタンプを操作するさまざまなメソッドがあります。
日付は内部的には単一の数値であるタイムスタンプで表されます。タイムスタンプを操作する際には、タイムスタンプを構造化された日時表現として解釈する必要があります。タイムスタンプを解釈する方法は常に 2 つあります。ローカル時刻として解釈する方法と、世界標準時を定義する協定世界時 (UTC) として解釈する方法です。ローカルタイムゾーンは Date オブジェクトには格納されず、ホスト環境（ユーザー端末）によって決定されます。
メモ: UTC をグリニッジ標準時 (GMT) と混同してはいけません。両者は常に同じではありません。これはリンク先のウィキペディアのページで詳しく説明されています。
例えば、タイムスタンプ 0 は歴史上の一意の瞬間を表しますが、2 つの方法で解釈することができます。
getTimezoneOffset() メソッドは、UTC とローカル時刻の差を分単位で返します。タイムゾーンのオフセットは、現在のタイムゾーンに依存するだけでなく、サマータイムや過去には変更があったため、Date オブジェクトが表す時刻にも依存することに注意しましょう。要するに、タイムゾーンオフセットは Date オブジェクトが表す時刻とホスト環境の場所における UTC 時刻からのオフセットです。
Date のメソッドには 2 種類あり、1 つはタイムスタンプをローカル時刻として解釈して様々な日付部品を取得したり設定したりするもの、もう 1 つは UTC を使用するものです。
Date() コンストラクターは 2 つ以上の引数を指定して呼び出すことができ、その場合はそれぞれローカル時刻年、月、日、時、分、秒、ミリ秒として解釈されます。Date.UTC() も同様に動作しますが、こちらは成分を UTC 時刻として解釈し、年を表す単一の引数も受け入れます。
メモ: Date() コンストラクターや Date.UTC()、そして非推奨の getYear()/setYear() メソッドなど、一部のメソッドは 2 桁の年を 1900 年代の年として解釈します。例えば、new Date(99, 5, 24) は 1999 年 6 月 24 日と解釈され、99 年 6 月 24 日とは解釈されません。 詳細は 2 桁の年の解釈 を参照ください。
ある部分が指定範囲を超えたり、下回ったりした場合、通常、その部分は上位の部分に「繰り上げ」されるか、「繰り下げ」されます。例えば、月を 12 に設定すると（月はゼロ基点なので、12 月は 11）、翌年の 1 月になります。日を 0 に設定すると、前月の最終日になります。これは日時文字列形式で指定した日付にも適用されます。
文字列として日付を書式化する方法はたくさんあります。JavaScript 仕様書では、普遍的に対応している書式を 1 つだけ指定しています。ISO 8601 カレンダー日付拡張書式を簡略化した日付時刻文字列書式です。書式は以下の通りです。
YYYY-MM-DDTHH:mm:ss.sssZさまざまな成分を省略できますので、以下のものはすべて有効です。
例えば、"2011-10-10"（日付のみの形式）、"2011-10-10T14:48:00"（日時形式）、"2011-10-10T14:48:00.000+09:00"（日時形式にミリ秒とタイムゾーンが付いたもの）はすべて有効な日時文字列です。
タイムゾーンオフセットがない場合、日付のみの形式は UTC 時刻として解釈され、日時形式はローカル時刻として解釈されます。 UTC 時刻として解釈するのは、過去には ISO 8601 に適合しない仕様があったためですが、ウェブの互換性のために変更できませんでした。Broken Parser - A Web Reality Issue を参照してください。
Date.parse() および Date() コンストラクターは、どちらも日時文字列形式の文字列を入力として受け入れます。さらに、入力がこの形式に一致しない場合、実装が他の日付形式にも対応することが許されています。
toISOString() メソッドは、タイムゾーンのオフセットを常に Z (UTC) に設定した状態で、日付の文字列表現を日時文字列形式で返します。
メモ: 他の書式への対応は保証されていませんので、互換性を最大にするために、入力は上記の日時文字列の書式に準拠するようにしてください。しかし、RFC 2822 形式のように、主要な実装ですべて対応している書式もあります。常にブラウザー横断テストを行い、対象とするブラウザーすべてで確実にコードが動作するようにしてください。様々な書式化に対応するには、ライブラリーが役立ちます。
標準外の文字列は、タイムゾーンを含め、実装が望む方法で構文解析できます。ほとんどの実装では既定でローカルのタイムゾーンを使用します。実装は、境界外の日付部品に対して不正な日付を返すことを要求されませんが、通常はそうします。文字列は(上で定義されていません)境界内の日付要素を持つことができますが、実際には日付を表していません(例えば、"2月30日")。この場合、実装上の不整合が発生します。Date.parse() のページでは、このような非標準の例について詳しく説明しています。
例についてはtoString メソッドの返値の形式の節を参照してください。
コンストラクターとして呼び出された場合、新しい Date オブジェクトを返します。関数として呼び出された場合、現在の日付と時刻の文字列表現を返します。
現在の時刻に対応する数値、すなわち UTC の 1970 年 1 月 1 日 00:00:00 からのミリ秒数を表す数値を返します。うるう秒は無視します。
Date.parse()日付を表す文字列を解釈して、UTC の 1970 年 1 月 1 日 00:00:00 からのミリ秒数を表す数値を返します。うるう秒は無視します。
Date.UTC()最も長い形式のコンストラクターと同じ引数（すなわち 2 〜 7）を受け取り、 1970 年 1 月 1 日 00:00:00 （UTC）からのミリ秒数を返します。うるう秒は無視します。
これらのプロパティは Date.prototype で定義されており、すべての Date インスタンスで共有されます。
Date.prototype.constructorこのインスタンスオブジェクトを作成したコンストラクター関数。Date インスタンスの場合、初期値は Date コンストラクターです。
地方時に基づき、指定された日時の「日」 (1 ～ 31) を返します。
Date.prototype.getDay()地方時に基づき、指定された日時の「曜日」 (0 ～ 6) を返します。
Date.prototype.getFullYear()地方時に基づき、指定された日時の「年」 (4 桁の年であれば 4 桁) を返します。
Date.prototype.getHours()地方時に基づき、指定された日時の「時」 (0 ～ 23) を返します。
Date.prototype.getMilliseconds()地方時に基づき、指定された日時の「ミリ秒」 (0 ～ 999) を返します。
Date.prototype.getMinutes()地方時に基づき、指定された日時の「分」 (0 ～ 59) を返します。
Date.prototype.getMonth()地方時に基づき、指定された日時の「月」 (0 ～ 11) を返します。
Date.prototype.getSeconds()地方時に基づき、指定された日時の「秒」 (0 ～ 59) を返します。
Date.prototype.getTime()指定された日時を協定世界時 (UTC) の 1970 年 1 月 1 日 00:00:00 からの経過ミリ秒単位の数値で返します。 (それ以前の時刻では負の数を返します。)
Date.prototype.getTimezoneOffset()現地の時間帯のオフセットを分で返します。
Date.prototype.getUTCDate()協定世界時に基づき、指定された日時の「日」 (1 ～ 31) を返します。
Date.prototype.getUTCDay()協定世界時に基づき、指定された日時の「曜日」 (0 ～ 6) を返します。
Date.prototype.getUTCFullYear()協定世界時に基づき、指定された日時の「年」 (4 桁の年であれば 4 桁) を返します。
Date.prototype.getUTCHours()協定世界時に基づき、指定された日時の「時」 (0 ～ 23) を返します。
Date.prototype.getUTCMilliseconds()協定世界時に基づき、指定された日時の「ミリ秒」 (0 ～ 999) を返します。
Date.prototype.getUTCMinutes()協定世界時に基づき、指定された日時の「分」 (0 ～ 59) を返します。
Date.prototype.getUTCMonth()協定世界時に基づき、指定された日時の「月」 (0 ～ 11) を返します。
Date.prototype.getUTCSeconds()協定世界時に基づき、指定された日時の「秒」 (0 ～ 59) を返します。
Date.prototype.getYear()地方時に基づき、指定された日時の「年」 (ふつうは 2 ～ 3 桁) を返します。代わりに getFullYear() を使用してください。
Date.prototype.setDate()地方時に基づき、指定された日時の「日」を設定します。
Date.prototype.setFullYear()地方時に基づき、指定された日時の「年」を完全な形 (例えば、 4 桁の年であれば 4 桁) で設定します。
Date.prototype.setHours()地方時に基づき、指定された日時の「時」を設定します。
Date.prototype.setMilliseconds()地方時に基づき、指定された日時の「ミリ秒」を設定します。
Date.prototype.setMinutes()地方時に基づき、指定された日時の「分」を設定します。
Date.prototype.setMonth()地方時に基づき、指定された日時の「月」を設定します。
Date.prototype.setSeconds()地方時に基づき、指定された日時の「秒」を設定します。
Date.prototype.setTime()Date オブジェクトを協定世界時 (UTC) の 1970 年 1 月 1 日 00:00:00 からのミリ秒単位の数で表された時刻に設定します。
Date.prototype.setUTCDate()協定世界時に基づき、指定された日時の「日」を設定します。
Date.prototype.setUTCFullYear()協定世界時に基づき、指定された日時の「年」を完全な形で設定します。
Date.prototype.setUTCHours()協定世界時に基づき、指定された日時の「時」を設定します。
Date.prototype.setUTCMilliseconds()協定世界時に基づき、指定された日時の「ミリ秒」を設定します。
Date.prototype.setUTCMinutes()協定世界時に基づき、指定された日時の「分」を設定します。
Date.prototype.setUTCMonth()協定世界時に基づき、指定された日時の「月」を設定します。
Date.prototype.setUTCSeconds()協定世界時に基づき、指定された日時の「秒」を設定します。
Date.prototype.setYear()協定地方時に基づき、指定された日時の「年」 (ふつうは 2 ～ 3 桁) を設定します。代わりに setFullYear() を使用してください。
Date.prototype.toDateString()Date の「日付」部を、 'Thu Apr 12 2018' のように人間が読みやすい形式の文字列にして返します。
Date.prototype.toISOString()日付を ISO 8601 Extended Format に準じた文字列に変換します。
Date.prototype.toJSON()Date を表す文字列を toISOString() を使用して返します。JSON.stringify() から暗黙に呼び出されるものです。
Date.prototype.toLocaleDateString()この日時の日付部分を、システム設定に基づいて地域性を考慮した表現による文字列にして返します。
Date.prototype.toLocaleString()日付を地域の日付書式に従った文字列に変換して返します。Object.prototype.toLocaleString() メソッドを上書きします。
Date.prototype.toLocaleTimeString()この日時の時刻部分を、システム設定に基づいて地域性を考慮した表現による文字列にして返します。
Date.prototype.toString()指定された Date オブジェクトを表す文字列を返します。 Object.prototype.toString() メソッドを上書きします。
Date.prototype.toTemporalInstant()この日時のタイムスタンプと同じ epochMilliseconds を持つ新しい Temporal.Instant オブジェクトを返します。
Date.prototype.toTimeString()Date の「時刻」部を人間が読みやすい形式の文字列にして返します。
Date.prototype.toUTCString()日時を UTC タイムゾーンを使用する文字列に変換します。
Date.prototype.valueOf()Date オブジェクトのプリミティブ値を返します。Object.prototype.valueOf() メソッドを上書きします。
Date.prototype[Symbol.toPrimitive]()Date オブジェクトをプリミティブ値に変換します。
以下の例で、 JavaScript の日時を生成するいくつかの方法を示します。
メモ: 文字列から日付を作成するには、動作に一貫性がありません。異なる書式を使用する際の注意点については日時文字列形式を参照してください。
new Date() は 2 桁の年の値に対して、古くで望ましくない一貫性のない挙動を示します。具体的には、 new Date() の呼び出しに 2 桁の年の値が与えられた場合、その年の値はリテラルの年として扱われず、そのまま使用され、代わりに相対的なオフセットとして解釈されます。ある場合には 1900 年からのオフセットとなりますが、またある場合には 2000 年からのオフセットになります。
西暦 0 年から 99 年までの間の年を生成および取得するには、setFullYear() メソッドと getFullYear() メソッドを使用してください。
以下の例で、2 つの JavaScript の日付の間で経過した時間を計る方法を示します。
日 (夏時間の切り替えによる)、月、年の長さが異なるため、経過時間を時、分、秒以上の単位で表現するには、いくつかの問題に対処する必要がありますので、事前によく調べて使用してください。
メモ: ウェブパフォーマンス API の高精度時刻機能に対応しているブラウザーでは、 Performance.now() で、 Date.now() よりも高信頼かつ高精度な経過時間の測定が可能です。
この場合、整数だけを返すことが重要です（単純な除算ではできません）。また、実際に経過した秒数を返すことも重要です（ですから、上の例では Math.round() ではなく Math.floor() を使っています）。
| ECMAScript® 2027 Language Specification # sec-date-objects |
Enable JavaScript to view this browser compatibility table.
This page was last modified on 2025年7月22日 by MDN contributors.
Your blueprint for a better internet.
Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.