語言

TimeZone 類別

定義

[加護病房強化] ICU 的替代 java.util.TimeZone。

[Android.Runtime.Register("android/icu/util/TimeZone", ApiSince=24, DoNotGenerateAcw=true)]
public abstract class TimeZone : Java.Lang.Object, Android.Icu.Util.IFreezable, IDisposable, Java.IO.ISerializable
[<Android.Runtime.Register("android/icu/util/TimeZone", ApiSince=24, DoNotGenerateAcw=true)>]
type TimeZone = class
    inherit Object
    interface IFreezable
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISerializable
繼承
屬性
實作

備註

[加護病房強化] ICU java.util.TimeZone的 . ICU 特有的方法、欄位及其他功能標示為「<strong>[icu]</strong>」。

TimeZone 代表時區偏移,並計算夏令時間。

通常你會根據程式執行的時區產生TimeZone一個#getDefault()使用TimeZone。 例如,在日本執行的程式,會 getDefault 根據日本標準時建立一個 TimeZone 物件。

你也可以申請 TimeZone 時 #getTimeZone(String) 區識別碼。 例如,美國太平洋時區的時區ID是「America/Los_Angeles」。 所以,你可以用以下條件獲得美國太平洋時間 TimeZone 的天體:

<引用>

TimeZone tz = TimeZone.getTimeZone("America/Los_Angeles");

</blockquote> 您可以使用此 #getAvailableIDs() 方法遍歷所有支援的時區 ID,或使用 getCanonicalID 方法檢查某個時區 ID 是否被支援。 接著你可以選擇支援的 ID 來取得 TimeZone. 如果你想要的時區沒有被支援的 ID 代表,你可以用以下語法建立自訂時區 ID:

<引用>

GMT[+|-]hh[[:]mm]

</區塊引用>

例如,你可以指定 GMT+14:00 作為自訂時區 ID。 TimeZone當你指定自訂時區 ID 時,會回傳這個設定,使用指定的 GMT(=UTC) 偏移量,且不遵守夏令時間。 例如,你可以設定 GMT+14:00 作為自訂時區 ID,建立一個時區,代表比 GMT 早 14 小時(沒有夏令時間)。 此外, getCanonicalID 也可用來標準化自訂時區 ID。

為了與 JDK 1.1.x 相容,也支援其他三字母時區 ID(如「PST」、「CTT」、「AST」)。 然而,它們的使用已被淘汰,因為同一個縮寫經常用於多個時區(例如,「CST」可能是美國的「中部標準時間」和「中國標準時間」),而 Java 平台因此只能辨識其中一種。

Java 文件 android.icu.util.TimeZone。

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

建構函式

名稱 Description
TimeZone()

預設建構函式。

TimeZone(IntPtr, JniHandleOwnership)

建立一個受管理實例,代表一個現有的 Java 物件。

欄位

名稱 Description
GenericLocation
已淘汰.

[加護病房]一種用getDisplayName()來標示源自時區備用名稱的長名稱的樣式指定符,例如「美國 (Los Angeles)。

Long
已淘汰.

用來表示長名稱的風格指定符 getDisplayName() ,例如「太平洋標準時間」。

LongGeneric
已淘汰.

[加護病房] 用來標示長泛稱的樣式指定符 getDisplayName() ,例如「Pacific Time.

LongGmt
已淘汰.

[加護病房] 用來指定由時區偏移衍生出長名稱的樣式指定符 getDisplayName() ,例如「GMT-08:00。

Short
已淘汰.

一個用來 getDisplayName() 表示短名稱的樣式規範符,例如「PST.

ShortCommonlyUsed
已淘汰.

[加護病房] 一種樣式指定符,用 getDisplayName() 來標示源自時區短標準或夏令時間區名稱(忽略 commonlyUsed,例如 “PDT.”)的短名稱。

ShortGeneric
已淘汰.

[加護病房] 用 getDisplayName() 來標示簡短通用名稱的樣式指定符,例如「PT.

ShortGmt
已淘汰.

[加護病房] 用來指定由時區偏移量衍生的短名稱的樣式指定符 getDisplayName() ,例如「-0800」。

TimezoneIcu
已淘汰.

[加護病房] 一種時區實作類型,用以表示 ICU 自有的時區 getTimeZone。

TimezoneJdk
已淘汰.

[加護病房] 一個時區實作類型,用 java.util.TimeZone 以表示所 getTimeZone使用的。

UnknownZoneId

[加護病房] 保留給未知時區的時區 ID。

屬性

名稱 Description
Class

回傳此 Object的執行時類別。

(繼承來源 Object)
Default

會拿到這個主機的預設 TimeZone 值。

DisplayName

回傳一個適合在預設 DISPLAY 地點顯示給使用者使用的時區名稱。

DSTSavings

將加入的時間回傳到當地標準時間,以取得當地壁鐘時間。

GmtZone

[加護病房] 不變的 GMT(=UTC)時區。

Handle

底層 Android 實例的帳號。

(繼承來源 Object)
ID

能拿到這個時區的ID。 -或者- 設定時區ID。

IsFrozen

判斷物體是否被凍結。

JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於存取此 Java 綁定成員的 JNI 元資料。

PeerReference

取得這個 Java 節點的 JNI 物件參考。

(繼承來源 Object)
RawOffset

