Swift version: 5.6
If you want to get a string from a
DateFormatter class has everything you need: you can get short dates, long dates, dates with times, and can even go the opposite way to give you a
Date from a string.
There are four primary ways you’re going to use it:
Dateinstance to a string using one of the built-in date formats.
Dateinstance to a string using one of the built-in time formats.
Dateinstance to a string using a completely custom format.
Below are examples of each to get you started.
First, this converts a
Date to a short date string using
let today = Date.now let formatter1 = DateFormatter() formatter1.dateStyle = .short print(formatter1.string(from: today))
That will print something like “12/31/2019” depending on the user’s locale.
Second, this converts the same date to a medium time string using
let formatter2 = DateFormatter() formatter2.timeStyle = .medium print(formatter2.string(from: today))
That will print something like “20:27:32” or “8:27:32pm” depending on the user’s locale.
Third, this converts the same date to a date and time string using a custom date format:
let formatter3 = DateFormatter() formatter3.dateFormat = "HH:mm E, d MMM y" print(formatter3.string(from: today))
That will print something like “20:32 Wed, 30 Oct 2019”.
Finally, this attempts to convert a string to a date
let string = "20:32 Wed, 30 Oct 2019" let formatter4 = DateFormatter() formatter4.dateFormat = "HH:mm E, d MMM y" print(formatter4.date(from: string) ?? "Unknown date")
date(from:) returns an optional
Date because it might be given a string containing an invalid value, so that code uses nil coalescing to make sure there’s a default value printed.
SPONSORED Play is the first native iOS design tool created for designers and engineers. You can install Play for iOS and iPad today and sign up to check out the Beta of our macOS app with SwiftUI code export. We're also hiring engineers!
Available from iOS 2.0
This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.
Link copied to your pasteboard.