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

Object

SystemClock

屬性

RegisterAttribute

備註

核心守時設施。

有三個不同的時鐘可供使用，因此不應混淆：

<ul><li>

System#currentTimeMillis System.currentTimeMillis() 是標準「牆」時鐘（時間和日期），表示自 epoch 以來的毫秒數。 時鐘可由使用者或電話網路設定（見 #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(millls)、 Object#wait(long) Object.wait(millis)和 System#nanoTime System.nanoTime()。 此時鍾保證為單調，且適合在間隔不跨越裝置睡眠時使用間隔時間。 接受時間戳值的大部分方法目前都預期 #uptimeMillis 時鐘。

<李>

#elapsedRealtime 並 #elapsedRealtimeNanos 傳回系統開機后的時間，並包含深度睡眠。 此時鍾保證為單調，即使 CPU 處於省電模式，仍會繼續刻度，因此是一般用途間隔時間的建議基礎。

</ul>

有數種機制可用來控制事件的時機：

<ul><li>

和等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 （通常存在於任何 GUI 應用程式中）。

<李>

android.app.AlarmManager可以觸發一次性或週期性事件，即使裝置處於深度睡眠狀態，或您的應用程式未執行也一次。 事件可能會隨著您選擇的 java.lang.System#currentTimeMillis （RTC） 或 #elapsedRealtime （ELAPSED_REALTIME） 排程，並在事件發生時產生 android.content.Intent 廣播。 </ul>

的 android.os.SystemClockJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

屬性

方法

明確介面實作

擴充方法

適用於