[Swift] Date, DateFormatter

이 글은 아래 링크 원문의 번역본입니다.
https://iharishsuthar.github.io/posts/swift-date/

Swift Date

캘린더나 time zone에 독립적인 시간의 특정 지점.

Date & Time

Swift에서 Date() 의 값은 시간의 단일 시점(a single point in time) 을 캡슐화합니다. 이것은 특정 시간대(time zone)나 달력 시스템(calendarical system)에 독립적입니다. 이를 달성하기 위해, Date() 값은 January 1, 2001 at 00:00:00 UTC 라는 기준 날짜로부터 상대적인 오프셋으로 초 수를 세는 64비트 부동소수점 숫자로서 저장됩니다.

Date 타입은 Foundation 프레임워크의 일부입니다. 따라서 iOS, watchOS, macOS, Catalyst, tvOS에서 날짜를 다룰 때 사용되는 기본 타입입니다.

참고: UTC는 Coordinated Universal Time을 나타냅니다.

우선 현재 날짜/시간을 나타내는 변수를 생성하고, 그 결과를 출력해 봅니다.

let now = Date()
print("Current date/time: \(now)")

위의 Swift 코드를 통해, 기본 날짜/시간 output이 UTC 기준의 ISO8601-포맷 문자열로 출력된다는 것을 알 수 있습니다.

let timestamp = Date().timeIntervalSince1970
print("Number of seconds since ref date: \(timestamp)")

위의 Swift코드는 기준 날짜(January 1, 1970 at 00:00:00 UTC)로부터 상대적인 초의 수를 출력합니다.

참고: timeIntervalSince1970 프로퍼티의 값은, 만약 date 객체가 기준 날짜(January 1, 1970 at 00:00:00 UTC) 보다 빠르면 음수를 반환합니다.

하지만 Swift의 진짜 다양한 기능들의 이점은 DateFormatter, Locale, 그리고 Calendar 를 사용하는 데서 나옵니다. 이것은 Swift가 시간대(timezones), 지역화된 날짜 포맷(localized date formats), 그리고 달력 산술(예를 들어, 1달 전, 5일 후 등등)을 지원하는 방법입니다.

DateFormatter 는 날짜와 그것의 텍스트 표상 간의 변환 작업을 할 수 있도록 해줍니다.

Date에서 String으로 변환하기 - Date와 Locale 포맷팅하기

Date 타입을 앱의 유저들에게 보여주고 싶을 때, 어떻게 Date 를 String 으로 변환할 수 있습니까?

let now = Date()

let dtFormatter = DateFormatter()
dtFormatter.dateStyle = .full
dtFormatter.timeStyle = .full

let formattedDateTime = dtFormatter.string(from: now)
print(formattedDateTime)

위의 Swift 코드는 콘솔에 Monday, March 01, 2021 at 9:00:00 AM India Standard Time 을 출력했습니다.

