TimeZoneNames クラス

定義

[Android.Runtime.Register("android/icu/text/TimeZoneNames", ApiSince=24, DoNotGenerateAcw=true)]
public abstract class TimeZoneNames : Java.Lang.Object, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("android/icu/text/TimeZoneNames", ApiSince=24, DoNotGenerateAcw=true)>]
type TimeZoneNames = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

継承

Object

JavaObject

Object

TimeZoneNames

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable ISerializable IDisposable

注釈

TimeZoneNames は、 UTS#35 Unicode ロケール データ マークアップ言語 (LDML) によって定義されたタイム ゾーン表示名データ モデルを表す抽象クラスです。 このモデルでは、一連の表示名を格納するために使用されるメタ ゾーンを定義します。 メタ ゾーンは、複数のタイム ゾーンで共有できます。 また、タイム ゾーンには、複数のメタ ゾーンの履歴マッピングが含まれる場合があります。

たとえば、米国のユーザーは、北米東部で使用されるゾーンを "東部標準時" と参照します。 tz データベースには、複数のタイム ゾーン "America/New_York"、"America/Montreal"、"America/Montreal"、および "Eastern Time" に属するその他のタイム ゾーンが含まれています。 ただし、これらのタイム ゾーンに異なる表示名を割り当てることは、ほとんどのユーザーにとってあまり意味がありません。

CLDR (ロケール データを表す LDML を使用) では、表示名 "Eastern Time" は、ID "America_Eastern" で識別されるメタ ゾーンの汎用表示名として格納されます。 次に、タイム ゾーンごとにメタ ゾーンへの履歴マッピングを保持する別のテーブルがあります。 上記の例のタイム ゾーン ("America/New_York"、"America/Detroit".)は、メタ ゾーン "America_Eastern" にマップされます。

場合によっては、過去にタイム ゾーンが別のタイム ゾーンにマップされることがあります。 たとえば、「アメリカ/インディアナ/ノックス」は「東部標準時」と「中部時間」を前後に動かしていました。 そのため、タイム ゾーンからメタ ゾーンへのマッピング データは日付範囲で格納する必要があります。

<b>Note:</b>

TimeZoneFormat は、 TimeZoneNames のインスタンスが不変であることを前提としています。 独自の TimeZoneNames 実装を提供し、 TimeZoneFormatで使用する場合は、コントラクトに従う必要があります。

このクラスのメソッドは、タイム ゾーン ID が既に正規化されていることを前提としています。 たとえば、タイム ゾーン ID が "America/インディアナ/インディアナポリス" のメソッドによって適切な結果が返されない場合があります。これは、標準のタイム ゾーン ID ではないためです (タイム ゾーンの正規のタイム ゾーン ID は "America/Indianapolis" です)。 ICU 標準タイム ゾーン ID の TimeZone#getCanonicalID(String) を参照してください。

CLDR では、場所名を除くほとんどのタイム ゾーン表示名はメタ ゾーンを介して提供されます。 ただし、タイム ゾーンには、他のタイム ゾーンと共有されていない特定の名前が含まれる場合があります。

たとえば、タイム ゾーン "ヨーロッパ/ロンドン" には、標準時の英語の長い名前 "グリニッジ標準時" があり、他のタイム ゾーンとも共有されます。 ただし、夏時間の長い名前は "British Summer Time" で、"Europe/London" にのみ使用されます。

#getTimeZoneDisplayName(String, NameType) は、1 つのタイム ゾーンでのみ使用される名前にアクセスするように設計されています。 ただし、サブクラスの実装で CLDR と同じモデルが使用されるとは限りません。 サブクラスの実装では、タイム ゾーン名は、 #getTimeZoneDisplayName(String, NameType)を介してのみ、または #getMetaZoneDisplayName(String, NameType)、またはその両方を通じてのみ提供できます。

TimeZoneNamesによって返される既定の#getInstance(ULocale)実装では、CLDR からインポートされたロケール データが使用されます。 CLDR では、一連のメタ ゾーン ID とゾーン ID とメタ ゾーン ID の間のマッピングが、すべてのロケールで共有されます。 そのため、#getAvailableMetaZoneIDs()のインスタンスを取得するために使用されるロケールに関係なく、#getAvailableMetaZoneIDs(String)、#getMetaZoneID(String, long)、#getReferenceZoneID(String, String)、およびTimeZoneNamesの動作は変更されません。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。