Node.js 日期.addYears() API

在 Node.js 中， Date 对象有一个 addYears() API，可以方便地对日期进行加减操作。在这篇文档中，我们将介绍如何使用 addYears() API，以及一些常见用例。

语法

dateObject.addYears(years)

参数

years：数字类型，表示要添加的年数。可为正数或负数。

返回值

添加指定年数后的 Date 对象。

示例

1. 添加一年

const date = new Date('2021-01-01');
const nextYear = date.addYears(1); // 添加一年
console.log(nextYear); // 输出：Fri Dec 31 2021 00:00:00 GMT+0800 (中国标准时间)

2. 减少一年

const date = new Date('2021-01-01');
const lastYear = date.addYears(-1); // 减少一年
console.log(lastYear); // 输出：Wed Dec 31 2020 00:00:00 GMT+0800 (中国标准时间)

3. 添加多年

const date = new Date('2021-01-01');
const fiveYearsLater = date.addYears(5); // 添加五年
console.log(fiveYearsLater); // 输出：Mon Dec 31 2026 00:00:00 GMT+0800 (中国标准时间)

注意事项

1. 虽然 addYears() API 的名称中包含了 Years，但它实际上是根据年份的差值来进行加减的，因此如果要对日期进行月份、天数等的加减操作，需要使用其他相应的 API。
2. addYears() API 改变的是 Date 对象本身，而非返回一个新的对象。

以上就是关于 Node.js 日期.addYears() API 的介绍。希望这篇文档能帮助到你在使用 Date 对象时更加方便快捷地进行日期操作。