資料來源的值,可以更新錶面上顯示的即時值。
這項元素已在 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 |
浮點值,結合代表目前時間的 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 |
字串,代表以 Wear OS 裝置當前時區為準的目前時間 12 小時制元件,包括 00 到 11 (含頭尾)。如果這個值小於 10 ,則開頭會加上零。 |
字串 | 版本 1 |
HOUR_0_11_MINUTE |
浮點值,結合代表目前時間的 ZonedDateTime
物件中經修改的 CLOCK_HOUR_OF_AMPM 欄位和分鐘欄位。這個值一律會介於 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 |
字串,代表以 Wear OS 裝置當前時區為準的目前時間 12 小時制元件,包括 01 到 12 (含頭尾)。如果這個值小於 10 ,則開頭會加上零。 |
string | 版本 1 |
HOUR_1_12_MINUTE |
浮點值,結合代表目前時間的 ZonedDateTime
物件 CLOCK_HOUR_OF_AMPM 欄位和分鐘欄位。這個值一律會介於 1.0 至 $ 12 \frac{59}{60} $ 之間 (含頭尾)。 |
浮點數 | 版本 1 |
HOUR_0_23 |
目前時間的 24 小時制元件,表示方法為 0 和 23 之間的值 (含頭尾)。如果值為 24 ,例如在 24:13 (隔天凌晨 12 點 13 分) 的情況下,這個值會轉換為 0 。 |
整數 | 版本 1 |
HOUR_0_23_Z |
字串,代表以 Wear OS 裝置當前時區為準的目前時間 24 小時制元件,包括 00 到 23 (含頭尾)。如果這個值小於 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 |
字串,代表以 Wear OS 裝置當前時區為準的目前時間 12 小時制元件,包括 01 到 24 (含頭尾)。如果這個值小於 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 |
修改版的 getDayOfWeek() 值,取自代表目前日期的 ZonedDateTime
物件。錶面格式會指派 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 |
修改版的 getMonthValue() 值,取自代表目前日期的 ZonedDateTime
物件。這個值會將 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 位數字。例如,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 的值,該物件代表目前日期。這個值一律會介於 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 |
字串,相當於對目前語言代碼的 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 |
整數,指出上午或下午指標應在時間字串中出現的位置。包含下列其中一個值:
|
整數 | 版本 1 |
AMPM_STRING |
2 個字元的字串,指出目前時間的狀態為上午或下午。值為「上午」(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 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_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] |
目前的 UV 指數。 | 整數 | 版本 2 |
[WEATHER.LAST_UPDATED] |
天氣資料上次更新時間的時間戳記。這項資訊是以 Unix 紀元時間中的毫秒為單位。 | 整數 | 版本 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] |
預測時數的 UV 指數,以使用者偏好的單位為準,其中 {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 |