date-fns 月助手函数

addMonths

描述

在给定日期上添加指定月数。

参数

字段	类型	描述
date	Date或Number	给定日期
amount	Number	月数

返回

类型	描述
Date	添加月数后的新日期

案例

const result = addMonths(new Date(2014, 8, 1), 5)
// => Sun Feb 01 2015 00:00:00

differenceInCalendarMonths

描述

获取给定日期之间的日历月数。

参数

字段	类型	描述
dateLeft	Date或Number	较晚的日期
dateRight	Date或Number	较早的日期

返回

类型	描述
Number	日历月数

案例

const result = differenceInCalendarMonths(new Date(2014, 8, 1), new Date(2014, 0, 31))
// => 8

differenceInMonths

描述

获取给定日期之间的完整月份数。

参数

字段	类型	描述
dateLeft	Date或Number	较晚的日期
dateRight	Date或Number	较早的日期

返回

类型	描述
Number	月数

案例

const result = differenceInMonths(new Date(2014, 8, 1), new Date(2014, 0, 31))
// => 7

eachWeekendOfMonth

描述

列出给定月份的所有周六和周日。

参数

字段	类型	描述
date	Date或Number	给定月份

返回

类型	描述
Date[]	包含所有周六和周日的数组

案例

 const result = eachWeekendOfMonth(new Date(2022, 1, 1))
// => [
//   Sat Feb 05 2022 00:00:00,
//   Sun Feb 06 2022 00:00:00,
//   Sat Feb 12 2022 00:00:00,
//   Sun Feb 13 2022 00:00:00,
//   Sat Feb 19 2022 00:00:00,
//   Sun Feb 20 2022 00:00:00,
//   Sat Feb 26 2022 00:00:00,
//   Sun Feb 27 2022 00:00:00
// ]

endOfMonth

描述

返回给定日期的所属月的最后时间。

参数

字段	类型	描述
date	Date或Number	给定日期

返回

类型	描述
Date	月的最后时间

案例

const result = endOfMonth(new Date(2014, 8, 2, 11, 55, 0))
// => Tue Sep 30 2014 23:59:59.999