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() 是标准“壁”时钟（时间和日期）表示自纪元以来的毫秒数。 时钟可由用户或电话网络设置（见 #setCurrentTimeMillis），因此时间可能会向后或向前跳转不可预知。 仅当与实际日期和时间的对应关系非常重要（例如日历或闹钟应用程序中）时，才应使用此时钟。 间隔或已用时间度量应使用不同的时钟。 如果使用 System.currentTimeMillis（），请考虑侦 android.content.Intent#ACTION_TIME_TICK ACTION_TIME_TICK听和 android.content.Intent#ACTION_TIME_CHANGED ACTION_TIME_CHANGEDandroid.content.Intent#ACTION_TIMEZONE_CHANGED ACTION_TIMEZONE_CHANGEDandroid.content.Intent Intent 广播，以确定时间何时发生更改。

<li>

#uptimeMillis 自系统启动以来的计数（以毫秒为单位）。 当系统进入深度睡眠（CPU 关闭、显示深色、等待外部输入的设备）时，此时钟将停止，但不受时钟缩放、空闲或其他节能机制的影响。 这是大多数间隔时间的基础，例如 Thread#sleep(long) Thread.sleep(millis)， Object#wait(long) Object.wait(millis)和 System#nanoTime System.nanoTime()。 此时钟保证为单调，适合间隔不跨越设备睡眠时的间隔时间。 接受时间戳值的大多数方法当前需要 #uptimeMillis 时钟。

<li>

#elapsedRealtime 并 #elapsedRealtimeNanos 返回系统启动后的时间，并包括深度睡眠。 此时钟保证为单调时钟，即使在 CPU 处于省电模式时，也会继续计时，因此建议使用常规用途间隔计时的基础。

</ul>

有多种机制可用于控制事件的计时：

<ul><li>

标准函数（如 Thread#sleep(long) Thread.sleep(millis) 且 Object#wait(long) Object.wait(millis) 始终可用）。 这些函数使用 #uptimeMillis 时钟;如果设备进入睡眠状态，则剩余时间将推迟到设备唤醒。 这些同步函数可能会中断 Thread#interrupt Thread.interrupt()，必须处理 InterruptedException。

<li>

#sleep SystemClock.sleep(millis) 是一个实用工具函数，它与它非常相似 Thread#sleep(long) Thread.sleep(millis)，但它忽略 InterruptedException。 如果不使用 Thread#interrupt Thread.interrupt()，请使用此函数进行延迟，因为它将保留线程的中断状态。

<li>

该 android.os.Handler 类可以在绝对或相对时间计划异步回调。 处理程序对象还使用 #uptimeMillis 时钟，并且需要（ android.os.Looper event loop 通常存在于任何 GUI 应用程序中）。

<li>

可以 android.app.AlarmManager 触发一次性或定期事件，即使设备处于深度睡眠状态或应用程序未运行也是如此。 事件可以按你选择（ java.lang.System#currentTimeMillis RTC）或 #elapsedRealtime （ELAPSED_REALTIME）进行计划，并在事件发生时进行 android.content.Intent 广播。 </ul>

适用于 . 的 android.os.SystemClockJava 文档

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