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

date-fns 秒助手函数

addSeconds

描述

在给定时间上加上给定秒数。

参数

字段	类型	描述
date	Date或Number	给定时间
amount	Number	给定秒数

返回

类型	描述
Date	添加秒数后的新时间

案例

const result = addSeconds(new Date(2014, 6, 10, 12, 45, 0), 30)
// => Thu Jul 10 2014 12:45:30

differenceInSeconds

描述

获取两个时间之间的秒数。

参数

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

返回

类型	描述
Number	秒数

案例

const result = differenceInSeconds(
    new Date(2014, 6, 2, 12, 30, 20, 0),
    new Date(2014, 6, 2, 12, 30, 7, 999)
)
// => 12

endOfSecond

描述

获取给定时间所在秒的结束时间。

参数

字段	类型	描述
date	Date或Number	给定时间

返回

类型	描述
Date	秒的结束时间

案例

const result = endOfSecond(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:45.999

getSeconds

描述

获取给定时间所在的秒数。

参数

字段	类型	描述
date	Date或Number	给定时间

返回

类型	描述
Number	所在的秒数

案例

const result = getSeconds(new Date(2012, 1, 29, 11, 45, 5, 123))
// => 5

isSameSecond

描述

给定的时间是否在同一秒内?

参数

字段	类型	描述
dateLeft	Date或Number	第一个时间
dateRight	Date或Number	第二个时间

返回

类型	描述
Boolean	是否在同一秒内

案例

const result = isSameSecond(
    new Date(2014, 8, 4, 6, 30, 15),
    new Date(2014, 8, 4, 6, 30, 15, 500)
)
// => true

const result = isSameSecond(
    new Date(2014, 8, 4, 6, 0, 15),
    new Date(2014, 8, 4, 6, 1, 15)
)
// => false

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

isThisSecond

描述

给定时间与当前时间是否在同一秒内?

参数

字段	类型	描述
date	Date或Number	给定时间

返回

类型	描述
Boolean	是否在同一秒内

案例

const result = isThisSecond(new Date(2014, 8, 25, 18, 30, 15))
// => true

setSeconds

描述

将给定时间所在的秒数设置为给定秒数。

参数

字段	类型	描述
date	Date或Number	要更改的时间
seconds	Number	新的秒数

返回

类型	描述
Date	新的时间

案例

const result = setSeconds(new Date(2014, 8, 1, 11, 30, 40), 45)
// => Mon Sep 01 2014 11:30:45

startOfSecond

描述

获取给定时间所在秒的开始时间。

参数

字段	类型	描述
date	Date或Number	给定时间

返回

类型	描述
Date	秒的开始时间

案例

const result = startOfSecond(new Date(2014, 11, 1, 22, 15, 45, 400))
// => Mon Dec 01 2014 22:15:45.000

subSeconds

描述

从给定时间中减去指定的秒数。

参数

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

返回

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

案例

const result = subSeconds(new Date(2014, 6, 10, 12, 45, 0), 30)
// => Thu Jul 10 2014 12:44:30