SourceType

数据源的值，用于更新表盘上显示的实时值。

此元素在 Wear OS 4 中推出。

时间和日期

表盘格式支持与时间和日期相关的以下数据源：

UTC_TIMESTAMP
自世界协调时间 (UTC) 1970 年 1 月 1 日午夜以来经过的毫秒数。
MILLISECOND
一个整数值，表示当前时间的 ZonedDateTime 对象的毫秒字段。此值始终介于 0 和 999 之间（包括这两个数值）。
SECOND
一个整数值，表示当前时间的 ZonedDateTime 对象的秒字段。此值始终介于 0 和 59 之间（包括这两个数值）。
SECOND_Z
一个字符串，表示当前时间的 ZonedDateTime 对象的秒字段，其中包含前导零，以使值的长度为 2 个字符。此值始终介于 00 和 59 之间（包括这两个数值）。
SECOND_MILLISECOND
一个浮点值，用于组合表示当前时间的 ZonedDateTime 对象的秒字段和毫秒字段。此值始终介于 0.0 和 59.999 之间（包括这两个数值）。
SECONDS_IN_DAY
当前日期经过的秒数，基于 HOUR_0_23、MINUTE 和 SECOND 的值。此值始终介于 0 和 86399 ($ 24 * 60 * 60 - 1 $) 之间（包括这两个数值）。
MINUTE
一个整数值，表示当前时间的 ZonedDateTime 对象的分钟字段。此值始终介于 0 和 59 之间（包括这两个数值）。
MINUTE_Z
一个字符串值，表示当前时间的 ZonedDateTime 对象的分钟字段，其中包含前导零，以使值的长度为 2 个字符。此值始终介于 00 和 59 之间（包括这两个数值）。
MINUTE_SECOND
一个浮点值，用于组合表示当前时间的 ZonedDateTime 对象的分钟字段和秒字段。此值始终介于 0.0 和 $ 59 \frac{59}{60} $ 之间（包括这两个数值）。
HOUR_0_11
当前时间的 12 小时制组件，表示为一个介于 0 和 11 之间的值（包括这两个数值）。如果当前 CLOCK_HOUR_OF_AMPM 为 12（如 12:34 PM 中），则此值将转换为 0。
HOUR_0_11_Z
一个字符串，用于表示当前时间的 12 小时制组件，介于 00 和 11 之间（包括这两个数值），并使用 Wear OS 设备的当前时区。如果此值小于 10，则此值包含前导零。
HOUR_0_11_MINUTE
一个浮点值，用于组合表示当前时间的 ZonedDateTime 对象的经过修改的 CLOCK_HOUR_OF_AMPM 字段和分钟字段。此值始终介于 0.0 和 $ 11 \frac{59}{60} $ 之间（包括这两个数值）。
HOUR_1_12
当前时间的 12 小时制组件，表示为一个介于 1 和 12 之间的值（包括这两个数值）。如果当前 HOUR_OF_DAY 为 0（如 0:12 中，即凌晨 12:12），则此值将转换为 12。
HOUR_1_12_Z
一个字符串，用于表示当前时间的 12 小时制组件，介于 01 和 12 之间（包括这两个数值），并使用 Wear OS 设备的当前时区。如果此值小于 10，则此值包含前导零。
HOUR_1_12_MINUTE
一个浮点值，用于组合表示当前时间的 ZonedDateTime 对象的 CLOCK_HOUR_OF_AMPM 字段和分钟字段。此值始终介于 1.0 和 $ 12 \frac{59}{60} $ 之间（包括这两个数值）。
HOUR_0_23
当前时间的 24 小时制组件，表示为一个介于 0 和 23 之间的值（包括这两个数值）。如果此值为 24（如 24:13，即第二天凌晨 12:13），则此值将转换为 0。
HOUR_0_23_Z
一个字符串，用于表示当前时间的 24 小时制组件，介于 00 和 23 之间（包括这两个数值），并使用 Wear OS 设备的当前时区。如果此值小于 10，则此值包含前导零。
HOUR_0_23_MINUTE
一个浮点值，用于组合表示当前时间的 ZonedDateTime 对象的小时字段和分钟字段。此值始终介于 0.0 和 $ 23 \frac{59}{60} $ 之间（包括这两个数值）。
HOUR_1_24
当前时间的 24 小时制组件，表示为一个介于 1 和 24 之间的值（包括这两个数值）。如果此值为 0（如 0:12，即凌晨 12:12），则此值将转换为 24。
HOUR_1_24_Z
一个字符串，用于表示当前时间的 12 小时制组件，介于 01 和 24 之间（包括这两个数值），并使用 Wear OS 设备的当前时区。如果此值小于 10，则此值包含前导零。
HOUR_1_24_MINUTE
一个浮点值，用于组合表示当前时间的 ZonedDateTime 对象的经过修改的小时字段和分钟字段。此值始终介于 1.0 和 $ 24 \frac{59}{60} $ 之间（包括这两个数值）。
DAY
一个整数值，表示当前日期的 ZonedDateTime 对象的日期字段。此值始终介于 1 和 31 之间（包括这两个数值）。
DAY_Z
一个字符串值，表示当前日期的 ZonedDateTime 对象的日期字段，其中包含前导零，以使值的长度为 2 个字符。此值始终介于 01 和 31 之间（包括这两个数值）。
DAY_HOUR
一个浮点值，用于组合表示当前日期和时间的 ZonedDateTime 对象的日期字段和小时字段。此值始终介于 1.0 和 $ 31 \frac{23}{24} $ 之间（包括这两个数值）。
DAY_0_30
表示当前日期的 ZonedDateTime 的 getDayOfMonth() 值的修改版，用于表示当前日期，需要减去 1。此值始终介于 0 和 30 之间（包括这两个数值）。
DAY_0_30_HOUR
一个浮点值，用于组合表示当前日期和时间的 ZonedDateTime 对象的日期字段和小时字段。此值始终介于 0.0 和 $ 30 \frac{23}{24} $ 之间（包括这两个数值）。
DAY_OF_YEAR
自日历年更改以来已经开始的天数。此值始终介于 1 和 366 之间（包括这两个数值），并且非闰年的最大值为 365。
DAY_OF_WEEK
表示当前日期的 ZonedDateTime 的 getDayOfWeek() 值的修改版。表盘格式会指定值 1 代表星期天，并指定值 7 代表星期六。
DAY_OF_WEEK_F
周几，表示为一个完整长度的字符串。示例包括 Sunday 和 Monday。
DAY_OF_WEEK_S
周几，表示为一个缩写的字符串。示例包括 Sun 和 Mon。
MONTH
一个整数值，表示当前日期的 ZonedDateTime 对象的月份字段。此值始终介于 1 和 12 之间（包括这两个数值）。
MONTH_Z
一个字符串值，表示当前日期的 ZonedDateTime 对象的月份字段，其中包含前导零，以使值的长度为 2 个字符。此值始终介于 01 和 12 之间（包括这两个数值）。
MONTH_F
一年中的当前月份，表示为一个完整长度的字符串。示例包括 January 和 December。
MONTH_S
一年中的当前月份，表示为一个缩写的字符串。示例包括 Jan 和 Dec。
DAYS_IN_MONTH
当前月份的天数。此值在 2 月为 28 或 29，在 4 月、6 月、9 月和 11 月为 30，在公历的所有其他月份为 31。
MONTH_DAY
一个浮点值，用于组合表示当前日期的 ZonedDateTime 对象的月份字段和经过修改的日期字段。此值始终介于 1.0 和 $ 12 \frac{29}{30} $ 之间（包括这两个数值）。
MONTH_0_11
表示当前日期的 ZonedDateTime 的 getMonthValue() 值的修改版。此值将为 1 月指定值 0，并为 12 月指定值 11。
MONTH_0_11_DAY
一个浮点值，用于组合表示当前日期的 ZonedDateTime 对象的经过修改的月份字段和经过修改的日期字段。此值始终介于 0.0 和 $ 11 \frac{29}{30} $ 之间（包括这两个数值）。
YEAR
一个整数值，表示当前日期的 ZonedDateTime 对象的年份字段。此值的限制取值范围始终介于 1902 和 2100 之间（包括这两个数值）。
YEAR_S
一个两位整数，表示当前年份的最后两位数字。例如，2023 的值为 23。
YEAR_MONTH
一个浮点值，用于组合表示当前日期的 ZonedDateTime 对象的年份字段和经过修改的日期字段。2023 年 1 月表示为 2023.0，而 2023 年 12 月表示为 $ 2023 \frac {11}{12} $。
YEAR_MONTH_DAY
一个浮点值，用于组合表示当前日期的 ZonedDateTime 对象的年份字段、经过修改的月份字段和经过修改的日期字段。2023 年 1 月 1 日表示为 2023.0，而 2023 年 12 月 31 日表示为 $ 2023 \frac{11 \frac{29}{30}}{12} \approx 2023.9972 $。
WEEK_IN_MONTH
一个整数，表示当前日期的 ChronoField 对象的 ALIGNED_WEEK_OF_MONTH 值。此值始终介于 0 和 5 之间（包括这两个数值）。
WEEK_IN_YEAR
一个整数，表示当前日期的 ChronoField 对象的 ALIGNED_WEEK_OF_YEAR 值。此值始终介于 1 和 53 之间（包括这两个数值）。
IS_24_HOUR_MODE
一个布尔值，相当于 is24HourFormat() 的当前返回值，基于用户选择的语言区域和偏好设置。
IS_DAYLIGHT_SAVING_TIME
一个布尔值，相当于对当前语言区域的 TimeZone 对象调用 inDaylightTime()，并传入包含当前时间的 Date 对象。指示当前设置的时区现在是否采用夏令时。
TIMEZONE
一个字符串，相当于对当前语言区域的 TimeZone 对象调用 getDisplayName()。返回完整的时区名称，例如冬季将针对纽约市所处的时区返回“东部标准时间”。
TIMEZONE_ABB
一个字符串，相当于对当前语言区域的 TimeZone 对象调用 getDisplayName() 的过载版本，其中给定的样式为 SHORT返回缩写的时区名称，例如冬季将针对纽约市所处的时区返回“EST”。
TIMEZONE_ID
一个字符串，相当于对当前语言区域的 TimeZone 对象调用 getId()。返回 IANA 时区 ID 值，例如针对纽约市所处的时区返回 America/New_York。
TIMEZONE_OFFSET
一个字符串，相当于对当前语言区域的 TimeZone 对象调用 getRawOffset()。此值始终介于 -12 和 +14 之间（包括这两个数值）。可返回一个值，世界协调时间 (UTC) 应与此值相加，才能得出当前时区的标准时间。
TIMEZONE_OFFSET_DST
一个字符串，相当于将当前日期传入当前语言区域的 TimeZone 对象的 getOffset()。此值始终介于 -12 和 +14 之间（包括这两个数值）。可返回一个值，世界协调时间 (UTC) 应与此值相加，才能得出当前的当地时间（必要时需要考虑到夏令时）。
AMPM_STATE
一个整数，表示当前时间是中午之前、中午还是中午之后。可能的值包括 0（针对“凌晨/上午”）和 1（针对“下午/晚上”）。
AMPM_POSITION

