LocalDateTime 類別

定義

命名空間:: Java.Time

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 2007-12-03T10:15:30。

[Android.Runtime.Register("java/time/LocalDateTime", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class LocalDateTime : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Time.Chrono.IChronoLocalDateTime

[<Android.Runtime.Register("java/time/LocalDateTime", ApiSince=26, DoNotGenerateAcw=true)>]
type LocalDateTime = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IChronoLocalDateTime
    interface IComparable
    interface ITemporal
    interface ITemporalAccessor
    interface ITemporalAdjuster

繼承: Object

JavaObject

Object
LocalDateTime

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ISerializable IComparable IChronoLocalDateTime ITemporal ITemporalAccessor ITemporalAdjuster IDisposable

備註

在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 2007-12-03T10:15:30。

LocalDateTime 是一個不變的日期-時間物件，代表一個日期時間，通常以年-月-日-小時-分秒來表示。其他日期與時間欄位，如年份、星期及週，亦可存取。時間以奈秒級的精度表示。例如，「2nd October 2 at 13：45.30.123456789」這個值可以儲存在 LocalDateTime.

此類別不儲存或表示時區。它其實是描述生日日期，並結合牆上時鐘上的當地時間。沒有額外資訊（如偏移或時區）時，它無法代表時間軸上的某個瞬間。

ISO-8601 曆法系統是現今世界大多數地區使用的現代民用曆法系統。它相當於前置的格里曆系統，該系統將現今的閏年規則適用於所有時間。對於現今大多數應用程式，ISO-8601 規則完全適用。然而，任何使用歷史日期且要求其準確性的應用程式，都會發現 ISO-8601 方法不適用。

新增於1.8版本。

的 java.time.LocalDateTimeJava 檔。

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

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
DayOfMonth	會得到月份的日期欄位。
DayOfWeek	會得到星期幾欄位，這是一個星期幾的星期。
DayOfYear	會拿到年份欄位。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
Hour	負責一天的時段。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
JniPeerMembers	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
Max	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
Min	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
Minute	他能進入每小時的場地。
Month	使用 Month enum 取得 month of year 欄位。
MonthValue	可以取得月份和年份欄位，範圍從1到12。
Nano	能得到秒奈米的場。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Second	獲得第二分鐘的場地。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
Year	會拿到年份欄位。

方法

名稱	Description
AdjustInto(ITemporal)	調整指定的時間物件，使其與該物件的日期和時間相同。
AtOffset(ZoneOffset)	將此日期時間與偏移量結合，建立 OffsetDateTime。
AtZone(ZoneId)	將此日期時間與時區結合，建立 ZonedDateTime。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CompareTo(IChronoLocalDateTime)	將這個日期時間與另一個日期時間做比較。
CompareTo(Object)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
Construct(JniObjectReference, JniObjectReferenceOptions)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
Equals(Object)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
Format(DateTimeFormatter)	使用指定的格式化器來格式化這個日期時間。
From(ITemporalAccessor)	從一個時間物件取得 LocalDateTime 的實例。
Get(ITemporalField)	從此日期-時間取得指定欄位的值，作為整數值。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetLong(ITemporalField)	從此日期時間取得指定欄位的值，作為長。
IsAfter(IChronoLocalDateTime)	檢查該日期時間是否晚於指定日期時間。
IsBefore(IChronoLocalDateTime)	檢查該日期時間是否早於指定日期。
IsEqual(IChronoLocalDateTime)	檢查此日期時間是否等於指定的日期時間。
IsSupported(ITemporalField)	檢查指定欄位是否支援。
IsSupported(ITemporalUnit)	檢查指定單位是否支援。
JavaFinalize()	當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Minus(Int64, ITemporalUnit)	回傳一份該日期時間的副本，並扣除指定金額。
Minus(ITemporalAmount)	回傳一份該日期時間的副本，並扣除指定金額。
MinusDays(Int64)	回傳一份 LocalDateTime 的副本，並扣除指定的天數。
MinusHours(Int64)	回傳一份 LocalDateTime 的副本，並扣除指定的工時數。
MinusMinutes(Int64)	回傳一份 LocalDateTime 的副本，並扣除指定的分鐘數。
MinusMonths(Int64)	回傳一份已減去指定月份數的 LocalDateTime 副本。
MinusNanos(Int64)	回傳一份 LocalDateTime 的副本，並扣除指定的奈秒數。
MinusSeconds(Int64)	回傳一份 LocalDateTime 的副本，並扣除指定的秒數。
MinusWeeks(Int64)	回傳一份已扣除指定週數的 LocalDateTime 副本。
MinusYears(Int64)	回傳一份已扣除指定年數的 LocalDateTime 副本。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Now()	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
Now(Clock)	從指定的時鐘取得當前日期時間。
Now(ZoneId)	從指定時區的系統時鐘取得當前日期時間。
Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	取得 LocalDateTime 的實例，涵蓋年份、月份、日、小時、分鐘、秒及奈秒。
Of(Int32, Int32, Int32, Int32, Int32, Int32)	取得 LocalDateTime 的年、月、日、時、分鐘和秒，並將奈秒設為零。
Of(Int32, Int32, Int32, Int32, Int32)	取得 LocalDateTime 的年、月、日、小時和分鐘實例，並將秒與奈秒設為零。
Of(Int32, Month, Int32, Int32, Int32, Int32, Int32)	取得 LocalDateTime 的實例，涵蓋年份、月份、日、小時、分鐘、秒及奈秒。
Of(Int32, Month, Int32, Int32, Int32, Int32)	取得 LocalDateTime 的年、月、日、時、分鐘和秒，並將奈秒設為零。
Of(Int32, Month, Int32, Int32, Int32)	取得 LocalDateTime 的年、月、日、小時和分鐘實例，並將秒與奈秒設為零。
Of(LocalDate, LocalTime)	從某個日期和時間取得 LocalDateTime 的實例。
OfEpochSecond(Int64, Int32, ZoneOffset)	利用 1970-01-01T00：00：00Z 的秒數取得 LocalDateTime 實例。
OfInstant(Instant, ZoneId)	從即時與區域 ID 取得 LocalDateTime 實例。
Parse(ICharSequence, DateTimeFormatter)	使用特定格式化器從文字串取得 LocalDateTime 的實例。
Parse(ICharSequence)	從文字串（如 2007-12-03T10：15：30）取得 LocalDateTime 實例。
Parse(String, DateTimeFormatter)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
Parse(String)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
Plus(Int64, ITemporalUnit)	回傳一份日期時間的副本，並加上指定的金額。
Plus(ITemporalAmount)	回傳一份日期時間的副本，並加上指定的金額。
PlusDays(Int64)	回傳一份包含指定天數的 LocalDateTime 副本。
PlusHours(Int64)	回傳一份包含指定工時數的 LocalDateTime 副本。
PlusMinutes(Int64)	回傳一份包含指定分鐘數的 LocalDateTime 副本。
PlusMonths(Int64)	回傳一份包含指定月份數的 LocalDateTime 副本。
PlusNanos(Int64)	回傳一份包含指定奈秒數的 LocalDateTime 副本。
PlusSeconds(Int64)	回傳一份包含指定秒數的 LocalDateTime 副本。
PlusWeeks(Int64)	回傳一份包含指定週數的 LocalDateTime 副本。
PlusYears(Int64)	回傳一份已加入指定年數的 LocalDateTime 副本。
Query(ITemporalQuery)	在此日期點使用指定的查詢進行查詢。
Range(ITemporalField)	取得指定欄位的有效值範圍。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToLocalDate()	會收到這個約會時間裡的 LocalDate 部分。
ToLocalTime()	他會聽到這個日期時間的 LocalTime 部分。
ToString()	回傳物件的字串表示。 (繼承來源 Object)
TruncatedTo(ITemporalUnit)	回傳一份時間被截斷的 LocalDateTime 副本。
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)	回傳一份已更改日期的LocalDateTime副本。
WithDayOfYear(Int32)	回傳一份已更改年份日期的本地日期。
WithHour(Int32)	回傳一份已更改整點的 LocalDateTime 副本。
WithMinute(Int32)	回傳一份已更改整點的LocalDateTime副本。
WithMonth(Int32)	回傳一份已更改年份的 LocalDateTime 副本。
WithNano(Int32)	回傳一份LocalDateTime的副本，但秒數的奈米被更改。
WithSecond(Int32)	回傳一份修改過分鐘秒的 LocalDateTime 副本。
WithYear(Int32)	回傳一份已更改年份的本地日期時間副本。

明確介面實作

名稱	Description
IChronoLocalDateTime.AtZone(ZoneId)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
IChronoLocalDateTime.Plus(Int64, ITemporalUnit)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
IChronoLocalDateTime.ToLocalDate()	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
IChronoLocalDateTime.With(ITemporalField, Int64)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。
IJavaPeerable.Disposed()	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	在 ISO-8601 日曆系統中，沒有時區的日期時間，例如 `2007-12-03T10:15:30`。

擴充方法

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

適用於