資料來源的值,可以更新錶面上顯示的即時值。
這項元素已在 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 |
布林值,相當於對目前語言代碼的 TimeZone 物件呼叫 inDaylightTime() ,並傳入包含目前時間的 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 |
整數,指出上午或下午指標應在時間字串中出現的位置。會包含下列其中一個值:
|
整數 | 版本 1 |
AMPM_STRING |
2 個字元的字串,指出目前時間的狀態為上午或下午。值為「AM」或「下午」 | 字串 | 版本 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
作業系統感應器。這個值會視需要在左側加上零,讓值的長度為至少 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] |
表示載入作業是否發生錯誤的布林值 天氣資料。
|
布林值 | 版本 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] |
目前的紫外線指數。 | 整數 | 版本 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] |
預測時數的紫外線指數,以使用者偏好的時間為準
單位,其中 {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 |
[WEATHER.DAYS.{index}.UV_INDEX] |
預測紫外線指數。 | 整數 | 版本 2 |