getSecondsAgo()function
getSecondsAgo(target: PossibleDate, current?: PossibleDate, caller: AnyCaller = getSecondsAgo): number
| Param | Type | |
|---|---|---|
target | PossibleDate | Date to count back from. required |
current | PossibleDate | Date to count to (defaults to now). |
caller | AnyCaller | Function to attribute a thrown error to (defaults to getSecondsAgo itself). Defaults to getSecondsAgo |
| Return | |
|---|---|
number | Number of whole seconds from target to current (negative if target is in the future). |
| Throws | |
|---|---|
RequiredError | If target or current cannot be converted to a valid date. |
Count the whole seconds since a date.
- Rounds to the nearest whole second, i.e.
1 second 499 msreturns1
Examples
getSecondsAgo(target) // 90