About

ms-time-tools is a powerful Node.js module that allows you to easily manage time.

Features

• Installation
• Convert from milliseconds
• Convert from string

Installation

npm install --save ms-time-tools

Examples

const  mtt = require('ms-times-tools'); // Import the module

Convert from milliseconds

Here is the list of all the arguments available: |Parameter|Type|Optional|Default|Description| |:-:|:-:|:-:|:-:|:-:| |time|number|❌||Time in milliseconds to convert into string| |format|string|✅|Y-MO-W-D-H-M-S-MS|Format and order of time returned| |lang|string|✅|en|Language of time unities| |long|boolean|✅|false|Returns the whole word (not abbreviations)| |separator|string|✅|, |Separators of time values| |suppressTag|boolean|✅|false|Returns time without unities| |valueNull|boolean|✅|false|Removes values equal to zero|

Some usage examples:

mtt.stringifyTime(61000); // 1m, 1s

mtt.stringifyTime(
    617780000,
	{
	    format: 'Y-MO-W-D-H-M-S-MS',
		lang: 'en',
		long: true
	}
); // 1 week, 3 hours, 36 minutes, 20 seconds

mtt.stringifyTime(
	5100300,
	{
		valueNull: true,
		separator: '/'
	}
); // 0y/0mo/0w/0d/1h/25m/0s/3ms

mtt.stringifyTime(
	35071,
	{ suppressTag: true }
); // 35, 71

Convert from string

Here is the list of all the arguments available: |Parameter|Type|Optional|Default|Description| |:-:|:-:|:-:|:-:|:-:| |time|string|❌||Time in string to convert into milliseconds| |msOff|boolean|✅|false|Returns time in seconds instead of milliseconds|

Some usage examples:

mtt.parseTime('1 minute 1 second'); // 61000

mtt.parseTime(
    '2h 5m',
	{ msOff: true }
); // 7500

mtt.parseTime('1 month 2d 4hours'); // 187260000

mtt.stringifyTime(
	35071,
	{ suppressTag: true }
); // 35, 71

Format time

Here is the list of all the arguments available: |Parameter|Type|Optional|Default|Description| |:-:|:-:|:-:|:-:|:-:| |time|string|❌||Time to format| |format|string|✅|y YYYY, mo MMMM, d DD H:M:S.MS|Format and order of time returned, check here for more information| |lang|string|✅|en|Language of time unities| |long|boolean|✅|false|Returns the whole word (not abbreviations)| |suppressTag|boolean|✅|false|Returns time without unities| |valueNull|boolean|✅|false|Removes values equal to zero|

Some usage examples:

mtt.formatTime(654686145655); // 20 years, 8 months, 29 days 01:00:25.655

mtt.formatTime(
    65364,
    { format: 'M:S.MS' }
); // 01:05.364

mtt.formatTime(
    449155098,
    { format: 'D DD, h:M:S.ms' }
); // 05 days, 4:45:55.98