Period 類別

定義

命名空間:

Java.Time

組件:

Mono.Android.dll

在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。

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

[<Android.Runtime.Register("java/time/Period", ApiSince=26, DoNotGenerateAcw=true)>]
type Period = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IChronoPeriod
    interface ITemporalAmount

繼承

Object

JavaObject

Object

Period

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ISerializable IChronoPeriod ITemporalAmount IDisposable

備註

在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。

這門課以年、月和天來模擬時間的數量或長度。 請參見 Duration 此類別的時間等價物。

在加入 ZonedDateTime後，時間和期間對夏令時間的處理方式有所不同。 A Duration 會加上精確的秒數，因此一天的持續時間總是恰好 24 小時。 相較之下，A Period 會加入概念性一天，試圖維持當地時間。

例如，考慮在夏令時間間隔前的晚上18：00，增加一天的時間段和一天的時間。 他們 Period 會加上概念日，結果 ZonedDateTime 是隔天18：00。 相反地，會 Duration 加整整24小時，結果是 ZonedDateTime 隔天19：00（假設有1小時的DST空檔）。

一個週期的支撐單位為 ChronoUnit#YEARS YEARS、 和 ChronoUnit#MONTHS MONTHSChronoUnit#DAYS DAYS。 這三個欄位始終存在，但可設為零。

ISO-8601 曆法系統是現今世界大多數地區使用的現代民用曆法系統。 它相當於前置的格里曆系統，該系統將現今的閏年規則適用於所有時間。

該週期以定向時間長度來建模，意味著週期中的個別部分可能是負值。

新增於1.8版本。

的 java.time.PeriodJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

屬性

名稱	Description
Chronology	取得此時期的時間順序，也就是ISO曆法系統。
Class	傳回這個 Object的運行時間類別。 (繼承來源 Object)
Days	取得這段期間的天數。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsNegative	檢查此期間三個單位中是否有任何一個為負值。
IsZero	檢查這段期間的三個單位是否全部為零。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
JniPeerMembers	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。
Months	會知道這段期間的月份數。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 Object)
ThresholdType	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 Object)
Units	取得該期間所支持的單位集合。
Years	取得這段期間的年數。
Zero	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。

方法

名稱	Description
AddTo(ITemporal)	將此週期加到指定的時間對象上。
Between(LocalDate, LocalDate)	取得一個由兩個日期之間年、月、天數組成的期間。
Clone()	建立並傳回這個 對象的複本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
Equals(Object)	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
From(ITemporalAmount)	從時間值獲得一個 Period 實例。
Get(ITemporalUnit)	取得所要求單位的價值。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾收集決定不再參考物件時，垃圾收集行程在 物件上呼叫。 (繼承來源 Object)
Minus(ITemporalAmount)	回傳該期間的副本，並扣除指定期間。
MinusDays(Int64)	回傳此期間的副本，並扣除指定天數。
MinusMonths(Int64)	回傳該期間的副本，並扣除指定月份。
MinusYears(Int64)	回傳該期間的副本，並扣除指定年份。
MultipliedBy(Int32)	回傳一個新實例，該週期內的每個元素乘以指定的純量。
Negated()	在這段期間內，每個金額都會被抵消，並返回一個新的實例。
Normalized()	回傳一份這段期間的副本，年份和月份已標準化。
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
Of(Int32, Int32, Int32)	取得代表若干年、月和天的期間。
OfDays(Int32)	獲得一個代表若干天數的期間。
OfMonths(Int32)	取得代表數月的期間。
OfWeeks(Int32)	取得代表數週的期間。
OfYears(Int32)	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。
Parse(ICharSequence)	從像 PnYnMnD 這樣的文字串中取得一個句點。
Parse(String)	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。
Plus(ITemporalAmount)	回傳該期間的副本，並加上指定期間。
PlusDays(Int64)	回傳一份包含指定天數的期間副本。
PlusMonths(Int64)	回傳該期間的副本，並加上指定的月份。
PlusYears(Int64)	回傳該期間的副本，並加上指定年份。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
SubtractFrom(ITemporal)	從指定的時間對象中減去此週期。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
ToTotalMonths()	會拿到這段期間的總月份數。
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)
WithDays(Int32)	回傳該期間的副本，並附上指定天數。
WithMonths(Int32)	回傳該期間及指定月份數的副本。
WithYears(Int32)	回傳該期間及指定年限的副本。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	在 ISO-8601 日曆系統中，以日期為基礎的時間長度，例如「2年3個月4天」。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。