猿创征文｜date-fns 天助手函数

date-fns 天助手函数

addBusinessDays

描述

在给定日期上添加指定工作日数(mon-fri)。

参数

字段	类型	描述
date	Date或Number	要更改的日期
amount	Number	要添加的工作日数

返回

类型	描述
Date	添加了工作日的新日期

案例

const result = addBusinessDays(new Date(2014, 8, 1), 10)
// => Mon Sep 15 2014 00:00:00 (skipped weekend days)

addDays

描述

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

参数

字段	类型	描述
date	Date或Number	要更改的日期
amount	Number	要添加的天数

返回

类型	描述
Date	添加了天数的新日期

案例

const result = addDays(new Date(2014, 8, 1), 10)
// => Thu Sep 11 2014 00:00:00

differenceInBusinessDays

描述

获取给定日期之间的工作日数。

参数

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

返回

类型	描述
Number	工作日数

案例

const result = differenceInBusinessDays(
    new Date(2014, 6, 20),
    new Date(2014, 0, 10)
)
// => 136


const result = differenceInBusinessDays(
    new Date(2021, 10, 30),
    new Date(2021, 10, 1)
)
// => 21

const result = differenceInBusinessDays(
    new Date(2021, 10, 1),
    new Date(2021, 11, 1)
)
// => -22

const result = differenceInBusinessDays(
    new Date(2021, 10, 1),
    new Date(2021, 10, 1)
)
// => 0

differenceInCalendarDays

描述

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

参数

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

返回

类型	描述
Number	日历天数

案例

const result = differenceInCalendarDays(
    new Date(2012, 6, 2, 0, 0),
    new Date(2011, 6, 2, 23, 0)
)
// => 366
const result = differenceInCalendarDays(
    new Date(2011, 6, 3, 0, 1),
    new Date(2011, 6, 2, 23, 59)
)
// => 1

differenceInDays

描述

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

参数

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

返回

类型	描述
Number	完整天数

案例

const result = differenceInDays(
    new Date(2012, 6, 2, 0, 0),
    new Date(2011, 6, 2, 23, 0)
)
// => 365

const result = differenceInDays(
    new Date(2011, 6, 3, 0, 1),
    new Date(2011, 6, 2, 23, 59)
)
// => 0

const result = differenceInDays(
    new Date(2020, 5, 1),
    new Date(2020, 2, 1)
)
// => 92

endOfDay

描述

返回给定日期当天的结束时间。

参数

字段	类型	描述
date	Date或Number	原始日期

返回

类型	描述
Date	当天的结束时间

案例

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

endOfToday

描述

返回今天的结束时间。

返回

类型	描述
Date	今天的结束时间

案例

 const result = endOfToday()
// => Mon Oct 6 2014 23:59:59.999

endOfTomorrow

描述

返回明天的结束时间。

返回

类型	描述
Date	明天的结束时间

案例

const result = endOfYesterday()
// => Sun Oct 5 2014 23:59:59.999

endOfYesterday

描述

返回昨天的结束时间。

返回

类型	描述
Date	昨天的结束时间

案例

const result = endOfYesterday()
// => Sun Oct 5 2014 23:59:59.999

getDate

描述

获取给定日期是当月的第几天。

参数

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

返回

类型	描述
Number	当月的第几天

案例

 const result = getDate(new Date(2012, 1, 29))
// => 29

getDayOfYear

描述

获取给定日期是当年的第几天。

参数

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

返回

类型	描述
Number	当年中的第几天

案例

const result = getDayOfYear(new Date(2014, 6, 2))
// => 183

isFriday

描述

给定日期是否是星期五？

参数

字段	类型	描述
date	Date或Number	要检查的日期

返回

类型	描述
Boolean	日期是否为星期五

案例

const result = isFriday(new Date(2014, 8, 26))
// => true

isSameDay

描述

给定日期是否是同一天？

参数

字段	类型	描述
dateLeft	Date或Number	要检查的第一个日期
dateRight	Date或Number	要检查的第二个日期

返回

类型	描述
Boolean	是否在同一天

案例

const result = isSameDay(new Date(2014, 8, 4, 6, 0), new Date(2014, 8, 4, 18, 0))
// => true

const result = isSameDay(new Date(2014, 8, 4), new Date(2014, 9, 4))
// => false

const result = isSameDay(new Date(2014, 8, 4), new Date(2015, 8, 4))
// => false

isToday

描述

给定日期是否是今天？

参数

字段	类型	描述
date	Date或Number	要检查的日期

返回

类型	描述
Boolean	是否是今天

案例

const result = isToday(new Date(2014, 9, 6, 14, 0))
// => true

isTomorrow

描述

给定日期是否是明天？

参数

字段	类型	描述
date	Date或Number	要检查的日期

返回

类型	描述
Boolean	是否是明天

案例

const result = isTomorrow(new Date(2014, 9, 6, 14, 0))
// => true

isYesterday

描述

给定日期是否是昨天？

参数

字段	类型	描述
date	Date或Number	要检查的日期

返回

类型	描述
Boolean	是否是昨天

案例

const result = isYesterday(new Date(2014, 9, 6, 14, 0))
// => true

setDate

描述

将给定日期设置为当月的第几天。

参数

字段	类型	描述
date	Date或Number	要更改的日期
dayOfMonth	Number	当月的第几天

返回

类型	描述
Date	新日期

案例

const result = setDate(new Date(2014, 8, 1), 30)
// => Tue Sep 30 2014 00:00:00

setDayOfYear

描述

将给定日期设置为当年的第几天。

参数

字段	类型	描述
date	Date或Number	要更改的日期
dayOfYear	Number	当年的第几天

返回

类型	描述
Date	新日期

案例

const result = setDayOfYear(new Date(2014, 6, 2), 2)
// => Thu Jan 02 2014 00:00:00

startOfDay

描述

返回给定日期当天的开始时间。

参数

字段	类型	描述
date	Date或Number	原始日期

返回

类型	描述
Date	当天的开始时间

案例

const result = startOfDay(new Date(2014, 8, 2, 11, 55, 0))
// => Tue Sep 02 2014 00:00:00

startOfToday

描述

返回今天的开始时间。

返回

类型	描述
Date	今天的开始时间

案例

const result = startOfToday()
// => Mon Oct 6 2014 00:00:00

startOfTomorrow

描述

返回明天的开始时间。

返回

类型	描述
Date	明天的开始时间

案例

const result = startOfTomorrow()
// => Tue Oct 7 2014 00:00:00

startOfYesterday

描述

返回昨天的开始时间。

返回

类型	描述
Date	昨天的开始时间

案例

const result = startOfYesterday()
// => Sun Oct 5 2014 00:00:00

subBusinessDays

描述

从给定日期减去指定的工作日数(mon-fri)。

参数

字段	类型	描述
date	Date或Number	要更改的日期
amount	Number	要减去的工作日数

返回

类型	描述
Date	减去工作日后的新日期

案例

const result = subBusinessDays(new Date(2014, 8, 1), 10)
// => Mon Aug 18 2014 00:00:00 (skipped weekend days)

subDays

描述

从给定日期减去指定的天数。

参数

字段	类型	描述
date	Date或Number	要更改的日期
amount	Number	要减去的天数

返回

类型	描述
Date	减去天数后的新日期

案例

const result = subDays(new Date(2014, 8, 1), 10)
// => Fri Aug 22 2014 00:00:00