Date.prototype.getUTCFullYear()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
getUTCFullYear()
は Date
インスタンスのメソッドで、協定世界時に基づき、指定された日時の「年」を返します。
試してみましょう
const date1 = new Date("December 31, 1975, 23:15:30 GMT+11:00");
const date2 = new Date("December 31, 1975, 23:15:30 GMT-11:00");
console.log(date1.getUTCFullYear());
// 予想される結果: 1975
console.log(date2.getUTCFullYear());
// 予想される結果: 1976
構文
js
getUTCFullYear()
引数
なし。
返値
指定された日時の、協定世界時に基づく年を表す整数です。日時が無効な場合は NaN
を返します。
解説
getYear()
とは異なり、 getUTCFullYear()
が返す値は絶対数値です。1000 年から 9999 年の日付の場合、 getFullYear()
は 4 桁の数値(例えば 1995)を返します。 2000 年以降の年に対応していることを確認するには、この関数を使用してください。
例
getUTCFullYear() の使用
次の例は、現在の年を表す 4 桁の値を変数 year
に代入します。
js
const today = new Date();
const year = today.getUTCFullYear();
仕様書
Specification |
---|
ECMAScript® 2026 Language Specification # sec-date.prototype.getutcfullyear |