Interval and Duration

:formatI(patternOut, patternIn)

v4.1.0+

Format intervals and duration. List of format names:

• human+
• human
• millisecond(s) or ms
• second(s) or s
• minute(s) or m
• hour(s) or h
• year(s) or y
• month(s) or M
• week(s) or w
• day(s) or d

Params	Description	Type
patternOut	output format: human, human+, milliseconds, seconds, ...	String
patternIn	[optional] input unit: milliseconds, seconds, ...	String

Examples

// With API options: {
//   "lang": "en",
//   "timezone": "Europe/Paris"
// }
{d.value:formatI('second')} // input: 2000 → output: 2
{d.value:formatI('seconds')} // input: 2000 → output: 2
{d.value:formatI('s')} // input: 2000 → output: 2
{d.value:formatI('minute')} // input: 3600000 → output: 60
{d.value:formatI('hour')} // input: 3600000 → output: 1
{d.value:formatI('days')} // input: 2419200000 → output: 28
// With API options: {
//   "lang": "fr",
//   "timezone": "Europe/Paris"
// }
{d.value:formatI('human')} // input: 2000 → output: "quelques secondes"
{d.value:formatI('human+')} // input: 2000 → output: "dans quelques secondes"
{d.value:formatI('human+')} // input: -2000 → output: "il y a quelques secondes"
// With API options: {
//   "lang": "en",
//   "timezone": "Europe/Paris"
// }
{d.value:formatI('human')} // input: 2000 → output: "a few seconds"
{d.value:formatI('human+')} // input: 2000 → output: "in a few seconds"
{d.value:formatI('human+')} // input: -2000 → output: "a few seconds ago"
// With API options: {
//   "lang": "en",
//   "timezone": "Europe/Paris"
// }
{d.value:formatI('ms', 'minute')} // input: 60 → output: 3600000
{d.value:formatI('ms', 'weeks')} // input: 4 → output: 2419200000
// With API options: {
//   "lang": "en",
//   "timezone": "Europe/Paris"
// }
{d.value:formatI('ms')} // input: "P1M" → output: 2628000000
{d.value:formatI('hour')} // input: "P1Y2M3DT4H5M6S" → output: 10296.085