数据源的值,用于更新表盘上显示的实时值。
此元素在 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
对象调用useDaylightTime()
。指示当前设置的时区是否采用夏令时。 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 设备的电池电量是否为 20% 或更低且正在放电。如果电池正在充电,则此值为
false
。 BATTERY_TEMPERATURE_CELSIUS
- 一个浮点值,表示 Wear OS 设备的电池温度(以摄氏度为单位)。此值的计算方法为电池的原始温度值(以十分之一摄氏度为单位)除以 10。
BATTERY_TEMPERATURE_FAHRENHEIT
- 一个浮点值,表示 Wear OS 设备的电池温度(以华氏度为单位)。此值由摄氏度换算而来。
通知
表盘格式支持与设备通知相关的以下数据源:
UNREAD_NOTIFICATION_COUNT
- 一个字符串,表示已发送到此 Wear OS 设备的用户尚未读取的通知数量。
为您推荐
- 注意:当 JavaScript 处于关闭状态时,系统会显示链接文字
- ArithmeticExpression
- 结合使用合成数据与健康服务
- ListConfiguration