在夏令時間期間,會獲得未修改的抵消,但不會被修改。

ThresholdClass

取得用於虛擬方法派遣的 Java 類別。

ThresholdType

取得宣告這個 Java 綁定的受管理型別。

TZDataVersion

[加護病房] 回傳 ICU 目前使用的時區資料版本。

UnknownZone

[加護病房] 那個不可變(凍結)的「未知」時區。

方法

名稱 Description
Clone()

覆蓋複製人。

CloneAsThawed()

提供複製人行動的規定。

Construct(JniObjectReference, JniObjectReferenceOptions)

將此對等節點的建置委派給執行時的值管理器。

(繼承來源 JavaObject)
CountEquivalentIDs(String)

[加護病房] 回傳包含該 ID 的等效群組中 ID 的數量。

Dispose()

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
Dispose(Boolean)

釋放該 Java 節點所持有的資源。

(繼承來源 Object)
DisposeUnlessReferenced()

請求值管理器處置此對等節點,除非其映射保留該受管理實例。

(繼承來源 JavaObject)
Equals(Object)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
Equals(Object)

表示是否有其他物體「等同」於此物。

(繼承來源 Object)
Freeze()

凍結物體。

GetAvailableIDs()

回傳一個包含所有系統 TimeZone ID 的新字串陣列。

GetAvailableIDs(Int32)

回傳一個新的字串陣列,包含所有系統 TimeZone ID,並以 GMT 原始偏移量。

GetAvailableIDs(String)

回傳一個新的字串陣列,包含所有與該國家相關的系統時區 ID。

GetAvailableIDs(TimeZone+SystemTimeZoneType, String, Integer)

[加護病房]回傳一組時區 ID 字串,並符合給定的過濾條件。

GetCanonicalID(String, Boolean[])

[加護病房] 傳回指定時區 ID 的標準系統時區 ID 或標準化的自訂時區 ID。

GetCanonicalID(String)

[加護病房] 傳回指定時區 ID 的標準系統時區 ID 或標準化的自訂時區 ID。

GetDisplayName(Boolean, TimeZoneNameStyle, Locale)

回傳一個適合在指定地點向使用者呈現的時區名稱。

GetDisplayName(Boolean, TimeZoneNameStyle, ULocale)

回傳一個適合在指定地點向使用者呈現的時區名稱。

GetDisplayName(Boolean, TimeZoneNameStyle)

回傳一個適合在預設 DISPLAY 地點顯示給使用者使用的時區名稱。

GetDisplayName(Locale)

回傳一個適合在指定地點向使用者呈現的時區名稱。

GetDisplayName(ULocale)

回傳一個適合在指定地點向使用者呈現的時區名稱。

GetEquivalentID(String, Int32)

回傳包含該 ID 的等價群組 ID。

GetFrozenTimeZone(String)

取得該身分證的資訊 TimeZone 。

GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
GetIanaID(String)

回傳 IANA 資料庫中該時區 ID 的首選時區 ID。

GetIDForWindowsID(String, String)

[加護病房]將 Windows 時區 ID 轉換為區域的等效系統時區 ID。

GetOffset(Int32, Int32, Int32, Int32, Int32, Int32)

取得當前日期的時區偏移,並因應夏令時間而有所調整。

GetOffset(Int64, Boolean, Int32[])

回傳給定時刻的原始時區與 GMT 偏移。

GetOffset(Int64)

回傳該時區在指定日期從UTC的偏移量。

GetRegion(String)

[加護病房] 回傳與指定系統時區 ID 相關聯的區域代碼。

GetTimeZone(String, TimeZoneType)

會取得該 ID 和時區類型的資料 TimeZone 。

GetTimeZone(String)

取得該身分證的資訊 TimeZone 。

GetWindowsID(String)

[加護病房]將系統時區 ID 轉換為等效的 Windows 時區 ID。

HasSameRules(TimeZone)

如果該區域與另一個區域有相同的規則和偏移,則返回為真。

InDaylightTime(Date)

查詢該日期是否屬於該時區的夏令時間。

JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
ObservesDaylightTime()

詢問此時區是否屬於夏令時間,或未來任何時間都會實施夏令時間。

SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

(繼承來源 JavaObject)
ToArray<T>()

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()

回傳物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Object)
UseDaylightTime()

查詢這個時區是否使用夏令時間。

Wait()

使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。

(繼承來源 Object)
Wait(Int64, Int32)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
Wait(Int64)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)

明確介面實作

名稱 Description
IFreezable.CloneAsThawed()

提供複製人行動的規定。

IFreezable.Freeze()

凍結物體。

IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.Finalized()

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

取得此對等端使用的原生控制區塊指標。

(繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

儲存執行時提供的身份雜湊碼。

(繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

取代儲存的受管理對等狀態旗標。

(繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。

(繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

將此實例從執行時的 Java 物件查詢中移除。

擴充方法

名稱 Description
GetJniTypeName(IJavaPeerable)

取得實例 self類型的 JNI 名稱。

JavaAs<TResult>(IJavaPeerable)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

JavaCast<TResult>(IJavaObject)

執行 Android 執行時檢查型別轉換。

JavaCast<TResult>(IJavaObject)

重用相容的受管理對等端或取得請求型態的包裝器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

試著強制self輸入 TResult,檢查 強制在 Java 端是否有效。

適用於