NSLocale

Overview 概要

You typically use a locale to format and interpret information about and according to the user’s customs and preferences. あなたは概してあるロケールを使うことで、ユーザの習慣と好みに従ってそしてそれについて情報を書式設定および解釈します。

You can initialize any number of locale instances with init(localeIdentifier:) using one of the locale identifiers found in the availableLocaleIdentifiers array. However, you usually use a locale configured to match the preferences of the current user. あなたは、任意の数のロケールインスタンスを初期化することがinit(localeIdentifier:)と、availableLocaleIdentifiers配列で見つかるロケール識別子の１つを使って可能です。しかしながら、あなたは通常は現在のユーザの環境設定に一致するよう構成設定されたあるロケールを使います。

Use the current property to get the locale matching the current user's preferences. If you need to be alerted when the user does make changes to region settings, register for the currentLocaleDidChangeNotification notification. Alternatively, you can use the autoupdatingCurrent property to get a locale that automatically updates with the user's configuration settings: currentプロパティを使って、現在のユーザの環境設定に合っているロケールを取得してください。ユーザが地域設定を変更する時にあなたが警告される必要があるならば、currentLocaleDidChangeNotification通知に登録してください。あるいはまた、あなたはautoupdatingCurrentプロパティを使ってロケールを取得できます、それはユーザの機器構成の設定で自動的に更新します。

let locale = NSLocale.autoupdatingCurrent

You can inspect a locale by reading its properties, as listed in Getting Information About a Locale. For properties containing a code or identifier, you can then obtain a string suitable for presentation to the user with the methods listed in Getting Display Information About a Locale. For example, you can report the user's language as a string localized in that language using the autoupdating locale obtained in the previous example: あなたは、あるロケールをそのプロパティを読み出すことによって調査できます、あるロケールについての情報を得るで一覧にされるように。コードまたは識別子を含んでいるプロパティに対して、あなたはユーザに提示するのに適した文字列をロケールについての表示情報を取得するで一覧にされるメソッドで入手できます。例えば、あなたはユーザの言語をその言語でローカライズされた文字列として報告することが、以前の例で入手される自動更新ロケールを使って可能です：

let code = locale.languageCode!
let language = locale.localizedString(forLanguageCode: code)!


print("\(language)")
// Prints "English" for locale en_US, "français" for fr_FR

You frequently use a locale in conjunction with a formatter. For example, the DateFormatter class has a locale property that ensures dates are converted to strings that match the user's expectations about date formatting. By default, this property indicates the user's current locale, which is usually the behavior you want, but you can instead set it to another locale instance to obtain a different output. See Data Formatting Guide for more information about working with formatters. あなたはしばしばフォーマッタと協力してロケールを使います。例えば、DateFormatterクラスはlocaleプロパティを持ちます、それはユーザが日付書式設定について期待する文字列へと日付が変換されることを確かにするものです。省略時には、このプロパティはユーザの現在のロケールを指し示します、それは通常あなたが望む挙動です、しかしあなたは代わりにそれを別のロケールインスタンスに設定することで異なる出力を手に入れることができます。Data Formatting Guideをフォーマッタを扱うことについてのさらなる情報として見てください。

NSLocale is toll-free bridged with its Core Foundation counterpart, CFLocale. See Toll-Free Bridging for more information on toll-free bridging. トールフリーブリッジに関する更なる情報としてToll-Free Bridgingを見てください。