语言

Year 类

定义

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
继承
特性
实现

注解

ISO-8601 日历系统中的一年,例如 2007。

Year 是表示年份的不可变日期时间对象。 可以获取可从一年派生的任何字段。

<b>请注意,ISO 时序中的年份与现代 Gregorian-Julian 系统中的年数保持一致。 直到1920年,俄罗斯部分地区才切换到现代公历/ISO 规则。 因此,必须谨慎对待历史岁月。</b>

此类不存储或表示月份、日、时间或时区。 例如,值“2007”可以存储在一个 Year.

此类所表示的年份遵循 ISO-8601 标准,并使用预编号系统。 第 1 年之前是第 0 年,然后是第 -1 年。

ISO-8601 日历系统是当今世界上大多数地区使用的现代民用日历系统。 它相当于公历系统,在该系统中,今天的跨年规则一直适用。 对于今天编写的大多数应用程序,ISO-8601 规则是完全合适的。 但是,任何使用历史日期的应用程序,并要求它们准确将找到不适合的 ISO-8601 方法。

已在 1.8 中添加。

Java文档java.time.Year。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

字段

名称 说明
MaxValue

支持的最大年份“+999,999,999”。

MinValue

支持的最低年份“-999,999,999”。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
IsLeap

根据 ISO proleptic 日历系统规则,检查年份是否为跃年。

JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)
ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)
Value

获取年份值。

方法

名称 说明
AdjustInto(ITemporal)

将指定的临时对象调整为今年。

AtDay(Int32)

将今年与一年一起创建 LocalDate。

AtMonth(Int32)

结合今年与一个月来创建年月。

AtMonth(Month)

结合今年与一个月来创建年月。

AtMonthDay(MonthDay)

将今年与每月一起创建 LocalDate。

Clone()

创建并返回此对象的副本。

(继承自 Object)
CompareTo(Year)

将今年与另一年进行比较。

Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
Format(DateTimeFormatter)

今年使用指定的格式化程序设置格式。

From(ITemporalAccessor)

从临时对象获取 Year 的实例。

Get(ITemporalField)

获取从今年开始作为 int 的指定字段的值。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
GetLong(ITemporalField)

获取从今年开始指定字段的值(长)。

InvokeIsLeap(Int64)

根据 ISO proleptic 日历系统规则,检查年份是否为跃年。

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()

从默认时区中的系统时钟获取当前年份。

Now(Clock)

从指定的时钟获取当前年份。

Now(ZoneId)

从指定时区的系统时钟中获取当前年份。

Of(Int32)

获取 Year 实例。

Parse(ICharSequence, DateTimeFormatter)

使用特定格式化程序从文本字符串中获取 Year 的实例。

Parse(ICharSequence)

从文本字符串(如 2007)获取 Year 的实例。

Parse(String, DateTimeFormatter)

使用指定的格式化程序分析年份字符串。

Parse(String)

分析字符串中的 ISO 日历年。

Plus(Int64, ITemporalUnit)

返回一份包含指定金额的今年副本。

Plus(ITemporalAmount)

返回一份包含指定金额的今年副本。

PlusYears(Int64)

返回已添加指定年份的今年副本。

Query(ITemporalQuery)

今年使用指定的查询查询。

Range(ITemporalField)

获取指定字段的有效值范围。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Until(ITemporal, ITemporalUnit)

根据指定的单位计算一年之前的时间量。

Wait()

使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><>

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)
With(ITemporalAdjuster)

返回今年调整后的副本。

With(ITemporalField, Int64)

返回一个今年的副本,其中指定的字段设置为新值。

显式接口实现

名称 说明
IComparable.CompareTo(Object)

将此对象与指定的顺序对象进行比较。

IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

从运行时的Java对象查找中删除此实例。

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于