Period 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
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 中添加。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
属性
| 名称 | 说明 |
|---|---|
| Chronology |
获取此时间段的计时,即 ISO 日历系统。 |
| Class |
返回此 |
| 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() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
从运行时的Java对象查找中删除此实例。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |