構造体


Locale.Components


特定のオーバーライドを使用してロケールを作成するときに使用する、ロケールのコンポーネントを表す型。


iOS 16.0+ iPadOS 16.0+ Mac Catalyst 16.0+ macOS 13.0+

tvOS 16.0+ visionOS 1.0+ watchOS 9.0+ Xcode 14.0+

struct Components





概観


Locale.Componentsinit(components:) イニシャライザとともに使用して、デフォルトのロケールの特定の特性をオーバーライドするカスタム Locale を作成します。コンポーネントを使用してロケールを作成すると、ロケールは地域または言語で推奨されるデフォルトではなく、オーバーライドされた値を使用します。デフォルト値を受け入れるには、プロパティを nil のままにします。


この型のプロパティは Locale のプロパティに対応しており、読み書き可能ではなく読み取り専用として宣言されています。カスタムロケールを作成するときにこの型を使用してコンポーネントをカスタマイズし、Locale を使用して既存のロケールのコンポーネントを調べて下さい。


以下の例では、米国英語の Locale.Components インスタンスを作成しますが、その時そのコンポーネントをカスタマイズします。週の最初の曜日を月曜日に設定し、時間サイクルを 0 から 23 に設定します。これらのコンポーネントは、それぞれ en-US のデフォルトである日曜日と 1 から 12 をオーバーライドします。次に、init(components:) を使用してカスタム Locale を作成します。


  1. var components = Locale.Components(languageCode: "en", languageRegion: "US")
  2. components.firstDayOfWeek = Locale.Weekday.monday
  3. components.hourCycle = Locale.HourCycle.zeroToTwentyThree
  4. let locale = Locale(components: components)




トピックス


ロケールコンポーネントインスタンスの作成


init(identifier: String)

指定された識別子を持つロケールコンポーネントインスタンスを作成します。


init(languageCode: Locale.LanguageCode?, script: Locale.Script?, languageRegion: Locale.Region?)

指定された言語コード、スクリプト、および地域識別子を持つロケールコンポーネントインスタンスを作成します。


init(locale: Locale)

既存のロケールから言語コンポーネントインスタンスを作成します。



言語コンポーネントの指定


var languageComponents: Locale.Language.Components

ロケールの Unicode 言語識別子部分。


struct Locale.Language.Components

さまざまなコンポーネントによって言語を識別する型。



日付と時刻のコンポーネントの指定


var calendar: Calendar.Identifier?

ロケールで使用されるカレンダー。


enum Calendar.Identifier

利用可能なカレンダーの列挙型。


var firstDayOfWeek: Locale.Weekday?

このロケールで表される週の最初の曜日。


enum Locale.Weekday

曜日を表す型で、ロケールの週の最初の曜日を示すために使用されます。


var hourCycle: Locale.HourCycle?

ロケールで使用される時間サイクル (1 から 12 または 0 から 23 など)。


enum Locale.HourCycle

1 から 12 または 0 から 23 など、ロケールで使用される時間サイクルを表す型。


var timeZone: TimeZone?

もしあれば、ロケールに関連するタイムゾーン。



測定と数え方のコンポーネントを指定


var currency: Locale.Currency?

ロケールで使用される通貨。


struct Locale.Currency

ドルやユーロなど、ロケールで使用される通貨システムを表す型。


var measurementSystem: Locale.MeasurementSystem?

メートル法や米国のシステムなど、ロケールで使用される測定システム。


struct Locale.MeasurementSystem

メートル法や米国のシステムなど、ロケールで使用される測定システムを表す型。


var numberingSystem: Locale.NumberingSystem?

ロケールで使用される数え方のシステム。


struct Locale.NumberingSystem

ロケールで使用される数え方のシステムを表す型。



地域コンポーネントを指定


var region: Locale.Region?

ロケールで使用される地域。


struct Locale.Region

ロケールまたは言語を指定するために使用する、地理的領域を表す型。


var subdivision: Locale.Subdivision?

このロケールで使用される地域の optional の区分。


struct Locale.Subdivision

米国の state (州) やカナダの province (州) など、地域の区分を表す型。


var variant: Locale.Variant?

ロケールによって使用される optional のバリアント。


struct Locale.Variant

ロケールの言語バリアントを表す型。



順序付けコンポーネントの指定


var collation: Locale.Collation?

ロケールの文字列の並べ方順序。


struct Locale.Collation

ロケールで使用される文字列の並べ方順序を表す型。



コード化と復号化


init(from: any Decoder)

与えられた復号器から復号して新しいインスタンスを作成します。


func encode(to: any Encoder)

この値を与えられたエンコーダにコード化します。



ハッシュ化


var hashValue: Int

ハッシュ値です。


func hash(into: inout Hasher)

この値の不可欠なコンポーネントを与えられたハッシャーに入力してハッシュします。



ロケールコンポーネントの比較


static func == (Locale.Components, Locale.Components) -> Bool

2 つの値が等しいかどうかを示すブール値を返します。


static func != (Locale.Components, Locale.Components) -> Bool

2 つの値が等しくないかどうかを示すブール値を返します。





関連


以下に準拠


Decodable

Encodable

Hashable

Sendable





以下も見よ


コンポーネントによるロケールの作成


init(components: Locale.Components)

与えられたコンポーネントからロケールを作成します。


init(languageCode: Locale.LanguageCode?, script: Locale.Script?, languageRegion: Locale.Region?)

指定された言語コード、スクリプト、および地域識別子を持つロケールを作成します。


init(languageComponents: Locale.Language.Components)

与えられた言語コンポーネントからロケールを作成します。


struct Locale.Language.Components

さまざまなコンポーネントによって言語を識別する型。














トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ












トップへ