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

date-fns 小时助手函数

addHours

描述

在给定的时间上添加指定小时数。

参数

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

返回

类型	描述
Date或Number	要更改的日期

案例

const result = addHours(new Date(2014, 6, 10, 23, 0), 2)
// => Fri Jul 11 2014 01:00:00

differenceInHours

描述

计算两个日期之间的小时数。

参数

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

返回

类型	描述
Number	小时数

案例

const result = differenceInHours(
    new Date(2014, 6, 2, 19, 0),
    new Date(2014, 6, 2, 6, 50)
)
// => 12

endOfHour

描述

返回给定日期所在小时的结束时间。
结果为本地时区。

参数

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

返回

类型	描述
Date	所在小时的结束时间

案例

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

getHours

描述

返回给定日期所在小时。

参数

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

返回

类型	描述
Date	所在小时

案例

const result = getHours(new Date(2012, 1, 29, 11, 45))
// => 11

isSameHour

描述

给定日期是否在同一小时(同一天)?

参数

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

返回

类型	描述
Boolean	日期在同一小时(同一天)

案例

const result = isSameHour(new Date(2014, 8, 4, 6, 0), new Date(2014, 8, 5, 6, 0))
// => false

isThisHour

描述

给定日期是否与当前日期在同一小时内?

参数

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

返回

类型	描述
Boolean	是否与当前日期在同一小时内

案例

const result = isThisHour(new Date(2014, 8, 25, 18))
// => true

setHours

描述

将小时设置为给定日期。

参数

字段	类型	描述
date	Date或Number	要更改的日期

返回

类型	描述
Date	设置了时间的新日期

案例

const result = setHours(new Date(2014, 8, 1, 11, 30), 4)
// => Mon Sep 01 2014 04:30:00

startOfHour

描述

返回给定日期一小时的开始时间。
结果将在本地时区。

参数

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

返回

类型	描述
Date	给定日期一小时的开始时间

案例

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

subHours

描述

从给定日期中减去指定的小时数。

参数

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

返回

类型	描述
Date	减去小时的新日期

案例

const result = subHours(new Date(2014, 6, 11, 1, 0), 2)
// => Thu Jul 10 2014 23:00:00

其他 date-fns 方法

date-fns