TimeZone — τι είναι, η κλάση Foundation και οι ζώνες ώρας

Τι είναι το TimeZone στο Foundation;

TimeZone — είναι ένας τύπος τιμής στο Swift που παρέχει πληροφορίες σχετικά με μια γεωγραφική ζώνη ώρας: τη χρονική διαφορά σε σχέση με UTC, το όνομα, τη συντομογραφία και τους κανόνες μετάβασης σε θερινή ώρα. Στο Objective-C, η κλάση ονομάζεται NSTimeZone. Και οι δύο κλάσεις βασίζονται στην IANA Time Zone Database (γνωστή και ως βάση δεδομένων Olson), η οποία περιέχει το ιστορικό αλλαγών ζωνών ώρας από το 1970.

Κάθε στιγμιότυπο TimeZone αποθηκεύει ένα αναγνωριστικό ζώνης ώρας (π.χ. Europe/Moscow), την τρέχουσα χρονική διαφορά σε δευτερόλεπτα από UTC, τη σημαία isDaylightSavingTime και την ημερομηνία της επόμενης μετάβασης. Το αναγνωριστικό είναι το πρωτεύον κλειδί: κατά την αρχικοποίηση TimeZone(identifier:), το σύστημα φορτώνει την αντίστοιχη εγγραφή από τη βάση δεδομένων ζωνών ώρας της συσκευής.

Σύμφωνα με τα δεδομένα IANA (2024), η βάση δεδομένων περιέχει πάνω από 600 μοναδικά αναγνωριστικά ζωνών ώρας. Η Apple παρέχει ένα μέρος αυτής της βάσης σε κάθε έκδοση iOS και macOS, εγγυώμενη την ομοιομορφία των υπολογισμών σε όλες τις συσκευές χωρίς ανάγκη δικτυακών αιτημάτων.

Πώς λειτουργεί το TimeZone σε iOS και macOS;

Αρχιτεκτονική — το TimeZone στο Foundation είναι δομημένο σε ένα σύστημα δύο επιπέδων: ένα αναγνωριστικό ζώνης ώρας (ένα αναγνώσιμο από τον άνθρωπο όνομα) και η αριθμητική του αναπαράσταση (η διαφορά από UTC). Το σύστημα επιλέγει αυτόματα την τρέχουσα ζώνη ώρας από τις ρυθμίσεις της συσκευής, αλλά ο προγραμματιστής μπορεί να την παρακάμψει για συγκεκριμένες λειτουργίες μορφοποίησης.

Το TimeZone συνδέεται στενά με το Calendar και το DateFormatter. Κατά τη μορφοποίηση μιας ημερομηνίας, το DateFormatter χρησιμοποιεί την ιδιότητα timeZone ενός στιγμιότυπου TimeZone για να μετατρέψει την απόλυτη χρονική στιγμή (Date) σε μορφή κειμένου στην κατάλληλη ζώνη ώρας. Εάν δεν έχει οριστεί το timeZone, χρησιμοποιείται η προκαθορισμένη ζώνη ώρας του συστήματος — TimeZone.current.

Τύποι στιγμιότυπων TimeZone

Σημαντική απόχρωση: Το TimeZone(identifier:) επιστρέφει nil για άγνωστα αναγνωριστικά. Αυτή είναι μια συνήθης αιτία καταρρεύσεων της εφαρμογής — οι προγραμματιστές ξεχνούν να χειριστούν την προαιρετική τιμή, μεταβίβοντας λανθασμένο αναγνωριστικό από την είσοδο του χρήστη. Για τα αναγνωριστικά IANA, η πεζή/κεφαλαία γραμμή έχει σημασία: Europe/Moscow — σωστό, europe/moscow — nil.

Μορφές αναγνωριστικών ζωνών ώρας

IANA Time Zone Database χρησιμοποιεί τη μορφή "Περιοχή/Πόλη" (Continent/City), όπου η περιοχή είναι μία από τις ηπείρους (Africa, America, Asia, Atlantic, Australia, Europe, Indian, Pacific) ή ένας ωκεανός, και η πόλη είναι ο μεγαλύτερος οικισμός στη ζώνη της ζώνης ώρας. Αυτή η μορφή εγγυάται τη μοναδικότητα και την αναγνωσιμότητα του αναγνωριστικού.

