.setFullYear()

setFullYear()メソッドは、指定された日付のローカルタイムに沿って、年(西暦の全桁)を設定します。

文法

dateObj.setFullYear(yearValue[, monthValue[, dayValue]])
引数 説明
yearValue 例えば1995のような、年を整数で指定します。
monthValue 1月から12月を表す、0~11の月の整数を指定します。
dayValue 1~31の月の日を表す整数を指定します。 もしdayValueパラメーターを指定した場合は、monthValueも指定しなければいけません。

説明

もしmonthValuedayValueのパラメーターを指定しなかった場合、 値はgetMonthと、 getDateを使用した戻り値になります。

もし、指定された値が期待される値の範囲外であった場合、 setFullYearはそれに沿って、Dateオブジェクトの他のパラメーターと日付情報の更新を試みます。 例えば、もしmonthValueに15を指定した場合、 年は1増加(year + 1)され、月には3が使用されます。

setFullYearの使用例

var theBigDay = new Date();
theBigDay.setFullYear(1997);

仕様

ブラウザ互換性

デスクトップ
機能 Chrome Firefox
(Gecko)
IE Opera Safari
基本
モバイル
機能 Android Chrome for
Android
Firefox
Mobile
IE
Mobile
Opera
Mobile
Safari
Mobile
基本

関連項目

 Back to top

© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。

  • 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
  • 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
  • MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
  • "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。