Skip to content

Function.formatDuration

github-actions[bot] edited this page Nov 18, 2026 · 13 revisions

umt / formatDuration

Function: formatDuration()

formatDuration(milliseconds): string

Defined in: Time/formatDuration.ts:28

Formats a millisecond duration as a compact human-readable string. Units are days (d), hours (h), minutes (m), seconds (s) and milliseconds (ms), separated by a space. Zero units are omitted, fractional milliseconds are truncated, and a zero duration returns "0s". Negative durations keep a leading "-".

Parameters

milliseconds

number

Duration in milliseconds

Returns

string

The formatted duration

Example

formatDuration(5_400_000); // "1h 30m"
formatDuration(45_000); // "45s"
formatDuration(183_600_000); // "2d 3h"
formatDuration(1500); // "1s 500ms"
formatDuration(-90_000); // "-1m 30s"
formatDuration(0); // "0s"

API

Classes

Interfaces

Type Aliases

Variables

Functions

Clone this wiki locally