JavaScript Date.setFullYear 方法：設定本地時間年份值

語法

dateObj.setFullYear(numYear[, numMonth[, numDate]])

參數

• dateObj：必選，Date 物件。
• numYear：必選，年份（四位數，如 2024）。
• numMonth：可選，月份（0~11），若提供 numDate 則必填。
• numDate：可選，日期（1~31）。

行為

• 省略選填參數時採用對應 get 當前值。
• 值超出範圍自動調整（如月份 12 → 翌年）。
• 設定 UTC 年份請用 setUTCFullYear()。
• 支援範圍：約 1970 年前後各 285,616 年。

範例

function SetFullYearDemo(newyear) {
    var d = new Date();
    d.setFullYear(newyear);
    return "Current setting is " + d.toLocaleString();
}