本文介绍了 Android 上时间和时区检测功能的工作原理。其中包括 Android 如何自动检测时间和时区、适用于设备制造商的配置选项以及测试信息。
时间和时区概览
为确定在状态栏等位置中显示的用户当地时间,Android 会跟踪两种相关又独立的状态:
- 当前 Unix 纪元时间
- 当前时区
当前 Unix 纪元时间和当前时区是设备级状态,这意味着它们将由设备的所有用户共享。
当前 Unix 纪元时间不是固定值。它会自动更新,以体现时间的流逝。除了正常的时间流逝之外,如果发现设备的当前 Unix 纪元时间不正确(例如,在设备断电后),系统会对这个时间加以调整。
当前时区决定了将当前 Unix 纪元时间转换为当地时间时所要进行的调整。例如,在洛杉矶的夏季,设备会将当前 Unix 纪元时间减去 7 小时,而在冬季,则会减去 8 小时。
为了支持这些当地时间计算,所有 Android 设备均拥有一个包含所有全球时区规则的数据库。 如需详细了解时区规则,请参阅时区规则。
当用户前往使用一个不同时区的新位置时,当前 Unix 纪元时间无需调整,但用户通常希望看到当地时间,而不是他们先前所在地的时间。通过更改当前时区,系统可以确保向当前 Unix 纪元时间应用正确的偏移值,从而正确显示新位置的当地时间。
AOSP 提供以下机制,允许用户独立控制是否自动设置时间和时区。
- 自动时间检测:确保设备的当前 Unix 纪元时间正确无误。
- 自动时区检测:确保设备的当前时区正确无误。
自动时间检测
本部分简要介绍 time_detector
服务,该服务用于管理自动时间检测、用户控件、配置选项和测试详情。
time_detector 服务
搭载 Android 10 或更高版本的设备上提供的 time_detector
服务用于管理自动时间检测。在已启用自动时间检测的情况下,该服务会根据需要调整设备的当前 Unix 纪元时间。
time_detector
服务始终处于以下两种状态之一:不确定或确定。该服务的确定或不确定状态取决于它从各种源收到的时间建议。
当 time_detector
服务处于确定状态(即已收到包含 Unix 纪元时间信息的建议)时,如果时间建议与当前 Unix 纪元时间不同,它会替换当前 Unix 纪元时间。
当 time_detector
处于不确定状态时,则不会替换当前时间。不确定状态通常表示 time_detector
服务未收到时间建议。此外,如果 time_detector
服务收到的建议被认为太旧而不能使用,它也会变为不确定状态。系统会考虑建议的存在时长,因为使用旧 Unix 纪元时间建议的调整项依赖于设备上已流逝的实时时钟时间,系统会假定后者在很长一段时间后会变得不准确。
为了自动确定当前 Unix 纪元时间,设备可使用各种源。这些在本文档中称为“源站”(origin)。time_detector
服务会根据源站将各个建议序列视为不同的内容。
time_detector
服务是有状态的,这意味着它会记录每个源站提供的最新建议。如果源站有更新的 Unix 纪元时间信息,系统会向 time_detector
提出新建议。time_detector
服务会重新评估新建议和现有建议,并在收到建议后更新设备状态。
尽管 UTC 时间在国际上得到了认可,但对 Android 设备来说,建立当前 Unix 纪元时间并非总是那么简单的,原因多种多样:
- Unix 纪元时间和 UTC 时间是两个略有不同的计时系统。 若要在这两者之间转换,则需了解闰秒的出现时间以及源站对它们的处理方式。
- 源站可能仅在特定时间或在特定情况下可用。例如,如果源站需要网络连接,那么可能只有在设备连接到互联网后才能使用源站。
- 源站可能不准确或不精确,或者有误。例如,如果电话手机基站没正确跟踪“世界时间”,telephony 源站可能会提供不准确的时间建议。
- 获取 Unix 纪元时间时可能会引入不准确因素。 例如,网络延迟、缓冲或进程调度可能会导致 Unix 纪元时间不准确。
- 用于在收到建议后流逝的时间内调整该建议的参考时钟可能不准确。
在 AOSP 中,有两个主要的时间检测源站已配置为默认使用:
- network:使用网络时间协议 (NTP) 时间服务器。
- telephony:使用网络身份和时区 (NITZ) 电话信号。
telephony 和 network 源站都需要连接到外部网络,但网络并非始终可用。
从 Android 12 开始,Android 还支持以下源站,它们未配置为默认使用:
时间设置
用户可以在 AOSP“设置”应用的系统 > 日期和时间中启用自动时间检测。
图 1. “设置”中的自动时间检测。
下表介绍了 AOSP“设置”应用中用于时间检测的用户控件。
*在 Android 11 及更低版本中,此设置带有使用网络提供的时间标记 |
|||
在 AOSP“设置”中的位置 | 在 AOSP“设置”中的名称 | 范围 | 行为 |
---|---|---|---|
系统 > 日期和时间 | 自动设置时间* | 所有用户 | 一个切换开关。 处于开启状态时,设备会负责检测当前 Unix 纪元时间。处于关闭状态时,系统会为用户提供用于手动设置设备时间的控件。 |
当用户手动输入时间时,输入的是当地时间,而不是 Unix 纪元时间。当前 Unix 纪元时间通过使用当前时区得出 Unix 纪元时间来计算。
配置
设备制造商可以采用多种方式配置 time_detector
服务,例如要使用哪些源站,以及如何为来自这些源站的信号排定优先级。
源站优先级
从 Android 12 开始,设备制造商可以更改 core/res/res/values/config.xml
配置文件,以指定要在自动时间检测中包含的时间源站,以及 time_detector
考虑这些源站的优先级。
对于搭载 Android 11 或更低版本的设备,源站优先级会被硬编码为 ["telephony", "network"]
,这意味着 telephony 建议的优先级高于 network 建议。
默认 AOSP 配置如下所示:
<!-- Specifies priority of automatic time sources. Suggestions from higher entries in the list
take precedence over lower ones.
See com.android.server.timedetector.TimeDetectorStrategy for available sources. -->
<string-array name="config_autoTimeSourcesPriority">
<item>network</item>
<item>telephony</item>
</string-array>
在 Android 12 中,network 和 telephony 建议被配置为要默认使用的源站。network 时间建议的优先级高于 telephony 时间建议。设备制造商可以更改源站的顺序,以还原 Android 11 或更低版本(其中 telephony 建议的优先级较高)中的行为。
默认情况下,如果优先级最高的有效建议与设备当前的系统时钟时间仅相差几秒,系统会视为两者互相匹配,不会更改设备时间。这是为了避免为监听 ACTION_TIME_CHANGED
intent 的已安装应用增加负担。
允许的源站值包括:
允许的时间范围
Android 14 针对 time_detector
服务收到的时间建议引入了时间上限。如果设备支持 32 位进程,框架会设置上限,以防止设备使用可能触发 Y2038 问题的时间建议。
Android 12 引入了一个时间下限,用于验证 time_detector
服务收到的时间建议。用于自动建议的下限时间值根据 build 时间戳设置。这基于以下原则:有效的时间不能是在设备的系统映像构建之前。如果时间建议是在时间下限之前,time_detector
服务会舍弃这条建议,因为如果 build 时间戳是正确的,这条建议就不可能有效。
对于搭载 Android 11 或更低版本的设备,time_detector
服务不会验证传入的 Unix 纪元时间建议。
时间调试和测试
本部分介绍如何调试和测试 time_detector
服务及由所有源站共享的其他组件的行为。
与 time_detector 服务交互
如需查看 time_detector
服务的配置和 time_detector
服务的状态,请使用以下命令:
adb shell cmd time_detector dump
如需查看用于调试和测试时区检测的其他命令,请使用以下命令:
adb shell cmd time_detector help
帮助输出还描述了 device_config 服务属性,它们可用于在测试环境或生产环境中影响 time_detector
的行为。如需了解详情,请参阅使用 device_config 服务配置设备。
如需验证自动时间检测,测试人员必须知道 time_detector
服务使用的是哪个源站。以下是 adb shell cmd time_detector dump
命令的输出内容示例,其中有关当前源站和服务状态的信息以粗体显示:
$ adb shell cmd time_detector dump
TimeDetectorStrategy:
mLastAutoSystemClockTimeSet=null
mEnvironment.isAutoTimeDetectionEnabled()=true
mEnvironment.elapsedRealtimeMillis()=23717241
mEnvironment.systemClockMillis()=1626707861336
mEnvironment.systemClockUpdateThresholdMillis()=2000
mEnvironment.autoTimeLowerBound()=2021-07-19T07:48:05Z(1626680885000)
mEnvironment.autoOriginPriorities()=[network,telephony]
Time change log:
...
Telephony suggestion history:
...
Network suggestion history:
...
Gnss suggestion history:
...
External suggestion history:
...
这些信息可解读为:
键 | 值 |
---|---|
mEnvironment.isAutoTimeDetectionEnabled() |
是否启用了自动时间检测。 |
mEnvironment.autoTimeLowerBound() |
用于验证时间建议的当前下限。 |
mEnvironment.autoOriginPriorities() |
正在使用的源站和优先级顺序。 |
时间更改日志用于指明 time_detector
服务更改了设备的当前 Unix 纪元时间的情况。
建议历史记录信息用于指明每个源站提供的建议。
自动时区检测
本部分简要介绍 time_zone_detector
服务,该服务用于管理自动时区检测、“设置”中的用户控件、电话和位置信息时区检测以及测试详情。
time_zone_detector 服务
搭载 Android 11 或更高版本的设备上提供的 time_zone_detector
服务用于管理自动时区检测。在自动时区检测启用的情况下,该服务可根据需要调整设备的当前时区。
启用自动时区检测后,time_zone_detector
可以处于以下两种状态之一:不确定和确定。
当 time_zone_detector
服务处于确定状态时,这意味着 time_zone_detector
服务已收到强时区信息,这可能会导致它替换当前时区。当该服务处于不确定状态时,这表示它未收到任何信息或者仅有低置信度的信息,这意味着它不会替换当前时区。
time_zone_detector
服务的确定状态可能包括 time_zone_detector
无可用时区信息,或有多个时区可供选择的情况。这些状态如下:
- 当设备处于没有时区的地方(例如国际海域或争议区域)时,就会进入不带时区的确定状态。这种状态与不确定状态类似,但表示
time_zone_detector
无需执行进一步操作即可尝试确定时区。 - 当存在不明确的情况或边界条件时,设备就会进入带有多个时区的确定状态。在这种状态下,如果当前时区是
time_zone_detector
确定的时区之一,则当前时区将保持不变。否则,系统将使用某个可用时区。如果用户之前手动选择了时区,或者设备接近边界,这就给了time_zone_detector
一个粘性元素。
time_zone_detector
服务的确定或不确定状态取决于算法发送的时区建议。
通常,建议分为与 time_zone_detector
可能的状态高度匹配的两种类型:确定和不确定。以下是建议类型的示例:
类型 =
uncertain
,zoneIds = []
- 算法并不知道时区。
类型 =
certain
,zoneIds = ["Europe/London"]
- 算法确定时区是欧洲/伦敦。
类型 =
certain
,zoneIds = []
`- 算法是确定的,但没有与当前位置关联的时区 ID。
类型 =
certain
,zoneIds = ["America/Denver", "America/Phoenix"]
- 算法确定时区就是“America/Denver”和“America/Phoenix”这两个时区中的一个,但无法从中进行选择。
time_zone_detector
服务会根据算法将各个建议序列视为不同的内容。根据算法,建议还可能包含表明算法确定程度的元数据。
time_zone_detector
服务是有状态的,这意味着它会记录每个算法提供的最新建议。如果之前的建议不再正确,也就是说,如果算法现在有不同的建议,或者它失去了检测时区的能力,新建议就会发送到 time_zone_detector
服务。time_zone_detector
服务会重新评估新建议和现有建议,并在收到建议后更新设备状态。
Android 支持两种时区检测算法:
- 电话
- 位置
time_zone_detector
服务通常使用单个算法来确定时区。如果设备支持位置算法,系统会根据用户使用的时区设置确定设备使用的算法。如果所用算法不确定时区,time_zone_detector
通常不会使用其他算法提供的建议。与未使用的算法相关联的建议可以由 time_zone_detector
保存在内存中,但除非算法发生变化,否则系统不会使用它们。当用户更改自动时区检测设置且算法发生更改时,系统会使用适用于新算法的最新建议。
如需详细了解使用多种算法来确定时区的情况,请参阅电话回退模式。
电话回退模式
在搭载 Android 13 及更高版本的设备上,time_zone_detector
服务支持电话回退模式。在该模式下,如果位置信息检测无法检测时区,或者位置信息检测要用比电话检测更长的时间检测时区,则 Android 可以暂时使用电话检测建议。
电话回退模式适用于同时支持电话检测和位置信息检测且用户已在时区设置中启用“使用位置信息设置时区”的设备。当设备重新启动以及当停用飞行模式时,该模式会自动启用。
在 Android 14 及更高版本中,可以通过 LTZP 状态报告 API 触发电话回退,也就是说,如果 LTZP 报告了不确定并且其检测位置或时区的能力因环境而下降,则会触发电话回退模式。
在电话回退模式下,time_zone_detector
服务会使用电话建议,就像位置信息服务检测已停用一样,直到位置信息算法提供特定建议为止。系统在收到特定建议后会停用电话回退模式,并仅使用位置信息建议。
如需了解电话回退模式的配置详细信息,请参阅时区检测配置。
时区设置
用户可以在 AOSP“设置”应用中启用和配置自动时区检测设置。
图 2. “设置”中的自动时区检测设置。
下表介绍了 AOSP“设置”应用中用于时区检测的用户控件。
*在 Android 11 及更低版本中,此设置带有使用网络提供的时区标记 |
|||
在 AOSP“设置”中的位置 | 在 AOSP“设置”中的名称 | 范围 | 行为 |
---|---|---|---|
系统 > 日期和时间 | 自动设置时区* | 所有用户 | 一个切换开关。 开启时,设备负责检测当前时区。关闭时,系统会为用户提供用于手动设置设备时区的控件。 |
系统 > 日期和时间 | 使用位置信息设置时区 | 当前用户 | 一个切换开关。 从 Android 12 开始提供。仅当设备支持位置信息时区检测时,才会显示此切换开关。 如需了解 Android 14 中引入的更改,请参阅仅支持位置信息时区检测的设备。 |
位置 | 使用位置信息 | 当前用户 | 一个切换开关。 一般来说,用于允许或阻止使用设备的位置信息。如果设备支持位置时区检测,则此值相关。 |
下面简要介绍了在用户所选设置下的设备时区检测行为:
[日期和时间] 自动设置时区:关闭
- 用户必须手动选择时区。
[日期和时间] 自动设置时区:开启
[位置信息] 使用位置信息:关闭
- 电话信号将用于检测时区。
[位置信息] 使用位置信息:开启
[日期和时间] 使用位置信息设置时区:开启
- 位置信息将用于检测时区。
[日期和时间] 使用位置信息设置时区:关闭
- 电话信号将用于检测时区。
多用户设备
由于所涉及的多项设置是针对当前用户的,因此在多用户 Android 设备上,如果当前用户发生切换,设备的时区检测行为可能会发生变化。
使用位置信息设置时区切换开关针对的是当前用户,且不受设备政策的限制,这意味着用户始终可以更改其值,即使自动设置时区切换开关处于关闭状态,或者设备政策控制器限制了其他时间或时区控件,也是如此。
仅支持位置信息时区检测算法的设备
本部分介绍了仅支持位置算法的设备的行为。
Android 14 及更高版本
- AOSP 设置应用不会向用户显示使用位置信息选项,设备的行为就像启用了使用位置信息选项一样。
- 系统会忽略用户级范围的
SettingsProvider
设置location_time_zone_detection_enabled
的值。此值会记录用户在其他类型的设备上的偏好设置。
Android 12 或 Android 13
- 在 AOSP“设置”应用中,用户可以看到使用位置信息选项,用户可以停用此选项。如果停用此选项,设备不会自动检测时区。
更改为自动检测模式以及从自动检测模式改为其他模式时的行为
当用户将时区检测模式从手动切换为自动时,time_zone_detector
可能已确定当前时区。如果是这样的话,当用户启用自动检测时,设备的时区可能会同时发生变化,以便与 time_zone_detector
服务的观点保持一致。
同样,如果用户在“设置”中做出的更改导致 time_zone_detector
服务的当前算法发生变化,而 time_zone_detector
可能已收到针对新算法的建议,那么,设备的时间可能会相应更改,以与 time_zone_detector
服务的观点保持一致。
电话时区检测
电话时区检测使用电话信号来确定当前时区。如需了解详情,请参阅电话时区检测。
位置信息时区检测
Android 12 或更高版本支持位置信息时区检测功能。这是一项可选的自动时区检测功能,可让设备使用其位置信息来确定当前时区。
Android 12 中引入的 location_time_zone_manager
服务在系统服务器中运行,其中包含负责向 time_zone_detector
服务提交位置信息算法建议的代码。如需了解详情,请参阅位置信息时区检测。
功能采用方面的注意事项
本部分介绍位置信息时区检测功能的各个方面,帮助设备制造商确定是否在设备上采用该功能。
比较电话检测和位置信息检测
下表对比了分别使用位置信息以及电话信号进行时区检测的优缺点。
电话检测 | 位置信息检测 | |
---|---|---|
正确性 | 因国家/地区而异。 取决于 MCC 和 NITZ 的正确性及可用性。 |
取决于功能配置或插件组件。 正确性通常因以下因素而异:
|
可更新性 | 电话检测依赖于可更新的时区数据模块 (com.android.tzdata APEX) 中包含的文件。 | 取决于功能配置或插件组件。 可更新性通常取决于设备使用的是服务器还是客户端时区地图数据。 注意:用于更新 Android 的 TZDB 及其他时区信息副本的时区数据模块中不包含时区地图数据。 此外,设备制造商还必须考虑时区规则和时区地图数据之间的版本一致性。 |
耗电量 | 耗电量为零或极低 | 取决于用户位置信息设置、正在使用的插件以及通常会有其他哪些应用请求位置信息。 |
可用性 | 仅电话设备提供此功能。通常需要有效的 SIM 卡。 | 位置信息检测取决于可用的位置信息提供程序。 |
用户隐私
用户的首选时区通常取决于用户所在的地理位置。位置信息属于敏感数据。在时区检测过程中,用户可能会担心他们的位置信息被共享。在设备上运行的所有应用无需 Android 权限即可读取设备的当前时区,并且应用可以根据这一信息推断出并不精确的设备位置,这与时区检测无关。
更具体地说,时区检测可以通过被动或主动方式进行:
- 被动:设备所处环境中的某些组件告知设备该环境中所用的时区。
- 主动:设备必须自行确定时区,并根据用户的隐私设置,在征得其同意后获取设备的位置信息,以达到此目的。然后,它可以与外部服务共享其位置信息。请参阅下文,详细了解用户隐私以及如何征得用户同意。
被动检测(例如使用 telephony 算法)不会给用户带来隐私权方面的其他影响。
主动检测(例如使用 location 算法)涉及确定设备的位置信息(用户可能不想同意),此外,位置信息可以通过网络发送,以确定时区 ID。
借助 Android 在时区检测时采用的用户隐私保护方法,用户能够单独停用预计会执行主动检测的算法。此外,AOSP 平台代码不直接处理位置信息本身:位置信息检测和将位置信息映射到时区 ID 的操作由设备制造商配置的插件组件完成。
如需详细了解用户隐私功能,请参阅位置信息时区检测。
配置
设备制造商可以配置 time_zone_detector
服务以更改其行为。本部分介绍 time_zone_detector
服务的一般行为的配置选项。如需了解电话和时区检测算法的配置详细信息,请参阅电话时区检测和位置信息时区检测。
基本 AOSP 配置位于 frameworks/base/core/res/res/values/config.xml
中。
配置键 | AOSP 值 | 说明 |
---|---|---|
config_supportTelephonyTimeZoneFallback |
true |
true 时,time_zone_detector 使用电话回退模式。这适用于 Android 13 及更高版本。
|
更改设备默认行为
在 AOSP 中,自动时区检测功能默认处于启用状态,并且 auto_time_zone
设为 true
。如需默认停用自动时间检测功能,请将 frameworks/base/packages/SettingsProvider/res/values/defaults.xml
中定义的 def_auto_time_zone
的值设为 false
。
从其他设备恢复备份时,框架默认更新 auto_time_zone
设置的值。如果您想确保此设置不会从备份中恢复,请在 frameworks/base/packages/SettingsProvider/res/values/blocked_settings.xml
中定义的 restore_blocked_global_settings
数组中添加 auto_time_zone
。
时区调试和测试
本部分介绍如何调试和测试 time_zone_detector
服务及由所有算法共享的其他组件的行为。
使用 device_config 服务配置设备
device_config
服务是 Android 中所用的一种机制:使用由专有(非 AOSP)代码从远程服务器提取的值来配置可修改的行为。使用 device_config
值进行测试时,尤其是在长时间运行的手动测试期间,设备可能会同步这些标志,进而重置这些标志并清除为测试设置的值。
在 Android 12 或更高版本中,如需暂时阻止标志同步,请使用以下命令:
adb shell cmd device_config set_sync_disabled_for_tests persistent
如需在测试后恢复标志同步,请使用以下命令:
adb shell cmd device_config set_sync_disabled_for_tests none
恢复标志同步后,请重新启动设备。
如需了解详情,请使用 $ adb shell cmd device_config help
。
与 time_zone_detector 服务交互
如需查看 time_zone_detector
配置和 time_zone_detector
服务的状态,请使用以下命令:
adb shell cmd time_zone_detector dump
如需查看用于调试和测试时区检测的其他命令,请使用以下命令:
adb shell cmd time_zone_detector help
帮助输出还描述了 device_config
服务属性,它们可用于在测试环境或生产环境中影响 time_zone_detector
服务的行为。如需了解详情,请参阅使用 device_config 服务配置设备。
如需验证时区检测,测试人员必须知道 time_zone_detector
使用的是哪个算法。如需了解和影响 time_zone_detector
的当前算法,请使用以下某个选项:
- 通过“设置”界面直观地进行检查。如需了解详情,请参阅时区设置。
通过 adb 使用命令行:
- 如需转储
time_zone_detector
状态,请使用adb shell cmd time_zone_detector dump
- 如需更改设备设置,请使用其他
time_zone_detector
命令。如需了解详情,请使用adb shell cmd time_zone_detector help
。
- 如需转储
以下是 adb shell cmd
time_zone_detector dump
命令的输出内容示例,其中有关当前算法和服务状态的信息以粗体显示:
$ adb shell cmd time_zone_detector dump
TimeZoneDetectorStrategy:
mEnvironment.getCurrentUserId()=0
mEnvironment.getConfiguration(currentUserId)=ConfigurationInternal{mUserId=0, mUserConfigAllowed=true, mTelephonyDetectionSupported=true, mGeoDetectionSupported=true, mAutoDetectionEnabled=true, mLocationEnabled=true, mGeoDetectionEnabled=true}
[Capabilities=TimeZoneCapabilitiesAndConfig{mCapabilities=TimeZoneDetectorCapabilities{mUserHandle=UserHandle{0}, mConfigureAutoDetectionEnabledCapability=40, mConfigureGeoDetectionEnabledCapability=40, mSuggestManualTimeZoneCapability=30}, mConfiguration=TimeZoneConfiguration{mBundle=Bundle[{geoDetectionEnabled=true, autoDetectionEnabled=true}]}}]
mEnvironment.isDeviceTimeZoneInitialized()=true
mEnvironment.getDeviceTimeZone()=Europe/London
Time zone change log:
Manual suggestion history:
...
Geolocation suggestion history:
...
Telephony suggestion history:
...
这些信息可解读为:
键 | 值 |
---|---|
mUserConfigAllowed |
设备政策控制器是否阻止用户控制日期和时间设置。 |
mTelephonyDetectionSupported |
设备是否具有电话时区检测功能。 |
mGeoDetectionSupported |
设备是否支持位置信息时区检测功能。这是基于配置以及至少存在一个 LTZP 时的有效状态。 |
mAutoDetectionEnabled |
是否启用了自动时区检测。 |
mLocationEnabled |
主位置信息切换开关。 |
mGeoDetectionEnabled |
算法开关:false 表示电话算法,true 表示位置信息算法。 |
建议历史记录信息用于指明通过“设置”(手动)以及 telephony 和 location 算法提供的建议。