SystemClock 類別

定義

[Android.Runtime.Register("android/os/SystemClock", DoNotGenerateAcw=true)]
public sealed class SystemClock : Java.Lang.Object

[<Android.Runtime.Register("android/os/SystemClock", DoNotGenerateAcw=true)>]
type SystemClock = class
    inherit Object

繼承

Object

JavaObject

Object

SystemClock

屬性

RegisterAttribute

備註

核心考勤設施。

有三種不同的時鐘可供選擇，且不應混淆：

<烏爾><·李>

System#currentTimeMillis System.currentTimeMillis() 是標準的「壁鐘」（時間與日期），表示自紀元以來的毫秒。 牆上時鐘可由使用者或電話網路設定（參見 #setCurrentTimeMillis），因此時間可能會不可預測地前後跳動。 此時鐘僅在與現實日期和時間對應重要時使用，例如日曆或鬧鐘應用。 間隔或經過時間的測量應該使用不同的時鐘。 如果你使用 System.currentTimeMillis（），可以考慮聆聽 android.content.Intent#ACTION_TIME_TICK ACTION_TIME_TICK、 android.content.Intent#ACTION_TIME_CHANGED ACTION_TIME_CHANGED 和 android.content.Intent#ACTION_TIMEZONE_CHANGED ACTION_TIMEZONE_CHANGEDandroid.content.Intent Intent 廣播，以了解時間何時改變。

<李>

#uptimeMillis 自系統啟動以來，會以毫秒計數。 當系統進入深度休眠（CPU 關閉、顯示器變暗、裝置等待外部輸入）時，這個時脈會停止，但不受時脈縮放、閒置或其他省電機制影響。 這是大多數區間計時的基礎，如 Thread#sleep(long) Thread.sleep(millis)、 Object#wait(long) Object.wait(millis)和 System#nanoTime System.nanoTime()。 此時鐘保證為單調，適合在間隔未跨越裝置睡眠時進行間隔計時。 大多數接受時間戳記值的方法目前都預期時鐘。#uptimeMillis

<李>

#elapsedRealtime 並 #elapsedRealtimeNanos 回傳自系統啟動以來的時間，並包含深度睡眠。 此時脈保證為單調，且即使 CPU 處於省電模式仍持續跳動，因此是一般間隔定時的推薦基準。

</ul>

控制事件時機有幾種機制：

<烏爾><·李>

標準功能 Thread#sleep(long) Thread.sleep(millis) 如 和 Object#wait(long) Object.wait(millis) 總是可用。 這些功能會利用 #uptimeMillis 時鐘;如果裝置進入睡眠狀態，剩餘的時間會延後，直到裝置喚醒。 這些同步函數可能會被中斷， Thread#interrupt Thread.interrupt()你必須處理 InterruptedException。

<李>

#sleep SystemClock.sleep(millis) 是一個與 非常相似 Thread#sleep(long) Thread.sleep(millis)的效用函數，但它忽略 InterruptedException了 。 如果你不使用 Thread#interrupt Thread.interrupt()，請使用此函式來延遲，因為它會保留執行緒的中斷狀態。

<李>

該 android.os.Handler 類別可在絕對時間或相對時間安排非同步回撥。 處理器物件也會使用 #uptimeMillis 時鐘，並需要一個 android.os.Looper event loop （通常存在於任何圖形介面應用程式中）。

<李>

即使裝置處於深度休眠或應用程式未執行，也可能 android.app.AlarmManager 觸發一次性或重複發生的事件。 活動可依您選擇 java.lang.System#currentTimeMillis 的（RTC）或 #elapsedRealtime （ELAPSED_REALTIME）安排，並在發生時引發 android.content.Intent 廣播。 </ul>

Java 文件 android.os.SystemClock。

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