数据源类型

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

在 Wear OS 4 中引入。

来源 描述 类别 可用性
UTC_TIMESTAMP 自 1970 年 1 月 1 日 UTC 午夜以来的毫秒数。 整数 版本 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 当前秒的个位数字，例如，对于 12:03:47 为 7。 整数 版本 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 表示当前时间 24 小时制部分的字符串，从 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() 值的修改版本，减去 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 一个浮点值，它将年字段和修改后的月日字段结合起来，该对象表示当前日期。2023 年 1 月表示为 2023.0，2023 年 12 月表示为 $ 2023 \frac {11}{12} $。 浮点数 版本 1
MONTH_0_11 表示当前日期的 ZonedDateTime 对象的 getMonthValue() 值的修改版本。此值将 0 赋值给 1 月，将 11 赋值给 12 月。 整数 版本 1
MONTH_0_11_DAY 一个浮点值，它将修改后的年字段和修改后的月日字段结合起来，该对象表示当前日期。此值始终介于 0.0 和 $ 11 \frac{29}{30} $ 之间（含）。 浮点数 版本 1
YEAR 一个整数值，表示 ZonedDateTime 对象的年份字段，用于表示当前日期。此值始终介于 1902 和 2100（含）之间。 整数 版本 1
YEAR_S 一个 2 位整数，表示当前年份的后两位数字。例如，2023 年的值为 23。 整数 版本 1
YEAR_MONTH 一个浮点值，它将年份字段和修改后的月日字段结合起来，该对象表示当前日期。2023 年 1 月表示为 2023.0，2023 年 12 月表示为 $ 2023 \frac {11}{12} $。 浮点数 版本 1
YEAR_MONTH_DAY 一个浮点值，它将年份字段、修改后的月份字段和修改后的月日字段结合起来，该对象表示当前日期。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 的值，该对象表示当前日期。此值始终介于 0 和 5（含）之间。 整数 版本 1
WEEK_IN_YEAR 一个整数，表示 ALIGNED_WEEK_OF_YEAR 的值，该对象表示当前日期。此值始终介于 1 和 53（含）之间。 整数 版本 1
IS_24_HOUR_MODE 一个布尔值，等效于基于用户选择的区域设置和偏好，调用 is24HourFormat() 的当前返回值。 Boolean 版本 1
IS_DAYLIGHT_SAVING_TIME 一个布尔值，等效于在当前区域设置的 TimeZone 对象上调用 inDaylightTime()，并将包含当前时间的 Date 对象传递给它。指示当前设置的时区现在是否正在使用夏令时。 Boolean 版本 1
TIMEZONE 与在当前区域设置下对 TimeZone 对象调用 getDisplayName() 等效的字符串。返回完整的时区名称，例如纽约市在冬季的时区为“东部标准时间”。 字符串 版本 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 一个整数，指示 AM 或 PM 指示符应出现在时间字符串中的位置。包含以下值之一
  • 0 表示 AM 或 PM 应出现在字符串的开头，例如 AM 12:03。
  • 1 表示 AM 或 PM 应出现在字符串的末尾，例如 12:03 AM。
  • -1 表示不知道 AM 或 PM 应出现在字符串中的位置。
 整数 版本 1
AMPM_STRING 一个 2 个字符的字符串，指示当前时间的 AM 或 PM 状态。该值为“AM”或“PM”。 字符串 版本 1
MOON_PHASE_POSITION 一个整数，指示自最近一次新月开始的天数。此值始终在 0 和 28（含）之间。 整数 版本 1
MOON_PHASE_TYPE 一个整数，编码当前月相。可能的值包括以下内容
  • 0 代表最近一次新月
  • 1 代表晚间新月
  • 2 代表上弦月
  • 3 代表盈凸月
  • 4 代表满月
  • 5 代表亏凸月
  • 6 代表下弦月
  • 7 代表晨间新月
 整数 版本 1
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 天时。
 字符串 版本 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 OS 传感器，用户的当前心率。此值在左侧用零填充，以使值至少为 2 个字符长。因此，如果用户的心率测量值为 65，则此值为 65。如果用户的心率测量值为 0，则此值为 00。 字符串 版本 1
