Clock 類別

定義

[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

繼承

Object

JavaObject

Object

Clock

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable IInstantSource IDisposable

備註

一個時鐘，透過時區提供即時、日期和時間的存取。

此抽象類別的實例用於存取當前時刻的可插拔表示，並可利用儲存的時區來解讀該表示，以尋找當前日期與時間。 例如， Clock 可以用來代替 System#currentTimeMillis() 和 TimeZone#getDefault()。

使用 a 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 文件 java.time.Clock。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。