OffsetDateTime 類別

定義

命名空間:

Java.Time

組件:

Mono.Android.dll

在 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

繼承

Object

JavaObject

Object

OffsetDateTime

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ISerializable IComparable ITemporal ITemporalAccessor ITemporalAdjuster IDisposable

備註

在 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	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
JniPeerMembers	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。
Max	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。
Min	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01: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)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
Equals(Object)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 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)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。
Parse(String)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。
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)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
TimeLineOrder()	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。
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)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。
IJavaPeerable.Disposed()	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	在 ISO-8601 日曆系統中，與 UTC/Greenwich 有偏移的日期時間，例如 2007-12-03T10:15:30+01:00。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。