SourceType

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

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

來源 說明 類別 產品數量限制
UTC_TIMESTAMP 自世界標準時間 1970 年 1 月 1 日午夜起經過的毫秒數。 整數 版本 1
MILLISECOND 整數值,代表目前時間 ZonedDateTime 物件的毫秒欄位。這個值一律會介於 0999 之間 (含頭尾)。 整數 版本 1
SECOND 整數值,代表目前時間 ZonedDateTime 物件的第二個欄位。這個值一律會介於 059 之間 (含頭尾)。 整數 版本 1
SECOND_Z 字串,代表目前 ZonedDateTime 物件的第二欄位,開頭會加上零,讓值的長度為 2 個字元。這個值一律會介於 0059 之間 (含頭尾)。 字串 版本 1
SECOND_TENS_DIGIT 目前秒數的十位數,例如 4 代表 12:03:47。 整數 版本 2
SECOND_UNITS_DIGIT 目前秒數的單位數字,例如 7 代表 12:03:47。 整數 版本 2
SECOND_MILLISECOND 浮點值,結合代表目前時間的 ZonedDateTime 物件秒數欄位和毫秒欄位。這個值一律會介於 0.059.999 之間 (含頭尾)。 浮點數 版本 1
SECONDS_IN_DAY 根據 HOUR_0_23MINUTESECOND 的值,代表當天已經過的秒數。這個值一律會介於 086399 ($ 24 * 60 * 60 - 1 $) 之間 (含頭尾)。 整數 版本 1
MINUTE 整數值,代表目前時間 ZonedDateTime 物件的分鐘欄位。這個值一律會介於 059 之間 (含頭尾)。 整數 版本 1
MINUTE_Z 字串值,代表目前時間 ZonedDateTime 物件的分鐘欄位,開頭會加上零,讓值的長度為 2 個字元。這個值一律會介於 0059 之間 (含頭尾)。 字串 版本 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 小時制元件,表示方法為 011 之間的值 (含頭尾)。如果目前 CLOCK_HOUR_OF_AMPM12,例如在 12:34 PM 的情況下,這個值會轉換為 0 整數 版本 1
HOUR_0_11_Z 字串,代表以 Wear OS 裝置當前時區為準的目前時間 12 小時制元件,包括 0011 (含頭尾)。如果這個值小於 10,則開頭會加上零。 字串 版本 1
HOUR_0_11_MINUTE 浮點值,結合代表目前時間的 ZonedDateTime 物件中經修改的 CLOCK_HOUR_OF_AMPM 欄位和分鐘欄位。這個值一律會介於 0.0 至 $ 11 \frac{59}{60} $ 之間 (含頭尾)。 浮點數 版本 1
HOUR_1_12 目前時間的 12 小時制元件,表示方法為 112 之間的值 (含頭尾)。如果目前 HOUR_OF_DAY0,例如在 0:12 (中午 12 點 12 分) 的情況下,這個值會轉換為 12 整數 版本 1
HOUR_1_12_Z 字串,代表以 Wear OS 裝置當前時區為準的目前時間 12 小時制元件,包括 0112 (含頭尾)。如果這個值小於 10,則開頭會加上零。 string 版本 1
HOUR_1_12_MINUTE 浮點值,結合代表目前時間的 ZonedDateTime 物件 CLOCK_HOUR_OF_AMPM 欄位和分鐘欄位。這個值一律會介於 1.0 至 $ 12 \frac{59}{60} $ 之間 (含頭尾)。 浮點數 版本 1
HOUR_0_23 目前時間的 24 小時制元件,表示方法為 023 之間的值 (含頭尾)。如果值為 24,例如在 24:13 (隔天凌晨 12 點 13 分) 的情況下,這個值會轉換為 0 整數 版本 1
HOUR_0_23_Z 字串,代表以 Wear OS 裝置當前時區為準的目前時間 24 小時制元件,包括 0023 (含頭尾)。如果這個值小於 10,則開頭會加上零。 整數 版本 1
HOUR_0_23_MINUTE 浮點值,結合代表目前時間的 ZonedDateTime 物件小時欄位和分鐘欄位。這個值一律會介於 0.0 至 $ 23 \frac{59}{60} $ 之間 (含頭尾)。 浮點數 版本 1
HOUR_1_24 目前時間的 24 小時制元件,表示方法為 124 之間的值 (含頭尾)。如果值為 0,例如在 0:12 (凌晨 12 點 12 分) 的情況下,這個值會轉換為 24 整數 版本 1
HOUR_1_24_Z 字串,代表以 Wear OS 裝置當前時區為準的目前時間 12 小時制元件,包括 0124 (含頭尾)。如果這個值小於 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 物件日期欄位。這個值一律會介於 131 之間 (含頭尾)。 整數 版本 1
DAY_Z 字串值,代表目前日期的 ZonedDateTime 物件日期欄位,開頭會加上零,讓值的長度為 2 個字元。這個值一律會介於 0131 之間 (含頭尾)。 字串 版本 1
DAY_HOUR 浮點值,結合代表目前日期和時間的 ZonedDateTime 物件日期欄位和小時欄位。這個值一律會介於 1.0 至 $ 31 \frac{23}{24} $ 之間 (含頭尾)。 浮點數 版本 1
DAY_0_30 修改版的 getDayOfMonth() 值,取自目前日期的 ZonedDateTime 物件,會減去 1。這個值一律會介於 030 之間 (含頭尾)。 整數 版本 1
DAY_0_30_HOUR 浮點值,結合代表目前日期和時間的 ZonedDateTime 物件中經修改的日期欄位和小時欄位。這個值一律會介於 0.0 至 $ 30 \frac{23}{24} $ 之間 (含頭尾)。 浮點數 版本 1
DAY_OF_YEAR 自日曆年度變更後經過的天數。這個值一律會介於 1366 之間 (含頭尾),且非閏年的上限值為 365 整數 版本 1
DAY_OF_WEEK 修改版的 getDayOfWeek() 值,取自代表目前日期的 ZonedDateTime 物件。錶面格式會指派 1 值來代表星期天,並指派 7 值代表星期六。 整數 版本 1
DAY_OF_WEEK_F 完整字串,代表目前星期幾。範例包括 SundayMonday 字串 版本 1
DAY_OF_WEEK_S 短字串,代表目前星期幾。範例包括 SunMon 字串 版本 1
FIRST_DAY_OF_WEEK 根據 getFirstDayOfWeek() 提供一週的第一天,其中 1 為星期日,7 代表星期六。例如美國的星期日、法國的星期一。 整數 版本 2
MONTH 整數值,代表目前日期的 ZonedDateTime 物件月份欄位。這個值一律會介於 112 之間 (含頭尾)。 整數 版本 1
MONTH_Z 字串值,代表目前日期的 ZonedDateTime 物件月份欄位,開頭會加上零,讓值的長度為 2 個字元。這個值一律會介於 0112 之間 (含頭尾)。 字串 版本 1
MONTH_F 完整字串,代表一年中的月份。範例包括 JanuaryDecember 字串 版本 1
MONTH_S 短字串,代表一年中的月份。範例包括 JanDec 字串 版本 1
DAYS_IN_MONTH 當月天數。這個值在公曆 2 月為 2829,在 4 月、6 月、9 月和 11 月為 30,在其餘月份則為 31 整數 版本 1
MONTH_DAY 浮點值,結合代表目前日期的 ZonedDateTime 物件月份欄位和經修改的日期欄位。這個值一律會介於 1.0 至 $ 12 \frac{29}{30} $ 之間 (含頭尾)。 浮點數 版本 1
MONTH_0_11 修改版的 getMonthValue() 值,取自代表目前日期的 ZonedDateTime 物件。這個值會將 0 值指派給 1 月,並將 11 值指派給 12 月。 整數 版本 1
MONTH_0_11_DAY 浮點值,結合代表目前日期的 ZonedDateTime 物件中經修改的月份欄位和經修改的日期欄位。這個值一律會介於 0.0 至 $ 11 \frac{29}{30} $ 之間 (含頭尾)。 浮點數 版本 1
YEAR 整數值,代表目前日期的 ZonedDateTime 物件年份欄位。這個值的限制取值範圍一律會介於 19022100 之間 (含頭尾)。 整數 版本 1
YEAR_S 2 位數的整數,代表目前年度的最後 2 位數字。例如,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 代表 ChronoField 物件中 ALIGNED_WEEK_OF_MONTH 值的整數,該物件代表目前日期。這個值一律會介於 05 之間 (含頭尾)。 整數 版本 1
WEEK_IN_YEAR 代表 ChronoField 物件中 ALIGNED_WEEK_OF_YEAR 值的整數,該物件代表目前日期。這個值一律會介於 153 之間 (含頭尾)。 整數 版本 1
IS_24_HOUR_MODE 根據使用者選擇的語言代碼和偏好設定,相當於 is24HourFormat() 目前傳回值的布林值。 布林值 版本 1
IS_DAYLIGHT_SAVING_TIME 布林值,相當於對目前語言代碼的 TimeZone 物件呼叫 inDaylightTime(),並傳入包含目前時間的 Date 物件。指出目前設定的時區是否正在觀察日光節約時間。 布林值 版本 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 之間 (含頭尾)。會傳回應加入世界標準時間的值,以取得目前時區的標準時間,而非修正為日光節約時間。 字串 版本 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) 或「下午」(PM)。 字串 版本 1
MOON_PHASE_POSITION 整數值,代表從最近一次新月起算的天數。這個值一律會介於 028 之間 (含頭尾)。 整數 版本 1
MOON_PHASE_TYPE 為目前月相編碼的整數。可能的值如下:
  • 0 代表最近的新月
  • 1 代表眉月
  • 2 代表上弦月
  • 3 代表上凸月
  • 4 代表滿月
  • 5 代表下凸月
  • 6 代表下弦月
  • 7 代表殘月
