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/Detroit」、「America/Montreal」以及其他屬於「東部時間」的時區。 然而，對大多數人來說，為這些時區分配不同的顯示名稱並不太合理。

在 CLDR （使用 LDML 表示地點資料）中，顯示名稱「Eastern Time」會儲存為以 ID 「America_Eastern」標示的元區域的長通用顯示名稱。 接著，還有另一個表格維護每個時區對元區域的歷史映射。 上述例子中的時區（「America/New_York」、「America/底特律」......）被映射到元區域「America_Eastern」。

有時候，時區會被映射到過去不同的時區。 例如，「America/Indiana/Knox」一直在「東部時間」和「中部時間」之間來回移動。 因此，時區到元區域的映射資料必須依日期範圍儲存。

<b>註：</b>

TimeZoneFormat 假設 的 TimeZoneNames 實例是不變的。 如果你想提供自己的 TimeZoneNames 實作並使用它 TimeZoneFormat，你必須遵守合約。

這類方法假設時區 ID 已經被標準化。 例如，你可能無法用時區 ID 為「America/Indiana/Indianapolis」的方法回傳正確結果，因為該時區的標準時區 ID 是「America/Indianapolis」。 可以參考 TimeZone#getCanonicalID(String) 加護病房的標準時區識別碼。

在 CLDR 中，除了地點名稱外，大多數時區顯示名稱都是透過元區域提供。 但某個時區可能有特定名稱，且不與其他時區共享。

例如，時區「Europe/London」在英語中對標準時間「Greenwich 標準時間」的長稱，這也與其他時區相同。 然而，夏令時間的長稱是「英國夏令時間」，僅用於「歐洲/倫敦」這一詞。

#getTimeZoneDisplayName(String, NameType) 設計用來存取僅在單一時區使用的名稱。 但這不一定代表子類別實作會用相同的模型搭配 CLDR。 子類別實作可能僅 #getTimeZoneDisplayName(String, NameType)透過 ，或僅 #getMetaZoneDisplayName(String, NameType)透過 ，或兩者兼具。

TimeZoneNames預設實作 會#getInstance(ULocale)使用 CLDR 匯入的 locale 資料。 在 CLDR 中，元區域 ID 集合及區域 ID 與元區域 ID 之間的映射會被所有地點共享。 因此，無論使用哪個地點來取得 的實例，、 的行為#getAvailableMetaZoneIDs()#getAvailableMetaZoneIDs(String)#getMetaZoneID(String, long)#getReferenceZoneID(String, String)都不會改變。TimeZoneNames

Java 文件 android.icu.text.TimeZoneNames。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。