duration.js

Documentation

Check out Neko Of The Abyss for documentation.

Duration follows the performance.now() format, so microseconds and nanoseconds go after the decimal point.

Installation

$ npm install --save @retraigo/duration.js # NPM
$ pnpm install @retraigo/duration.js # PNPM

Usage

Basic Usage

// Node
import Duration from "@retraigo/duration.js"; 
// Deno
import Duration from "https://deno.land/x/durationjs@v2.3.2/mod.ts"; 

const Duration = await import("@retraigo/duration.js"); // Node with CommonJS

new Duration(); // Get duration since midnight

new Duration(3545346); // A random duration

new Duration(0); // Just 0

new Duration(-1); // Negative duration returns 0 too

For CommonJS support with require, download the index.js file and replace export default with module.exports = .

From Text

Duration.fromString("1m2s"); // Duration {d:0, h:0, m:1, s:2, ms:0}

Duration.fromString("4090 sec 4939  days 7342  hour 2324milliseconds 4344 min"); // // Duration {d: 5246, h: 13, m: 52, s: 12, ms: 324 }

You can also get the entire Duration in milliseconds through the raw property.

const dur = Duration.fromString(
  "4090 sec 4939  days 7342  hour 2324milliseconds 4344 min"
);
dur.raw; // 453304332324

Properties

Duration {
    raw: 0 // Original milliseconds passed to the constructor
    d: 0, // Days
    h: 0, // Hours
    m: 0, // Minutes
    s: 0, // Seconds
    ms: 0 // Milliseconds
    us: 0 // Microseconds
    ns: 0 // Nanoseconds
};

Methods

toString()

toString() returns a simplified version of stringify() despite not looking nice at all. Simply exists.

new Duration(261174).toString();
// `[Duration 0d 0h 4m 21s]`

stringify([values] [,short])

stringify() returns a formatted string of the duration object. It has two optional parameters. values - An array of values to include. Should be one of ['d', 'h', 'm', 's', 'ms']. Defaults to the array I mentioned a few words ago. Leave an empty array (TS) or null (JS) if you wanna skip this. short - true if the function should return letters instead of words (I suck at explaining). Defaults to false.

new Duration(165684).stringify();
// `0 days, 0 hours, 2 minutes, 45 seconds, 684 milliseconds`
new Duration(165684).stringify(["s", "h"]);
// `0 hours, 45 seconds`
new Duration(165684).stringify(["s", "h"], true);
// `0h 45s`

getFormattedDuration([from] [,to])

getFormattedDuration() returns a formatted string of the duration object in the d:h:m:s:ms format. It has two optional parameters. from - The value to begin with. Should be one of ['d', 'h', 'm', 's', 'ms']. Defaults to 'd'. to - The value to end with. Should be one of ['d', 'h', 'm', 's', 'ms']. Defaults to 'ms'.

new Duration(165684).getFormattedDuration();
// `0:0:2:45:684`
new Duration(165684).getFormattedDuration("h", "s");
// `0:2:45`
new Duration(165684).getFormattedDuration("s", "h");
// `45:684`
// ignores the `to` parameter if it is larger than the `from` parameter

NOTE: getFormattedDuration() will be deprecated soon.`

getSimpleFormattedDuration()

getSimpleFormattedDuration() returns a formatted string of the duration object in the d:h:m:s:ms format.

NOTE: getSimpleFormattedDuration() is deprecated. Please use Duration#toString()

new Duration(165684).getSimpleFormattedDuration();
// `0:0:2:45:684`

reload()

Reload the duration.

const d = new Duration(6000);
d.m += 70
console.log(d) // Only d.m changes. d.h remains the same
d.reload()
console.log(d) // d.m turns into 10 and d.h turns into 1

get json()

Returns a JavaScript object version of the class with just the main stuff.

new Duration(114750).json;
// `{ d: 0, h: 0, m: 1, s: 54, ms: 750 }`

get array()

Returns an array of objects with type and value.

new Duration(245074).array;
/* 
   [
       { type: 'd', value: 0 },
       { type: 'h', value: 0 },
       { type: 'm', value: 4 },
       { type: 's', value: 5 },
       { type: 'ms', value: 74 }
   ]
*/

Support

Join our Discord server here