iOS（Swift） で日付・時刻を ISO 8601 形式で扱う際に ISO8601DateFormatter を使ったのでまとめました。

ISO 8601 とは

ウィキペディア：ISO 8601

ISO 8601 は日付・時刻の表記に関する国際規格。

基本形式	20180904T161400+0900
拡張形式	2018-09-04T16:14:00+09:00

ISO8601DateFormatter とは

• 日付・時刻を ISO 8601 形式で扱う（DateFormatter クラスの代わりに利用¹）
• iOS 10 以降（一部 iOS 11 以降）で利用可能
• デフォルトでは RFC 3339 形式（"yyyy-MM-dd'T'HH:mm:ssXXXXX"）

基本的な使い方

import Foundation

Date から ISO 8601 形式へ変換

let formatter = ISO8601DateFormatter()
formatter.string(from: date)
// 例: "2018-09-18T02:00:00Z"

ISO 8601 形式から Date へ変換

let formatter = ISO8601DateFormatter()
formatter.date(from: "2018-09-18T02:00:00Z")

注意事項

プロパティを再設定すると CFDateFormatterRef が再生成されてコストが非常に高くなる可能性があります。

Please note that there can be a significant performance cost when resetting these properties. Resetting each property can result in regenerating the entire CFDateFormatterRef, which can be very expensive.

オプション

デフォルト設定は次のとおりです。（それぞれの説明は 後述）

• .withInternetDateTime
• .withDashSeparatorInDate
• .withColonSeparatorInTime
• .withColonSeparatorInTimeZone

ISO8601DateFormatter.Options は OptionSet なので次のように追加や削除ができます。

オプションを追加

let formatter = ISO8601DateFormatter()
formatter.formatOptions.insert(.withFractionalSeconds)
formatter.string(from: date)
// 例: "2018-09-18T02:00:00.000Z"

オプションを削除

let formatter = ISO8601DateFormatter()
formatter.formatOptions.remove(.withDashSeparatorInDate)
formatter.string(from: date)
// 例: "20180918T02:00:00Z"

タイムゾーン

デフォルトは GMT² です。

タイムゾーンを変更

let formatter = ISO8601DateFormatter()
formatter.timeZone = TimeZone(identifier: "Asia/Tokyo")!
formatter.string(from: date)
// 例: "2018-09-18T11:00:00+09:00"

おまけ：オプション一覧

参考記事

• Developers.IO: [iOS 10] ISO8601DateFormatter について
• Qiita: iOSでISO8601を扱う