Structure

Locale

Information about linguistic, cultural, and technological conventions for use in formatting data for presentation. 提示用にデータの体裁を整えるのに使う言語的、文化的、そして技術的な慣行についての情報。

Declaration 宣言 

struct Locale

Overview 概要

Locale encapsulates information about linguistic, cultural, and technological conventions and standards. Examples of information encapsulated by a locale include the symbol used for the decimal separator in numbers and the way dates are formatted. Localeは、言語的、文化的、そして技術的な慣行と標準に関する情報をカプセル化します。あるロケールによってカプセル化された情報の例は、数値において小数分離子として使われる表象および日付が書式設定される方法があります。

Locales are typically used to provide, format, and interpret information about and according to the user’s customs and preferences. They are frequently used in conjunction with formatters. Although you can use many locales, you usually use the one associated with the current user. ロケールは、概して利用者のカスタムおよび環境設定によってそしてそれについて情報を提供、書式設定、そして解釈するために使われます。それらはしばしばフォーマッタと連携して使われます。たとえあなたが多くのロケールを使用可能であっても、あなたはたいてい現在のユーザと結び付けられるものを使います。

Topics 話題

Creating a Locale ロケールを作成する

init(identifier: String)
Creates a locale with the specified identifier. 指定された識別子を使ってあるロケールを作成します。

Getting the User's Locale ユーザの持つロケールを取得する

static var autoupdatingCurrent: Locale
A locale which tracks the user’s current preferences. ユーザの持つ現在の環境設定を追跡するあるロケール。
static var current: Locale
A locale representing the user's region settings at the time the property is read. プロパティが読み出された時点でのユーザの持つ地域設定を表すロケール。

Getting Known Identifiers and Codes 既知の識別子とコードを取得する

static var availableIdentifiers: [String]
A list of available identifiers. 利用可能な識別子のリスト。
static var isoRegionCodes: [String]
A list of available region codes. 利用可能な地域コードのリスト。
static var isoLanguageCodes: [String]
A list of available language codes. 利用可能な言語コードのリスト。
static var isoCurrencyCodes: [String]
A list of available currency codes. 利用可能な通貨コードのリスト。
static var commonISOCurrencyCodes: [String]
A list of common currency codes. 共通の通貨コードのリスト。

Converting Between Identifiers 識別子間で変換する

static func canonicalIdentifier(from: String) -> String
Returns a canonical identifier from the given string. 与えられた文字列から正準識別子を返します。
static func components(fromIdentifier: String) -> [String : String]
Returns a dictionary that splits an identifier into its component pieces. ある識別子をそれの構成要素断片へと分割するある辞書を返します。
static func identifier(fromComponents: [String : String]) -> String
Constructs an identifier from a dictionary of components. 構成要素いくつかからなる辞書からある識別子を組み立てます。
static func canonicalLanguageIdentifier(from: String) -> String
Returns a canonical language identifier from the given string. 与えられた文字列から正準言語識別子を返します。
static func identifier(fromWindowsLocaleCode: Int) -> String?
Returns the locale identifier from a given Windows locale code, or nil if it could not be converted. 与えられたWindowsロケールコードからロケール識別子を返します、またはそれが変換できなかったならばnil。
static func windowsLocaleCode(fromIdentifier: String) -> Int?
Returns the Windows locale code from a given identifier, or nil if it could not be converted. 与えられた識別子からWindowsロケールコードを返します、またはそれが変換できなかったならばnil。

Getting Information About a Locale ロケールについての情報を取得する

var identifier: String
The identifier of the locale. このロケールの識別子。
var calendar: Calendar
The calendar for the locale, or the Gregorian calendar as a fallback. ロケールに対する暦、または代替としてのグレゴリオ暦。
var regionCode: String?
The region code of the locale, or nil if it has none. ロケールに対する地域コード、またはそれが持たないならばnil。
var languageCode: String?
The language code of the locale, or nil if has none. ロケールに対する言語コード、またはそれが持たないならばnil。
var scriptCode: String?
The script code of the locale, or nil if has none. ロケールに対する書体コード、またはそれが持たないならばnil。
var variantCode: String?
The variant code for the locale, or nil if it has none. ロケールに対する変種コード、またはそれが持たないならばnil。
var exemplarCharacterSet: CharacterSet?
The exemplar character set for the locale, or nil if has none. ロケールに対する文字セット見本、またはそれが持たないならばnil。
var collationIdentifier: String?
The collation identifier for the locale, or nil if it has none. ロケールに対する照合識別子、またはそれが持たないならばnil。
var collatorIdentifier: String?
The collator identifier of the locale. ロケールの照合子。
var usesMetricSystem: Bool
A Boolean that is true if the locale uses the metric system. ロケールがメートル法を使うならばtrueであるブール値。
var decimalSeparator: String?
The decimal separator of the locale. このロケールの小数分離子。
var groupingSeparator: String?
The grouping separator of the locale. このロケールのグループ分離子。
var currencyCode: String?
The currency code of the locale. このロケールの通貨コード。
var currencySymbol: String?
The currency symbol of the locale. このロケールの通貨表象。
var quotationBeginDelimiter: String?
The quotation begin delimiter of the locale. このロケールの引用符開始区切り。
var quotationEndDelimiter: String?
The quotation end delimiter of the locale. このロケールの引用符終了区切り。
var alternateQuotationBeginDelimiter: String?
The alternate quotation begin delimiter of the locale. このロケールの代替の引用符開始区切り。
var alternateQuotationEndDelimiter: String?
The alternate quotation end delimiter of the locale. このロケールの代替の引用符終了区切り。