整數 版本 1
MOON_PHASE_TYPE_STRING 字串,代表目前月相。可能的值如下:
  • New Moon (新月):自最近一次新月起,經過的天數少於 0.5 天或超過 27.5 天時。
  • 眉月:自最近一次新月起,已經過至少 0.5 天,但少於 6.5 天時。
  • First Quarter (上弦月):自最近一次新月起,已經過至少 6.5 天,但少於 7.5 天時。
  • Waxing Gibbous (下凸月):自最近一次新月起,已經過至少 7.5 天,但少於 13.5 天時。
  • Full Moon (滿月):自最近一次新月起,已經過至少 13.5 天,但少於 14.5 天時。
  • Waning Gibbous (下凸月):自最近一次新月起,已經過至少 14.5 天,但少於 20.5 天時。
  • Last Quarter (下弦月):自最近一次新月起,已經過至少 20.5 天,但少於 21.5 天時。
  • Morning Crescent (殘月):自最近一次新月起,已經過至少 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 整數,代表使用者目前達成的步數目標進度,以四捨五入的百分比表示。這個值一律會介於 0100 之間 (含頭尾)。 整數 版本 1
HEART_RATE 使用者目前的心率,計算依據為 Wear OS 感應器。這個值一律會介於 0240 之間 (含頭尾)。 整數 版本 1
HEART_RATE_Z 代表使用者目前心率的字串,計算依據為 Wear OS 感應器。這個值會視需要在左側加上零,讓值的長度為至少 2 個字元。因此,如果使用者心率的測量結果為 65,這個值會是 65。如果使用者心率的測量結果為 0,這個值會是 00 字串 版本 1
ACCELEROMETER_IS_SUPPORTED 布林值,指出錶面是否能從目前的 Wear OS 裝置感應器取得加速計資料。00 布林值 版本 1
ACCELEROMETER_X 浮點值,指出目前沿著 X 軸的直線加速度,計算依據為 Wear OS 裝置的加速計。正值表示在錶面指向天空或天花板時,Wear OS 裝置是向右加速。 浮點數 版本 1
ACCELEROMETER_Y 浮點值,指出目前沿著 Y 軸的直線加速度,計算依據為 Wear OS 裝置的加速計。正值表示在錶面指向天空或天花板時,Wear 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_XACCELEROMETER_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_ERRORIS_AVAILABLE 並非互斥。如果兩者都為 true,錶面的預期行為是持續轉譯部分天氣資料,但同時顯示擷取資料時發生錯誤的指標。

布林值 版本 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] 目前降雨機率。這是介於 0100 之間的值。 整數 版本 2
[WEATHER.UV_INDEX] 目前的 UV 指數 整數 版本 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] 預測小時的 UV 索引,位於使用者偏好的單位,其中 {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} 代表今天起的天數。這是介於 0100 之間的值。 整數 版本 2
[WEATHER.DAYS.{index}.CHANCE_OF_PRECIPITATION_NIGHT] 夜間降雨機率,其中 {index} 代表今天起降的天數。這是介於 0100 之間的值。 整數 版本 2