Clock 类

定义

[Android.Runtime.Register("java/time/Clock", ApiSince=26, DoNotGenerateAcw=true)]
public abstract class Clock : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, 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

继承

Object

Object

Clock

属性

RegisterAttribute

实现

IJavaObject IJavaPeerable IInstantSource IDisposable

注解

提供使用时区访问当前即时、日期和时间的时钟。

此抽象类的实例用于访问当前即时的可插入表示形式，可以使用存储的时区来查找当前日期和时间。 例如， 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 中添加。

适用于 . 的 java.time.ClockJava 文档

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