一个整数，表示“凌晨/上午”或“下午/晚上”指示器应在时间字符串中的显示位置。包含以下某个值：

  • 0 表示“凌晨/上午”或“下午/晚上”应显示在字符串的开头，例如 AM 12:03。
  • 1 表示“凌晨/上午”或“下午/晚上”应显示在字符串的末尾，例如 12:03 AM。
  • -1 表示不知道“凌晨/上午”或“下午/晚上”应显示在字符串中的什么位置。
AMPM_STRING

一个包含两个字符的字符串，表示当前时间的“凌晨/上午”或“下午/晚上”状态。其值为“凌晨/上午”或“下午/晚上”。

月相

表盘格式支持与月相相关的以下数据源：

MOON_PHASE_POSITION
一个整数值，用于表示自最近一次新月以来已经开始的天数。此值始终介于 0 和 28 之间（包括这两个数值）。
MOON_PHASE_TYPE

一个整数，用于对当前月相进行编码。可能的值包括下列项：

  • 0：最近一次新月
  • 1：傍晚新月
  • 2：上弦月
  • 3：盈凸月
  • 4：满月
  • 5：亏凸月
  • 6：下弦月
  • 7：清晨新月
MOON_PHASE_TYPE_STRING

一个字符串，表示当前的月相。可能的值包括下列项：

  • 新月：自最近一次新月以来经过了不到 0.5 天或超过 27.5 天。
  • 傍晚新月：自最近一次新月以来经过了至少 0.5 天，但不足 6.5 天。
  • 上弦月：自最近一次新月以来经过了至少 6.5 天，但不足 7.5 天。
  • 盈凸月：自最近一次新月以来经过了至少 7.5 天，但不足 13.5 天。
  • 满月：自最近一次新月以来经过了至少 13.5 天，但不足 14.5 天。
  • 亏凸月：自最近一次新月以来经过了至少 14.5 天，但不足 20.5 天。
  • 下弦月：自最近一次新月以来经过了至少 20.5 天，但不足 21.5 天。
  • 清晨新月：自最近一次新月以来经过了至少 21.5 天，但不足 27.5 天。

