<div id="readability-page-1" class="page"><div>Swift에서 날짜를 표시하고, 저장하고, 계산하는 작업을 자주 수행한다. iOS 15 이전에는 <code>DateFormatter</code>를 사용하여 이러한 작업을 처리해왔지만, 복잡하고 성능 비용이 높다는 단점이 있었다. iOS 15에서 Apple은 이러한 문제를 해결하기 위해 새로운 <code>Date.FormatStyle</code> API를 도입했다.<h2 id="기존-dateformatter의-한계점">기존 DateFormatter의 한계점<a href="#기존-dateformatter의-한계점"></a></h2>먼저, 새로운 방식의 장점을 이해하기 위해 기존 <code>DateFormatter</code>의 한계점을 살펴보자:<div><code><table><tbody><tr><td><pre>1
2
3
4
5
6
7
8
</pre></td><td><pre>// 기존 DateFormatter 방식
let dateFormatter = DateFormatter()
dateFormatter.dateStyle = .medium
dateFormatter.timeStyle = .short
dateFormatter.locale = Locale(identifier: "ko_KR")

let dateString = dateFormatter.string(from: Date())
// 2025년 4월 14일 오후 8:52
</pre></td></tr></tbody></table></code></div>이 방식에는 몇 가지 단점이 있다:<ul><li><code>DateFormatter</code> 인스턴스 생성 비용이 높다</li><li>여러 설정을 별도로 구성해야 한다</li><li>코드가 길어지고 가독성이 떨어진다</li><li>재사용을 위해 전역 인스턴스를 만들거나 캐싱 전략이 필요하다</li></ul><h2 id="ios-15의-새로운-접근-방식-dateformatstyle">iOS 15의 새로운 접근 방식: Date.FormatStyle<a href="#ios-15의-새로운-접근-방식-dateformatstyle"></a></h2>iOS 15에서는 <code>formatted()</code> 메서드와 <code>Date.FormatStyle</code>을 통해 더 간결하고 선언적인 방식으로 날짜 포맷팅을 수행할 수 있다.<h3 id="기본-사용법-formatted">기본 사용법: formatted()<a href="#기본-사용법-formatted"></a></h3>가장 간단한 형태로는 파라미터 없이 <code>formatted()</code>를 호출하는 것이다:<div><code><table><tbody><tr><td><pre>1
2
3
</pre></td><td><pre>let date = Date()
print(date.formatted())
// 2025. 4. 14. 8:28 PM (사용자 로캘에 따라 다름)
</pre></td></tr></tbody></table></code></div>이 메서드는 사용자의 현재 설정된 로캘과 지역 설정에 따라 자동으로 날짜를 포맷팅한다. 별도의 <code>DateFormatter</code> 인스턴스를 만들 필요가 없어 코드가 훨씬 간결해진다.<h3 id="커스텀-포맷-스타일-지정하기">커스텀 포맷 스타일 지정하기<a href="#커스텀-포맷-스타일-지정하기"></a></h3>더 세밀한 제어가 필요한 경우, <code>Date.FormatStyle</code>을 사용하여 원하는 형식을 지정할 수 있다:<div><code><table><tbody><tr><td><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
</pre></td><td><pre>let date = Date()

let formattedDate = date.formatted(
 .dateTime
 .year()
 .month(.wide)
 .day(.twoDigits)
 .hour(.defaultDigits(amPM: .abbreviated))
 .minute(.twoDigits)
 .timeZone(.identifier(.long))
 .weekday(.abbreviated)
)
// Mon, April 14, 2025 8:45 PM Asia/Seoul
</pre></td></tr></tbody></table></code></div>이 방식의 장점은 메서드 체이닝을 통해 원하는 요소만 선택적으로 포함할 수 있다는 점이다. 각 구성 요소에 대해 다양한 표시 옵션을 선택할 수 있어 높은 수준의 커스터마이징이 가능하다.<h3 id="간결한-스타일-프리셋-사용하기">간결한 스타일 프리셋 사용하기<a href="#간결한-스타일-프리셋-사용하기"></a></h3>더 빠르게 날짜와 시간 형식을 지정하려면, 미리 정의된 스타일을 활용할 수 있다:<div><code><table><tbody><tr><td><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
</pre></td><td><pre>let date = Date()

// 날짜만 표시 (시간 생략)
print(date.formatted(date: .complete, time: .omitted))
// Monday, April 14, 2025

// 시간만 표시 (날짜 생략)
print(date.formatted(date: .omitted, time: .complete))
// 8:52:28 PM GMT+9

// 날짜와 시간 모두 간략하게 표시
print(date.formatted(date: .abbreviated, time: .shortened))
// April 14, 2025 at 8:52 PM
</pre></td></tr></tbody></table></code></div><code>Date.FormatStyle.DateStyle</code>과 <code>Date.FormatStyle.TimeStyle</code> 열거형은 다양한 프리셋을 제공한다:<ul><li><code>.complete</code>: 모든 구성 요소를 포함한 완전한 형식</li><li><code>.long</code>: 상세한 형식</li><li><code>.abbreviated</code>: 축약된 형식</li><li><code>.numeric</code>: 숫자만 사용한 형식</li><li><code>.omitted</code>: 해당 부분 생략</li></ul><h3 id="로캘-지정하기">로캘 지정하기<a href="#로캘-지정하기"></a></h3>사용자의 현재 로캘이 아닌 특정 로캘로 날짜를 포맷팅하려면 다음과 같이 할 수 있다:<div><code><table><tbody><tr><td><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
</pre></td><td><pre>let date = Date()
let koreanStyle = Date.FormatStyle(locale: Locale(identifier: "ko_KR"))
let englishStyle = Date.FormatStyle(locale: Locale(identifier: "en_US"))

print(date.formatted(koreanStyle))
// 2025. 4. 14. 오후 8:52
print(date.formatted(englishStyle))
// 4/14/2025, 8:52 PM

let birthday = Date()
birthday.formatted(
	.dateTime
 .year()
 .month(.wide)
 .day(.twoDigits)
 .hour(.defaultDigits(amPM: .abbreviated))
 .minute(.twoDigits)
 .locale(Locale(identifier: "ko_KR"))	// 로캘 지정
)
// 2025년 4월 14일 오후 8:52
</pre></td></tr></tbody></table></code></div>로캘을 명시적으로 지정하면 사용자의 기기 설정과 관계없이 일관된 형식으로 날짜를 표시할 수 있다.<h2 id="결론">결론<a href="#결론"></a></h2>iOS 15의 <code>Date.FormatStyle</code>은 Swift에서 날짜 포맷팅을 더 간결하고, 선언적이며, 효율적으로 만들었다. 이 API를 사용하면 코드의 가독성이 향상되고, 유지 관리가 쉬워진다. iOS 15 이상을 지원하는 앱에서는 가능한 한 <code>Date.FormatStyle</code>을 활용하여 날짜 관련 기능을 구현하는 것이 좋다. 참고 <a href="https://developer.apple.com/documentation/foundation/date/formatted%28%29" target="_blank">formatted()</a><a href="https://developer.apple.com/documentation/foundation/date/formatstyle" target="_blank">Date.FormatStyle</a></div></div>

iOS 15에서 Date.FormatStyle을 사용하여 Swift에서 날짜 서식 지정하기

댓글