ACCELEROMETER_IS_SUPPORTED 一个布尔值，指示表盘是否可以从当前 Wear OS 设备的传感器获取加速度计数据。 00。 Boolean 版本 1
ACCELEROMETER_X 一个浮点值，表示根据 Wear OS 设备的加速度计，沿 x 轴的当前线性加速度。正值表示，当表盘指向天空或天花板时，Wear OS 设备正在向右加速。 浮点数 版本 1
ACCELEROMETER_Y 一个浮点值，表示根据 Wear OS 设备的加速度计，沿 y 轴的当前线性加速度。正值表示，当表盘指向天空或天花板时，Wear OS 设备正在沿表盘的 12 点钟（顶部）方向加速。 浮点数 版本 1
ACCELEROMETER_Z 一个浮点值，表示根据 Wear OS 设备的加速度计，沿 z 轴的当前线性加速度。正值表示，当表盘指向天空或天花板时，Wear OS 设备正在朝天空或天花板加速。注意：当设备静止时，此值约为 -9.8，以考虑重力。 浮点数 版本 1
ACCELEROMETER_Z 一个浮点值，表示根据 Wear OS 设备的加速度计，沿 z 轴的当前线性加速度。正值表示，当表盘指向天空或天花板时，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。 Boolean 版本 1
BATTERY_IS_LOW 一个布尔值，指示 Wear OS 设备的电池电量是否不足。此值的精确阈值取决于制造商。如果电池正在充电，则此值为 false。 Boolean 版本 1
BATTERY_TEMPERATURE_CELSIUS 一个浮点值，表示 Wear OS 设备电池的温度（以摄氏度为单位）。电池的原始温度值（以十分之一摄氏度为单位）除以 10 后得到此值。 浮点数 版本 1
BATTERY_TEMPERATURE_FAHRENHEIT 一个浮点值，表示 Wear OS 设备电池的温度（以华氏度为单位）。这是从摄氏度转换而来的。 浮点数 版本 1
UNREAD_NOTIFICATION_COUNT 一个字符串，表示已传送到此 Wear OS 设备但用户尚未阅读的通知数量。 整数 版本 1
[WEATHER.IS_AVAILABLE] 一个布尔值，表示是否有可用的天气数据可以渲染。 Boolean 版本 2
[WEATHER.IS_ERROR]

一个布尔值，表示加载天气数据时是否出错。

IS_ERROR 和 IS_AVAILABLE 不是互斥的。当两者都为真时，表盘的预期行为是继续渲染一些天气数据，但同时还显示一个指示器，表明获取数据时出错。

 Boolean 版本 2
[WEATHER.CONDITION]

一个枚举值，表示当前天气状况。

可能的值为

  • 0 - UNKNOWN_VALUE
  • 1 - CLEAR
  • 2 - CLOUDY
  • 3 - FOG
  • 4 - HEAVY_RAIN
  • 5 - HEAVY_SNOW
  • 6 - RAIN
  • 7 - SNOW
  • 8 - SUNNY
  • 9 - THUNDERSTORM
  • 10 - SLEET
  • 11 - LIGHT_SNOW
  • 12 - LIGHT_RAIN
  • 13 - MIST
  • 14 - PARTLY_CLOUDY
  • 15 - WINDY

注意：如果使用 [WEATHER.CONDITION] 数据源，强烈建议手表表盘识别所有枚举值。

 整数 版本 2
[WEATHER.CONDITION_NAME] 天气数据的可读表示形式，已翻译成用户的首选语言。 字符串 版本 2
[WEATHER.IS_DAY] 表示当前情况是否发生在白天。这很有用，因为白天的长度在一年中会发生变化。 Boolean 版本 2
[WEATHER.TEMPERATURE] 当前温度，以用户的首选单位表示。 整数 版本 2
[WEATHER.TEMPERATURE_UNIT]

温度单位。可能的值为

  • 1 - CELSIUS
  • 2 - FAHRENHEIT
 整数 版本 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 纪元时间中的毫秒数表示。 整数 版本 2
[WEATHER.HOURS.{index}.IS_AVAILABLE]

表示对于指定的 {index} 小时是否可以获取每小时的天气数据，其中 {index} 表示距离当前时间的时长（以小时为单位）。

手表表盘开发者应在访问给定 {index} 值的任何基于小时的天气数据之前检查此值。

 Boolean 版本 2
[WEATHER.HOURS.{index}.CONDITION] 表示预测天气状况的枚举值，其中 {index} 表示距离当前时间的时长（以小时为单位）。枚举值与 [WEATHER.CONDITION] 中的相同。 整数 版本 2
[WEATHER.HOURS.{index}.CONDITION_NAME] 天气状况的可读表示形式，已翻译成用户的首选语言。 字符串 版本 2
[WEATHER.HOURS.{index}.IS_DAY] 表示预测小时的条件是否发生在白天。这很有用，因为白天的长度在一年中会发生变化。 Boolean 版本 2
[WEATHER.HOURS.{index}.TEMPERATURE] 预测小时的温度，以用户的首选单位表示，其中 {index} 表示距离当前时间的时长（以小时为单位）。 整数 版本 2
[WEATHER.HOURS.{index}.UV_INDEX] 预测小时的紫外线指数，以用户的首选单位表示，其中 {index} 表示距离当前时间的时长（以小时为单位）。 整数 版本 2
[WEATHER.DAYS.{index}.IS_AVAILABLE]

表示对于指定的 {index} 天是否可以获取每天的天气数据，其中 {index} 表示距离当前日期的时长（以天为单位）。

手表表盘开发者应在访问给定 {index} 值的任何基于日期的天气数据之前检查此值。

 Boolean 版本 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