---
title: "timeSeparator(_:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/date/iso8601formatstyle/timeseparator(_:)"
---

# timeSeparator(_:)

Modifies the ISO 8601 date format style to use the specified time separator.

## Declaration

```swift
func timeSeparator(_ separator: Date.ISO8601FormatStyle.TimeSeparator) -> Date.ISO8601FormatStyle
```

## Parameters

- `separator`: Character used to separate the hour and minute in a date.

## Return Value

Return Value An ISO 8601 date format style modified to include the specified time separator style.

## Discussion

Discussion Possible values of Date.ISO8601FormatStyle.TimeSeparator are Date.ISO8601FormatStyle.TimeSeparator.colon and Date.ISO8601FormatStyle.TimeSeparator.omitted. This example shows a variety of ISO 8601 time separator formats applied to an ISO 8601 date format: let meetingDate = Date() // Jun 23, 2021 at 1:41 PM meetingDate.formatted(.iso8601.timeSeparator(.omitted)) // 20210623T184148Z meetingDate.formatted(.iso8601.timeSeparator(.colon)) // 20210623T18:41:48Z meetingDate.formatted(.iso8601) // 20210623T184148Z If no format is specified as a parameter, the Date.ISO8601FormatStyle.DateSeparator.omitted case is the default format. For more information about ISO 8601 formatted dates, see the Date.ISO8601FormatStyle.

## See Also

### Modifying Times in an ISO 8601 Format Style

- [time(includingFractionalSeconds:)](foundation/date/iso8601formatstyle/time(includingfractionalseconds:).md)
- [timeZone(separator:)](foundation/date/iso8601formatstyle/timezone(separator:).md)
- [timeZoneSeparator(_:)](foundation/date/iso8601formatstyle/timezoneseparator(_:).md)