Getting Display Information About a Locale あるロケールについての表示情報を取得する

func localizedString(for: Calendar.Identifier) -> String?
Returns a localized string for a specified calendar. ある指定されたカレンダーに対するローカライズされた文字列を返します。
func localizedString(forCollationIdentifier: String) -> String?
Returns a localized string for a specified ICU collation identifier. ある指定されたICU照合識別子に対するローカライズされた文字列を返します。
func localizedString(forCollatorIdentifier: String) -> String?
Returns a localized string for a specified ICU collator identifier. ある指定されたICU照合子識別子に対するローカライズされた文字列を返します。
func localizedString(forCurrencyCode: String) -> String?
Returns a localized string for a specified ISO 4217 currency code. ある指定されたISO 4217通貨コードに対するローカライズされた文字列を返します。
func localizedString(forIdentifier: String) -> String?
Returns a localized string for a specified locale identifier. ある指定されたロケール識別子に対するローカライズされた文字列を返します。
func localizedString(forLanguageCode: String) -> String?
Returns a localized string for a specified language code. ある指定された言語コードに対するローカライズされた文字列を返します。
func localizedString(forRegionCode: String) -> String?
Returns a localized string for a specified region code. ある指定された地域コードに対するローカライズされた文字列を返します。
func localizedString(forScriptCode: String) -> String?
Returns a localized string for a specified script code. ある指定された書体コードに対するローカライズされた文字列を返します。
func localizedString(forVariantCode: String) -> String?
Returns a localized string for a specified variant code. ある指定されたバリアントコードに対するローカライズされた文字列を返します。

Getting the User's Preferred Languages ユーザの環境設定した言語を取得する

static var preferredLanguages: [String]
A list of the user’s preferred languages. ユーザの環境設定した言語のリスト。

Getting Line and Character Direction for a Language ある言語に対する行と文字の方向を取得する

static func characterDirection(forLanguage: String) -> Locale.LanguageDirection
Returns the character direction for a specified language code. ある指定された言語コードに対する文字の方向を返します。
static func lineDirection(forLanguage: String) -> Locale.LanguageDirection
Returns the line direction for a specified language code. ある指定された言語コードに対する行の方向を返します。
typealias Locale.LanguageDirection
An alias for the standard set of language directions. 言語の方向の標準セットに対するエイリアス。
enum NSLocale.LanguageDirection
The directions that a language may take across a page of text. ある言語がテキストのページを渡っていく方向。

Comparing Locales ロケールを比較する

static func != (Locale, Locale) -> Bool
Returns a Boolean value indicating whether two values are not equal. ２つの値が等しくないかどうかを指し示すブール値を返します。
static func == (Locale, Locale) -> Bool
Returns a Boolean indicating whether two locales are identical. ２つのロケールが同一かどうかを指し示すブール値を返します。

Describing a Locale あるロケールを記述する

var description: String
A textual description of the locale. ロケールのテキスト表現。
var debugDescription: String
A textual description of the locale suitable for debugging. デバッグに適するこのロケールのテキスト表現。
var customMirror: Mirror
A mirror that reflects the locale. ロケールを反映するミラー。
var hashValue: Int
The computed hash value for the locale. このロケールに対する計算ハッシュ値。

Using Reference Types 参照型を使用する

class NSLocale
An object representing information about linguistic, cultural, and technological conventions that bridges to Locale; use NSLocale when you need reference semantics or other Foundation-specific behavior. 言語的、文化的、そして技術的な慣行についての情報を表しているオブジェクトで、それはLocaleへブリッジを行います；あなたが参照意味論や他のFoundation特有の挙動を必要とする場合はNSLocaleを使ってください。
typealias Locale.ReferenceType
An alias for this value type's equivalent reference type. この値型のもつ同等な参照型に対するエイリアス。

Initializers イニシャライザ

init(from: Decoder)

Instance Methods インスタンス メソッド

func encode(to: Encoder)
func hash(into: inout Hasher)

Relationships 関係

Conforms To 次に準拠