資料來源的值,可以更新錶面上顯示的即時值。
這項元素已在 Wear OS 4 推出。
時間與日子
錶面格式支援下列有關時間和日子的資料來源:
UTC_TIMESTAMP
- 自世界標準時間 1970 年 1 月 1 日午夜起經過的毫秒數。
MILLISECOND
- 整數值,代表目前時間的
ZonedDateTime
物件毫秒欄位。這個值一律會介於0
和999
之間 (含頭尾)。 SECOND
- 整數值,代表目前時間的
ZonedDateTime
物件秒數欄位。這個值一律會介於0
和59
之間 (含頭尾)。 SECOND_Z
- 字串,代表目前時間的
ZonedDateTime
物件秒數欄位,開頭會加上零,讓值的長度為 2 個字元。這個值一律會介於00
和59
之間 (含頭尾)。 SECOND_MILLISECOND
- 浮點值,結合代表目前時間的
ZonedDateTime
物件秒數欄位和毫秒欄位。這個值一律會介於0.0
和59.999
之間 (含頭尾)。 SECONDS_IN_DAY
- 根據
HOUR_0_23
、MINUTE
和SECOND
的值,代表當天已經過的秒數。這個值一律會介於0
和86399
($ 24 * 60 * 60 - 1 $) 之間 (含頭尾)。 MINUTE
- 整數值,代表目前時間
ZonedDateTime
物件的分鐘欄位。這個值一律會介於0
和59
之間 (含頭尾)。 MINUTE_Z
- 字串值,代表目前時間
ZonedDateTime
物件的分鐘欄位,開頭會加上零,讓值的長度為 2 個字元。這個值一律會介於00
和59
之間 (含頭尾)。 MINUTE_SECOND
- 浮點值,結合代表目前時間的
ZonedDateTime
物件分鐘欄位和秒數欄位。這個值一律會介於0.0
和 $ 59 \frac{59}{60} $ 之間 (含頭尾)。 HOUR_0_11
- 目前時間的 12 小時制元件,表示方法為
0
和11
之間的值 (含頭尾)。如果目前CLOCK_HOUR_OF_AMPM
為12
,例如在12:34 PM
的情況下,這個值會轉換為0
。 HOUR_0_11_Z
- 字串,代表以 Wear OS 裝置當前時區為準的目前時間 12 小時制元件,包括
00
到11
(含頭尾)。如果這個值小於10
,則開頭會加上零。 HOUR_0_11_MINUTE
- 浮點值,結合代表目前時間的
ZonedDateTime
物件中經修改的CLOCK_HOUR_OF_AMPM
欄位和分鐘欄位。這個值一律會介於0.0
至 $ 11 \frac{59}{60} $ 之間 (含頭尾)。 HOUR_1_12
- 目前時間的 12 小時制元件,表示方法為
1
和12
之間的值 (含頭尾)。如果目前HOUR_OF_DAY
為0
,例如在0:12
(中午 12 點 12 分) 的情況下,這個值會轉換為12
。 HOUR_1_12_Z
- 字串,代表以 Wear OS 裝置當前時區為準的目前時間 12 小時制元件,包括
01
到12
(含頭尾)。如果這個值小於10
,則開頭會加上零。 HOUR_1_12_MINUTE
- 浮點值,結合代表目前時間的
ZonedDateTime
物件CLOCK_HOUR_OF_AMPM
欄位和分鐘欄位。這個值一律會介於1.0
至 $ 12 \frac{59}{60} $ 之間 (含頭尾)。 HOUR_0_23
- 目前時間的 24 小時制元件,表示方法為
0
和23
之間的值 (含頭尾)。如果值為24
,例如在24:13
(隔天凌晨 12 點 13 分) 的情況下,這個值會轉換為0
。 HOUR_0_23_Z
- 字串,代表以 Wear OS 裝置當前時區為準的目前時間 24 小時制元件,包括
00
到23
(含頭尾)。如果這個值小於10
,則開頭會加上零。 HOUR_0_23_MINUTE
- 浮點值,結合代表目前時間的
ZonedDateTime
物件小時欄位和分鐘欄位。這個值一律會介於0.0
至 $ 23 \frac{59}{60} $ 之間 (含頭尾)。 HOUR_1_24
- 目前時間的 24 小時制元件,表示方法為
1
和24
之間的值 (含頭尾)。如果值為0
,例如在0:12
(凌晨 12 點 12 分) 的情況下,這個值會轉換為24
。 HOUR_1_24_Z
- 字串,代表以 Wear OS 裝置當前時區為準的目前時間 12 小時制元件,包括
01
到24
(含頭尾)。如果這個值小於10
,則開頭會加上零。 HOUR_1_24_MINUTE
- 浮點值,結合代表目前時間的
ZonedDateTime
物件中經修改的小時欄位和分鐘欄位。這個值一律會介於1.0
至 $ 24 \frac{59}{60} $ 之間 (含頭尾)。 DAY
- 整數值,代表目前日期的
ZonedDateTime
物件日期欄位。這個值一律會介於1
和31
之間 (含頭尾)。 DAY_Z
- 字串值,代表目前日期的
ZonedDateTime
物件日期欄位,開頭會加上零,讓值的長度為 2 個字元。這個值一律會介於01
和31
之間 (含頭尾)。 DAY_HOUR
- 浮點值,結合代表目前日期和時間的
ZonedDateTime
物件日期欄位和小時欄位。這個值一律會介於1.0
至 $ 31 \frac{23}{24} $ 之間 (含頭尾)。 DAY_0_30
- 修改版的
getDayOfMonth()
值,取自目前日期的ZonedDateTime
物件,會減去 1。這個值一律會介於0
和30
之間 (含頭尾)。 DAY_0_30_HOUR
- 浮點值,結合代表目前日期和時間的
ZonedDateTime
物件中經修改的日期欄位和小時欄位。這個值一律會介於0.0
至 $ 30 \frac{23}{24} $ 之間 (含頭尾)。 DAY_OF_YEAR
- 自日曆年度變更後經過的天數。這個值一律會介於
1
和366
之間 (含頭尾),且非閏年的上限值為365
。 DAY_OF_WEEK
- 修改版的
getDayOfWeek()
值,取自代表目前日期的ZonedDateTime
物件。錶面格式會指派1
值來代表星期天,並指派7
值代表星期六。 DAY_OF_WEEK_F
- 完整字串,代表目前星期幾。範例包括
Sunday
和Monday
。 DAY_OF_WEEK_S
- 短字串,代表目前星期幾。範例包括
Sun
和Mon
。 MONTH
- 整數值,代表目前日期的
ZonedDateTime
物件月份欄位。這個值一律會介於1
和12
之間 (含頭尾)。 MONTH_Z
- 字串值,代表目前日期的
ZonedDateTime
物件月份欄位,開頭會加上零,讓值的長度為 2 個字元。這個值一律會介於01
和12
之間 (含頭尾)。 MONTH_F
- 完整字串,代表一年中的目前月份。範例包括
January
和December
。 MONTH_S
- 短字串,代表一年中的月份。範例包括
Jan
和Dec
。 DAYS_IN_MONTH
- 當前月份的天數。這個值在公曆 2 月為
28
或29
,在 4 月、6 月、9 月和 11 月為30
,在其餘月份則為31
。 MONTH_DAY
- 浮點值,結合代表目前日期的
ZonedDateTime
物件月份欄位和經修改的日期欄位。這個值一律會介於1.0
至 $ 12 \frac{29}{30} $ 之間 (含頭尾)。 MONTH_0_11
- 修改版的
getMonthValue()
值,取自代表目前日期的ZonedDateTime
物件。這個值會將0
值指派給 1 月,並將11
值指派給 12 月。 MONTH_0_11_DAY
- 浮點值,結合代表目前日期的
ZonedDateTime
物件中經修改的月份欄位和經修改的日期欄位。這個值一律會介於0.0
至 $ 11 \frac{29}{30} $ 之間 (含頭尾)。 YEAR
- 整數值,代表目前日期的
ZonedDateTime
物件年份欄位。這個值的限制取值範圍一律會介於1902
和2100
之間 (含頭尾)。 YEAR_S
- 2 位數的整數,代表目前年度的最後 2 位數字。例如,2023 年的值為
23
。 YEAR_MONTH
- 浮點值,結合代表目前日期的
ZonedDateTime
物件年份欄位和經修改的日期欄位。2023 年 1 月會以2023.0
表示,2023 年 12 月則會以 $ 2023 \frac {11}{12} $ 表示。 YEAR_MONTH_DAY
- 浮點值,結合代表目前日期的
ZonedDateTime
物件中經修改的月份欄位和經修改的日期欄位。2023 年 1 月 1 日會以2023.0
表示,2023 年 12 月 31 日則會以 $ 2023 \frac{11 \frac{29}{30}}{12} \approx 2023.9972 $ 表示。 WEEK_IN_MONTH
- 代表
ChronoField
物件中ALIGNED_WEEK_OF_MONTH
值的整數,該物件代表目前日期。這個值一律會介於0
和5
之間 (含頭尾)。 WEEK_IN_YEAR
- 代表
ChronoField
物件中ALIGNED_WEEK_OF_YEAR
值的整數,該物件代表目前日期。這個值一律會介於1
和53
之間 (含頭尾)。 IS_24_HOUR_MODE
- 根據使用者選擇的語言代碼和偏好設定,相當於
is24HourFormat()
目前傳回值的布林值。 IS_DAYLIGHT_SAVING_TIME
- 布林值,相當於對目前語言代碼的
TimeZone
物件呼叫useDaylightTime()
。表示目前設定的時區是否遵行日光節約時間。 TIMEZONE
- 字串,相當於對目前語言代碼的
TimeZone
物件呼叫getDisplayName()
。會傳回完整時區名稱,例如代表紐約市冬季時區的「東部標準時間」。 TIMEZONE_ABB
- 字串,相當於對目前語言代碼的
TimeZone
物件呼叫getDisplayName()
超載版本,該版本的指定樣式為SHORT
。會傳回縮寫版時區名稱,例如「EST」代表紐約市冬季時區。 TIMEZONE_ID
- 字串,相當於對目前語言代碼的
TimeZone
物件呼叫getId()
。會傳回 IANA 時區 ID 值,例如America/New_York
代表紐約市時區。 TIMEZONE_OFFSET
- 字串,相當於對目前語言代碼的
TimeZone
物件呼叫getRawOffset()
。這個值一律會介於-12
和+14
之間 (含頭尾)。會傳回應加入世界標準時間的值,以取得目前時區的標準時間,而非修正為日光節約時間。 TIMEZONE_OFFSET_DST
- 字串,相當於在表示目前語言代碼的
TimeZone
物件中,將目前日期傳入getOffset()
。這個值一律會介於-12
和+14
之間 (含頭尾)。會傳回應加入世界標準時間的值,以取得目前的當地時間,並視需要將日光節約時間納入考量。 AMPM_STATE
- 整數,表示目前時間為中午前、中午或中午後。可能的值包括代表上午的
0
和代表下午的1
。 AMPM_POSITION
整數,指出上午或下午指標應在時間字串中出現的位置。會包含下列其中一個值:
0
表示上午或下午指標應出現在字串開頭,例如AM 12:03
。1
表示上午或下午指標應出現在字串結尾,例如12:03 AM
。-1
表示不知道上午或下午指標應出現在字串中的哪個位置。
AMPM_STRING
2 個字元的字串,指出目前時間的狀態為上午或下午。值為「上午」(AM) 或「下午」(PM)。
月相
錶面格式支援下列有關月相的資料來源:
MOON_PHASE_POSITION
- 整數值,代表從最近一次新月起算的天數。這個值一律會介於
0
和28
之間 (含頭尾)。 MOON_PHASE_TYPE
為目前月相編碼的整數。可能的值如下:
0
代表最近的新月1
代表眉月2
代表上弦月3
代表上凸月4
代表滿月5
代表下凸月6
代表下弦月7
代表殘月
MOON_PHASE_TYPE_STRING
字串,代表目前月相。可能的值如下:
- New Moon (新月):自最近一次新月起,經過的天數少於 0.5 天或超過 27.5 天時。
- Evening Cvecent (眉月):自最近一次新月起,已經過至少 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 天時。
語言
錶面格式支援下列有關使用者語言的資料來源:
LANGUAGE_LOCALE_NAME
- 代表 Wear OS 裝置目前語言代碼的字串,字串表示方式為 2 個字元的 ISO 639-1 語言代碼,再加上底線和 2 個字元的 ISO 3166-1 區碼。適用於美國的英文變化版本是以
en_US
表示。
健康資料
錶面格式支援下列有關使用者健康資料的資料來源:
STEP_COUNT
- 使用者當天已行走的步數,計算依據為 Wear OS 裝置感應器。
STEP_GOAL
- 使用者選擇的每日目標步數。這個值絕不會小於
1000
。 STEP_PERCENT
- 整數,代表使用者目前達成的步數目標進度,以四捨五入的百分比表示。這個值一律會介於
0
和100
之間 (含頭尾)。 HEART_RATE
- 使用者的目前心率,計算依據為 Wear OS 裝置感應器。這個值一律會介於
0
和240
之間 (含頭尾)。 HEART_RATE_Z
- 代表使用者目前心率的字串,計算依據為 Wear OS 裝置感應器。這個值會視需要在左側加上零,讓值的長度為至少 2 個字元。因此,如果使用者心率的測量結果為 65,這個值會是
65
。如果使用者心率的測量結果為 0,這個值會是00
。
裝置感應器
錶面格式支援下列有關裝置感應器的資料來源:
ACCELEROMETER_IS_SUPPORTED
- 布林值,指出錶面是否能從目前的 Wear OS 裝置感應器取得加速計資料。
ACCELEROMETER_X
- 浮點值,指出目前沿著 X 軸的直線加速度,計算依據為 Wear OS 裝置的加速計。正值表示在錶面指向天空或天花板時,Wear OS 裝置是向右加速。
ACCELEROMETER_Y
- 浮點值,指出目前沿著 Y 軸的直線加速度,計算依據為 Wear OS 裝置的加速計。正值表示在錶面指向天空或天花板時,Wear OS 裝置是沿著錶面 12 點鐘 (頂端) 的方向加速。
ACCELEROMETER_Z
浮點值,指出目前沿著 Z 軸的直線加速度,計算依據為 Wear OS 裝置的加速計。正值表示在錶面指向天空或天花板時,Wear OS 裝置是朝天空或天花板的方向加速。
ACCELEROMETER_ANGLE_X
浮點值,指出目前相對於 X 軸的角加速度,以度為單位。這個值一律會在 $ [-90.0, 90.0 $] 的範圍內。
ACCELEROMETER_ANGLE_Y
浮點值,指出目前相對於 Y 軸的角加速度,以度為單位。這個值一律會在 $ [-90.0, 90.0 $] 的範圍內。
ACCELEROMETER_ANGLE_Z
浮點值,指出目前相對於 Z 軸的角加速度,以度為單位。這個值一律會在 $ [-90.0, 90.0 $] 的範圍內。
ACCELEROMETER_ANGLE_XY
浮點值,
ACCELEROMETER_ANGLE_X
和ACCELEROMETER_ANGLE_Y
的總和。
裝置電池
錶面格式支援下列有關目前裝置電池狀態的資料來源:
BATTERY_PERCENT
- 整數,指出 Wear OS 裝置的目前電池電量,以百分比表示。值為
100
表示電量全滿,值為0
表示電量嚴重不足。 BATTERY_CHARGING_STATUS
- 布林值,指出 Wear OS 裝置的電池是否正在充電。如果電池已充飽電,這個值為
true
。 BATTERY_IS_LOW
- 布林值,指出 Wear OS 裝置的電池電量是否在 20% 以下,且未在充電。如果電池正在充電,這個值為
false
。 BATTERY_TEMPERATURE_CELSIUS
- 浮點值,指出 Wear OS 裝置電池的溫度,以攝氏度為單位。電池原始溫度值的單位為十分之一攝氏度,除以 10 即可取得這個值。
BATTERY_TEMPERATURE_FAHRENHEIT
- 浮點值,指出 Wear OS 裝置電池的溫度,以華氏度為單位。這個值是從攝氏度換算而來。
通知
錶面格式支援下列與裝置通知相關的資料來源:
UNREAD_NOTIFICATION_COUNT
- 此字串代表已傳送至 Wear OS 裝置,但使用者未讀取的通知數量。
為您推薦
- 注意:系統會在 JavaScript 關閉時顯示連結文字
- ArithmeticExpression
- 搭配健康照護服務使用合成資料
- ListConfiguration