Format durations like a stopwatch or a sentence

Duration formats as 1:02:05 or as 1 hour, 2 minutes, in the guest's language, with no manual division into hours and minutes.

iOS 16+macOS 13+ Swift 5.9

Turning seconds into hours and minutes by hand means integer division, zero padding and pluralisation, and the result is English only. Swift’s Duration type has two format styles: a clock-like pattern and a spelled-out list of units.

WorkoutSummary.swift
import SwiftUI

struct WorkoutSummary: View {
    let elapsed = Duration.seconds(3_725)
    let lap = Duration.seconds(65.4)

    var body: some View {
        VStack(alignment: .leading, spacing: 8) {
            Text(elapsed, format: .time(pattern: .hourMinuteSecond))
                .font(.largeTitle.monospacedDigit())

            Text(elapsed, format: .units(allowed: [.hours, .minutes], width: .wide))

            Text(elapsed, format: .units(allowed: [.hours, .minutes, .seconds], width: .narrow))

            Text(lap, format: .time(pattern: .minuteSecond(padMinuteToLength: 2, fractionalSecondsLength: 1)))
        }
    }
}

#Preview {
    WorkoutSummary()
}

Converting from a TimeInterval is one call: Duration.seconds(interval).

How it works

Gotchas

See also