SourceType

資料來源的值，可以更新錶面上顯示的即時值。

這項元素已在 Wear OS 4 推出。

來源 說明 類別 適用地區
UTC_TIMESTAMP 自世界標準時間午夜起經過的毫秒數 在 1970 年 1 月 1 日 整數 版本 1
MILLISECOND 整數值，代表 ZonedDateTime 物件。這個值一律會介於 0 和 999 (含首尾)。 整數 版本 1
SECOND 一個整數值，代表 ZonedDateTime敬上 目前時間的物件。這個值一律會介於 0 和 59 之間。 總和。 整數 版本 1
SECOND_Z 代表 ZonedDateTime 物件，開頭會加上零，讓值的長度為 2 個字元。這個 值一律會介於 00 和 59 之間 (含頭尾)。 字串 版本 1
SECOND_TENS_DIGIT 目前秒數的十位數，例如 4 代表 12:03:47。 整數 版本 2
SECOND_UNITS_DIGIT 目前秒數的單位數，例如 7 代表 12:03:47。 整數 版本 2
SECOND_MILLISECOND 這個浮點值結合了 100 個字元的秒數欄位和毫秒欄位 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 代表 a. 字串值，代表 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 浮點值，結合含有修改後的小時欄位和分鐘欄位 1 個 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 當月天數。這個值可以是 28 或 29 期間為 2 月、4 月、6 月、9 月和 11 月30，以及 31 則在公曆的其他月份 整數 版本 1
MONTH_DAY 結合年份欄位與經修改的浮點值 ZonedDateTime 的月份欄位 物件，代表目前 日期。這個值一律會介於 1.0 至 $ 12 \frac{29}{30} $ 之間 (含頭尾)。 浮點數 版本 1
MONTH_0_11 修改 ZonedDateTime 值的 getMonthValue() 值 代表目前日期的物件。這個值會將 0 值指派給 1 月，值為 11 到 12 月。 整數 版本 1
MONTH_0_11_DAY 浮點值，結合了已修改的月份欄位和 修改日期的 ZonedDateTime 月份欄位 物件，代表 目前日期。這個值一律會介於 0.0 至 $ 11 \frac{29}{30} $ 之間。 總和。 浮點數 版本 1
YEAR 整數值，代表 ZonedDateTime 的年份欄位 物件。這個值的限制取值範圍一律會介於 1902 之間 以及 2100 (含頭尾)。 整數 版本 1
YEAR_S 2 位數的整數，代表目前年度的最後 2 位數字。適用對象 例如 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 布林值，相當於對inDaylightTime() 目前語言代碼的 TimeZone 物件，並傳入 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 字串，相當於對getRawOffset() 目前語言代碼的 TimeZone 物件。這個值一律會介於 -12 和 +14 (含頭尾)。傳回應加入世界標準時間的值，以取得 目前時區的標準時間 (未修正日光節約時間) 時間)。 字串 版本 1
TIMEZONE_OFFSET_DST 字串，相當於將目前日期傳入 針對目前語言代碼的 TimeZone 物件上的 getOffset()。這個值一律會介於 -12 和 +14 之間 (含頭尾)。傳回應加入世界標準時間的值，以取得目前的當地時間，並採用日光節約時間 帳戶。 字串 版本 1
AMPM_STATE 整數，指出目前時間為中午前或中午時 或之後的版本。可能的值包括代表上午的 0 和代表下午的 1。 整數 版本 1
AMPM_POSITION 整數，指出上午或下午指標應在時間字串中出現的位置。會包含下列其中一個值：
  • 0 表示上午或下午指標應出現在字串開頭，例如 使用 AM 12:03。
  • 1 表示上午或下午指標應出現在字串結尾，例如 12:03 AM。
  • -1 表示不知道上午或下午指標應出現在字串中的哪個位置。
 整數 版本 1
AMPM_STRING 2 個字元的字串，指出目前時間的狀態為上午或下午。值為「AM」或「下午」 字串 版本 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 天 已經過時。
  • Evening Cvecent (眉月)：至少有 0.5 天，但少於 6.5 天時 自最近一次新月後經過。
  • 上弦月：至少有 6.5 天，但少於 7.5 天時 自最近一次新月後經過。
  • Waxing Gibbous (下凸月)：至少 7.5 天，但少於 13.5 天時 自最近一次新月後經過。
  • 滿月：至少有 13.5 天，但少於 14.5 天時 自最近一次新月後經過。
  • Waning Gibbous (下凸月)：至少 14.5 天，但少於 20.5 天時 自最近一次新月後經過。
  • 上一季：至少有 20.5 天，但少於 21.5 天時 自最近一次新月後經過。
  • Morning Crescent (殘月)：至少有 21.5 天，但少於 27.5 天時 自最近一次新月後經過。
 字串 版本 1
LANGUAGE_LOCALE_NAME 代表 Wear OS 裝置目前語言代碼的字串，以 2 個字元的 ISO 639-1 語言代碼、底線和 雙字元的 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 軸。正值 表示在錶面指向天空或天花板時 OS 裝置正在向右加速。 浮點數 版本 1
ACCELEROMETER_Y 浮點值，指出目前線性加速 顯示的 Y 軸 (取決於 Wear OS 裝置的加速計)。正值 表示在錶面指向天空或天花板時 OS 裝置沿著智慧手錶 12 點鐘 (頂端) 方向加速 臉上 浮點數 版本 1
ACCELEROMETER_Z 浮點值，指出目前沿著 Z 軸的直線加速度，計算依據為 Wear OS 裝置的加速計。正值 表示在錶面指向天空或天花板時 OS 裝置正朝天空或天花板使用加速。 注意：裝置處於靜止狀態時，這個值約需 -9.8 將重力納入考量 浮點數 版本 1
ACCELEROMETER_Z 浮點值，指出目前沿著 Z 軸的直線加速度，計算依據為 Wear OS 裝置的加速計。正值 表示在錶面指向天空或天花板時 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]

表示載入作業是否發生錯誤的布林值 天氣資料。

IS_ERROR和IS_AVAILABLE不在 彼此互斥如果兩者皆相同， 錶面是用來持續轉譯一些天氣資料 表示擷取資料時發生錯誤的指標。

 布林值 版本 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] 代表目前條件是否適用於 。因為一天的長度會隨著一年而改變，所以相當實用。 布林值 版本 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} 值的每小時天氣資料。

 布林值 版本 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]

代表是否有每日天氣資料可用 指定的 {index} 天，其中 {index} 代表從當天起的天數。

錶面開發人員應先檢查這個值，再存取 指定 {index} 值的任何日天氣資料。

 布林值 版本 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