在前端开发中，我们常常需要用到日期相关的操作，包括但不限于格式化日期、计算日期间隔、比较日期等。对于年份的操作也同样重要，例如常见的年份加减、范围筛选等。而今天介绍的 npm 包 expand-year 就是一款用于年份操作的工具库。
安装
在终端中输入以下命令即可安装 expand-year：
npm install expand-year
功能列表
expand-year 提供了以下功能：
- 返回当前或指定年份的上一年和下一年
- 返回当前或指定年份的范围内的所有年份
- 返回指定年份到当前年份之间的所有年份
- 返回指定年份及其增量后的年份（年份加减）
API 说明
expandYear(year?)
- 参数：year（可选）：要查询的年份，默认为当前年份
- 返回值：{ prevYear, nextYear }
- 描述：返回指定年份的上一年和下一年
expandYears(yearStart, yearEnd)
- 参数：yearStart：开始年份，yearEnd：结束年份
- 返回值：数组，包含了开始年份到结束年份之间的所有年份
- 描述：返回指定年份范围内的所有年份
expandYearsSince(year)
- 参数：year：开始年份
- 返回值：数组，包含了开始年份到当前年份之间的所有年份
- 描述：返回指定年份到当前年份之间的所有年份
expandYearsUntil(year)
- 参数：year：结束年份
- 返回值：数组，包含了从指定年份到当前年份之间的所有年份
- 描述：返回从指定年份到当前年份之间的所有年份
expandYearBy(year, offset)
- 参数：year：要加减的年份，offset：年份增减幅度，可以为负数
- 返回值：增量后的年份
- 描述：返回指定年份增量后的年份
示例
下面是一些示例代码，用于介绍 expand-year 的使用方法。
返回某年的上一年和下一年
const { prevYear, nextYear } = expandYear(2021) console.log(prevYear) // 输出 2020 console.log(nextYear) // 输出 2022
返回某个年份范围内的所有年份
const years = expandYears(2000, 2020) console.log(years) // 输出 [2000, 2001, ..., 2019, 2020]
返回指定年份到当前年份之间的所有年份
const years = expandYearsSince(2010) console.log(years) // 输出 [2010, 2011, ..., 2022]
返回从指定年份到当前年份之间的所有年份
const years = expandYearsUntil(2030) console.log(years) // 输出 [..., 2021, 2022, 2023, ..., 2029, 2030]
返回指定年份增量后的年份
const year = expandYearBy(2022, 5) console.log(year) // 输出 2027
总结
expand-year 提供了一系列可以方便地操作年份的方法，可以很好地解决前端开发中的时间和年份问题。在使用中应该根据实际需求灵活运用这些方法，以提高开发效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5f2ddf4a3b0ab45f74a8bc01