우리는 dateStyle 과 timeStyle 프로퍼티를 통해 다양한 평태를 선택할 수 있습니다. 둘은 모두 [DateFormatter.Style](http://DateFormatter.Style) enum으로부터 값을 가져옵니다. 우리는 dateStyle 과 timeStyle 을 조합해 날짜 또는 시간을, 또는 둘 다 포함시킬지 결정할 수 있습니다. 아래의 리스트는 각각의 style들이 할 수 있는 것을 나타냅니다:

DateFormatter.Style	Date	Time
.none	(nothing!)	(nothing!)
.short	1/3/21	9:15 AM
.medium	Mar 1, 2021	9:15:09 AM
.long	March 1, 2021	9:15:09 AM GMT+5:30
.full	Monday, March 1, 2021	9:15:09 AM India Standard Time

정확한 날짜 포맷은 시스템의 locale에 의존합니다. locale이 무엇입니까? 요약하자면, locale은 사용자의 언어, 지역(또는 국가), 그리고 추가적인 설정을 결정하는 파라미터들의 집합입니다.

위의 표는 en_IN locale로 생성되었습니다. 이것은 날짜와 시간 포맷팅에 인도 영어 style을 사용한다는 것을 의미합니다: AM/PM, 월/일/연 으로. 이를 세계의 다른 국가와 비교해 보면, 24시간제를 사용하고, 일-월-연 형식입니다. 왜 locale이 중요한지 알 수 있습니다.

당신의 시스템의 locale이 무엇인지 알고 싶다면, 아래 코드를 실행해 결과를 확인하십시오.

let dtFormatter = DateFormatter()
print(dtFormatter.locale ?? "N/A")

DateFormatter 객체는 기본적으로 아이폰의 시스템 locale을 사용합니다. DateFormatter 객체를 만들고, dateStyle 과 timeStyle 을 사용하고, 그 다음 string(from:) 을 사용한다면, 사용자의 locale에 맞는 날짜/시간 텍스트 표상을 만들었다는 것을 거의 확신할 수 있습니다.

커스텀 날짜/시간 포맷을 만들고 싶은 경우에는 아래와 같이 할 수 있습니다:

let now = Date()

let dtFormatter = DateFormatter()
dtFormatter.locale = Locale(identifier: "en_GB")
dtFormatter.setLocalizedDateFormatFromTemplate("dd-MM-yyyy")

let formattedDateTime = dtFormatter.string(from: now)
print(formattedDateTime)

위의 Swift 코드는 영국에서 일반적인 날짜 형식을 출력합니다. 대쉬(-)를 사용해 일-월-연 순으로 나타냅니다.

String에서 Date 로 변환하기 - Date 와 Timezone 파싱하기

String을 Date로 변환해야 하는 몇몇 유스케이스가 있습니다:

• 데이터베이스로부터 ISO8601 String을 받고, 그것을 Swift에서 Date로 변환해야 할 때
• 데이터베이스에서 Unix 타임스탬프를 저장했고, 그것을 Swift에서 Date로 변환해야 할 때
• 우리가 다루는 데이터가 특정 날짜 포맷을 가지고 있고, 그것을 Swift에서 Date로 변환해야 할 때

let dtFormatter = DateFormatter()
dtFormatter.dateFormat = "dd-MM-yyyy HH:mm:ss Z"

if let dt = dtFormatter.date(from: "01-03-2021 09:15:07 +0530") {
    print(dt)
}

위의 Swift코드는 “2021-03-01 03:45:07 +0000”을 콘솔에 출력합니다.

우리는 날짜 문자열과 출력된 Date객체 사이의 불일치를 확인할 수 있습니다. 우리는 09:15:07이라고 명시했는데, Date객체가 출력되어 나올 때는 03:45:07이라는 값을 얻었습니다. 그 이유가 무엇입니까?

내가 위의 코드를 실행한 Mac은 인도 표준시(IST)로 설정되어 있습니다. 인도 표준시는 UTC(Coordinated Universal Time)보다 5시간 반이 빠릅니다. +0000을 보고, 우리는 출력된 datetime 객체가 timezone offset을 갖지 않음을 확인할 수 있습니다 - 즉 UTC 시간입니다.

우리는 Mac 또는 iPhone의 timezone을 아래 코드로 확인할 수 있습니다:

let timeZone = TimeZone.current
print(timeZone)

위의 Swift 코드는 내 Mac의 콘솔에서 “Asia/Kolkata (current)”을 출력합니다.

Swift의 ISO8601DateFormatter 클래스는 ISO 8061 날짜/시간 포맷을 나타냅니다. 이것은 timezone이나 locale로부터 우리를 자유롭게 해 줍니다.

여기에 ISO8601DateFormatter 를 사용해 현재 날짜/시간을 출력하는 방법이 있습니다:

let now = Date()
let dtFormatter = ISO8601DateFormatter()
let formattedDateTime = dtFormatter.string(from: now)
print(formattedDateTime)

위의 Swift 코드는 콘솔에 “2021-03-01T09:15:07Z”를 출력합니다.

let dtFormatter = ISO8601DateFormatter()
if let dt = dtFormatter.date(from: "2021-03-01T09:15:07Z") {
    print(dt)
}

위의 Swift 코드는 ISO 8601 포맷의 날짜/시간 String을 Date객체로 변환하는 방법을 알려줍니다.

DateFormatter 의 포맷 옵션

아래의 표는 DateFormatter 에서 연(Year)에 사용 가능한 포맷 옵션을 나타냅니다:

Characters	Example	Description
y	2021	패딩이 없는 연도
yy	21	두 자리수 연도 (필요한 경우 0으로 패딩)
yyyy	2021	네 자리수 연도 (필요한 경우 0으로 패딩)

아래의 표는 DateFormatter 에서 분기(Quarter)에 사용 가능한 포맷 옵션을 나타냅니다:

Characters	Example	Description
Q	4	해당 연도의 분기
QQ	04	해당 연도의 분기. 0으로 패딩을 넣기 원할때 사용
QQQ	Q4	"Q" 를 포함한 분기
QQQQ	4th quarter	quarter 라는 문자 포함

아래의 표는 DateFormatter 에서 월(Month)에 사용 가능한 포맷 옵션을 나타냅니다:

Characters	Example	Description
M	3	숫자로 된 월
MM	03	숫자로 된 월. 0으로 패딩을 넣고 싶을 때 사용
MMM	Mar	월의 축약된 이름
MMMM	March	월의 전체 이름
MMMMM	M	월의 축약 이름

아래의 표는 DateFormatter 에서 일(Day)/요일에 사용 가능한 포맷 옵션을 나타냅니다:

Characters	Example	Description
d	1	월의 일
dd	01	월의 일. 0으로 패딩을 넣고 싶을 때 사용
F	1st Monday in March	월에서 그 주의 요일
E	Mon	그 주의 요일의 약자
EEEE	Monday	그 주의 요일의 전체 이름
EEEEE	M	그 주의 요일의 축약
EEEEEE	Mo	그 주의 요일의 약자

아래의 표는 DateFormatter 에서 시(Hour)에 사용 가능한 포맷 옵션을 나타냅니다:

Characters	Example	Description
h	9	12시간제 시간
hh	09	12시간제 시간 (0으로 패딩 포함)
H	21	24시간제 시간
HH	21	24시간제 시간 (0으로 패딩 포함)
a	AM	12시간제 형식에서의 오전/오후

아래의 표는 DateFormatter 에서 분(Minute)에 사용 가능한 포맷 옵션을 나타냅니다:

Characters	Example	Description
m	15	분
mm	15	분 (0으로 패딩 포함)

아래의 표는 DateFormatter 에서 초(Second)에 사용 가능한 포맷 옵션을 나타냅니다:

Characters	Example	Description
s	7	초
ss	07	초 (0으로 패딩 포함)
SSS	700	밀리초

아래의 표는 DateFormatter 에서 시간대(Time zone)에 사용 가능한 포맷 옵션을 나타냅니다:

Characters	Example	Description
zzz	IST	time zone의 3글자 이름. 이름이 알려지지 않은 경우 GMC-08:00으로 처리
zzzz	India Standard Time	time zone의 전체 이름. 이름이 알려지지 않은 경우 GMC-08:00으로 처리
ZZZZ	IST-05:30	time zone의 약자와 오프셋
Z	+0530	RFC 822 GMT 포맷
ZZZZZ	+05:30	ISO 8601 time zone 포맷

DateComponents 로 Date 를 생성하고 계산하기

DateComponents 는 날짜를 생성할 때만 유용한 것이 아닙니다 - 이것은 기간을 특정할 때도 도움이 됩니다. DateComponents 구조체는 특정 시점을 정의할 수 있고, 시점의 기간도 정의할 수 있습니다.

DateComponents 는 날짜의 컴포넌트(components)를 확장 가능하고 구조화된 방법으로 캡슐화합니다. 이것은 특정 달력의 날짜와 시간을 구성하는 임시 컴포넌트들을 제공함으로써 어떤 날짜를 특정하기 위해 사용됩니다: 시, 분, 초, 일, 월, 년 등등. 이것은 또한 시점의 기간을 나타낼 때도 쓰입니다 - 예를 들어, 5시간 16분. DateComponents는 모든 컴포넌트 부분을 선택적으로 정의 가능합니다.

let now = DateComponents(calendar: Calendar.current, year: 2021, month: 3, day: 1)
print(now)

위의 Swift 코드는 “calendar: gregorian (current) year: 2021 month: 3 day: 1 isLeapMonth: false” 를 콘솔에 출력합니다.

우리는 또한 특정 날짜에 더 많은 단위를 추가하기 위해 개별 날짜 컴포넌트들을 사용할 수 있습니다:

let now = DateComponents(calendar: Calendar.current, year: 2021, month: 3, day: 1)
if let dt = now.date, 
   let later = Calendar.current.date(byAdding: .month, value: 1, to: dt) {
    print(later)
}

위의 Swift 코드는 “2021-03-31 18:30:00 +0000”을 콘솔에 출력합니다. (기존 날짜에 month를 1개 더해 2021-03-01 에서 2021-03-31이 됨)

Calendar 와 DateComponents 를 사용함으로써, 특정 날짜의 시작과 끝을 얻을 수도 있습니다.

let todayStartOfDay = Calendar.current.startOfDay(for: Date())
let todayEndOfDay = Calendar.current.date(byAdding: DateComponents(day: 1),
                                                                                  to: todayStartOfDay)?.addingTimeInterval(-1)

print(todayStartOfDay)
print(todayEndOfDay!)

위의 Swift 코드는 현재 날짜의 시작과 끝을 콘솔에 출력합니다.

if let date: Date = DateComponents(calendar: Calendar.current, year: 2020, month: 3, day: 1).date {
    let units = Array<Calendar.Component>([.year, .month, .day, .hour, .minute, .second])
    let components = Calendar.current.dateComponents(Set(units), from: date, to: Date())

    for unit in units {
        guard let value = components.value(for: unit) else {
            continue
        }

        if value > 0 {
            print("\(value) \(unit)s ago")
        }
    }
}

위의 Swift 코드는 “11 months ago”, “27 days ago”, “22 hours ago”, “48 minutes ago”, 그리고 “16 seconds ago”를 콘솔에 출력합니다.

실제 Swift 개발에서 Date 와 extension 을 사용하는 예시

 extension Date {

    init?(value: String, format: String) {
        let dtFormatter = DateFormatter()
        dtFormatter.dateFormat = format

        if let date = dtFormatter.date(from: value) {
            self = date
        } else {
            return nil
        }
    }

    init?(value: String, format: String, timeZone: TimeZone? = nil) {
        let dtFormatter = DateFormatter()
        dtFormatter.dateFormat = format
        if let value = timeZone {
            dtFormatter.timeZone = value
        }

        if let date = dtFormatter.date(from: value) {
            self = date
        } else {
            return nil
        }
    }

    func to(format: String) -> String {
        let dtFormatter = DateFormatter()
        dtFormatter.dateFormat = format

        return dtFormatter.string(from: self)
    }

    func to(format: String, timeZone: TimeZone) -> String {
        let dtFormatter = DateFormatter()
        dtFormatter.dateFormat = format
        dtFormatter.timeZone = timeZone
        return dtFormatter.string(from: self)
    }

    func to(dateStyle: DateFormatter.Style, relativeFormatting: Bool = false, timeZone: TimeZone? = nil) -> String {
        let dtFormatter = DateFormatter()
        dtFormatter.dateStyle = dateStyle
        dtFormatter.doesRelativeDateFormatting = relativeFormatting
        if let value = timeZone {
            dtFormatter.timeZone = value
        }

        return dtFormatter.string(from: self)
    }
}

if let dt = Date(value: "2021-01-01T08:35:00", format: "yyyy-MM-dd'T'HH:mm:ss", timeZone: TimeZone(abbreviation: "UTC")) {
    print(dt.to(format: "dd-MM-yyyy", timeZone: (TimeZone(abbreviation: "IST") ?? TimeZone.current)))
}

위의 Swift 코드는 “01-01-2021”을 콘솔에 출력합니다.

결론

Swift의 Date 구조체는 Swift로 개발하며 날짜와 시간을 다뤄야 할 때 매우 유용합니다. 하지만, 우리가 날짜 계산을 위해 알맞은 API를 사용하기만
한다면, 시스템이 우리를 위해 그 복잡성들을 다루어 줍니다.