Як створити штамп часу та формат дати як ISO 8601, RFC 3339, часовий пояс UTC?


186

Як створити штамп часу, використовуючи стандарти формату ISO 8601 та RFC 3339 ?

Мета - рядок, який виглядає приблизно так:

"2015-01-01T00:00:00.000Z"

Формат:

  • рік, місяць, день як "XXXX-XX-XX"
  • літера "Т" як роздільник
  • година, хвилина, секунди, мілісекунди, як "XX: XX: XX.XXX".
  • літера "Z" як позначення зони для нульового зміщення, так само UTC, GMT, зулуський час.

Кращий випадок:

  • Швидкий вихідний код, простий, короткий та простий.
  • Не потрібно використовувати будь-який додатковий фреймворк, підпроект, cocoapod, код C тощо.

Я шукав StackOverflow, Google, Apple і т.д., і не знайшов відповіді на це швидко.

Класи, які здаються найбільш перспективними NSDate, NSDateFormatter- NSTimeZone.

Питання та відповіді: Як отримати дату ISO 8601 в iOS?

Ось найкраще, що я придумав поки що:

var now = NSDate()
var formatter = NSDateFormatter()
formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"
formatter.timeZone = NSTimeZone(forSecondsFromGMT: 0)
println(formatter.stringFromDate(now))

6
Зауважте, що iOS10 + ПРОСТО ВКЛЮЧАЄ ISO 8601 ВСТАНОВЛЕНО .. він просто автоматично заповниться для вас.
Fattie

2
@Fattie І - як можна обробити цю останню .234Z мілісекунд частина зулу / UTC частини часової позначки? Відповідь: Метт Лонгс @ stackoverflow.com/a/42101630/3078330
smat88dd

1
@ smat88dd - фантастична порада, дякую. Я не мав поняття, що існували "варіанти форматів", дивні та дикі!
Fattie

Я шукаю рішення, яке працює на Linux.
neoneye

@neoneye Просто використовуйте стару версію (звичайна DateFormatter) і змінити календар ISO8601 григоріанським stackoverflow.com/a/28016692/2303865
Лео Dabus

Відповіді:


392

Swift 4 • iOS 11.2.1 або новішої версії

extension ISO8601DateFormatter {
    convenience init(_ formatOptions: Options, timeZone: TimeZone = TimeZone(secondsFromGMT: 0)!) {
        self.init()
        self.formatOptions = formatOptions
        self.timeZone = timeZone
    }
}

extension Formatter {
    static let iso8601withFractionalSeconds = ISO8601DateFormatter([.withInternetDateTime, .withFractionalSeconds])
}

extension Date {
    var iso8601withFractionalSeconds: String { return Formatter.iso8601withFractionalSeconds.string(from: self) }
}

extension String {
    var iso8601withFractionalSeconds: Date? { return Formatter.iso8601withFractionalSeconds.date(from: self) }
}

Використання:

Date().description(with: .current)  //  Tuesday, February 5, 2019 at 10:35:01 PM Brasilia Summer Time"
let dateString = Date().iso8601withFractionalSeconds   //  "2019-02-06T00:35:01.746Z"

if let date = dateString.iso8601withFractionalSeconds {
    date.description(with: .current) // "Tuesday, February 5, 2019 at 10:35:01 PM Brasilia Summer Time"
    print(date.iso8601withFractionalSeconds)           //  "2019-02-06T00:35:01.746Z\n"
}

iOS 9 • Swift 3 або новішої версії

extension Formatter {
    static let iso8601withFractionalSeconds: DateFormatter = {
        let formatter = DateFormatter()
        formatter.calendar = Calendar(identifier: .iso8601)
        formatter.locale = Locale(identifier: "en_US_POSIX")
        formatter.timeZone = TimeZone(secondsFromGMT: 0)
        formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSSXXXXX"
        return formatter
    }()
}

Протокол, кодируемый

Якщо вам потрібно кодувати та декодувати цей формат під час роботи з протоколом Codable, ви можете створити власні власні стратегії кодування / декодування дати:

extension JSONDecoder.DateDecodingStrategy {
    static let iso8601withFractionalSeconds = custom {
        let container = try $0.singleValueContainer()
        let string = try container.decode(String.self)
        guard let date = Formatter.iso8601withFractionalSeconds.date(from: string) else {
            throw DecodingError.dataCorruptedError(in: container,
                  debugDescription: "Invalid date: " + string)
        }
        return date
    }
}

