Date.prototype.setUTCFullYear()

setUTCFullYear() メソッドは、協定世界時に基づき、指定された日付の年を設定します。

構文

dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])

引数

yearValue
「年」の数字を指定する整数値。例えば、1995。
monthValue
任意。1 月から 12 月を表す 0 から 11 までの間の整数値。
dayValue
任意。「日」を表す 1 から 31 までの間の整数値。dayValue 引数を指定した場合、monthValue も指定しなければなりません。

返値

協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。

解説

monthValue 引数と dayValue 引数を指定しない場合、getUTCMonth() メソッドと getUTCDate() メソッドから返される値が使われます。

指定した値が期待される日付の範囲外の場合、それに応じて setUTCFullYear() が他の引数と Date オブジェクトの日付情報の更新を試みます。例えば、monthValue に 15 を指定した場合、年に 1 が加算 (yearValue + 1) され、月が 3 になります。

setUTCFullYear() の使用

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

仕様書

仕様書
ECMAScript (ECMA-262)
Date.prototype.setUTCFullYear の定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
setUTCFullYearChrome 完全対応 1Edge 完全対応 12Firefox 完全対応 1IE 完全対応 4Opera 完全対応 4Safari 完全対応 1WebView Android 完全対応 1Chrome Android 完全対応 18Firefox Android 完全対応 4Opera Android 完全対応 10.1Safari iOS 完全対応 1Samsung Internet Android 完全対応 1.0nodejs 完全対応 0.1.100

凡例

完全対応  
完全対応

関連情報