init(dateSeparator:dateTimeSeparator:timeZone:)

Declaration

init(dateSeparator: Date.ISO8601FormatStyle.DateSeparator = .dash, dateTimeSeparator: Date.ISO8601FormatStyle.DateTimeSeparator = .standard, timeZone: TimeZone = TimeZone(secondsFromGMT: 0)!)

Parameters

• dateSeparator:

  The separator character used between the year, month, and day.

• dateTimeSeparator:

  The separator character used between the date and time components.

• timeZone:

  The Timezone used to create the string representation of the date.

Discussion

Possible values of dateSeparator are dash and omitted. Omitted is the default.

Possible values of dateTimeSeparator are space and standard. Standard is the default.

The following example shows the initizializer called with a variety of input parameters.

let aDate = Date()
print(aDate) // 2021-06-22 17:21:32 +0000
print(aDate.formatted(Date.ISO8601FormatStyle(dateSeparator: .omitted, dateTimeSeparator: .standard)))
// 20210622T172132Z

let cstDate = Date()
if let centralStandardTimeZone = TimeZone(identifier: "CST") {
   print(cstDate.formatted(Date.ISO8601FormatStyle(dateSeparator: .dash, dateTimeSeparator: .space, timeZone: centralStandardTimeZone)))
}
// 2021-06-22 122132-0500