JavaScript Date setUTCFullYear() 方法

定義和用法

setUTCFullYear() 方法根據 UTC 時間設置日期對象的年份（1000 年到 9999 年之間的四位數字）。

提示：世界協調時間 (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

將日期設置為六個月前，UTC 時間：

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

親自試一試

語法

Date.setUTCFullYear(year, month, day)

參數值

參數 描述
year 必需的。表示年份的值，允許負值。
month

可選。表示月份的整數。

預期值為 0-11，但允許其他值：

  • -1 將導致上一年的最后一個月
  • 12 將導致明年的第一個月
  • 13 將導致明年的第二個月
day

必需。整數，表示一個月中的某一天。

預期值為 1-31，但允許其他值：

  • 0 將導致上個月的最后一天
  • -1 將導致上個月的最后一天的前一天

如果一個月有 31 天：

  • 32 將導致下個月的第一天

如果一個月有 30 天：

  • 32 將導致下個月的第二天

技術細節

返回值： 數值，日期對象與 1970 年 1 月 1 日午夜之間的毫秒數。
JavaScript 版本： ECMAScript 1

瀏覽器支持

方法 Chrome IE Firefox Safari Opera
setUTCFullYear() 支持 支持 支持 支持 支持

相關頁面

教程：JavaScript 日期

教程：JavaScript 日期格式

教程：JavaScript 日期設置方法