지역 서식 관리

텍스트 필드와 날짜 및 시간 선택기(picker) 같은 관련 컴포넌트는 로케일(locale)별 서식 패턴을 자동으로 적용합니다. 여기에는 숫자, 날짜, 시간 및 통화 서식이 포함됩니다. 이러한 패턴은 시스템 로케일이나 애플리케이션 내에서 설정한 사용자 정의 로케일에 의해 결정되어, 여러 플랫폼에서 일관된 데이터 표시를 보장합니다.

로케일 서식 패턴

Compose Multiplatform의 서식 지정은 다음 항목에 대해 플랫폼별 로케일 관례를 준수합니다:

숫자 구분 기호(Numeric separators): 천 단위 구분 기호로 쉼표나 마침표를 사용할 수 있습니다. 예를 들어 en-US에서는 1,234.56이지만 de-DE에서는 1.234,56입니다.
날짜/시간 패턴: 12월 1일은 en-US에서 12/1/20으로 표시되는 반면, fr-CA에서는 2020-12-01로 표시됩니다.
통화 기호 및 위치: 지역 통화 기호는 숫자 앞이나 뒤에 올 수 있습니다. en-US에서는 $5,001이고 fr-FR에서는 5.001,00 €입니다.

이러한 지역 서식은 시스템 로케일과 앱에 정의된 사용자 정의 로케일 재정의(override) 모두에서 별도의 설정 없이도(out of the box) 작동합니다.

서식 지정은 현재 iOS에서는 kotlinx-datetime 라이브러리를 사용하고, Android 및 데스크톱에서는 JDK API를 사용하여 구현됩니다. 다음은 iOS 소스 세트에서 로컬라이즈된 날짜 및 통화 값을 관리하는 예제입니다:

kotlin

import androidx.compose.foundation.layout.Column
import androidx.compose.material.Text
import androidx.compose.runtime.Composable
import kotlinx.datetime.Clock
import kotlinx.datetime.TimeZone
import kotlinx.datetime.todayIn
import platform.Foundation.NSNumber
import platform.Foundation.NSNumberFormatter
import platform.Foundation.NSNumberFormatterCurrencyStyle
import platform.Foundation.NSLocale
import platform.Foundation.currentLocale

@Composable
fun RegionalFormatExample() {
    val currentLocale = NSLocale.current
    val languageCode = currentLocale.languageCode 
    val countryCode = currentLocale.countryCode 

    // 통화로 서식을 지정할 샘플 값
    val amount = 1234.56

    // iOS에서 통화 서식 지정을 위해 NSNumberFormatter를 사용합니다.
    val currencyFormatter = NSNumberFormatter().apply { 
        numberStyle = NSNumberFormatterCurrencyStyle
        locale = currentLocale
    }
    val formattedCurrency = currencyFormatter.stringFromNumber(NSNumber(amount)) 

    // `kotlinx-datetime`을 사용하여 현재 날짜를 가져옵니다.
    val today = Clock.System.todayIn(TimeZone.currentSystemDefault())
    val formattedDate = today.toString()

    Column {
        Text("Current language: $languageCode")
        Text("Current country: $countryCode")
        Text("Amount: $amount")
        Text("Formatted currency: $formattedCurrency")
        Text("Today's date: $formattedDate")
    }
}

일관된 서식 보장하기

통합된 멀티플랫폼 솔루션을 위한 공통 API는 없지만, 서식 지정 동작은 대부분의 경우 일관되게 유지됩니다. 지원되는 모든 지역에서 서식이 올바르게 지정되었는지 확인하려면 다음을 수행하세요:

큰 숫자, 음수 또는 0과 같은 에지 케이스(edge case)를 테스트하세요.
모든 대상 플랫폼에서 지원되는 모든 로케일에 대한 서식을 확인하세요.

다음 단계

앱 내 테마 및 언어와 같은 애플리케이션의 리소스 환경(resource environment)을 관리하는 방법을 알아보세요.

지역 서식 관리 ​

로케일 서식 패턴 ​

일관된 서식 보장하기 ​

다음 단계 ​

지역 서식 관리

로케일 서식 패턴

일관된 서식 보장하기

다음 단계