Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

Date.prototype.getYear()

非推奨
この機能は Web 標準から削除されました。まだサポートしているプラウザがあるかもしれませんが、ゆくゆくはなくなるものです。新旧にかかわらず、プロジェクトでの使用をやめてください。この機能を使用するページ、Web アプリはいつ動かなくなってもおかしくありません。

getYear() メソッドは、地方時に基づき、指定された日付の「年」を返します。getYear() は完全な桁数の値を返さないため (いわゆる 2000 年問題)、使用されなくなり、getFullYear() メソッドに置き換えられました。

構文

dateObj.getYear()

戻り値

地方時に基づき、与えられた日付の「年」を表す数値 - 1900 を返します。

説明

  • 2000 年以降の年について、getYear() が返す値は 100 以上です。例えば、2026 年の場合、getYear() は 126 を返します。
  • 1900 年から 1999 年について、getYear() が返す値は 0 から 99 の間です。例えば、1976 年の場合、getYear() は 76 を返します。
  • 1900 年以前の年について、getYear() が返す値は 0 未満です。例えば、1800 年の場合、getYear() は -100 を返します。

2000 年以前と以降に対処するため、getYear() の代わりに、完全な桁数の値を返す getFullYear() を使用するべきです。

後方互換性

JavaScript 1.2 以前の動作

getYear() メソッドは、2 桁または 4 桁の年を返します:

  • 1900 年から 1999 年の間の場合、getYear() が返す値は year - 1900 です。例えば 1976 年の場合、戻り値は 76 です。
  • 1900 年より前または 1999 年より後の場合、getYear() が返す値は 4 桁の年です。例えば、1856 年の場合、戻り値は 1856 です。2026 年の場合、戻り値は 2026 です。

1900 年から 1999 年の間の年

2 行目の文は、変数 year に 95 を代入します。

var Xmas = new Date('December 25, 1995 23:15:00');
var year = Xmas.getYear(); // 95 を返す

1999 年より後の年

2 行目の文は、変数 year に 100 を代入します。

var Xmas = new Date('December 25, 2000 23:15:00');
var year = Xmas.getYear(); // 100 を返す

1900 年より前の年

2 行目の文は、変数 year に -100 を代入します。

var Xmas = new Date('December 25, 1800 23:15:00');
var year = Xmas.getYear(); // -100 を返す

1900 年から 1999 年の間の年の設定または取得

3 行目の文は、変数 year に 1995 年を表す 95 を代入します。

var Xmas = new Date('December 25, 2015 23:15:00');
Xmas.setYear(95);
var year = Xmas.getYear(); // 95 を返す

仕様

仕様書 策定状況 備考
ECMAScript 1st Edition (ECMA-262) 標準 初期定義。JavaScript 1.3 で実装。
ECMAScript 5.1 (ECMA-262)
Date.prototype.getYear の定義
標準 Defined in the (informative) compatibility annex.
ECMAScript 2015 (6th Edition, ECMA-262)
Date.prototype.getYear の定義
標準 Defined in the (normative) annex for additional features for web browsers.
ECMAScript 2017 Draft (ECMA-262)
Date.prototype.getYear の定義
ドラフト

ブラウザの実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) (有) (有) (有) (有)
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) (有) (有) (有) (有) (有)

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: Marsf, teoli, ethertank
 最終更新者: Marsf,