# formatted(_:) Formats the duration, using the provided format style. ``` func formatted(_ v: S) -> S.FormatOutput where S : FormatStyle, S.FormatInput == Duration ``` ## Return Value A localized, formatted string that describes the duration. For example, a duration of 1 hour, 30 minutes, and 56 seconds in the `en_US` locale with a [`Duration.TimeFormatStyle`](/documentation/Swift/Duration/TimeFormatStyle) returns `1:30:56`. In the Finnish locale, this returns `1.30.56`. ## Discussion Use this formatting method to apply a custom style when formatting a duration. There are two format styles that apply to durations: - [`Duration.TimeFormatStyle`](/documentation/Swift/Duration/TimeFormatStyle) shows durations in a compact, numeric, localized form, like “2:03”. - [`Duration.UnitsFormatStyle`](/documentation/Swift/Duration/UnitsFormatStyle) shows durations with localized labeled components, like “2 min, 3 sec”. The following example uses a custom [`Duration.TimeFormatStyle`](/documentation/Swift/Duration/TimeFormatStyle) that shows hours, minutes, and seconds, and pads the hour part to a minimum of two characters. When it formats a two-second duration, this produces the string `00:00:02`. ``` let duration = Duration.seconds(2) let style = Duration.TimeFormatStyle(pattern: .hourMinuteSecond(padHourToLength: 2)) let formatted = duration.formatted(style) // "00:00:02". ``` Instead of explicitly initializing styles, you can use `Swift/Duration/TimeFormatStyle/time(pattern:)` or `Swift/Duration/UnitsFormatStyle/units(allowed:width:maximumUnitCount:zeroValueUnits:valueLength:fractionalPart:)` in any call that expects a whose input type is [`Duration`](/documentation/Swift/Duration). This allows you to rewrite the above example as follows: ``` let duration = Duration.seconds(2) let formatted = duration.formatted( .time(pattern: .hourMinuteSecond(padHourToLength: 2))) // "00:00:02". ``` --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)