語言

OffsetDateTime 類別

定義

在 ISO-8601 日曆系統中,與 UTC/Greenwich 有偏移的日期時間,例如 2007-12-03T10:15:30+01:00。

[Android.Runtime.Register("java/time/OffsetDateTime", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class OffsetDateTime : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable, Java.Time.Temporal.ITemporal, Java.Time.Temporal.ITemporalAdjuster
[<Android.Runtime.Register("java/time/OffsetDateTime", ApiSince=26, DoNotGenerateAcw=true)>]
type OffsetDateTime = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable
    interface ITemporal
    interface ITemporalAccessor
    interface ITemporalAdjuster
繼承
OffsetDateTime
屬性
實作

備註

在 ISO-8601 日曆系統中,與 UTC/Greenwich 有偏移的日期時間,例如 2007-12-03T10:15:30+01:00。

OffsetDateTime 是帶有偏移量的日期時間的不變表示。 此類別儲存所有日期與時間欄位,精確度達奈秒,並包含UTC/格林威治的偏移量。 例如,值「2nd October 2 at 13:45:30.123456789 +02:00」可以儲存在 OffsetDateTime。

OffsetDateTime java.time.ZonedDateTime,且java.time.Instant所有瞬間都以奈秒精度儲存在時間軸上。 Instant 是最簡單的,簡單地表示當下。 OffsetDateTime 會將與UTC/格林威治的偏移相加於瞬間,從而取得當地日期時間。 ZonedDateTime 新增了完整的時區規則。

其目的是或ZonedDateTimeInstant用於在較簡單的應用中建模資料。 此類別可用於更詳細地建模日期-時間概念,或在與資料庫或網路協定通訊時使用。

新增於1.8版本。

Java 文件 java.time.OffsetDateTime。

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

屬性

名稱 Description
Class

回傳此 Object的執行時類別。

(繼承來源 Object)
DayOfMonth

會得到月份的日期欄位。

DayOfWeek

會得到星期幾欄位,這是一個星期幾的星期。

DayOfYear

會拿到年份欄位。

Handle

底層 Android 實例的帳號。

(繼承來源 Object)
Hour

負責一天的時段。

JniIdentityHashCode

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

(繼承來源 Object)
JniManagedPeerState

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

(繼承來源 JavaObject)
JniPeerMembers

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

Max

最大支援的 OffsetDateTime 為「+999999999-12-31T23:59:59.99999999999-18:00」。

Min

最低支援的 OffsetDateTime 為「-99999999-01-01T00:00:00+18:00」。

Minute

他能進入每小時的場地。

Month

使用 Month enum 取得 month of year 欄位。

MonthValue

可以取得月份和年份欄位,範圍從1到12。

Nano

能得到秒奈米的場。

Offset

取得區域偏移,例如「+01:00」。

PeerReference

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

(繼承來源 Object)
Second

獲得第二分鐘的場地。

ThresholdClass

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

(繼承來源 Object)
ThresholdType

此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。

(繼承來源 Object)
Year

會拿到年份欄位。

方法

名稱 Description
AdjustInto(ITemporal)

調整指定的時間物件,使其偏移、日期和時間與此物件相同。

AtZoneSameInstant(ZoneId)

將此日期時間與時區結合,建立 ZonedDateTime,確保結果具有相同的瞬間。

AtZoneSimilarLocal(ZoneId)

將這個日期時間與時區結合,建立一個嘗試保持相同當地日期與時間的 ZonedDateTime。

Clone()

建立並回傳此物件的副本。

(繼承來源 Object)
CompareTo(OffsetDateTime)

將這個日期時間與另一個日期時間做比較。

Construct(JniObjectReference, JniObjectReferenceOptions)

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

(繼承來源 JavaObject)
Dispose()

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

(繼承來源 Object)
Dispose(Boolean)

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

(繼承來源 Object)
DisposeUnlessReferenced()

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

(繼承來源 JavaObject)
Equals(Object)

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

(繼承來源 JavaObject)
Equals(Object)

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

(繼承來源 Object)
Format(DateTimeFormatter)

使用指定的格式化器來格式化這個日期時間。

From(ITemporalAccessor)

從一個時間物件取得 OffsetDateTime 的實例。

Get(ITemporalField)

從此日期-時間取得指定欄位的值,作為整數值。

GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
GetLong(ITemporalField)

從此日期時間取得指定欄位的值,作為長。

IsAfter(OffsetDateTime)

檢查該日期-時間的瞬間是否晚於指定日期-時間。

IsBefore(OffsetDateTime)

檢查該日期-時間點是否早於指定日期時間。

IsEqual(OffsetDateTime)

檢查該日期-時間的瞬間是否等於指定的日期-時間。

IsSupported(ITemporalField)

檢查指定欄位是否支援。

IsSupported(ITemporalUnit)

檢查指定單位是否支援。

JavaFinalize()
已淘汰.

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

(繼承來源 Object)
Minus(Int64, ITemporalUnit)

回傳一份該日期時間的副本,並扣除指定金額。

Minus(ITemporalAmount)

回傳一份該日期時間的副本,並扣除指定金額。

MinusDays(Int64)

回傳一份 OffsetDateTime 的副本,並扣除指定的天數。

MinusHours(Int64)

回傳一份 OffsetDateTime 的副本,並扣除指定的工時數。

MinusMinutes(Int64)

回傳一份 OffsetDateTime 的副本,並扣除指定的分鐘數。

MinusMonths(Int64)

回傳一份 OffsetDateTime 的副本,並扣除指定的月份數。

MinusNanos(Int64)

回傳一份 OffsetDateTime 的副本,並扣除指定的奈秒數。

MinusSeconds(Int64)

回傳一份 OffsetDateTime 的副本,並扣除指定的秒數。

MinusWeeks(Int64)

回傳一份 OffsetDateTime 的副本,並扣除指定的週數。

MinusYears(Int64)

回傳一份已減去指定年數的 OffsetDateTime 副本。

Notify()

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

(繼承來源 Object)
NotifyAll()

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

(繼承來源 Object)
Now()

從系統時鐘取得預設時區的當前日期時間。

Now(Clock)

從指定的時鐘取得當前日期時間。

Now(ZoneId)

從指定時區的系統時鐘取得當前日期時間。

Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32, ZoneOffset)

取得來自年份、月份、日、小時、分鐘、秒、奈秒及偏移量的 OffsetDateTime 實例。

Of(LocalDate, LocalTime, ZoneOffset)

從日期、時間和偏移中取得 OffsetDateTime 的實例。

Of(LocalDateTime, ZoneOffset)

從日期時間與偏移量取得 OffsetDateTime 的實例。

OfInstant(Instant, ZoneId)

從即時與區域 ID 取得 OffsetDateTime 的實例。

Parse(ICharSequence, DateTimeFormatter)

使用特定格式化器從文字字串取得 OffsetDateTime 的實例。

Parse(ICharSequence)

可從文字串(如 2007-12-03T10:15:30+01:00)取得 OffsetDateTime 實例。

Parse(String, DateTimeFormatter)

解析偏移日期-時間字串,並使用指定的格式化器。

Parse(String)

解析 ISO 日期與時間,並以 UTC 偏移量與字串相連。

Plus(Int64, ITemporalUnit)

回傳一份日期時間的副本,並加上指定的金額。

Plus(ITemporalAmount)

回傳一份日期時間的副本,並加上指定的金額。

PlusDays(Int64)

回傳一份 OffsetDateTime 的副本,並加上指定的天數。

PlusHours(Int64)

回傳一份包含指定小時數的 OffsetDateTime 副本。

PlusMinutes(Int64)

回傳一份 OffsetDateTime 的副本,並加上指定的分鐘數。

PlusMonths(Int64)

回傳一份 OffsetDateTime 的副本,並加上指定的月份數。

PlusNanos(Int64)

回傳一份 OffsetDateTime 的副本,並加上指定的奈秒數。

PlusSeconds(Int64)

回傳一份 OffsetDateTime 的副本,並加上指定的秒數。

PlusWeeks(Int64)

回傳一份 OffsetDateTime 的副本,並加上指定的週數。

PlusYears(Int64)

回傳一份已加入指定年數的 OffsetDateTime 副本。

Query(ITemporalQuery)

在此日期點使用指定的查詢進行查詢。

Range(ITemporalField)

取得指定欄位的有效值範圍。

SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

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

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

(繼承來源 JavaObject)
TimeLineOrder()

會有一個比較器,僅根據瞬間比較兩個 OffsetDateTime 實例。

ToArray<T>()

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

(繼承來源 Object)
ToEpochSecond()

將此日期時間轉換為1970-01-01T00:00:00Z的秒數。

ToInstant()

將此日期時間轉換為瞬間。

ToLocalDate()

會收到這個約會時間裡的 LocalDate 部分。

ToLocalDateTime()

會取得這個日期時間的 LocalDateTime 部分。

ToLocalTime()

他會聽到這個日期時間的 LocalTime 部分。

ToOffsetTime()

將此日期時間轉換為 OffsetTime。

ToString()

回傳物件的字串表示。

(繼承來源 Object)
ToZonedDateTime()

利用偏移量作為區域 ID,將此日期時間轉換為 ZonedDateTime。

TruncatedTo(ITemporalUnit)

回傳一份 OffsetDateTime 的副本,時間被截斷。

UnregisterFromRuntime()

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

(繼承來源 Object)
Until(ITemporal, ITemporalUnit)

以指定單位計算到下一個日期時間的時間。

Wait()

導致目前執行緒等待被喚醒,通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。

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

會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。

(繼承來源 Object)
Wait(Int64)

會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。

(繼承來源 Object)
With(ITemporalAdjuster)

回傳經過調整的日期副本。

With(ITemporalField, Int64)

回傳一份將指定欄位設定為新值的日期-時間副本。

WithDayOfMonth(Int32)

回傳一份修改日期日期的 OffsetDateTime。

WithDayOfYear(Int32)

回傳一份已更改年份日期的 OffsetDateTime 副本。

WithHour(Int32)

回傳一份修改了整點的 OffsetDateTime 副本。

WithMinute(Int32)

回傳一份修改過整點的 OffsetDateTime 副本。

WithMonth(Int32)

回傳一份已更改年份月份的 OffsetDateTime 副本。

WithNano(Int32)

回傳一份OffsetDateTime的副本,並修改了秒數的奈米。

WithOffsetSameInstant(ZoneOffset)

回傳一份帶有指定偏移量的 OffsetDateTime 副本,確保結果在同一時刻。

WithOffsetSameLocal(ZoneOffset)

回傳一份帶有指定偏移量的 OffsetDateTime 副本,確保結果具有相同的本地日期時間。

WithSecond(Int32)

回傳一份修改過分鐘秒的 OffsetDateTime 副本。

WithYear(Int32)

回傳一份已更改年份的 OffsetDateTime 副本。

明確介面實作

名稱 Description
IComparable.CompareTo(Object)

將此物件與指定的物件比較排序。

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 端是否有效。

適用於