Date.prototype.setFullYear()

Date 实例的 setFullYear() 方法根据当地时间更改此日期的年、月和/或月日。

¥The setFullYear() method of Date instances changes the year, month, and/or day of month for this date according to local time.

Try it

语法

¥Syntax

js
setFullYear(yearValue)
setFullYear(yearValue, monthValue)
setFullYear(yearValue, monthValue, dateValue)

参数

¥Parameters

yearValue

代表年份的整数。例如,1995 年。

monthValue Optional

代表月份的整数:0 代表一月,1 代表二月,依此类推。

dateValue Optional

1 到 31 之间的整数,表示月份中的第几天。如果指定 dateValue,则还必须指定 monthValue

返回值

¥Return value

就地更改 Date 对象,并返回其新的 timestamp。如果参数为 NaN(或获取 coercedNaN 的其他值,例如 undefined),则日期设置为 失效日期,并返回 NaN

¥Changes the Date object in place, and returns its new timestamp. If a parameter is NaN (or other values that get coerced to NaN, such as undefined), the date is set to Invalid Date and NaN is returned.

描述

¥Description

如果不指定 monthValuedateValue 参数,则使用与 getMonth()getDate() 返回的值相同的值。

¥If you do not specify the monthValue and dateValue parameters, the same values as what are returned by getMonth() and getDate() are used.

如果你指定的参数超出预期范围,则 Date 对象中的其他参数和日期信息将相应更新。例如,如果为 monthValue 指定 15,则年份将增加 1 (yearValue + 1),月份将使用 3。

¥If a parameter you specify is outside of the expected range, other parameters and the date information in the Date object are updated accordingly. For example, if you specify 15 for monthValue, the year is incremented by 1 (yearValue + 1), and 3 is used for the month.

示例

¥Examples

使用 setFullYear()

¥Using setFullYear()

js
const theBigDay = new Date();
theBigDay.setFullYear(1997);

规范

Specification
ECMAScript Language Specification
# sec-date.prototype.setfullyear

¥Specifications

浏览器兼容性

BCD tables only load in the browser

¥Browser compatibility

也可以看看