数据源的值，用于更新表盘上显示的实时值。
此元素在 Wear OS 4 中推出。
| 源代码 | 说明 | 类别 | 可用性 |
|---|---|---|---|
UTC_TIMESTAMP |
自世界协调时间 (UTC) 1970 年 1 月 1 日午夜以来经过的毫秒数。 | 整数 | 版本 1 |
MILLISECOND |
一个整数值，表示
ZonedDateTime
对象。此值始终介于
0 和 999（含边界值）。
|
整数 | 版本 1 |
SECOND |
一个整数值，表示当前时间的 ZonedDateTime 对象的秒字段。此值始终介于 0 和 59 之间，
（含边界值）。
|
整数 | 版本 1 |
SECOND_Z |
一个字符串，表示
ZonedDateTime
对象，其中带有前导零，以使值的长度为 2 个字符。这个
值始终介于 00 和 59 之间（包括这两个数值）。
|
字符串 | 版本 1 |
SECOND_TENS_DIGIT |
当前秒数的十位数，例如，对于 12:03:47，则为 4。
|
整数 | 版本 2 |
SECOND_UNITS_DIGIT |
当前秒数的单位数字，例如 7 表示 12:03:47。
|
整数 | 版本 2 |
SECOND_MILLISECOND |
一个浮点值，用于组合
ZonedDateTime
对象。
此值始终介于 0.0 和 59.999 之间（包括这两个数值）。
|
浮点数 | 版本 1 |
SECONDS_IN_DAY |
当前日期经过的秒数，基于
HOUR_0_23、MINUTE 和 SECOND 的值。此值始终介于 0 和 86399 ($ 24 * 60 * 60 - 1 $) 之间（包括这两个数值）。
|
整数 | 版本 1 |
MINUTE |
一个整数值，表示
ZonedDateTime
对象。此值始终介于 0 和 59 之间，
（含边界值）。
|
整数 | 版本 1 |
MINUTE_Z |
一个字符串值，表示
ZonedDateTime 对象
代表当前时间，并带有前导零，以使值的长度为 2 个字符。这个
值始终介于 00 和 59 之间（包括这两个数值）。
|
字符串 | 版本 1 |
MINUTE_TENS_DIGIT |
当前分钟的十位数，例如 12:03 的 0。
|
整数 | 版本 2 |
MINUTE_UNITS_DIGIT |
当前分钟的单位数，例如 12:03 中的 3。
|
整数 | 版本 2 |
MINUTE_SECOND |
一个浮点值，用于组合
ZonedDateTime
对象。该值为
始终介于 0.0 和 $ 59 \frac{59}{60} $ 之间（包括这两个数值）。
|
浮点数 | 版本 1 |
HOUR_0_11 |
当前时间的 12 小时制组件，表示为一个介于 0 之间的值
和 11（含）之间的任意十进制值。如果当前的
CLOCK_HOUR_OF_AMPM为
12（例如在 12:34 PM 中），此值将转换为 0。
|
整数 | 版本 1 |
HOUR_0_11_Z |
一个字符串，表示当前时间的 12 小时制组件，来自 00
设置为 11（含）- 使用 Wear OS 设备的当前时区。如果此值
小于 10，则包含前导零。
|
字符串 | 版本 1 |
HOUR_0_11_MINUTE |
一个浮点值，用于组合经过修改的 CLOCK_HOUR_OF_AMPM 字段和
ZonedDateTime 的分钟字段
对象表示当前时间。
此值始终介于 0.0 和 $ 11 \frac{59}{60} $ 之间（包括这两个数值）。
|
浮点数 | 版本 1 |
HOUR_1_12 |
当前时间的 12 小时制组件，表示为一个介于 1 之间的值
和 12（含）之间的任意十进制值。如果当前的 HOUR_OF_DAY 为 0，
例如 0:12（凌晨 12:12），此值将转换为 12。
|
整数 | 版本 1 |
HOUR_1_12_Z |
一个字符串，表示当前时间的 12 小时制组件，来自 01
设置为 12（含）- 使用 Wear OS 设备的当前时区。如果此值
小于 10，则包含前导零。
|
string | 版本 1 |
HOUR_1_12_MINUTE |
一个浮点值，用于组合 CLOCK_HOUR_OF_AMPM 字段和分钟字段
（共 ZonedDateTime）
对象表示当前时间。此值始终介于 1.0 和 $ 12 \frac{59}{60} $ 之间（包括这两个数值）。
|
浮点数 | 版本 1 |
HOUR_0_23 |
当前时间的 24 小时制组件，表示为一个介于 0 之间的值
和 23（含）之间的任意十进制值。如果此值为 24，例如 24:13（下一项是凌晨 12:13）
天），此值将转换为 0。
|
整数 | 版本 1 |
HOUR_0_23_Z |
一个字符串，表示当前时间的 24 小时制组件，来自 00
设置为 23（含）- 使用 Wear OS 设备的当前时区。如果此值
小于 10，则包含前导零。
|
整数 | 版本 1 |
HOUR_0_23_MINUTE |
一个浮点值，用于组合
ZonedDateTime
对象。此值始终介于 0.0 和 $ 23 \frac{59}{60} $ 之间（包括这两个数值）。
|
浮点数 | 版本 1 |
HOUR_1_24 |
当前时间的 24 小时制组件，表示为一个介于 1 之间的值
和 24（含）之间的任意十进制值。如果值为 0，如 0:12（凌晨 12:12），则
值会转换为 24。
|
整数 | 版本 1 |
HOUR_1_24_Z |
一个字符串，表示当前时间的 12 小时制组件，来自 01
设置为 24（含）- 使用 Wear OS 设备的当前时区。如果此值
小于 10，则包含前导零。
|
字符串 | 版本 1 |
HOUR_1_24_MINUTE |
一个浮点值，用于组合经过修改的小时字段和
ZonedDateTime
对象。该值为
始终介于 1.0 和 $ 24 \frac{59}{60} $ 之间（包括这两个数值）。
|
浮点数 | 版本 1 |
HOUR_TENS_DIGIT |
当前小时的十位数，例如 12:03 中的 1。
|
整数 | 版本 2 |
HOUR_UNITS_DIGIT |
当前小时的单位数字，例如 12:03 的 2。
|
整数 | 版本 2 |
DAY |
一个整数值，表示
ZonedDateTime
对象。此值始终介于 1 和 31 之间（包括这两个数值）。
|
整数 | 版本 1 |
DAY_Z |
一个字符串值，表示当前日期的 ZonedDateTime 对象的日期字段，其中包含前导零，以使值的长度为 2 个字符。这个
值始终介于 01 和 31 之间（包括这两个数值）。
|
字符串 | 版本 1 |
DAY_HOUR |
一个浮点值，用于组合表示当前日期和时间的 ZonedDateTime 对象的日期字段和小时字段。这个
值始终介于 1.0 和 $ 31 \frac{23}{24} $ 之间（包括这两个数值）。
|
浮点数 | 版本 1 |
DAY_0_30 |
的修改版本
getDayOfMonth()
ZonedDateTime
对象，代表当前日期，要减去 1。
此值始终介于 0 和 30 之间（包括这两个数值）。
|
整数 | 版本 1 |
DAY_0_30_HOUR |
一个浮点值，用于组合表示当前日期和时间的 ZonedDateTime 对象的日期字段和小时字段。此值始终介于 0.0 和 $ 30 \frac{23}{24} $ 之间（包括这两个数值）。
|
浮点数 | 版本 1 |
DAY_OF_YEAR |
自日历年更改以来已经开始的天数。这个
值始终介于 1 和 366 之间（包括这两个数值），最大值为
平年为 365。
|
整数 | 版本 1 |
DAY_OF_WEEK |
来自 ZonedDateTime 的 getDayOfWeek() 值的修改版本
该对象表示当前日期。表盘格式会指定值 1 代表星期天，并指定值 7 代表星期六。
|
整数 | 版本 1 |
DAY_OF_WEEK_F |
星期几，表示为一个完整长度的字符串。示例包括 Sunday 和 Monday。
|
字符串 | 版本 1 |
DAY_OF_WEEK_S |
周几，表示为一个缩写的字符串。示例
包括 Sun 和 Mon。
|
字符串 | 版本 1 |
FIRST_DAY_OF_WEEK |
根据以下因素提供一周的第一天：
getFirstDayOfWeek()，其中1是星期日
7 是星期六。例如，美国为星期日，法国为星期一。
|
整数 | 版本 2 |
MONTH |
表示 ZonedDateTime 的月份字段的整数值
对象。此值始终介于 1 和 12 之间，
（含边界值）。
|
整数 | 版本 1 |
MONTH_Z |
表示 ZonedDateTime 的月份字段的字符串值
对象，其中带前导零，以使值的长度为 2 个字符。这个
值始终介于 01 和 12 之间（包括这两个数值）。
|
字符串 | 版本 1 |
MONTH_F |
一年中的当前月份，表示为一个完整长度的字符串。示例
包括 January 和 December。
|
字符串 | 版本 1 |
MONTH_S |
一年中的当前月份，表示为一个缩写的字符串。示例
包括 Jan 和 Dec。
|
字符串 | 版本 1 |
DAYS_IN_MONTH |
当前月份的天数。此值在 2 月为 28 或 29，在 4 月、6 月、9 月和 11 月为 30，在公历的所有其他月份为 31。
|
整数 | 版本 1 |
MONTH_DAY |
一个浮点值，用于组合月份字段和经过修改的
ZonedDateTime 的日期字段
对象，该对象表示当前的
日期。此值始终介于 1.0 和 $ 12 \frac{29}{30} $ 之间（包括这两个数值）。
|
浮点数 | 版本 1 |
MONTH_0_11 |
来自 ZonedDateTime 的 getMonthValue() 值的修改版本
该对象表示当前日期。此值将为 1 月指定值 0，并为 12 月指定值 11。
|
整数 | 版本 1 |
MONTH_0_11_DAY |
一个浮点值，用于组合经过修改的月份字段和
经过修改的 ZonedDateTime 的日期字段
对象，该对象代表
当前日期。此值始终介于 0.0 和 $ 11 \frac{29}{30} $ 之间，
（含边界值）。
|
浮点数 | 版本 1 |
YEAR |
一个整数值，表示 ZonedDateTime 的年份字段
对象。此值的限制取值范围始终介于 1902 和 2100 之间（包括这两个数值）。
|
整数 | 版本 1 |
YEAR_S |
一个两位整数，表示当前年份的最后两位数字。对于
例如，2023 的值为 23。
|
整数 | 版本 1 |
YEAR_MONTH |
一个浮点值，用于组合年份字段和经过修改的日期
ZonedDateTime 中的字段
对象。
2023 年 1 月表示为 2023.0，而 2023 年 12 月表示为
$ 2023 \frac {11}{12} $。
|
浮点数 | 版本 1 |
YEAR_MONTH_DAY |
一个浮点值，用于组合年份字段（经过修改的月份）
字段，而经过修改的日期字段 ZonedDateTime
对象。2023 年 1 月 1 日表示为 2023.0。
而 2023 年 12 月 31 日表示为 $ 2023 \frac{11 \frac{29}{30} }{12} \approx 2023.9972 $。
|
浮点数 | 版本 1 |
WEEK_IN_MONTH |
一个整数，表示
ALIGNED_WEEK_OF_MONTH
代表当前日期的 ChronoField 对象。此值始终介于 0 和 5 之间（包括这两个数值）。
|
整数 | 版本 1 |
WEEK_IN_YEAR |
一个整数，表示当前日期的 ChronoField 对象的 ALIGNED_WEEK_OF_YEAR 值。此值始终介于 1 和 53 之间，
（含边界值）。
|
整数 | 版本 1 |
IS_24_HOUR_MODE |
相当于当前返回值的布尔值
is24HourFormat()。
|
布尔值 | 版本 1 |
IS_DAYLIGHT_SAVING_TIME |
一个布尔值，相当于对当前语言区域的 TimeZone 对象调用 inDaylightTime()，并传入包含当前时间的 Date 对象。指明当前设置的时区是否为
目前采用夏令时
|
布尔值 | 版本 1 |
TIMEZONE |
相当于对 getDisplayName() 调用
TimeZone 对象。返回完整的时区名称，如
设为“东部标准时间”纽约时区。
|
字符串 | 版本 1 |
TIMEZONE_ABB |
一个字符串，相当于调用
针对当前语言区域的 TimeZone 对象设置 getDisplayName()，其中
指定的样式为 SHORT。返回缩写的时区名称，如“EST”
纽约时区。
|
字符串 | 版本 1 |
TIMEZONE_ID |
一个字符串，相当于调用
TimeZone上的getId()
对象。返回 IANA 时区 ID
值，例如表示纽约市时间的 America/New_York
可用区。
|
字符串 | 版本 1 |
TIMEZONE_OFFSET |
一个字符串，相当于对当前语言区域的 TimeZone 对象调用 getRawOffset()。此值始终介于 -12 和
+14（含边界值）。可返回一个值，世界协调时间 (UTC) 应与此值相加，才能得出当前时区的标准时间。
|
字符串 | 版本 1 |
TIMEZONE_OFFSET_DST |
一个字符串，相当于将当前日期传入
针对当前语言区域的 TimeZone 对象拥有 getOffset() 权限。此值始终介于 -12 和 +14 之间（包括这两个数值）。可返回一个值，世界协调时间 (UTC) 应与此值相加，才能得出当前的当地时间（夏令时）
（如果需要的话）。
|
字符串 | 版本 1 |
AMPM_STATE |
一个整数，用于指明当前时间是在中午之前还是中午
或更新版本。可能的值包括 0（针对“凌晨/上午”）和 1（针对“下午/晚上”）。
|
整数 | 版本 1 |
AMPM_POSITION |
一个整数，表示“凌晨/上午”或“下午/晚上”指示器应在时间字符串中的显示位置。包含以下某个值：
|
整数 | 版本 1 |
AMPM_STRING |
一个包含两个字符的字符串，表示当前时间的“凌晨/上午”或“下午/晚上”状态。值为“AM”或“PM”。 | 字符串 | 版本 1 |
MOON_PHASE_POSITION |
一个整数值，表示自
最近的新月此值始终介于 0 和 28 之间（包括这两个数值）。
|
整数 | 版本 1 |
MOON_PHASE_TYPE |
一个整数，用于对当前月相进行编码。可能的值包括
以下：
|
整数 | 版本 1 |
MOON_PHASE_TYPE_STRING |
一个字符串，表示当前的月相。可能的值包括
以下：
|
字符串 | 版本 1 |
LANGUAGE_LOCALE_NAME |
一个字符串，表示 Wear OS 设备的当前语言区域，表示为
2 个字符的 ISO 639-1 语言代码、下划线和
2 个字符的 ISO 3166-1 地区代码。英语的美国变体表示为 en_US。
|
字符串 | 版本 1 |
STEP_COUNT |
用户今天到目前为止走过的步数，数据基于 Wear OS 传感器。 | 整数 | 版本 1 |
STEP_GOAL |
用户选择作为每日步数目标的步数。这个
值始终不小于 1000。
|
整数 | 版本 1 |
STEP_PERCENT |
一个整数，表示用户完成的步数
今日目标，用四舍五入的百分比表示。此值始终介于 0 和 100 之间（包括这两个数值）。
|
整数 | 版本 1 |
HEART_RATE |
用户当前的心率，基于 Wear OS 传感器。这个
值始终介于 0 和 240 之间（包括这两个数值）。
|
整数 | 版本 1 |
HEART_RATE_Z |
一个字符串，表示用户当前的心率，基于 Wear
操作系统传感器。可视需要在此值左侧添加零，以使其长度至少为 2 个字符。因此，如果用户的心率测量为
65，则此值为 65。如果用户的心率为 0，则此值为
00。
|
字符串 | 版本 1 |
ACCELEROMETER_IS_SUPPORTED |
指示表盘是否可以获取加速度计数据的布尔值
来自当前 Wear OS 设备的传感器。
00。
|
布尔值 | 版本 1 |
ACCELEROMETER_X |
一个浮点值，表示当前的线性加速度 x 轴（基于 Wear OS 设备的加速度计计算）。正值 表示，当表盘指向天空或天花板时， OS 设备正在向右加速。 | 浮点数 | 版本 1 |
ACCELEROMETER_Y |
一个浮点值，表示 y 轴的当前线性加速度，基于 Wear OS 设备的加速度计。正值 表示，当表盘指向天空或天花板时， OS 设备在手表的 12 点（顶部）方向上加速 。 | 浮点数 | 版本 1 |
ACCELEROMETER_Z |
一个浮点值，表示 z 轴的当前线性加速度，基于 Wear OS 设备的加速度计。正值表示当表盘指向天空或天花板时，Wear OS 设备会朝着天空或天花板加速。
注意：当设备处于静止状态时，此值约为 -9.8
都考虑到了重力
|
浮点数 | 版本 1 |
ACCELEROMETER_Z |
一个浮点值，表示 z 轴的当前线性加速度，基于 Wear OS 设备的加速度计。正值表示当表盘指向天空或天花板时，Wear OS 设备会朝着天空或天花板加速。
注意：当设备处于静止状态时，此值约为 -9.8
都考虑到了重力
|
浮点数 | 版本 1 |
ACCELEROMETER_ANGLE_X |
一个浮点值，表示相对于 x 轴的当前角加速度（以度为单位）。此值始终在范围内 $ [-90.0, 90.0 $]。 | 浮点数 | 版本 1 |
ACCELEROMETER_ANGLE_Y |
一个浮点值，表示相对于 y 轴的当前角加速度（以度为单位）。此值始终在范围内 $ [-90.0, 90.0 $]。 | 浮点数 | 版本 1 |
ACCELEROMETER_ANGLE_Z |
一个浮点值，表示相对于 z 轴的当前角加速度（以度为单位）。此值始终在 $ [-90.0, 90.0 $] 的范围内。 | 浮点数 | 版本 1 |
ACCELEROMETER_ANGLE_XY |
一个浮点值，它是 ACCELEROMETER_ANGLE_X 和
ACCELEROMETER_ANGLE_Y。
|
浮点数 | 版本 1 |
BATTERY_PERCENT |
一个整数，表示 Wear OS 设备的当前电池电量。
以百分比表示值 100 表示电池电量已满；值 0 表示电池电量极低。
|
整数 | 版本 1 |
BATTERY_CHARGING_STATUS |
一个布尔值，表示 Wear OS 设备的电池是否正在充电。如果
表示电池已完成充电且电量充足，此值为 true。
|
布尔值 | 版本 1 |
BATTERY_IS_LOW |
一个布尔值，表示 Wear OS 设备的电池电量是否不足。通过
确切阈值取决于制造商。如果电池正在充电，
此值为 false。
|
布尔值 | 版本 1 |
BATTERY_TEMPERATURE_CELSIUS |
一个浮点值，表示 Wear OS 设备的温度 电池电量（以摄氏度为单位）。此值的计算方法为电池的原始温度值（以十分之一摄氏度为单位）除以 10。 | 浮点数 | 版本 1 |
BATTERY_TEMPERATURE_FAHRENHEIT |
一个浮点值，表示 Wear OS 设备的温度 以华氏度为单位。此值由摄氏度换算而来。 | 浮点数 | 版本 1 |
UNREAD_NOTIFICATION_COUNT |
一个字符串，表示已发送到此 Wear OS 设备的用户尚未读取的通知数量。 | 整数 | 版本 1 |
[WEATHER.IS_AVAILABLE] |
表示是否有可用天气数据的布尔值 可渲染对象。 | 布尔值 | 版本 2 |
[WEATHER.IS_ERROR] |
表示加载时是否出错的布尔值 天气数据。
|
布尔值 | 版本 2 |
[WEATHER.CONDITION] |
表示当前天气状况的枚举值。 可能的值为：
注意：如果使用 |
整数 | 版本 2 |
[WEATHER.CONDITION_NAME] |
人类可读的天气数据表示形式，经过翻译 翻译成用户的首选语言 | 字符串 | 版本 2 |
[WEATHER.IS_DAY] |
表示当前条件在 日光。此数据很有用，因为一天中的长度在一年中会发生变化。 | 布尔值 | 版本 2 |
[WEATHER.TEMPERATURE] |
当前温度（以用户的首选单位表示）。 | 整数 | 版本 2 |
[WEATHER.TEMPERATURE_UNIT] |
温度单位。可能的值包括：
|
整数 | 版本 2 |
[WEATHER.DAY_TEMPERATURE_LOW] |
一天内的最低温度。 | 整数 | 版本 2 |
[WEATHER.DAY_TEMPERATURE_HIGH] |
一天中的最高温度。 | 整数 | 版本 2 |
[WEATHER.CHANCE_OF_PRECIPITATION] |
当前的降水概率。这是
范围：0 至 100。
|
整数 | 版本 2 |
[WEATHER.UV_INDEX] |
当前紫外线指数。 | 整数 | 版本 2 |
[WEATHER.LAST_UPDATED] |
上次更新天气数据的时间戳。这是 以毫秒为单位，以 Unix Epoch 时间为单位。 | 整数 | 版本 2 |
[WEATHER.HOURS.{index}.IS_AVAILABLE] |
表示是否有每小时天气数据可用于
指定的 表盘开发者应先检查此值，然后再访问指定 |
布尔值 | 版本 2 |
[WEATHER.HOURS.{index}.CONDITION] |
表示预报天气状况的枚举值，其中 {index} 表示距离当前时间的小时数。枚举值与 [WEATHER.CONDITION] 的值相同。
|
整数 | 版本 2 |
[WEATHER.HOURS.{index}.CONDITION_NAME] |
人类可读的天气状况表示形式，经过翻译 翻译成用户的首选语言 | 字符串 | 版本 2 |
[WEATHER.HOURS.{index}.IS_DAY] |
表示在 日光。非常有用，因为一天的时长会随着一年的变化而变化。 | 布尔值 | 版本 2 |
[WEATHER.HOURS.{index}.TEMPERATURE] |
天气预报时段的温度（用户首选名称）
单位，其中 {index} 表示从
当前时间。
|
整数 | 版本 2 |
[WEATHER.HOURS.{index}.UV_INDEX] |
天气预报时段的紫外线指数（用户偏好设置）
单位，其中 {index} 表示从
当前时间。
|
整数 | 版本 2 |
[WEATHER.DAYS.{index}.IS_AVAILABLE] |
表示是否有针对以下地点的每日天气数据：
指定的 表盘开发者在访问之前应检查此值
针对指定 |
布尔值 | 版本 2 |
[WEATHER.DAYS.{index}.CONDITION_DAY] |
表示日间天气预报的枚举值
条件，其中 {index} 表示天数
从当天开始枚举值与
[WEATHER.CONDITION]。
|
整数 | 版本 2 |
[WEATHER.DAYS.{index}.CONDITION_DAY_NAME] |
人类可读的天气状况表示法， 天气预报的一天，并将其翻译成用户的首选语言。 | 字符串 | 版本 2 |
[WEATHER.DAYS.{index}.CONDITION_NIGHT] |
表示夜间天气预报的枚举值
条件，其中 {index} 表示天数
从当天开始枚举值与
[WEATHER.CONDITION]。
|
整数 | 版本 2 |
[WEATHER.DAYS.{index}.CONDITION_NIGHT_NAME] |
人类可读的天气状况表示法， 天气预报的晚间，并将其翻译成用户的首选语言。 | 字符串 | 版本 2 |
[WEATHER.DAYS.{index}.TEMPERATURE_LOW] |
当天的最低气温预报，其中 {index} 表示距离当前日期的天数。
|
整数 | 版本 2 |
[WEATHER.DAYS.{index}.TEMPERATURE_HIGH] |
当日最高气温预报，其中{index}
表示从当前日期开始的天数。
|
整数 | 版本 2 |
[WEATHER.DAYS.{index}.CHANCE_OF_PRECIPITATION] |
预测降水概率，其中 {index}
表示从当前日期开始的天数。这是
范围：0 - 100。
|
整数 | 版本 2 |
[WEATHER.DAYS.{index}.CHANCE_OF_PRECIPITATION_NIGHT] |
夜间的降水概率：{index}
表示从当前日期开始的天数。此值应在 0 到 100 的范围内。
|
整数 | 版本 2 |
[WEATHER.DAYS.{index}.UV_INDEX] |
预计紫外线指数。 | 整数 | 版本 2 |