Function formatDuration

src/utils/string.ts:27–47

(
  totalSeconds: number,
  options: { enableHoursWhenZero?: boolean; disableMilliseconds?: boolean } = {
    enableHoursWhenZero: false,
    disableMilliseconds: false,
  },
)

 * @returns {string}: Formatted duration in HH:MM::SS.mm
 */
export function formatDuration(
  totalSeconds: number,
  options: { enableHoursWhenZero?: boolean; disableMilliseconds?: boolean } = {
    enableHoursWhenZero: false,
    disableMilliseconds: false,
  },
): string {
  const hours = Math.floor(totalSeconds / 3600)
  const minutes = Math.floor((totalSeconds % 3600) / 60)
  const seconds = Math.floor(totalSeconds % 60)
  const milliseconds = Math.floor(
    (totalSeconds - Math.floor(totalSeconds)) * 100,
  )

  const pad = (n: number, size = 2) => n.toString().padStart(size, '0')
  const hoursPart =
    (options?.enableHoursWhenZero && hours === 0) || hours !== 0
      ? `${pad(hours)}:`
      : ''
  return `${hoursPart}${pad(minutes)}:${pad(seconds)}${!options?.disableMilliseconds ? `.${pad(milliseconds)}` : ''}`
}