0.4.1 • Published 1 year ago

@ariesclark/time v0.4.1

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

Fast, efficient, and easy-to-use time functions for TypeScript.

Packages

Installation

npm install @ariesclark/extensions
# Or directly, if you only need the number extension.
npm install @ariesclark/number

Documentation

MaybeSuffix (type)

Milliseconds (type)

A duration in milliseconds.

DurationLiteral (type)

Duration (type)

A duration value.

Supports the following formats in both short and long form:

  • ms (milliseconds) e.g. 20ms or 20 as a number.
  • s (seconds) e.g. 1s or 1 second.
  • m (minutes) e.g. 2m or 2 minutes.
  • h (hours) e.g. 3h or 3 hours.
  • d (days) e.g. 4d or 4 days.
  • w (weeks) e.g. 5w or 5 weeks.
  • y (years) e.g. 6y or 6 years.

milliseconds (function)

object Object,object Object,object Object

Parameters:

  • value (Duration)

returns: number

ms('5m'); // 300000, 5 minutes in milliseconds, short form.
ms(300000); // 300000, 5 minutes in milliseconds, pass-through.
ms('2 hours'); // 7200000, 2 hours in milliseconds, long form.

ms (variable)

object Object,object Object,object Object

now (function)

Current time in milliseconds.

returns: number

Timestamp (type)

object Object,object Object,object Object,object Object,object Object

InvalidTimestampError (variable)

timestamp (function)

object Object,object Object,object Object

Parameters:

  • timestamp (Timestamp)

returns: number

randomTime (function)

Parameters:

  • offset (Duration)
  • anchor (number)

returns: number