语言

表盘格式支持与用户语言相关的以下数据源：

LANGUAGE_LOCALE_NAME
一个字符串，表示 Wear OS 设备的当前语言区域，表示为一个包含两个字符的 ISO 639-1 语言代码、一条下划线和一个包含两个字符的 ISO 3166-1 地区代码。英语的美国变体表示为 en_US。

健康数据

表盘格式支持与健康数据相关的以下数据源：

STEP_COUNT
用户当天到目前为止走过的步数，基于 Wear OS 设备传感器。
STEP_GOAL
用户选择作为每日步数目标的步数。此值始终不小于 1000。
STEP_PERCENT
一个整数，表示用户当前实现步数目标的进度，表示为经过四舍五入的百分比。此值始终介于 0 和 100 之间（包括这两个数值）。
HEART_RATE
用户当前的心率，基于 Wear OS 设备传感器。此值始终介于 0 和 240 之间（包括这两个数值）。
HEART_RATE_Z
一个字符串，表示用户当前的心率，基于 Wear OS 设备传感器。可视需要在此值左侧添加零，以使其长度至少为 2 个字符。因此，如果用户的心率为 65，则此值为 65。因此，如果用户的心率为 0，则此值为 00。

设备传感器

表盘格式支持与设备传感器相关的以下数据源：

