---
title: "formatted(_:)"
framework: swift
role: symbol
role_heading: Instance Method
path: "swift/duration/formatted(_:)"
---

# formatted(_:)

Formats the duration, using the provided format style.

## Declaration

```swift
func formatted<S>(_ v: S) -> S.FormatOutput where S : FormatStyle, S.FormatInput == Duration
```

## Return Value

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 returns 1:30:56. In the Finnish locale, this returns 1.30.56.

## Discussion

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 shows durations in a compact, numeric, localized form, like “2:03”. Duration.UnitsFormatStyle shows durations with localized labeled components, like “2 min, 3 sec”. The following example uses a custom 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 FormatStyle whose input type is 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".

## See Also

### Formatting a duration

- [formatted()](swift/duration/formatted().md)
- [Duration.TimeFormatStyle](swift/duration/timeformatstyle.md)
- [Duration.UnitsFormatStyle](swift/duration/unitsformatstyle.md)