formatTime()

const formatTime: (seconds, options?) => string;

Formats a duration in seconds as a human-readable time string.

Default output is "M:SS" (e.g. "5:30"). Use hours to control when the hours segment appears, and padMinutes to keep the minutes column at a fixed two-digit width.

Parameters

Parameter	Type	Description
seconds	number	Total duration in seconds.
options?	FormatTimeOptions	Optional formatting options.

Returns

string

A formatted time string.

Example

formatTime(90)                                   // "1:30"
formatTime(90, { padMinutes: true })             // "01:30"
formatTime(3750, { hours: 'auto' })              // "1:02:30"
formatTime(330, { hours: 'always' })             // "0:05:30"