Year 類別

定義

命名空間:: Java.Time

組件:: Mono.Android.dll

重要

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

ISO-8601 日曆系統中的一年，例如 2007。

[Android.Runtime.Register("java/time/Year", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class Year : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable, Java.Time.Temporal.ITemporal, Java.Time.Temporal.ITemporalAdjuster

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

繼承: Object

JavaObject

Object
Year

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ISerializable IComparable ITemporal ITemporalAccessor ITemporalAdjuster IDisposable

備註

ISO-8601 日曆系統中的一年，例如 2007。

Year 是一個不可變的日期-時間物件，代表年份。任何可由年份推導的欄位皆可取得。

<b>請注意，ISO 年表中的年份僅與現代年份的 Gregorian-Julian 系統年份相符。俄羅斯部分地區直到1920年才改用現代格里曆/ISO規則。因此，歷史年份必須謹慎對待。</b>

此類別不儲存或表示月份、日期、時間或時區。例如，值「2007」可以儲存在 Year。

此類別所代表的年份遵循 ISO-8601 標準，並採用預示編號系統。第一年之前是0年，然後是-1年。

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

新增於1.8版本。

的 java.time.YearJava 檔。

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

欄位

名稱	Description
MaxValue	最大支持年份為「+999,999,999」。
MinValue	最低支持年份為「-999,999,999」。

屬性

名稱	Description
Class	傳回這個 `Object`的運行時間類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsLeap	根據ISO預言曆法系統規則，檢查該年份是否為閏年。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
JniPeerMembers	ISO-8601 日曆系統中的一年，例如 `2007`。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 Object)
ThresholdType	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 Object)
Value	取得年份價值。

方法

名稱	Description
AdjustInto(ITemporal)	調整指定的時間物件，使其成為今年的目標。
AtDay(Int32)	將今年與一年中的某一天結合，建立一個 LocalDate。
AtMonth(Int32)	將今年與月份合併，形成一個年度月。
AtMonth(Month)	將今年與月份合併，形成一個年度月。
AtMonthDay(MonthDay)	今年與月日合併，形成一個 LocalDate。
Clone()	建立並傳回這個對象的複本。 (繼承來源 Object)
CompareTo(Year)	拿今年和另一年比較。
Construct(JniObjectReference, JniObjectReferenceOptions)	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
Equals(Object)	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
Format(DateTimeFormatter)	今年使用指定的格式化器。
From(ITemporalAccessor)	從一個時間物件獲得 Year 實例。
Get(ITemporalField)	取得今年指定欄位的值作為整數值。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
GetLong(ITemporalField)	取得今年指定欄位的值為 long。
InvokeIsLeap(Int64)	根據ISO預言曆法系統規則，檢查該年份是否為閏年。
IsAfter(Year)	檢查今年是否超過指定年份。
IsBefore(Year)	檢查今年是否早於指定年份。
IsSupported(ITemporalField)	檢查指定欄位是否支援。
IsSupported(ITemporalUnit)	檢查指定單位是否支援。
IsValidMonthDay(MonthDay)	檢查今年的月份日是否有效。
JavaFinalize()	已淘汰. 當垃圾收集決定不再參考物件時，垃圾收集行程在物件上呼叫。 (繼承來源 Object)
Length()	以天數計算今年的長度。
Minus(Int64, ITemporalUnit)	退回一份今年的副本，扣除指定金額。
Minus(ITemporalAmount)	退回一份今年的副本，扣除指定金額。
MinusYears(Int64)	回傳一份本年度副本，並扣除指定年數。
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
Now()	ISO-8601 日曆系統中的一年，例如 `2007`。
Now(Clock)	從指定的時鐘取得當前年份。
Now(ZoneId)	從指定時區的系統時鐘取得當前年份。
Of(Int32)	獲得一年的實例。
Parse(ICharSequence, DateTimeFormatter)	從特定格式化器中的文字字串取得 Year 實例。
Parse(ICharSequence)	可從文字串（如 2007）取得 Year 的實例。
Parse(String, DateTimeFormatter)	ISO-8601 日曆系統中的一年，例如 `2007`。
Parse(String)	ISO-8601 日曆系統中的一年，例如 `2007`。
Plus(Int64, ITemporalUnit)	回傳一份今年的副本，並加上指定金額。
Plus(ITemporalAmount)	回傳一份今年的副本，並加上指定金額。
PlusYears(Int64)	回傳本年度副本，並加上指定的年數。
Query(ITemporalQuery)	今年使用指定的查詢查詢。
Range(ITemporalField)	取得指定欄位的有效值範圍。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Until(ITemporal, ITemporalUnit)	以指定單位計算距離下一年的時間。
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)
With(ITemporalAdjuster)	回傳的是今年的修正版。
With(ITemporalField, Int64)	回傳今年的副本，並將指定欄位設定為新值。

明確介面實作

名稱	Description
IComparable.CompareTo(Object)	ISO-8601 日曆系統中的一年，例如 `2007`。
IJavaPeerable.Disposed()	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	ISO-8601 日曆系統中的一年，例如 `2007`。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	ISO-8601 日曆系統中的一年，例如 `2007`。

擴充方法

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

適用於