Εκτός από την κύρια μορφή, το TimeZone υποστηρίζει τρεις επιπλέον μεθόδους αναγνώρισης: συντομογραφίες (MSK, EST, PST), τριγράμματους κωδικούς ζωνών ώρας (GMT, UTC) και αριθμητικές διαφορές (+0300, -0500). Ωστόσο, οι συντομογραφίες είναι αμφίσημες: το EST μπορεί να σημαίνει είτε Eastern Standard Time (GMT-5) είτε Eastern Summer Time (GMT+10) στην Αυστραλία. Η Apple συνιστά την αποκλειστική χρήση αναγνωριστικών IANA.

import Foundation

// Λήψη όλων των γνωστών αναγνωριστικών ζωνών ώρας
let allIdentifiers: [String] = TimeZone.knownTimeZoneIdentifiers
print("Σύνολο ζωνών ώρας: \(allIdentifiers.count)")

// Φιλτράρισμα ανά περιοχή
let europeZones = allIdentifiers.filter { $0.hasPrefix("Europe/") }
print("Ευρωπαϊκές ζώνες ώρας: \(europeZones)")

// Συντομογραφίες (δεν συνιστώνται για παραγωγή)
if let moscowTimeZone = TimeZone(abbreviation: "MSK") {
    print("Δευτερόλεπτα MSK από GMT: \(moscowTimeZone.secondsFromGMT())")
}

// Εύρεση αναγνωριστικού ανά υπολογισμό
let utcPlus3 = TimeZone(secondsFromGMT: 10800)
print("Αναγνωριστικό: \(utcPlus3.identifier)")

Συντομογραφίες στο TimeZone.abbreviationDictionary περιέχουν συντομογραφίες για όλες τις γνωστές ζώνες ώρας, αλλά αυτό το λεξικό δεν εγγυάται μοναδικότητα: το κλειδί PST μπορεί να αντιστοιχεί τόσο σε America/Los_Angeles όσο και σε Pacific/Pago_Pago. Σε κώδικα παραγωγής, να χρησιμοποιείτε πάντοτε αναγνωριστικά IANA.

Μετάβαση σε θερινή ώρα και TimeZone

TimeZone λαμβάνει αυτόματα υπόψη τη μετάβαση σε θερινή και χειμερινή ώρα (DST — Daylight Saving Time) για όλες τις περιοχές όπου εφαρμόζεται. Το σύστημα χρησιμοποιεί ιστορικά δεδομένα από την IANA Time Zone Database, που περιλαμβάνουν ακριβείς ημερομηνίες μετάβασης για κάθε ζώνη ώρας. Η ιδιότητα isDaylightSavingTime επιστρέφει true εάν η ζώνη ώρας βρίσκεται προς το παρόν σε θερινή ώρα.

Η μέθοδος nextDaylightSavingTimeTransition σας επιτρέπει να μάθετε την ημερομηνία της επόμενης μετάβασης, χρήσιμο για τον προγραμματισμό μελλοντικών συμβάντων. Αυτή η λειτουργία είναι ιδιαίτερα σημαντική για περιοχές με συχνές αλλαγές στους κανόνες DST, όπως η Βραζιλία ή το Μαρόκο — μέχρι το 2024, η Βραζιλία άλλαζε ετήσια τις ημερομηνίες μετάβασης, και ο χειροκίνητος υπολογισμός οδηγούσε σε σφάλματα στις εφαρμογές.

Σύμφωνα με τα δεδομένα Apple WWDC 2023, η βιβλιοθήκη ICU (International Components for Unicode), που βρίσκεται στη βάση του Foundation, ενημερώνει τα δεδομένα DST σε κάθε ενημέρωση iOS. Οι εφαρμογές δεν πρέπει να αποθηκεύουν στην κρυφή μνήμη δεδομένα για τη θερινή ώρα για περισσότερο από μία ημέρα μετά την ενημέρωση του συστήματος — η βάση IANA μπορεί να αλλάξει ακόμα και χωρίς ενημέρωση της έκδοσης λειτουργικού συστήματος μέσω διορθώσεων ζώνης ώρας.

