TimeZone — 개념, Foundation 클래스 및 시간대

Foundation에서 TimeZone이란?

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 릴리스에 이 데이터베이스의 스냅샷을 제공하여 네트워크 요청 없이 모든 기기에서 일관된 계산을 보장합니다.

iOS 및 macOS에서 TimeZone의 작동 방식

아키텍처 Foundation의 TimeZone은 2계층 시스템으로 구축됩니다: 시간대 식별자(사람이 읽을 수 있는 이름)와 숫자 표현(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는 “지역/도시”(대륙/도시) 형식을 사용합니다. 여기서 지역은 대륙 중 하나(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("GMT로부터 MSK 초: \(moscowTimeZone.secondsFromGMT())")
}

// 오프셋으로 식별자 찾기
let utcPlus3 = TimeZone(secondsFromGMT: 10800)
print("식별자: \(utcPlus3.identifier)")

약어 TimeZone.abbreviationDictionary에는 알려진 모든 시간대의 약어가 포함되어 있지만, 이 사전은 고유성을 보장하지 않습니다: PST 키는 America/Los_Angeles 또는 Pacific/Pago_Pago 중 하나에 해당할 수 있습니다. 프로덕션 코드의 경우 항상 IANA 식별자를 사용하세요.

일광 절약 시간과 TimeZone

TimeZone은 일광 절약 시간(DST)이 시행되는 모든 지역에서 자동으로 DST 전환을 고려합니다. 시스템은 IANA Time Zone Database의 기록 데이터를 사용하며, 각 시간대의 정확한 전환 날짜가 포함되어 있습니다. isDaylightSavingTime 속성은 시간대가 현재 일광 절약 시간인 경우 true를 반환합니다.

nextDaylightSavingTimeTransition 메서드를 사용하면 다음 전환 날짜를 알 수 있어 향후 이벤트 계획에 유용합니다. 이 기능은 브라질이나 모로코처럼 DST 규칙이 자주 변경되는 지역에서 특히 중요합니다 — 2024년까지 브라질은 매년 전환 날짜를 변경했으며 수동 계산으로 인해 애플리케이션에 오류가 발생했습니다.

Apple WWDC 2023에 따르면, Foundation의 기반이 되는 ICU 라이브러리(International Components for Unicode)는 iOS 업데이트마다 DST 데이터를 업데이트합니다. 애플리케이션은 시스템 업데이트 후 하루 이상 일광 절약 시간 데이터를 캐시해서는 안 됩니다 — IANA 데이터베이스는 OS 버전 업데이트 없이도 시간대 조정을 통해 변경될 수 있습니다.

import Foundation

// Europe/Moscow의 DST 확인
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시간이 될 수 있으며, 로그나 기록 데이터에 중요합니다.

Swift의 TimeZone: 코드 예제

특정 시간대로 날짜 형식 지정은 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의 경우 메서드는 러시아어 이름 “Moskva”를 반환하고, 영어 로케일의 경우 “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)")

시간대 식별자 직렬화는 데이터베이스나 UserDefaults에 TimeZone을 저장하는 가장 좋은 방법입니다. 식별자(Europe/Moscow와 같은 문자열)를 저장하고 초 단위 오프셋이나 약어는 저장하지 마세요. DST 변경에 따라 오프셋이 변경될 수 있으며 약어는 모호합니다. 복원: TimeZone(identifier: savedString).

TimeZone 사용 시 흔한 실수

시간대 식별자 대신 고정 오프셋 사용은 가장 흔한 실수입니다. TimeZone(secondsFromGMT: 10800)은 DST를 고려하지 않으므로 여름철 Europe/Moscow의 경우 이 구성은 1시간의 잘못된 오프셋을 제공합니다. 일광 절약 시간이 있는 지역에는 항상 IANA 식별자를 사용하세요.

TimeZone(identifier:) 초기화 시 nil 처리 누락은 두 번째로 흔한 오류입니다. 사용자가 잘못된 식별자(예: “Europe/Moscow” 대신 “moscow”)를 입력하면 생성자가 nil을 반환합니다. 옵셔널 값을 처리하지 않으면 앱이 런타임 오류로 충돌합니다. guard let 또는 알려진 폴백과 함께 TimeZone(identifier:)을 사용하세요.

미래 날짜 작업 시 DST 무시. TimeZone.secondsFromGMT(for:)는 특정 날짜의 오프셋을 얻는 유일한 올바른 방법입니다. 기록 또는 미래 날짜에 대해 매개변수 없이 secondsFromGMT()를 사용하면 현재 순간의 오프셋이 반환되어 지정된 날짜의 실제 오프셋과 일치하지 않을 수 있으며, 특히 DST를 폐지하거나 도입한 지역에서 두드러집니다.

Stack Overflow(2024)에 따르면, DateFormatter 관련 질문의 약 15%가 잘못된 timeZone 구성과 관련됩니다. 일반적인 시나리오: 서버가 UTC로 날짜를 보내고 개발자가 포맷터의 timeZone을 설정하지 않고 형식을 지정하면 날짜가 기기의 시간대로 표시되어 다른 지역의 사용자에게 혼란을 야기합니다. 규칙: 서버 데이터의 경우 항상 포맷터의 timeZone을 명시적으로 설정하세요.