Skip to content

Instance MethodFoundationEssentials

parse(_:)

iOS 15.0+ iPadOS 15.0+ Mac Catalyst 15.0+ macOS 12.0+ tvOS 15.0+ watchOS 8.0+
Parses a string into a date.
func parse(_ value: String) throws -> Date

Parameters

value

The string to parse.

Return Value

An instance of Date parsed from the input string.

Discussion

This method attempts to parse a provided string into an instance of date using the source date format style. The function throws an error if it can’t parse the input string into a date instance.

let birthdayFormatStyle = Date.ISO8601FormatStyle()
    .dateSeparator(.dash)
    .timeSeparator(.colon)
    .year()
    .month()
    .day()
    .time(includingFractionalSeconds: false)

let yourBirthdayString = "2021-02-17T14:33:25"
let yourBirthday = try? birthdayFormatStyle.parse(yourBirthdayString)
// Feb 17, 2021 at 8:33 AM