JavaScript Date setUTCFullYear() メソッド

定義と使用法

setUTCFullYear() 方法はUTC時間に基づいて、日付オブジェクトの年を設定します（1000年から9999年までの4桁の数字）。

ヒント：協定世界時（UTC）は世界標準時間で設定されています。

注記：UTC時間はGMT（グリニッジ標準時）と同じです。

例

例1

年を1992年に設定します：

var d = new Date();
d.setUTCFullYear(1992);

自分で試してみてください

例2

日付を2020年11月3日に設定します：

var d = new Date();
d.setUTCFullYear(2020, 10, 3);

自分で試してみてください

例3

日付を6ヶ月前のUTC時間に設定します：

var d = new Date();
d.setUTCFullYear(d.getUTCFullYear(), d.getUTCMonth() - 6);

自分で試してみてください

文法

Date.setUTCFullYear(year, month, day)

パラメータの値

パラメータ 説明
year 必須。年を表す値、負の値も許可されます。
month

オプション。月を表す整数です。

期待値は0-11ですが、他の値も許可されています：

  • -1は前年の最終月になります
  • 12は来年の1月になります
  • 13は来年の2月になります
day

必須。整数で、1ヶ月の特定の日を表します。

期待値は1-31ですが、他の値も許可されています：

  • 0は前の月の最終日になります
  • -1は前の月の最終日の一日前になります

1ヶ月が31日の場合：

  • 32は次の月の1日になります

1ヶ月が30日の場合：

  • 32は次の月の2日になります

技術的詳細

返り値： 数値、日付オブジェクトと1970年1月1日午前0時のミリ秒数の差。
JavaScript バージョン： ECMAScript 1

ブラウザのサポート

方法 Chrome IE Firefox Safari Opera
setUTCFullYear() サポート サポート サポート サポート サポート

関連ページ

チュートリアル：JavaScript 日期

チュートリアル：JavaScript 日期フォーマット

チュートリアル：JavaScript 日期設定メソッド