[Localized Number] 2편: NumberFormatter를 이용한 국가별 숫자 표기 변환

목차

• 1편 - [Localized Number] 1편: 글로벌 서비스 숫자 표기에 대한 고민
• 2편 - [Localized Number] 2편: NumberFormatter를 이용한 국가별 숫자 표기 변환
• 3편 - [Localized Number] 3편: NumberFormatter의 제약사항과 보완점
• 4편 - [Localized Number] 4편: LocalizedNumberFormatter 구현하기
• 5편 - [Localized Number] 5편: LocalizedNumberField 라이브러리 만들기

🍬 NumberFormatter에서 사용할 주요 API

// Returns an NSNumber object created by parsing a given string.
open func string(from number: NSNumber) -> String?
    
// Returns a string containing the formatted value of the provided number object.
func string(from: NSNumber) -> String?
    
// Returns a localized number string with the specified style.
@available(iOS 4.0, *)
open class func localizedString(from num: NSNumber, number nstyle: NumberFormatter.Style) -> String

• NumberFormatter - Topics- Converting Between Numbers and Strings 참고

1. numberFormatter에 locale을 설정합니다.

NumberFormatter의 Locale을 설정하는 방법은 두 가지가 있습니다.

1-1 ) identifier 직접 설정

let numberFormatter: NumberFormatter = NumberFormatter()
numberFormatter.locale = Locale(identifier: "en_US")

• 변환하고자하는 국가/언어의 identifier를 직접 설정할 수 있습니다.
  • 예시 코드의 en_US는 English (United States)의 identifier 입니다.
  • 찾고 싶은 iOS Locale Identifier가 있으면 이 문서를 참고해주세요
    • iOS Locale Identifier 별 숫자 표기

1-2) 유저의 지역 설정에 따름

// A locale representing the user's region settings at the time the property is read.
static var current: Locale { get }

• current 는 특정 국가/언어의 identifier를 넣어주지 않아도, 유저의 지역 설정을 따를 수 있게 해주는 Property 입니다.
• 참고 링크 - Apple Developer Documentation

let numberFormatter: NumberFormatter = NumberFormatter()
// numberFormatter.locale = .current (생략 가능)

• NumberFormatter에서는 locale을 따로 설정해주지 않으면 default로 .current가 설정 됩니다.

2. numberFormatter에 numberStyle을 설정한다.

let numberFormatter = NumberFormatter()
numberFormatter.locale = Locale(identifier: "en_US") // << identifier here
numberFormatter.numberStyle = .decimal // 💛 소숫점까지 모두 커버하려면 decimal 필수

• numberStyle 지정 안해주면 Default가 .none이라서 integer로 변환됩니다. (NumberFormatter.Style.none)
• 더 많은 numberStyle는 문서 참고 - Apple Developer Documentation - NumberFormatter.Style

3. Number String을 변환한다.

3-1. String to NSNumber

// 3-1 Number String -> NSNumber
let number: NSNumber = numberFormatter.number(from: "123456")

• 문서 참고 - Apple Developer Documentation - number(from:)

3-2. NSNumber to LocalizedString

// 3-2 NSNumber -> Number String
numberFormatter.numberStyle = .decimal
let localizedNumberString = numberFormatter.string(from: number)

• 문서 참고 - Apple Developer Documentation - string(from:)
• NumberFormatter에 변환하고자 하는 numberStyle을 설정할 수 있다.
  • Apple Developer Documentation - NumberFormatter.Style

---

🔜 .. 3편에서 계속 .. 🔜