データソースの値です。ウォッチフェイスに表示されるリアルタイムの値を更新します。
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 デバイスに配信された通知のうち、ユーザーの未読通知の数を表す文字列。
あなたへのおすすめ
- 注: JavaScript がオフになっている場合はリンクテキストが表示されます
- ArithmeticExpression
- ヘルスサービスで合成データを使用する
- ListConfiguration