SourceType

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

這項元素已在 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 裝置，但使用者未讀取的通知數量。