import Foundation

// Έλεγχος DST για Europe/Moscow
let moscow = TimeZone(identifier: "Europe/Moscow")!
let now = Date()
let isMoscowDST = moscow.isDaylightSavingTime(for: now)
print("Η Μόσχα αυτήν τη στιγμή σε DST: \(isMoscowDST)")

// Λήψη ημερομηνίας επόμενης μετάβασης DST
if let nextTransition = moscow.nextDaylightSavingTimeTransition(
    after: now
) {
    let dstOffset = moscow.daylightSavingTimeOffset(
        for: nextTransition
    )
    print("Επόμενη μετάβαση: \(nextTransition), υπολογισμός DST: \(dstOffset)s")
}

// Ασφαλής μετατροπή με ενημερότητα DST
let newYork = TimeZone(identifier: "America/New_York")!
let offsetNY = newYork.secondsFromGMT(for: now)
print("Τρέχων υπολογισμός NY: \(offsetNY / 3600)h")

Κρίσιμη απόχρωση: Το secondsFromGMT(for:) λαμβάνει υπόψη το DST για την καθορισμένη ημερομηνία, ενώ το secondsFromGMT() μόνο για την τρέχουσα ώρα. Κατά τη μορφοποίηση ιστορικών ημερομηνιών, να χρησιμοποιείτε πάντοτε την έκδοση με παράμετρο Date: secondsFromGMT(for: someHistoricalDate). Η διαφορά μπορεί να φτάσει τις 1–2 ώρες, κρίσιμο για αρχεία καταγραφής ή ιστορικά δεδομένα.

TimeZone στο Swift: παραδείγματα κώδικα

Μορφοποίηση ημερομηνίας με συγκεκριμένη ζώνη ώρας — η πιο συνηθισμένη εργασία κατά την εργασία με TimeZone. Το DateFormatter χρησιμοποιεί την ιδιότητα timeZone για να μετατρέψει το Date σε κείμενο. Εάν δεν έχει οριστεί ρητά το timeZone, ο μορφοποιητής χρησιμοποιεί το TimeZone.current — τη ζώνη ώρας που έχει οριστεί στη συσκευή του χρήστη, που μπορεί να οδηγήσει σε απροσδόκητα αποτελέσματα για δεδομένα διακομιστή.

import Foundation

// Μορφοποίηση ημερομηνίας σε συγκεκριμένη ζώνη ώρας
let formatter = DateFormatter()
formatter.dateFormat = "yyyy-MM-dd HH:mm:ss"

let tokyo = TimeZone(identifier: "Asia/Tokyo")!
formatter.timeZone = tokyo
let tokyoTime = formatter.string(from: Date())
print("Ώρα Τόκυο: \(tokyoTime)")

// Διαθέσιμα αναγνωριστικά για επιλογή χρήστη
let displayNames: [(String, String)] = TimeZone.knownTimeZoneIdentifiers
    .prefix(20)
    .map { ($0, TimeZone(identifier: $0)!.localizedName(
        for: .generic, locale: .current
    )) }

// Σύγκριση δύο ζωνών ώρας
let london = TimeZone(identifier: "Europe/London")!
let difference = tokyo.secondsFromGMT(for: Date())
    - london.secondsFromGMT(for: Date())
print("Διαφορά Τόκυο-Λονδίνου: \(difference / 3600)h")

// Εργασία με λεξικό συντομογραφιών
let knownAbbrevs = TimeZone.abbreviationDictionary
for (abbr, ident) in knownAbbrevs.sorted(by: { $0.key < $1.key }).prefix(5) {
    print("\(abbr) -> \(ident)")
}

