SourceType

データソースの値です。ウォッチフェイスに表示されるリアルタイムの値を更新します。

Wear OS 4 から導入されました。

日時

Watch Face Format は、日時に関する次のデータソースをサポートしています。

UTC_TIMESTAMP
1970 年 1 月 1 日協定世界時（UTC）午前 0 時からの経過時間（ミリ秒数）。
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 デバイスの現在のタイムゾーンを使用して、00～11 の範囲内で、現在の時刻を 12 時間表記にした文字列。この値が 10 よりも小さい場合、先頭にゼロが付きます。
HOUR_0_11_MINUTE
現在の時刻を表す ZonedDateTime オブジェクトの変更済み CLOCK_HOUR_OF_AMPM フィールドと分フィールドを組み合わせた浮動小数点値。この値は常に 0.0～$ 11 \frac{59}{60} $ の範囲内となります。
HOUR_1_12
現在の時刻の 12 時間表記です。1～12 の範囲内の値で表されます。0:12（午前 12 時 12 分）のように、現在の HOUR_OF_DAY が 0 の場合、この値は 12 に変換されます。
HOUR_1_12_Z
Wear OS デバイスの現在のタイムゾーンを使用して、01～12 の範囲内で、現在の時刻を 12 時間表記にした文字列。この値が 10 よりも小さい場合、先頭にゼロが付きます。
HOUR_1_12_MINUTE
現在の時刻を表す ZonedDateTime オブジェクトの CLOCK_HOUR_OF_AMPM フィールドと分フィールドを組み合わせた浮動小数点値。この値は常に 1.0～$ 12 \frac{59}{60} $ の範囲内となります。
HOUR_0_23
現在の時刻の 24 時間表記です。0～23 の範囲内の値で表されます。24:13（翌日の午前 12 時 13 分）のように、値が 24 の場合、この値は 0 に変換されます。
HOUR_0_23_Z
Wear OS デバイスの現在のタイムゾーンを使用して、00～23 の範囲内で、現在の時刻を 24 時間表記にした文字列。この値が 10 よりも小さい場合、先頭にゼロが付きます。
HOUR_0_23_MINUTE
現在の時刻を表す ZonedDateTime オブジェクトの時間フィールドと分フィールドを組み合わせた浮動小数点値。この値は常に 0.0～$ 23 \frac{59}{60} $ の範囲内となります。
HOUR_1_24
現在の時刻の 24 時間表記です。1～24 の範囲内の値で表されます。0:12（午前 12 時 12 分）のように、値が 0 の場合、この値は 24 に変換されます。
HOUR_1_24_Z
Wear OS デバイスの現在のタイムゾーンを使用して、01～24 の範囲内で、現在の時刻を 12 時間表記にした文字列。この値が 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
現在の日付を表す ZonedDateTime オブジェクトの getDayOfMonth() 値から 1 を引いて修正したバージョン。この値は常に 0～30 の範囲内となります。
DAY_0_30_HOUR
現在の日付と時刻を表す ZonedDateTime オブジェクトの変更済み日付フィールドと時間フィールドを組み合わせた浮動小数点値。この値は常に 0.0～$ 30 \frac{23}{24} $ の範囲内となります。
DAY_OF_YEAR
年が変わってから経過した日数。この値は常に 1～366 の範囲内となります。うるう年以外の最大値は 365 です。
DAY_OF_WEEK
現在の日付を表す ZonedDateTime オブジェクトの getDayOfWeek() 値を修正したバージョン。Watch Face Format では、値 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
現在の日付を表す ZonedDateTime オブジェクトの getMonthValue() 値を修正したバージョン。1 月には値 0、12 月には値 11 を割り当てます。
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 の範囲内となります。現在のタイムゾーンの標準時間を取得するために UTC に追加する値を返します（夏時間の調整なし）。
TIMEZONE_OFFSET_DST
現在の言語 / 地域の TimeZone オブジェクトで現在の日付を getOffset() に渡すことに対応する文字列。この値は常に -12～+14 の範囲内となります。必要な場合は夏時間を考慮に入れて、現在の現地時間を取得するために UTC に追加する値を返します。
AMPM_STATE
現在の時刻が午前か午後かを示す整数値。午前の場合は 0、午後の場合は 1 が有効な値となります。
AMPM_POSITION

時間文字列内に AM または PM を表示するかどうかを示す整数値。次のいずれかの値が含まれます。

  • 0 は文字列の最初に AM または PM が表示されます（例: AM 12:03）。
  • 1 は文字列の末尾に AM または PM が表示されます（例: 12:03 AM）。
  • -1 は文字列のどこに AM または PM が表示されるかは不明であることを示します。
AMPM_STRING

現在の時刻が午前か午後かを示す 2 文字の文字列。値は「AM」または「PM」となります。

月相

Watch Face Format は、月相に関する次のデータソースをサポートしています。

MOON_PHASE_POSITION
直近の新月から経過した日数を示す整数値。この値は常に 0～28 の範囲内となります。
MOON_PHASE_TYPE

