LocalDate 類別

定義

命名空間:: Java.Time

組件:: Mono.Android.dll

重要

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

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

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

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

繼承: Object

JavaObject

Object
LocalDate

屬性: RegisterAttribute

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

備註

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

LocalDate 是一個不可變的日期-時間物件，代表日期，通常被視為年-月-日。其他日期欄位，如年份、週數及週數，也可存取。例如，值「2nd October 2007」可以儲存在 LocalDate。

此類別不儲存或表示時間或時區。相反地，它是對日期的描述，就像生日的用法一樣。沒有額外資訊（如偏移或時區）時，它無法代表時間軸上的某個瞬間。

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

新增於1.8版本。

Java 文件 java.time.LocalDate。

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

屬性

名稱	Description
Chronology	取得這個日期的時間順序，也就是 ISO 日曆系統。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
DayOfMonth	會得到月份的日期欄位。
DayOfWeek	會得到星期幾欄位，這是一個星期幾的星期。
DayOfYear	會拿到年份欄位。
Epoch	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。
Era	此時適用的時代。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsLeapYear	根據ISO預言曆法系統規則，檢查該年份是否為閏年。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
JniPeerMembers	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。
Max	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。
Min	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。
Month	使用 Month enum 取得 month of year 欄位。
MonthValue	可以取得月份和年份欄位，範圍從1到12。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
Year	會拿到年份欄位。

方法

名稱	Description
AdjustInto(ITemporal)	調整指定的時間物件，使其日期與此物件相同。
AtStartOfDay()	將此日期與午夜時間結合，建立該日期開始時的 LocalDateTime。
AtStartOfDay(ZoneId)	根據該時區規則，從該日期回傳一個分區日期時間，並以最早有效時間為準。
AtTime(Int32, Int32, Int32, Int32)	將此日期與時間結合，建立 LocalDateTime。
AtTime(Int32, Int32, Int32)	將此日期與時間結合，建立 LocalDateTime。
AtTime(Int32, Int32)	將此日期與時間結合，建立 LocalDateTime。
AtTime(LocalTime)	將此日期與時間結合，建立 LocalDateTime。
AtTime(OffsetTime)	將此日期與一個偏移時間結合，建立一個 OffsetDateTime。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CompareTo(IChronoLocalDate)	將此日期與另一個日期做比較。
CompareTo(Object)	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。
Construct(JniObjectReference, JniObjectReferenceOptions)	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
Equals(Object)	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
Format(DateTimeFormatter)	請使用指定的格式化器來格式化這個日期。
From(ITemporalAccessor)	從一個時間物件取得 LocalDate 的實例。
Get(ITemporalField)	從此日期取得指定欄位的值，作為整數值。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetLong(ITemporalField)	從該日期取得指定欄位的值為 long。
IsAfter(IChronoLocalDate)	檢查這個日期是否已經超過指定日期。
IsBefore(IChronoLocalDate)	檢查該日期是否早於指定日期。
IsEqual(IChronoLocalDate)	檢查此日期是否等於指定日期。
IsSupported(ITemporalField)	檢查指定欄位是否支援。
IsSupported(ITemporalUnit)	檢查指定單位是否支援。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
LengthOfMonth()	回傳此日期所代表的月份長度。
LengthOfYear()	回傳該日期所代表的年度長度。
Minus(Int64, ITemporalUnit)	回傳一份該日期的副本，並扣除指定金額。
Minus(ITemporalAmount)	回傳一份該日期的副本，並扣除指定金額。
MinusDays(Int64)	回傳一份已扣除指定天數的 LocalDate 副本。
MinusMonths(Int64)	回傳一份已扣除指定月份數的 LocalDate 副本。
MinusWeeks(Int64)	回傳一份已扣除指定週數的 LocalDate 副本。
MinusYears(Int64)	回傳一份已扣除指定年數的本地日期副本。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Now()	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。
Now(Clock)	從指定的時鐘中取得當前日期。
Now(ZoneId)	從指定時區的系統時鐘取得當前日期。
Of(Int32, Int32, Int32)	取得一個年份、月份和日期的 LocalDate 實例。
Of(Int32, Month, Int32)	取得一個年份、月份和日期的 LocalDate 實例。
OfEpochDay(Int64)	從紀元日計數中取得 LocalDate 的實例。
OfInstant(Instant, ZoneId)	從即時與區域 ID 取得 LocalDate 實例。
OfYearDay(Int32, Int32)	取得 LocalDate 的年份和年份日期實例。
Parse(ICharSequence, DateTimeFormatter)	使用特定格式化器從文字字串取得 LocalDate 實例。
Parse(ICharSequence)	從文字串（如 2007-12-03）取得 LocalDate 實例。
Parse(String, DateTimeFormatter)	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。
Parse(String)	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。
Plus(Int64, ITemporalUnit)	回傳一份日期副本，並加上指定的金額。
Plus(ITemporalAmount)	回傳一份日期副本，並加上指定的金額。
PlusDays(Int64)	回傳一份已加入指定天數的 LocalDate 副本。
PlusMonths(Int64)	回傳一份已加入指定月份數的 LocalDate 副本。
PlusWeeks(Int64)	回傳一份已加入指定週數的 LocalDate 副本。
PlusYears(Int64)	回傳一份包含指定年數的本地日期副本。
Query(ITemporalQuery)	使用指定的查詢來查詢此日期。
Range(ITemporalField)	取得指定欄位的有效值範圍。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToEpochDay()	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。
ToEpochSecond(LocalTime, ZoneOffset)	將此LocalDate轉換為自1970-01-01T00：00：00Z以來的秒數。
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Until(IChronoLocalDate)	將此日期與另一個日期之間的期間計算為一個期間。
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)	回傳一份已更改月份日期的本地日期副本。
WithDayOfYear(Int32)	回傳一份已更改年份的本地日期副本。
WithMonth(Int32)	回傳一份已更改年份月份的本地日期副本。
WithYear(Int32)	回傳一份已更改年份的本地日期副本。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	在 ISO-8601 日曆系統中沒有時區的日期，例如 `2007-12-03`。

擴充方法

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

適用於