Μεταφρασμένο όνομα της ζώνης ώρας μέσω localizedName(for:locale:) επιστρέφει ένα αναγνώσιμο από τον άνθρωπο όνομα στην καθορισμένη γλώσσα. Για παράδειγμα, για Europe/Moscow με ρωσικό τοπικό, η μέθοδος θα επιστρέψει "Μόσχα", και με αγγλικό τοπικό — "Moscow Time". Οι διαθέσιμες στυλ είναι: .standard (κανονικό όνομα), .daylightSaving (θερινή ώρα) και .shortGeneric (σύντομο).

import Foundation

let paris = TimeZone(identifier: "Europe/Paris")!
let nameRU = paris.localizedName(
    for: .standard,
    locale: Locale(identifier: "ru_RU")
)
print("Ρωσικό όνομα: \(nameRU)")

// Έλεγχος εάν η περιοχή είναι στην ίδια μέρα
let isSameDay = Calendar.current.isDate(
    Date(),
    equalTo: Date(),
    toGranularity: .day
)
print("Ίδια μέρα σε διαφορετικές ζώνες ώρας: \(isSameDay)")

Σειριοποίηση του αναγνωριστικού ζώνης ώρας — η καλύτερη πρακτική για αποθήκευση TimeZone σε βάσεις δεδομένων ή UserDefaults. Αποθηκεύστε το αναγνωριστικό (συμβολοσειρά τύπου Europe/Moscow), όχι τη διαφορά σε δευτερόλεπτα ή τη συντομογραφία. Η διαφορά μπορεί να αλλάξει με την αλλαγή DST, και η συντομογραφία είναι αμφίσημη. Ανάκτηση: TimeZone(identifier: savedString).

Συνήθη λάθη κατά την εργασία με TimeZone

Χρήση σταθερής διαφοράς αντί για αναγνωριστικό ζώνης ώρας — το πιο συνηθισμένο λάθος. Το TimeZone(secondsFromGMT: 10800) δεν λαμβάνει υπόψη το DST, επομένως για Europe/Moscow το καλοκαίρι αυτή η κατασκευή δίνει λανθασμένη διαφορά 1 ώρας. Να χρησιμοποιείτε πάντοτε το αναγνωριστικό IANA για περιοχές με θερινή ώρα.

Παραμελημένη διαχείριση nil κατά την αρχικοποίηση TimeZone(identifier:) — το δεύτερο πιο συνηθισμένο λάθος. Εάν ο χρήστης εισάγει λανθασμένο αναγνωριστικό (π.χ. "moscow" αντί "Europe/Moscow"), ο κατασκευαστής επιστρέφει nil. Χωρίς διαχείριση της προαιρετικής τιμής, η εφαρμογή καταρρέει με σφάλμα εκτέλεσης. Χρησιμοποιήστε guard let ή TimeZone(identifier:) με γνωστό fallback.

Παράβλεψη του DST κατά την εργασία με μελλοντικές ημερομηνίες. Το TimeZone.secondsFromGMT(for:) είναι ο μόνος σωστός τρόπος για τη λήψη της διαφοράς για μια συγκεκριμένη ημερομηνία. Η χρήση του secondsFromGMT() χωρίς παράμετρο για ιστορικές ή μελλοντικές ημερομηνίες δίνει τη διαφορά για την τρέχουσα στιγμή, που μπορεί να μην αντιστοιχεί στην πραγματική διαφορά στην ημερομηνία αυτή, ιδιαίτερα για περιοχές με κατάργηση ή εισαγωγή DST.

Σύμφωνα με τα δεδομένα Stack Overflow (2024), περίπου 15% των ερωτήσεων σχετικά με το DateFormatter σχετίζονται με λανθασμένη ρύθμιση του timeZone. Τυπικό σενάριο: ο διακομιστής στέλνει ημερομηνία σε UTC, ο προγραμματιστής τη μορφοποιεί χωρίς να ορίσει το timeZone του μορφοποιητή, και η ημερομηνία εμφανίζεται στη ζώνη ώρας της συσκευής, δημιουργώντας σύγχυση σε χρήστες από διαφορετικές περιοχές. Κανόνας: να ορίζετε πάντοτε ρητά το timeZone του μορφοποιητή για δεδομένα διακομιστή.