语言

Duration 类

定义

基于时间的时间量,例如“34.5 秒”。

[Android.Runtime.Register("java/time/Duration", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class Duration : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable, Java.Time.Temporal.ITemporalAmount
[<Android.Runtime.Register("java/time/Duration", ApiSince=26, DoNotGenerateAcw=true)>]
type Duration = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable
    interface ITemporalAmount
继承
特性
实现

注解

基于时间的时间量,例如“34.5 秒”。

此类根据秒数和纳秒数对数量或时间进行建模。 可以使用其他基于持续时间的单位(例如分钟和小时)访问它。 此外, ChronoUnit#DAYS DAYS 可以使用该单元,并被视为完全等于 24 小时,从而忽略夏令时效果。 有关此类的基于日期的等效项,请参阅 Period 。

物理持续时间可能无限长。 为了现实,持续时间以类似于 Instant的约束存储。 持续时间使用纳秒分辨率,其最大值可在一个 long中保存。 这大于宇宙目前的估计年龄。

持续时间的范围要求存储大于一个 long数字。 为了实现此目的,该类存储一个 long 表示秒数和一个 int 表示纳秒秒,该秒数始终介于 0 到 999,999,999 之间。 模型具有定向持续时间,这意味着持续时间可能是负数。

持续时间以“秒”度量,但这些持续时间不一定与基于原子时钟的科学“SI 秒”定义相同。 这种差异仅影响在飞跃秒附近测量的持续时间,不应影响大多数应用程序。 请参阅 Instant 讨论第二次和时间刻度的含义。

已在 1.8 中添加。

Java文档java.time.Duration。

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

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
IsNegative

检查此持续时间是否为负,不包括零。

IsPositive

检查此持续时间是否为正,不包括零。

IsZero

检查此持续时间是否为零长度。

JniIdentityHashCode

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

(继承自 Object)
JniManagedPeerState

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

(继承自 JavaObject)
JniPeerMembers

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

Nano

获取此持续时间内秒内秒数。

PeerReference

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

(继承自 Object)
Seconds

获取此持续时间中的秒数。

ThresholdClass

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

(继承自 Object)
ThresholdType

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

(继承自 Object)
Units

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

Zero

持续时间为零的常量。

方法

名称 说明
Abs()

返回此持续时间的副本,长度为正。

AddTo(ITemporal)

将此持续时间添加到指定的临时对象。

Between(ITemporal, ITemporal)

获取表示两个临时对象之间的持续时间的持续时间。

Clone()

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

(继承自 Object)
CompareTo(Duration)

将此持续时间与指定的持续时间进行比较。

Construct(JniObjectReference, JniObjectReferenceOptions)

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

(继承自 JavaObject)
Dispose()

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

(继承自 Object)
Dispose(Boolean)

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

(继承自 Object)
DisposeUnlessReferenced()

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

(继承自 JavaObject)
DividedBy(Duration)

返回指定工期在此持续时间内发生的整个次数。

DividedBy(Int64)

返回此持续时间的副本除以指定值。

Equals(Object)

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

(继承自 JavaObject)
Equals(Object)

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

(继承自 Object)
From(ITemporalAmount)

从临时量获取持续时间的实例。

Get(ITemporalUnit)

获取所请求单位的值。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Minus(Duration)

返回此持续时间的副本,并减去指定的持续时间。

Minus(Int64, ITemporalUnit)

返回此持续时间的副本,并减去指定的持续时间。

MinusDays(Int64)

返回此持续时间的副本,其中指定持续时间(以标准 24 小时为单位)减去。

MinusHours(Int64)

返回此持续时间的副本,指定的持续时间(以小时为单位减去)。

MinusMillis(Int64)

返回此持续时间的副本,指定的持续时间(以毫秒为单位减去)。

MinusMinutes(Int64)

返回此持续时间的副本,指定的持续时间(以分钟为单位减去)。

MinusNanos(Int64)

返回此持续时间的副本,指定的持续时间(以纳秒为单位减去)。

MinusSeconds(Int64)

返回此持续时间的副本,指定的持续时间(以秒为单位减去)。

MultipliedBy(Int64)

返回此持续时间的副本乘以标量。

Negated()

返回此持续时间的副本,长度被否定。

Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
Of(Int64, ITemporalUnit)

获取表示指定单位中的金额的持续时间。

OfDays(Int64)

获取表示标准 24 小时天数的持续时间。

OfHours(Int64)

获取表示标准小时数的持续时间。

OfMillis(Int64)

获取表示毫秒数的持续时间。

OfMinutes(Int64)

获取表示标准分钟数的持续时间。

OfNanos(Int64)

获取表示数纳秒数的持续时间。

OfSeconds(Int64, Int64)

获取表示秒数的持续时间和以纳秒为单位的调整。

OfSeconds(Int64)

获取表示秒数的持续时间。

Parse(ICharSequence)

从文本字符串(如 PnDTnHnMn.nS)获取持续时间。

Parse(String)

分析字符串中的持续时间。

Plus(Duration)

返回添加指定持续时间的此持续时间的副本。

Plus(Int64, ITemporalUnit)

返回添加指定持续时间的此持续时间的副本。

PlusDays(Int64)

返回此持续时间的副本,该持续时间在标准 24 小时中添加了指定的持续时间。

PlusHours(Int64)

返回此持续时间的副本,并添加指定的持续时间(以小时为单位)。

PlusMillis(Int64)

返回此持续时间的副本,并添加指定的持续时间(以毫秒为单位)。

PlusMinutes(Int64)

返回此持续时间的副本,其中添加了指定的持续时间(以分钟为单位)。

PlusNanos(Int64)

返回此持续时间的副本,该持续时间以纳秒为单位添加。

PlusSeconds(Int64)

返回此持续时间的副本,并添加指定的持续时间(以秒为单位)。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

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

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

(继承自 JavaObject)
SubtractFrom(ITemporal)

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

ToArray<T>()

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

(继承自 Object)
ToDays()

获取此持续时间中的天数。

ToDaysPart()

提取持续时间中的天数。

ToHours()

获取此持续时间中的小时数。

ToHoursPart()

提取持续时间中的小时数。

ToMillis()

将此持续时间转换为总长度(以毫秒为单位)。

ToMillisPart()

提取持续时间部分的毫秒数。

ToMinutes()

获取此持续时间中的分钟数。

ToMinutesPart()

提取持续时间中的分钟数部分。

ToNanos()

将此持续时间转换为以纳秒为单位的总长度(以纳秒为单位 long)。

ToNanosPart()

在持续时间的几秒内获取 nanoseconds 部分。

ToSeconds()

获取此持续时间中的秒数。

ToSecondsPart()

提取持续时间中的秒数。

ToString()

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

(继承自 Object)
TruncatedTo(ITemporalUnit)

返回将此持续时间截断到指定单位的副本。

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

返回具有指定纳秒的此持续时间的副本。

WithSeconds(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端有效。

适用于