JavaScript Date setFullYear() 方法

定義和用法

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

此方法也可用于設置月份和月份的日期。

實例

例子 1

將年份設置為 2020：

var d = new Date();
d.setFullYear(2020);

親自試一試

例子 2

實例

將日期設置為 2020 年 11 月 3 日：

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

親自試一試

例子 3

將日期設置為六個月前：

var d = new Date();
d.setFullYear(d.getFullYear(), d.getMonth() - 6);

親自試一試

語法

Date.setFullYear(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
setFullYear() 支持 支持 支持 支持 支持

相關頁面

教程：JavaScript 日期

教程：JavaScript 日期格式

教程：JavaScript 日期設置方法