Get unlimited public & private packages + team-based management with npm Teams.Learn more »

yet-another-duration

1.7.3 • Public • Published

Yet Another Duration

Install

npm install yet-another-duration

Usage

toString()

Transform the number of milliseconds into the Duration string.

  • duration(milliseconds, options).toString().
    • options is optional param;
const {duration} = require('yet-another-duration');
 
const result = duration(1649254321).toString();
 
console.log(result); // 19d 2h 7m 34s

toTimeSpan()

Transform the number of milliseconds into the Timespan string, eq. 01:12:34:55.

const {duration} = require('yet-another-duration');
 
const result = duration(131695000).toTimeSpan();
 
console.log(result); // 01:12:34:55

toISO8601()

Transform the number of milliseconds into the ISO 8601 duration string, eq. P1Y2M10DT2H30M.

const {duration} = require('yet-another-duration');
 
const result = duration(131695000).toISO8601();
 
console.log(result); // P0Y0M1DT12H34M55S

toObject()

Transform the number of milliseconds into the Duration object.

  • duration(milliseconds, options).toObject();
    • options is optional param;
const {duration} = require('yet-another-duration');
 
const r2 = duration(1649254321).toObject();
 
console.log(r2); // { years: 0, months: 0, days: 19 ... }

Options

interface DurationConfig {
    calculateWeeks?: boolean;
    units?: {
        max?: string,
        min?: string
    };
    string?: {
        trimZerosLeft?: boolean;
        trimZerosRight?: boolean;
        removeZeros?: boolean;
    };
}
  • calculateWeeks true|false - include weeks into calculations;

units options

  • max years|months|weeks|days|hours|minutes|seconds - set max unit for output:
    • If set to hours, then 1m 15d 12h 32m 45s -> 1116h 32m 45s;
  • min years|months|weeks|days|hours|minutes|seconds - set min unit for output:
    • If set to days, then 1m 15d 12h 32m 45s -> 1m 15d;

Both options may be provided together. As example:

  • If max is set to days, min is set to hours: 1m 15d 12h 32m 45s -> 46d 12h;

string options

  • trimZerosLeft true|false - remove zero values from left side of the string:
    • If true, then 0y 0m 0d 2h 0m 30s -> 2h 0m 30s;
  • trimZerosRight true|false - remove zero values from right side of the string:
    • If true, then 0y 0m 5d 12h 0m 0s -> 0y 0m 5d 12h;
    • If both options is set true, then toString() will produce 5d 12h instead of 0y 0m 5d 12h 0m 0s;
  • removeZeros - remove zero values from the string;
    • When removeZeros option is true, then toString() will produce 2h 30s instead of 0y 0m 0d 2h 0m 30s;

Examples

JavaScript

Specifying defaults

const {duration} = require('yet-another-duration');
 
const timer = duration.defaults({ ... });
 
timer(1234567).toObject();
  • defaults is not affecting the duration library in another modules.

Install

npm i yet-another-duration

DownloadsWeekly Downloads

3

Version

1.7.3

License

ISC

Unpacked Size

63.5 kB

Total Files

23

Last publish

Collaborators

  • avatar