JavaScript setUTCFullYear() 方法

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

语法

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

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

返回值

设置后的 Date 对象。

示例

设置年份

const date = new Date();
console.log(date.toUTCString()); // 输出当前日期时间

date.setUTCFullYear(2022);
console.log(date.toUTCString()); // 输出设置年份后的日期时间

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

设置年份和月份

const date = new Date();
console.log(date.toUTCString()); // 输出当前日期时间

date.setUTCFullYear(2022, 11); // 11 表示 12 月
console.log(date.toUTCString()); // 输出设置年份和月份后的日期时间

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

设置年份、月份和日期

const date = new Date();
console.log(date.toUTCString()); // 输出当前日期时间

date.setUTCFullYear(2022, 11, 25);
console.log(date.toUTCString()); // 输出设置年份、月份和日期后的日期时间

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

注意事项

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

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