@m234/ns

Use this package to easily convert various time formats to nanoseconds (BigInt) or milliseconds (Number).

This library is based on ms v4. For more details, see that package.

Differences from ms

• This library uses BigInt and nanoseconds instead of milliseconds.
• ns(StringValue | bigint): bigint | string is available.
• ms(StringValue | number): number | string is available.
• The StringValue argument is more friendly.

Usage

const start = process.hrtime.bigint();
setTimeout(() => {
  const end = process.hrtime.bigint();
  const diff = ns(end - start);
  console.log(diff);
}, 1000);

Examples

ns("2 days");     // 172800000000000n
ns("1d");         // 86400000000000n
ns("10h");        // 36000000000000n
ns("2.5 hrs");    // 9000000000000n
ns("2h");         // 7200000000000n
ns("1m");         // 60000000000n
ns("5s");         // 5000000000n
ns("1y");         // 31557600000000000n
ns("100");        // 100n
ns("-3 days");    // -259200000000000n
ns("-1h");        // -3600000000000n
ns("-200");       // -200n

Convert from nanoseconds

ns(60000000000n);          // "1m"
ns(2n * 60000000000n);     // "2m"
ns(-3n * 60000000000n);    // "-3m"
ns(ns("10 hours"));        // "10h"

Time format written-out

ns(60000000000n, { long: true });          // "1 minute"
ns(2n * 60000000000n, { long: true });     // "2 minutes"
ns(-3n * 60000000000n, { long: true });    // "-3 minutes"
ns(ns('10 hours'), { long: true });        // "10 hours"

Input formats (units)

type Years = "years" | "year" | "yrs" | "yr" | "y";
type Months = "months" | "month" | "mo";
type Weeks = "weeks" | "week" | "w";
type Days = "days" | "day" | "d";
type Hours = "hours" | "hour" | "hrs" | "hr" | "h";
type Minutes = "minutes" | "minute" | "mins" | "min" | "m";
type Seconds = "seconds" | "second" | "secs" | "sec" | "s";
type Milliseconds = "milliseconds" | "millisecond" | "msecs" | "msec" | "ms";
type Microseconds = "microseconds" | "microsecond" | "µsecs" | "µsec" | "µs";
type Nanoseconds = "nanoseconds" | "nanosecond" | "nsecs" | "nsec" | "ns";
type Unit =
  | Years
  | Months
  | Weeks
  | Days
  | Hours
  | Minutes
  | Seconds
  | Milliseconds
  | Microseconds
  | Nanoseconds;