Clock 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供使用时区访问当前即时、日期和时间的时钟。
[Android.Runtime.Register("java/time/Clock", ApiSince=26, DoNotGenerateAcw=true)]
public abstract class Clock : Java.Lang.Object, IDisposable, Java.Time.IInstantSource
[<Android.Runtime.Register("java/time/Clock", ApiSince=26, DoNotGenerateAcw=true)>]
type Clock = class
inherit Object
interface IInstantSource
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 继承
- 特性
- 实现
注解
提供使用时区访问当前即时、日期和时间的时钟。
此抽象类的实例用于访问当前即时的可插入表示形式,可以使用存储的时区来查找当前日期和时间。 例如, Clock 可以使用而不是 System#currentTimeMillis() 和 TimeZone#getDefault()。
使用 Clock 是可选的。 所有关键日期时间类也有一个 now() 工厂方法,该方法使用默认时区中的系统时钟。 此抽象的主要用途是允许根据需要插入备用时钟。 应用程序使用对象获取当前时间,而不是静态方法。 这可以简化测试。
因此,此抽象类不能保证结果实际上表示时间线上的当前即时。 相反,它允许应用程序提供当前即时和时区的受控视图。
应用程序的最佳做法是传入 Clock 需要当前即时和时区的任何方法。 依赖项注入框架是实现此目的的一种方法:
public class MyBean {
private Clock clock; // dependency inject
...
public void process(LocalDate eventDate) {
if (eventDate.isBefore(LocalDate.now(clock)) {
...
}
}
}
此方法允许备用时钟,例如 #fixed(Instant, ZoneId) fixed 或在 #offset(Clock, Duration) offset 测试期间使用。
工厂 system 方法基于最佳可用系统时钟提供时钟。 这可以使用,或者如果可用,则使用 System#currentTimeMillis()更高分辨率的时钟。
已在 1.8 中添加。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
| 名称 | 说明 |
|---|---|
| Clock() |
子类可访问的构造函数。 |
| Clock(IntPtr, JniHandleOwnership) |
创建表示现有Java对象的托管实例。 |
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
获取用于访问此Java绑定成员的 JNI 元数据。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| ThresholdClass |
获取用于虚拟方法调度的 Java 类。 |
| ThresholdType |
获取声明此Java绑定的托管类型。 |
| Zone |
获取用于创建日期和时间的时区。 |
方法
| 名称 | 说明 |
|---|---|
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
将此对等方的构造委托给运行时的值管理器。 (继承自 JavaObject) |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
要求值管理器释放此对等方,除非其映射保留此相同的托管实例。 (继承自 JavaObject) |
| Equals(Object) |
测试另一个托管对等方是否引用同一Java对象。 (继承自 JavaObject) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| Fixed(Instant, ZoneId) |
获取始终返回相同即时的时钟。 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| Instant() |
获取时钟的当前即时。 |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| Millis() |
获取时钟的当前毫秒时间。 |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| Offset(Clock, Duration) |
获取从指定时钟返回具有指定持续时间的即时的时钟的时钟。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。 (继承自 JavaObject) |
| System(ZoneId) |
获取使用最佳可用系统时钟返回当前即时的时钟。 |
| SystemDefaultZone() |
获取使用最佳可用系统时钟返回当前即时的时钟,并使用默认时区转换为日期和时间。 |
| SystemUTC() |
获取使用最佳可用系统时钟返回当前即时的时钟,并使用 UTC 时区转换为日期和时间。 |
| Tick(Clock, Duration) |
获取一个时钟,该时钟返回从被截断到指定持续时间最近的时间点的指定时钟的实例。 |
| TickMillis(ZoneId) |
获取一个时钟,该时钟使用最佳可用系统时钟以整毫秒为单位返回当前即时计时。 |
| TickMinutes(ZoneId) |
获取一个时钟,该时钟使用最佳可用系统时钟在整分钟内返回当前即时计时。 |
| TickSeconds(ZoneId) |
获取一个时钟,该时钟使用最佳可用系统时钟以整秒为单位返回当前即时计时。 |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| 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) |
| WithZone(ZoneId) |
返回具有不同时区的此时钟的副本。 |
显式接口实现
| 名称 | 说明 |
|---|---|
| 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) |
尝试强制 |