JavaScript 参考手册 目录

JavaScript setUTCFullYear() 方法

在 JavaScript 中,setUTCFullYear() 方法用于设置 Date 对象的年份,以协调世界时(UTC)为准。该方法可以帮助我们在处理日期和时间时更精确地控制年份部分。

语法

setUTCFullYear(yearValue[, monthValue[, dayValue]])

  • yearValue: 必需。一个四位数的年份值。
  • monthValue: 可选。一个从 0 到 11 的整数,表示月份。如果省略,则月份保持不变。
  • dayValue: 可选。一个从 1 到 31 的整数,表示日期。如果省略,则日期保持不变。

返回值

设置后的 Date 对象。

示例

设置年份

----- ---- - --- -------
-------------------------------- -- --------

--------------------------
-------------------------------- -- ------------

在上面的示例中,我们首先创建了一个 Date 对象 date,然后使用 setUTCFullYear() 方法将年份设置为 2022 年。最后打印出设置年份后的日期时间。

设置年份和月份

----- ---- - --- -------
-------------------------------- -- --------

------------------------- ---- -- -- -- -- -
-------------------------------- -- ---------------

在这个示例中,我们除了设置了年份为 2022 年外,还设置了月份为 12 月。注意,月份是从 0 开始计数的,所以 11 表示 12 月。

设置年份、月份和日期

----- ---- - --- -------
-------------------------------- -- --------

------------------------- --- ----
-------------------------------- -- ------------------

在这个示例中,我们设置了年份为 2022 年,月份为 12 月,日期为 25 日。最后打印出设置年份、月份和日期后的日期时间。

注意事项

  • setUTCFullYear() 方法会改变原始的 Date 对象,而不是创建一个新的对象。
  • 如果设置的日期超出了合法范围,会自动调整为合法日期。

通过 setUTCFullYear() 方法,我们可以方便地在 JavaScript 中设置 Date 对象的年份,并根据需要调整月份和日期,从而更灵活地处理日期和时间相关的操作。


下一篇:概览