і стратегія кодування

extension JSONEncoder.DateEncodingStrategy {
    static let iso8601withFractionalSeconds = custom {
        var container = $1.singleValueContainer()
        try container.encode(Formatter.iso8601withFractionalSeconds.string(from: $0))
    }
}

Тестування дитячого майданчика

let dates = [Date()]   // ["Feb 8, 2019 at 9:48 PM"]

кодування

let encoder = JSONEncoder()
encoder.dateEncodingStrategy = .iso8601withFractionalSeconds
let data = try! encoder.encode(dates)
print(String(data: data, encoding: .utf8)!)

розшифровка

let decoder = JSONDecoder()
decoder.dateDecodingStrategy = .iso8601withFractionalSeconds
let decodedDates = try! decoder.decode([Date].self, from: data)  // ["Feb 8, 2019 at 9:48 PM"]

введіть тут опис зображення


3
Було б корисно додати протилежне розширення конверсії:extension String { var dateFormattedISO8601: NSDate? {return NSDate.Date.formatterISO8601.dateFromString(self)} }
Vive

1
Лише зауважте, що це втрачає трохи точності, тому важливо переконатися, що рівність дат порівнюється через створений рядок, а не timeInterval. let now = NSDate() let stringFromDate = now.iso8601 let dateFromString = stringFromDate.dateFromISO8601! XCTAssertEqual(now.timeIntervalSince1970, dateFromString.timeIntervalSince1970)
pixelrevision

7
Потрібно говорити, що якщо вам не потрібні мілісекунди, новий iOS 10 ISO8601DateFormatterспрощує процес. Я випустив звіт про помилку (27242248) в Apple, попросивши їх розширити цей новий форматер, щоб запропонувати також можливість задавати мілісекунди (оскільки цей новий формат не корисний для багатьох з нас без мілісекунд).
Роб

1
У RFC3339 ми можемо знайти примітку "ПРИМІТКА. ISO 8601 визначає дату та час, розділені на" T ". Програми, що використовують цей синтаксис, можуть вибрати для зручності читання вказати повну дату та повний робочий день, розділений на (скажіть) космічний символ ". Чи охоплює також формат дати, Tнаприклад 2016-09-21 21:05:10+00:00:?
manRo

3
@LeoDabus так, але це перший результат для "Swift iso8601". Мій коментар мав на меті попередити інших розробників, які натрапляли на це в майбутньому і не були направлені в ОП.
thislooksfun

38

Не забудьте встановити мову, en_US_POSIXяк описано в Технічному запитанні та записі A1480 . У Swift 3:

let date = Date()
let formatter = DateFormatter()
formatter.locale = Locale(identifier: "en_US_POSIX")
formatter.timeZone = TimeZone(secondsFromGMT: 0)
formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSSZZZZZ"
print(formatter.string(from: date))

Проблема полягає в тому, що якщо ви користуєтесь пристроєм, який використовує негригоріанський календар, рік не буде відповідати RFC3339 / ISO8601, якщо ви не вкажете locale, а також timeZoneі dateFormatрядок.

Або ви можете скористатися ISO8601DateFormatterдля того, щоб позбутися вас від бур'янів, що склалися, localeі timeZoneсамі:

let date = Date()
let formatter = ISO8601DateFormatter()
formatter.formatOptions.insert(.withFractionalSeconds)  // this is only available effective iOS 11 and macOS 10.13
print(formatter.string(from: date))

Про видання Swift 2 див. Попередню редакцію цієї відповіді .


чому ми повинні встановити локаль на en_US_POSIX? навіть якщо ми не в США?
mnemonic23

2
Ну, вам потрібен певний послідовний локал, і конвенція стандартів ISO 8601 / RFC 3999 - це той формат, який пропонується компанією en_US_POSIX. Це lingua franca для обміну датами в Інтернеті. І у вас не може бути неправильного тлумачення дат, якщо один календар був використаний на пристрої під час збереження рядка дати, а інший, коли рядок буде прочитаний пізніше. Крім того, вам потрібен формат, який гарантовано ніколи не змінюється (саме тому ви використовуєте en_US_POSIXі ні en_US). Для отримання додаткової інформації див. Технічні запитання та відповіді 1480 або ті стандарти RFC / ISO.
Роб

24

Якщо ви хочете використовувати ISO8601DateFormatter()дату з каналу Rails 4+ JSON (і, звичайно, не потрібні мільйони), вам потрібно встановити кілька варіантів форматера, щоб він працював правильно, інакше date(from: string)функція поверне нуль. Ось що я використовую:

extension Date {
    init(dateString:String) {
        self = Date.iso8601Formatter.date(from: dateString)!
    }

    static let iso8601Formatter: ISO8601DateFormatter = {
        let formatter = ISO8601DateFormatter()
        formatter.formatOptions = [.withFullDate,
                                          .withTime,
                                          .withDashSeparatorInDate,
                                          .withColonSeparatorInTime]
        return formatter
    }()
}

Ось результат використання віршів з параметрами не на скріншоті ігрового майданчика:

введіть тут опис зображення


Вам потрібно буде включити в параметри також, .withFractionalSecondsале я вже це намагався, і він продовжує кидати помилку libc++abi.dylib: terminating with uncaught exception of type NSException.
Лев Дабус

@MEnnabah Це добре працює для мене у Swift 4. Ви отримуєте помилку?
Метт Лонг

@LeoDabus, ви отримали ту ж помилку, що і ваша, ви її вирішили?
фрімен

замовлення JSONDecoder DateDecodingStrategy stackoverflow.com/a/46458771/2303865
LEO Dabus

@freeman Якщо ви хочете зберегти Дату з усіма її дробовими секундами, я пропоную використовувати подвійний (часовий проміжок від дати відліку) під час збереження / отримання вашої дати на сервер. І використовуйте стратегію декодування за замовчуванням дати, .deferredToDateколи використовуєте протокол Codable
Лео Дабус

6

Швидкий 5

Якщо ви орієнтовані на iOS 11.0+ / macOS 10.13+, ви просто використовуєте ISO8601DateFormatterпараметри withInternetDateTimeта withFractionalSeconds, наприклад:

let date = Date()

let iso8601DateFormatter = ISO8601DateFormatter()
iso8601DateFormatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
let string = iso8601DateFormatter.string(from: date)

// string looks like "2020-03-04T21:39:02.112Z"

5

Використання ISO8601DateFormatter на iOS10 або новіших версіях.

Використання DateFormatter на iOS9 або старше.

Швидкий 4

protocol DateFormatterProtocol {
    func string(from date: Date) -> String
    func date(from string: String) -> Date?
}

extension DateFormatter: DateFormatterProtocol {}

@available(iOS 10.0, *)
extension ISO8601DateFormatter: DateFormatterProtocol {}

struct DateFormatterShared {
    static let iso8601: DateFormatterProtocol = {
        if #available(iOS 10, *) {
            return ISO8601DateFormatter()
        } else {
            // iOS 9
            let formatter = DateFormatter()
            formatter.calendar = Calendar(identifier: .iso8601)
            formatter.locale = Locale(identifier: "en_US_POSIX")
            formatter.timeZone = TimeZone(secondsFromGMT: 0)
            formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSSXXXXX"
            return formatter
        }
    }()
}

5

Щоб подякувати Андресу Торесу Маррокіну та Лео Дабусу, у мене є версія, яка зберігає дробові секунди. Я не можу знайти його документально ніде, але Apple урізає дробові секунди до мікросекунди (3 цифри точності) як на вході, так і на виході (навіть якщо це визначено за допомогою SSSSSSS, всупереч Unicode tr35-31 ).

Я наголошую, що це, мабуть, не потрібно для більшості випадків використання . Дати в Інтернеті, як правило, не потребують мілісекундної точності, а коли це відбувається, часто краще використовувати інший формат даних. Але іноді треба взаємодіяти з існуючою системою певним чином.

Xcode 8/9 та Swift 3.0-3.2

extension Date {
    struct Formatter {
        static let iso8601: DateFormatter = {
            let formatter = DateFormatter()
            formatter.calendar = Calendar(identifier: .iso8601)
            formatter.locale = Locale(identifier: "en_US_POSIX")
            formatter.timeZone = TimeZone(identifier: "UTC")
            formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSSSSSXXXXX"
            return formatter
        }()
    }

    var iso8601: String {
        // create base Date format 
         var formatted = DateFormatter.iso8601.string(from: self)

        // Apple returns millisecond precision. find the range of the decimal portion
         if let fractionStart = formatted.range(of: "."),
             let fractionEnd = formatted.index(fractionStart.lowerBound, offsetBy: 7, limitedBy: formatted.endIndex) {
             let fractionRange = fractionStart.lowerBound..<fractionEnd
            // replace the decimal range with our own 6 digit fraction output
             let microseconds = self.timeIntervalSince1970 - floor(self.timeIntervalSince1970)
             var microsecondsStr = String(format: "%.06f", microseconds)
             microsecondsStr.remove(at: microsecondsStr.startIndex)
             formatted.replaceSubrange(fractionRange, with: microsecondsStr)
        }
         return formatted
    }
}

