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
语法
参数
¥Parameters
yearValue
-
代表年份的整数。例如,1995 年。
monthValue
Optional-
代表月份的整数:0 代表一月,1 代表二月,依此类推。
dateValue
Optional-
1 到 31 之间的整数,表示月份中的第几天。如果指定
dateValue
,则还必须指定monthValue
。
返回值
¥Return value
就地更改 Date
对象,并返回其新的 timestamp。如果参数为 NaN
(或获取 coerced 到 NaN
的其他值,例如 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
如果不指定 monthValue
和 dateValue
参数,则使用与 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.
示例
使用 setFullYear()
规范
Specification |
---|
ECMAScript Language Specification # sec-date.prototype.setfullyear |
浏览器兼容性
BCD tables only load in the browser