ACCELEROMETER_IS_SUPPORTED
布尔值，表示表盘是否可以从当前 Wear OS 设备的传感器获取加速度计数据。
ACCELEROMETER_X
一个浮点值，表示 x 轴的当前线性加速度，基于 Wear OS 设备的加速度计。正值表示当表盘指向天空或天花板时，Wear OS 设备会向右加速。
ACCELEROMETER_Y
一个浮点值，表示 y 轴的当前线性加速度，基于 Wear OS 设备的加速度计。正值表示当表盘指向天空或天花板时，Wear OS 设备会沿着表盘在 12 点（顶部）方向上加速。
ACCELEROMETER_Z

一个浮点值，表示 z 轴的当前线性加速度，基于 Wear OS 设备的加速度计。正值表示当表盘指向天空或天花板时，Wear OS 设备会朝着天空或天花板加速。

ACCELEROMETER_ANGLE_X

一个浮点值，表示相对于 x 轴的当前角加速度（以度为单位）。此值始终在 $ [-90.0, 90.0 $] 的范围内。

ACCELEROMETER_ANGLE_Y

一个浮点值，表示相对于 y 轴的当前角加速度（以度为单位）。此值始终在 $ [-90.0, 90.0 $] 的范围内。

ACCELEROMETER_ANGLE_Z

一个浮点值，表示相对于 z 轴的当前角加速度（以度为单位）。此值始终在 $ [-90.0, 90.0 $] 的范围内。

ACCELEROMETER_ANGLE_XY

一个浮点值，它是 ACCELEROMETER_ANGLE_X 和 ACCELEROMETER_ANGLE_Y 的总和。

设备电池

表盘格式支持与设备当前电池状态相关的以下数据源：

BATTERY_PERCENT
一个整数，表示 Wear OS 设备的当前电量（以百分比表示）。值 100 表示电池电量已满；值 0 表示电池电量极低。
BATTERY_CHARGING_STATUS
一个布尔值，表示 Wear OS 设备的电池是否正在充电。如果电池已完成充电且电量充足，则此值为 true。
BATTERY_IS_LOW
一个布尔值，表示 Wear OS 设备的电池电量是否不足。确切阈值取决于制造商。如果电池正在充电，则此值为 false。
BATTERY_TEMPERATURE_CELSIUS
一个浮点值，表示 Wear OS 设备的电池温度（以摄氏度为单位）。此值的计算方法为电池的原始温度值（以十分之一摄氏度为单位）除以 10。
BATTERY_TEMPERATURE_FAHRENHEIT
一个浮点值，表示 Wear OS 设备的电池温度（以华氏度为单位）。此值由摄氏度换算而来。

通知

表盘格式支持与设备通知相关的以下数据源：

UNREAD_NOTIFICATION_COUNT
一个字符串，表示已发送到此 Wear OS 设备的用户尚未读取的通知数量。