语言

Period 类

定义

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

注解

ISO-8601 日历系统中基于日期的时间量,例如“2 年、3 个月和 4 天”。

此类根据年份、月和天对数量或时间进行建模。 有关此类的基于时间的等效项,请参阅 Duration 。

加到 ZonedDateTime的夏令时,工期和时间段在处理夏令时有所不同。 A Duration 将添加确切的秒数,因此一天的持续时间始终正好为 24 小时。 相比之下,一个 Period 概念日将添加一个概念日,试图维护本地时间。

例如,请考虑在夏令时差前晚上将一天的时间段和一天的持续时间添加到 18:00。 这将 Period 添加概念日,并导致 ZonedDateTime 第二天为 18:00。 相比之下, Duration 将添加恰好24小时,导致 ZonedDateTime 第二天19:00(假设有一小时的DST差距)。

句点支持的单位是 ChronoUnit#YEARS YEARS, ChronoUnit#MONTHS MONTHS 以及 ChronoUnit#DAYS DAYS。 这三个字段始终存在,但可能设置为零。

ISO-8601 日历系统是当今世界上大多数地区使用的现代民用日历系统。 它相当于公历系统,在该系统中,今天的跨年规则一直适用。

周期建模为定向时间量,这意味着该时间段的各个部分可能是负数。

已在 1.8 中添加。

Java文档java.time.Period。

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

属性

名称 说明
Chronology

获取此时间段的计时,即 ISO 日历系统。

Class

返回此 Object的运行时类。

(继承自 Object)
Days

获取此时间段的天数。

Handle

基础 Android 实例的句柄。

(继承自 Object)
IsNegative

检查此时间段的三个单位中的任何一个是否为负数。

IsZero

检查此时间段的所有三个单位是否为零。

JniIdentityHashCode

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

(继承自 Object)
JniManagedPeerState

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

(继承自 JavaObject)
JniPeerMembers

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

Months

获取此时间段的月数。

PeerReference

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

(继承自 Object)
ThresholdClass

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

(继承自 Object)
ThresholdType

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

(继承自 Object)
Units

获取此时间段支持的单位集。

Years

获取此时间段的年数。

Zero

一个周期为零的常量。

方法

名称 说明
AddTo(ITemporal)

将此句点添加到指定的临时对象。

Between(LocalDate, LocalDate)

获取包含两个日期之间的年数、月数和天数的时间段。

Clone()

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

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

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

(继承自 JavaObject)
Dispose()

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

(继承自 Object)
Dispose(Boolean)

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

(继承自 Object)
DisposeUnlessReferenced()

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

(继承自 JavaObject)
Equals(Object)

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

(继承自 JavaObject)
Equals(Object)

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

(继承自 Object)
From(ITemporalAmount)

从临时量获取句点的实例。

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)

获取表示几年的时间段。

Parse(ICharSequence)

从文本字符串(如 PnYnMnD)获取句点。

Parse(String)

分析字符串中的年、月和日。

Plus(ITemporalAmount)

返回此时间段的副本,并添加指定的句点。

PlusDays(Int64)

返回此时间段的副本,并添加指定的天数。

PlusMonths(Int64)

返回此时间段的副本,其中包含添加的指定月份。

PlusYears(Int64)

返回此时间段的副本,并添加指定的年份。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

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

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

(继承自 JavaObject)
SubtractFrom(ITemporal)

从指定的临时对象中减去此时间段。

ToArray<T>()

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

(继承自 Object)
ToString()

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

(继承自 Object)
ToTotalMonths()

获取此时间段中的月总数。

UnregisterFromRuntime()

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

(继承自 Object)
Wait()

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

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

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

(继承自 Object)
Wait(Int64)

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

(继承自 Object)
WithDays(Int32)

返回具有指定天数的此时间段的副本。

WithMonths(Int32)

返回此时间段的副本,其中包含指定的月数。

WithYears(Int32)

返回具有指定年份的此时间段的副本。

显式接口实现

名称 说明
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端有效。

适用于