extension String {
    var dateFromISO8601: Date? {
        guard let parsedDate = Date.Formatter.iso8601.date(from: self) else {
            return nil
        }

        var preliminaryDate = Date(timeIntervalSinceReferenceDate: floor(parsedDate.timeIntervalSinceReferenceDate))

        if let fractionStart = self.range(of: "."),
            let fractionEnd = self.index(fractionStart.lowerBound, offsetBy: 7, limitedBy: self.endIndex) {
            let fractionRange = fractionStart.lowerBound..<fractionEnd
            let fractionStr = self.substring(with: fractionRange)

            if var fraction = Double(fractionStr) {
                fraction = Double(floor(1000000*fraction)/1000000)
                preliminaryDate.addTimeInterval(fraction)
            }
        }
        return preliminaryDate
    }
}

На мій погляд, це найкраща відповідь, оскільки вона дозволяє досягти рівня мікросекунди точності, коли всі інші рішення стикаються з мілісекундами.
Майкл А. Макклоскі

Якщо ви хочете зберегти Дату з усіма її дробовими секундами, під час збереження / отримання вашої дати на сервер слід використовувати лише подвійний (часовий інтервал з моменту опорної дати).
Лев Дабус

@LeoDabus так, якщо ви керуєте всією системою і не потрібно взаємодіяти. Як я вже говорив у відповіді, для більшості користувачів це не потрібно. Але ми не завжди маємо контроль над форматуванням даних у веб-API, і оскільки Android та Python (принаймні) зберігають 6 цифр дробової точності, іноді потрібно дотримуватися відповідності.
Елі Берк

3

У моєму випадку мені доведеться перетворити стовпець DynamoDB - lastUpdated (Unix Timestamp) у звичайний час.

Початкове значення останнього оновленого становило: 1460650607601 - переведено до 2016-04-14 16:16:47 +0000 через:

   if let lastUpdated : String = userObject.lastUpdated {

                let epocTime = NSTimeInterval(lastUpdated)! / 1000 // convert it from milliseconds dividing it by 1000

                let unixTimestamp = NSDate(timeIntervalSince1970: epocTime) //convert unix timestamp to Date
                let dateFormatter = NSDateFormatter()
                dateFormatter.timeZone = NSTimeZone()
                dateFormatter.locale = NSLocale.currentLocale() // NSLocale(localeIdentifier: "en_US_POSIX")
                dateFormatter.dateFormat =  "yyyy-MM-dd'T'HH:mm:ssZZZZZ"
                dateFormatter.dateFromString(String(unixTimestamp))

                let updatedTimeStamp = unixTimestamp
                print(updatedTimeStamp)

            }

3

Надалі формат може знадобитися змінити, що може бути невеликим болем у голові, у якому дата.dateFromISO8601 дзвонить скрізь у програмі. Використовуйте клас та протокол, щоб завершити реалізацію, змінити виклик формату дати в одному місці буде простішим. Якщо можливо, використовуйте RFC3339, його більш повне представлення. DateFormatProtocol і DateFormat чудово підходять для введення залежностей.

class AppDelegate: UIResponder, UIApplicationDelegate {

    internal static let rfc3339DateFormat = "yyyy-MM-dd'T'HH:mm:ssZZZZZ"
    internal static let localeEnUsPosix = "en_US_POSIX"
}

import Foundation

protocol DateFormatProtocol {

    func format(date: NSDate) -> String
    func parse(date: String) -> NSDate?

}


import Foundation

class DateFormat:  DateFormatProtocol {

    func format(date: NSDate) -> String {
        return date.rfc3339
    }

    func parse(date: String) -> NSDate? {
        return date.rfc3339
    }

}


extension NSDate {

    struct Formatter {
        static let rfc3339: NSDateFormatter = {
            let formatter = NSDateFormatter()
            formatter.calendar = NSCalendar(calendarIdentifier: NSCalendarIdentifierISO8601)
            formatter.locale = NSLocale(localeIdentifier: AppDelegate.localeEnUsPosix)
            formatter.timeZone = NSTimeZone(forSecondsFromGMT: 0)
            formatter.dateFormat = rfc3339DateFormat
            return formatter
        }()
    }

