# time(pattern:) Returns a style for formatting a duration using a provided pattern. ``` static func time(pattern: Duration.TimeFormatStyle.Pattern) -> Self ``` ## Parameters `pattern` A that specifies the units to include in the displayed string and the behavior of the units. ## Return Value A duration time format style customized with the specified pattern. ## Discussion Use the dot-notation form of this type method when the call point allows the use of . You typically do this when calling the method of . The following example creates a duration to represent 1 hour, 10 minutes, 32 seconds, and 400 milliseconds. It then uses [`time(pattern:)`](/documentation/Foundation/FormatStyle/time(pattern:)) to customize a to show hours, minutes, and seconds, padding the hours part to two digits and limiting the fractional seconds to two digits. When used with the method, the resulting string is `01:10:32.40`. ```swift let duration = Duration.seconds(70 * 60 + 32) + Duration.milliseconds(400) let format = duration.formatted( .time(pattern: .hourMinuteSecond(padHourToLength: 2, fractionalSecondsLength: 2))) // format == "01:10:32.40" ``` --- 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)