現在の月相をエンコードする整数値。有効な値は次のとおりです。

  • 0: 直近の新月
  • 1: 夜の三日月
  • 2: 上弦の月
  • 3: 十三夜の月
  • 4: 満月
  • 5: 十八夜の月
  • 6: 下弦の月
  • 7: 朝の三日月
MOON_PHASE_TYPE_STRING

現在の月相を示す整数値。有効な値は次のとおりです。

  • 新月: 直近の新月からの経過日数が 0.5 日未満または 27.5 日超の場合。
  • 夜の三日月: 直近の新月からの経過日数が 0.5 日以上 6.5 日未満の場合。
  • 上弦: 直近の新月からの経過日数が 6.5 日以上 7.5 日未満の場合。
  • 十三夜: 直近の新月からの経過日数が 7.5 日以上 13.5 日未満の場合。
  • 満月: 直近の新月からの経過日数が 13.5 日以上 14.5 日未満の場合。
  • 十八夜: 直近の新月からの経過日数が 14.5 日以上 20.5 日未満の場合。
  • 下弦: 直近の新月からの経過日数が 20.5 日以上 21.5 日未満の場合。
  • 朝の三日月: 直近の新月からの経過日数が 21.5 日以上 27.5 日未満の場合。

言語

Watch Face Format は、ユーザーの言語に関する次のデータソースをサポートしています。

LANGUAGE_LOCALE_NAME
Wear OS デバイスの現在の言語 / 地域を表す文字列で、2 文字の ISO 639-1 言語コード、アンダースコア、2 文字の ISO 3166-1 地域コードで構成されています。米国の英語の場合は en_US と表されます。

健康に関するデータ

Watch Face Format は、ユーザーの健康に関するデータについて次のデータソースをサポートしています。

STEP_COUNT
Wear OS デバイスのセンサーに基づく、ユーザーが今日の現時点までに歩いた歩数。
STEP_GOAL
ユーザーが 1 日の歩数目標として選択した歩数。この値は 1000 以上になります。
STEP_PERCENT
今日の歩数目標に対する進捗状況を示す整数。四捨五入したパーセンテージで表されます。この値は常に 0～100 の範囲内となります。
HEART_RATE
Wear OS デバイスのセンサーに基づく、ユーザーの現在の心拍数。この値は常に 0～240 の範囲内となります。
HEART_RATE_Z
Wear OS デバイスのセンサーに基づく、ユーザーの現在の心拍数を表す文字列。この値は、必要に応じて左側にゼロがパディングされ、2 文字以上になります。したがって、ユーザーの心拍数が 65 と測定された場合、この値は 65 になります。ユーザーの心拍数が 0 と測定される場合、この値は 00 です。

デバイスのセンサー

Watch Face Format は、デバイスのセンサーに関するデータについて次のデータソースをサポートしています。

ACCELEROMETER_IS_SUPPORTED
現在の Wear OS デバイスのセンサーからウォッチフェイスが加速度計データを取得できるかどうかを示すブール値。
ACCELEROMETER_X
Wear OS デバイスの加速度計に基づく、X 軸上の現在の直線加速度を示す浮動小数点値。正の値はウォッチフェイスが空または天井を指しているときに、Wear OS デバイスが右方向に加速していることを示します。
ACCELEROMETER_Y
Wear OS デバイスの加速度計に基づく、Y 軸上の現在の直線加速度を示す浮動小数点値。正の値はウォッチフェイスが空または天井を指しているときに、Wear OS デバイスがウォッチフェイスの 12 時（上）の方向に加速していることを示します。
ACCELEROMETER_Z

Wear OS デバイスの加速度計に基づく、Z 軸上の現在の直線加速度を示す浮動小数点値。正の値はウォッチフェイスが空または天井を指しているときに、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 を合計した浮動小数点値。

デバイスのバッテリー

Watch Face Format は、デバイスのバッテリーに関するデータについて次のデータソースをサポートしています。

BATTERY_PERCENT
Wear OS デバイスの現在のバッテリー残量を示す整数値。パーセンテージで表されます。値 100 はバッテリーがフル充電されていることを示し、値 0 はバッテリー残量が非常に少なくなっていることを示します。
BATTERY_CHARGING_STATUS
Wear OS デバイスのバッテリーが充電中かどうかを示すブール値。バッテリーの充電が完了しフル充電の状態では、この値は true です。
BATTERY_IS_LOW
Wear OS デバイスのバッテリー残量が 20% 以下で、放電されていることを示すブール値。バッテリーが充電中の場合、この値は false になります。
BATTERY_TEMPERATURE_CELSIUS
Wear OS デバイスのバッテリーの温度を示す浮動小数点値。摂氏で表されます。バッテリーの未加工の温度値（0.1 セルシウス度単位）を 10 で割ってこの数値を算出します。
BATTERY_TEMPERATURE_FAHRENHEIT
Wear OS デバイスのバッテリーの温度を示す浮動小数点値。華氏で表されます。これは摂氏からの変換です。

通知

Watch Face Format は、デバイスの通知に関連する次のデータソースをサポートしています。

UNREAD_NOTIFICATION_COUNT
Wear OS デバイスに配信された通知のうち、ユーザーの未読通知の数を表す文字列。