    var rfc3339: String { return Formatter.rfc3339.stringFromDate(self) }
}

extension String {
    var rfc3339: NSDate? {
        return NSDate.Formatter.rfc3339.dateFromString(self)
    }
}



class DependencyService: DependencyServiceProtocol {

    private var dateFormat: DateFormatProtocol?

    func setDateFormat(dateFormat: DateFormatProtocol) {
        self.dateFormat = dateFormat
    }

    func getDateFormat() -> DateFormatProtocol {
        if let dateFormatObject = dateFormat {

            return dateFormatObject
        } else {
            let dateFormatObject = DateFormat()
            dateFormat = dateFormatObject

            return dateFormatObject
        }
    }

}

3

Існує новий ISO8601DateFormatterклас, який дозволить вам створити рядок лише з одним рядком. Для зворотної сумісності я використовував стару C-бібліотеку. Сподіваюся, це комусь корисно.

Swift 3.0

extension Date {
    var iso8601: String {
        if #available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *) {
            return ISO8601DateFormatter.string(from: self, timeZone: TimeZone.current, formatOptions: .withInternetDateTime)
        } else {
            var buffer = [CChar](repeating: 0, count: 25)
            var time = time_t(self.timeIntervalSince1970)
            strftime_l(&buffer, buffer.count, "%FT%T%z", localtime(&time), nil)
            return String(cString: buffer)
        }
    }
}

1

Щоб доповнити версію Лео Дабуса, я додав підтримку проектів, написаних Swift та Objective-C, а також додав підтримку додаткових мілісекунд, напевно, не найкраще, але ви зрозумієте:

Xcode 8 і Swift 3

extension Date {
    struct Formatter {
        static let iso8601: DateFormatter = {
            let formatter = DateFormatter()
            formatter.calendar = Calendar(identifier: .iso8601)
            formatter.locale = Locale(identifier: "en_US_POSIX")
            formatter.timeZone = TimeZone(secondsFromGMT: 0)
            formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSSXXXXX"
            return formatter
        }()
    }

    var iso8601: String {
        return Formatter.iso8601.string(from: self)
    }
}


extension String {
    var dateFromISO8601: Date? {
        var data = self
        if self.range(of: ".") == nil {
            // Case where the string doesn't contain the optional milliseconds
            data = data.replacingOccurrences(of: "Z", with: ".000000Z")
        }
        return Date.Formatter.iso8601.date(from: data)
    }
}


extension NSString {
    var dateFromISO8601: Date? {
        return (self as String).dateFromISO8601
    }
}

0

Без деяких ручних струнних масок або TimeFormatters

import Foundation

struct DateISO: Codable {
    var date: Date
}

extension Date{
    var isoString: String {
        let encoder = JSONEncoder()
        encoder.dateEncodingStrategy = .iso8601
        guard let data = try? encoder.encode(DateISO(date: self)),
        let json = try? JSONSerialization.jsonObject(with: data, options: .allowFragments) as?  [String: String]
            else { return "" }
        return json?.first?.value ?? ""
    }
}

let dateString = Date().isoString

Це хороша відповідь, але використання .iso8601не буде включати мілісекунд.
Стефан Аренц

0

На основі прийнятної відповіді в парадигмі об'єкта

class ISO8601Format
{
    let format: ISO8601DateFormatter

    init() {
        let format = ISO8601DateFormatter()
        format.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
        format.timeZone = TimeZone(secondsFromGMT: 0)!
        self.format = format
    }

    func date(from string: String) -> Date {
        guard let date = format.date(from: string) else { fatalError() }
        return date
    }

    func string(from date: Date) -> String { return format.string(from: date) }
}


class ISO8601Time
{
    let date: Date
    let format = ISO8601Format() //FIXME: Duplication

    required init(date: Date) { self.date = date }

    convenience init(string: String) {
        let format = ISO8601Format() //FIXME: Duplication
        let date = format.date(from: string)
        self.init(date: date)
    }

    func concise() -> String { return format.string(from: date) }

    func description() -> String { return date.description(with: .current) }
}

позивний

let now = Date()
let time1 = ISO8601Time(date: now)
print("time1.concise(): \(time1.concise())")
print("time1: \(time1.description())")


let time2 = ISO8601Time(string: "2020-03-24T23:16:17.661Z")
print("time2.concise(): \(time2.concise())")
print("time2: \(time2.description())")
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.