ZoneOffset 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
格林威治/UTC 的時區偏移,例如 +02:00。
[Android.Runtime.Register("java/time/ZoneOffset", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class ZoneOffset : Java.Time.ZoneId, IDisposable, Java.Lang.IComparable, Java.Time.Temporal.ITemporalAccessor, Java.Time.Temporal.ITemporalAdjuster
[<Android.Runtime.Register("java/time/ZoneOffset", ApiSince=26, DoNotGenerateAcw=true)>]
type ZoneOffset = class
inherit ZoneId
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IComparable
interface ITemporalAccessor
interface ITemporalAdjuster
- 繼承
- 屬性
- 實作
備註
格林威治/UTC 的時區偏移,例如 +02:00。
時區偏移是指某時區與格林威治/UTC相差的時間長度。 這通常是固定的小時和分鐘數。
世界不同地區有不同的時區偏移。 課堂中記錄 ZoneId 了因地點和季節而異的抵消規則。
例如,巴黎在冬季比格林威治/UTC快一小時,夏天則比格林威治快兩小時。
ZoneId巴黎的例子會提到兩個ZoneOffset例子——一個+01:00是冬季,另一個+02:00是夏季。
2008年,全球時區偏移從-12:00延伸至+14:00。 為避免該範圍延伸出問題,同時仍能提供驗證,偏移範圍限制在 -18:00 至 18:00 之間。
此類別設計用於 ISO 日曆系統。 小時、分鐘和秒的欄位所做的假設,對這些欄位的標準 ISO 定義是有效的。 此類別可與其他曆法系統使用,前提是時間欄位的定義與 ISO 日曆系統相符。
必須用 ZoneOffset來比較 的#equals實例。 實作可以選擇快取某些常見的偏移量,但應用程式不應依賴此類快取。
新增於1.8版本。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
屬性
| 名稱 | Description |
|---|---|
| Class |
傳回這個 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| Id |
會取得正規化區域偏移ID。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
格林威治/UTC 的時區偏移,例如 |
| JniPeerMembers |
格林威治/UTC 的時區偏移,例如 |
| Max |
最大支援偏移量為常數。 |
| Min |
最小支援偏移量為常數。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| Rules |
取得相關的時區規則。 |
| ThresholdClass |
格林威治/UTC 的時區偏移,例如 |
| ThresholdType |
格林威治/UTC 的時區偏移,例如 |
| TotalSeconds |
幾秒鐘內就能取得整個區域的偏移。 |
| Utc |
UTC的時區偏移,ID為「Z」。 |
方法
| 名稱 | Description |
|---|---|
| AdjustInto(ITemporal) |
調整指定的時間物件,使其偏移量與此物件相同。 |
| Clone() |
建立並傳回這個 對象的複本。 (繼承來源 Object) |
| CompareTo(ZoneOffset) |
將此偏移量與另一個偏移量依序由高到低比較。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
格林威治/UTC 的時區偏移,例如 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
格林威治/UTC 的時區偏移,例如 |
| Equals(Object) |
格林威治/UTC 的時區偏移,例如 |
| Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
| From(ITemporalAccessor) |
從一個時間對象獲得一個 |
| Get(ITemporalField) |
從此偏移 |
| GetDisplayName(TextStyle, Locale) |
取得區域的文字表示,例如「英國時間」或「+02:00」。 (繼承來源 ZoneId) |
| GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
| GetLong(ITemporalField) |
從此偏移 |
| IsSupported(ITemporalField) |
檢查指定欄位是否支援。 |
| JavaFinalize() |
已淘汰.
當垃圾收集決定不再參考物件時,垃圾收集行程在 物件上呼叫。 (繼承來源 Object) |
| Normalized() |
標準化時區 ID,並在可能的情況下回傳 ZoneOffset。 (繼承來源 ZoneId) |
| Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
| NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
| Of(String) |
取得使用該 ID 的實例 |
| OfHours(Int32) |
以小時計算使用偏移的實例 |
| OfHoursMinutes(Int32, Int32) |
以小時和分鐘計算一個偏移的實例 |
| OfHoursMinutesSeconds(Int32, Int32, Int32) |
獲得以小時、分鐘和秒數計算的偏移量實例 |
| OfTotalSeconds(Int32) |
取得以秒數為單位指定總偏移量的實例 |
| Query(ITemporalQuery) |
查詢該偏移量,使用指定的查詢。 |
| Range(ITemporalField) |
取得指定欄位的有效值範圍。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
格林威治/UTC 的時區偏移,例如 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
讓目前線程等候直到喚醒為止,通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object) |
| Wait(Int64, Int32) |
讓目前的線程等到喚醒為止,通常是因為 <em>notified</em> 或 <em>interrupted</em>,或直到經過一定數量的實時為止。 (繼承來源 Object) |
| Wait(Int64) |
讓目前的線程等到喚醒為止,通常是因為 <em>notified</em> 或 <em>interrupted</em>,或直到經過一定數量的實時為止。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IComparable.CompareTo(Object) |
格林威治/UTC 的時區偏移,例如 |
| IJavaPeerable.Disposed() |
格林威治/UTC 的時區偏移,例如 |
| IJavaPeerable.Finalized() |
格林威治/UTC 的時區偏移,例如 |
| IJavaPeerable.JniObjectReferenceControlBlock |
格林威治/UTC 的時區偏移,例如 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
格林威治/UTC 的時區偏移,例如 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
格林威治/UTC 的時區偏移,例如 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
格林威治/UTC 的時區偏移,例如 |
| IJavaPeerable.UnregisterFromRuntime() |
格林威治/UTC 的時區偏移,例如 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
格林威治/UTC 的時區偏移,例如 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |