データタグ
テキストや式で使えるすべてのデータタグの一覧です。時刻と日付から、バッテリー、フィットネス、天気まで、それぞれのタグが表示する内容がわかります。
データタグは、角かっこで囲んだ名前で、ライブデータを表します。[h] は時、[bat_w] はウォッチのバッテリーです。タグをテキストレイヤーに入れると表示でき、
式に入れると計算に使えます。どちらのエディタでも、タグは下記と同じカテゴリごとに、現在の値と一緒に一覧で表示されます。
タグは、テキストと式で違う形になることがあります。テキストでは、[m] は先頭にゼロを付けた分(05)を表示しますが、式では数値の5です。2つが違う場合は、一覧に両方が書かれています。
これは、Wear OS 6 のウォッチフェイス用の一覧です。 コンプリケーションには、表示するデータ用の専用のタグがあり、コンプリケーションの編集中にエディタに表示されます。
[ampm]午前/午後の表示
am または pm
[AMPM]午前/午後の表示
AM または PM
[ampm_c]条件付きの午前/午後の表示
デジタル時計の形式が 12 時間制の場合のみ値を持ちます:am または pm
[AMPM_c]条件付きの午前/午後の表示
デジタル時計の形式が 12 時間制の場合のみ値を持ちます:AM または PM
[h12]12 時間制の時
最大 2 桁(例:1~12)
[h12l]12 時間制の時
テキスト内:必要に応じて先頭に 0 を付けた 2 桁(例:01~12)
テキスト専用です。式では使用できません。
[h24]24 時間制の時
最大 2 桁(例:0~23)
[h24l]24 時間制の時
テキスト内:必要に応じて先頭に 0 を付けた 2 桁(例:00~23)
テキスト専用です。式では使用できません。
[h]時(デジタル時計の形式に従う)
12時間制または24時間制の設定に従います。常にどちらかで表示するには、
[h12]または[h24]を使います。最大 2 桁(例:1~12 または 0~23)
[h_type]地域設定で選択したデジタル時計の形式
式内:12 または 24
式専用です。テキストでは使用できません。
[hl]時(デジタル時計の形式に従う)
必要に応じて先頭に 0 を付けた 2 桁(例:01~12 または 00~23)
[ht]時の十の位
現在の時の十の位(例:12:03:47 なら 1)。
[hu]時の一の位
現在の時の一の位(例:12:03:47 なら 2)。
[m]分
テキスト内:必要に応じて先頭に 0 を付けた 2 桁(例:00~59)。
式内:例:0~59。
[ms]ミリ秒
テキスト内:必要に応じて先頭に 0 を付けた 3 桁(例:000~999)。
式内:例:0~999。
アンビエント表示では使用できません。
[mt]分の十の位
現在の分の十の位(例:12:03:47 なら 0)。
[mu]分の一の位
現在の分の一の位(例:12:03:47 なら 3)。
[s]秒
テキスト内:必要に応じて先頭に 0 を付けた 2 桁(例:00~59)。
式内:例:0~59。
アンビエント表示では使用できません。
[st]秒の十の位
現在の秒の十の位(例:12:03:47 なら 4)。
アンビエント表示では使用できません。
[su]秒の一の位
現在の秒の一の位(例:12:03:47 なら 7)。
アンビエント表示では使用できません。
[unix_ms]Unix タイムスタンプ(ミリ秒)
式内:1970 年 1 月 1 日(UTC/GMT 午前 0 時)からの経過ミリ秒。
式専用です。テキストでは使用できません。
アンビエント表示では使用できません。
タイムゾーン
Section titled “タイムゾーン”[tmzn]タイムゾーン名
タイムゾーンの正式名を返します(例:冬のニューヨークのタイムゾーンなら「Eastern Standard Time」)。
[tmzn_abb]タイムゾーンの略称
タイムゾーンの略称を返します(例:冬のニューヨークのタイムゾーンなら「EST」)。
[tmzn_dst]夏時間
ウォッチのタイムゾーンが夏時間のあいだ true を返します。プレビューはシミュレーションの日付に従います。
[tmzn_id]タイムゾーン ID
IANA タイムゾーン ID を返します(例:ニューヨークのタイムゾーンなら America/New_York)
[tmzn_off]タイムゾーンのオフセット
現在のタイムゾーンの標準時を得るために UTC に加算する値を返します(夏時間は考慮されません)
[tmzn_off_dst]タイムゾーンのオフセット(夏時間を含む)
現在の現地時刻を得るために UTC に加算する値を返します(必要に応じて夏時間も考慮されます)。
[tmzn_off_min]タイムゾーンのオフセット(分)
現在のタイムゾーンの標準時を得るために UTC に加算する分数を返します(夏時間は考慮されません)
[tmzn_off_min_dst]タイムゾーンのオフセット(分、夏時間を含む)
現在の現地時刻を得るために UTC に加算する分数を返します(必要に応じて夏時間も考慮されます)。
[day]曜日名
例:日曜日、月曜日
[day_a]曜日の略称
例:日、月
[day_in_wk]週の何日目か
例:1~7(日曜日 = 1)
[day_in_year]今日が年の何日目か
例:1~365(1 月 1 日 = 1)
[day_n]日
例:1~31
[day_nl]日(先頭に 0 を付ける)
テキスト内:例:01~31
テキスト専用です。式では使用できません。
[days_in_month]今月の日数
日数
[days_in_year]今年の日数
日数
[month]月の名前
例:1月、2月
[month_a]月の略称
例:Jan、Feb
[month_d]月の数字
例:1~12
[month_n]2 桁の月
例:01~12
[week_in_mnth]月の第何週か
例:1~5
[week_nr]週番号
例:1~52
[year]年
例:2017
[year_a]西暦の下 2 桁
テキスト内:例:00~99
式内:例:0~99
[bat_w]ウォッチのバッテリー残量
例:0~100
[bat_w_c]ウォッチの充電状態
ウォッチが充電中かどうかを示します
[bat_w_low]ウォッチのバッテリー残量低下
ウォッチ自身のしきい値でバッテリー残量の低下を報告したときに true を返します。充電中は常に false です。
[bat_w_temp]ウォッチのバッテリー温度
温度の単位に応じて摂氏または華氏
フィットネス
Section titled “フィットネス”[lst_heart]最後に測定した心拍数
最後に測定した心拍数。
[step_goal]歩数の目標
設定で指定した 1 日の歩数の目標。
[steps]歩数
今日の歩数。
[rain_chance]降水確率
現在の予想降水確率。
[temp]現在の気温
「天気の単位」の設定の単位で表示されます。対応する記号を表示するには、このあとに
[temp_metric]を置きます。単位は天気の単位の設定で決まります。
[temp_max]最高気温
今日の最高気温。
[temp_metric]現在の気温の単位
設定で選択した単位の記号。
[temp_min]最低気温
今日の最低気温。
[uv_idx]UV 指数
0~2: 安全、3~7: 日陰を利用、8 以上:外出を避ける
[weather]現在の天気の種類
現在の天気の説明。
[weather_val]現在の天気の種類番号
現在の天気タイプの値: 不明な値(0), 快晴(1), 曇り(2), 霧(3), 大雨(4), 大雪(5), 雨(6), 雪(7), 晴れ(8), 雷雨(9), みぞれ(10), 小雪(11), 小雨(12), もや(13), 晴れ時々曇り(14), 強風(15)
[wthr_avlbl]天気データの有無
天気データがある場合は true を返します。天気データがない場合を正しく処理するために使用します
[wthr_dly]日ごとの天気予報オブジェクト
式内:日ごとの天気予報の全リスト
式専用です。テキストでは使用できません。
リストです。[0]、[1] のように指定して項目を選びます。
メンバー
- .available
- .max_temperature
- .min_temperature
- .precipitation_probability
- .precipitation_probability_night
- .uv_index
- .weather_type
- .weather_type_n
- .weather_type_night
- .weather_type_night_n
[wthr_err]天気エラー
天気の読み込みに失敗したときに true を返します。同時に以前の天気データがまだ利用できる場合もあります。
[wthr_hrly]1 時間ごとの天気予報オブジェクト
式内:1 時間ごとの天気予報の全リスト
式専用です。テキストでは使用できません。
リストです。[0]、[1] のように指定して項目を選びます。
メンバー
- .available
- .is_day
- .temperature
- .uv_index
- .weather_type
- .weather_type_n
[wthr_is_day]天気が日中か
現在の天気が日中のものであれば true を返します。日の長さは 1 年を通して変わるため便利です。
[wthr_upd]天気の最終更新
天気データが最後に更新された時刻(1970 年 1 月 1 日からのミリ秒)。([unix_ms] - [wthr_upd]) / 60000 で経過時間(分)がわかります。
[moon_days]月相
直近の新月からの日数
[moon_type]月相の種類
現在の月相
[moon_type_id]月相の種類 ID
現在の月相の値: 新月(0), 三日月(1), 上弦の月(2), 十三夜月(3), 満月(4), 寝待月(5), 下弦の月(6), 有明月(7)
[unread_cnt]未読の通知数
ウォッチでのみ利用できます。Wear OS ウォッチでのみ利用できます。
値があるのはウォッチ上のみです。スマートフォンのプレビューにはサンプルが表示されます。
[global]
ユーティリティ関数
Section titled “ユーティリティ関数”これらはデータではなく、式で使うヘルパーです。
[color]色の関数
式内:色の作成や操作にすぐ使える関数
式専用です。テキストでは使用できません。
[color].rgb()RGBカラー赤(r)、緑(g)、青(b)から色を作成して返します。r、g、b は 0〜255 の範囲である必要があります。
[color].rgb(255,0,0)
#FF0000[color].rgb(0, 255, 0)
#00FF00
[color].argb()ARGBカラーアルファ(a)、赤(r)、緑(g)、青(b)から色を作成して返します。各値は 0〜255 で、アルファ 0 は完全な透明、255 は完全な不透明です。
[color].argb(128, 255, 0, 0)
#FF0000[color].argb(64, 0, 255, 0)
#00FF00
[frmt]書式設定関数
式内:テキストの書式設定にすぐ使える関数
式専用です。テキストでは使用できません。
[frmt].lzero()ゼロ埋め入力値の先頭にゼロを追加します。指定した文字数になるまで、入力値の先頭をゼロで埋めます
[frmt].lzero(2, 2)
02[frmt].lzero(20, 2)
20
[frmt].frmt_ms()ミリ秒の書式設定ミリ秒(ms)を hh:mm:ss:ms の形式に変換します。 省略可能なパラメータ options で、含める部分を指定します。 (デフォルト値): options = { hh : false, mm : true, ss : true, ms : true, sep : ':' } 各オプションで、その部分を含めるかどうかを指定します。
[frmt].frmt_ms(1250632)
20:50:632[frmt].frmt_ms(1250632, { hh: true, mm: true, ss: true, ms: false, sep: '|||' } )00|||20|||50[frmt].frmt_ms(0)
00:00:000[frmt].frmt_ms(1234)
00:01:234
[frmt].frmt_number()数値パターンパターンで数値の書式を設定します。"#,###" は桁区切りを追加し、"0.00" は常に小数点以下 2 桁を表示し、"0.###E0" は指数表記で書きます。パターンは式の中にテキストとして書いてください。
[frmt].frmt_number(1234567, "#,###")
1,234,567[frmt].frmt_number(3.14159, "0.00")
3.14[frmt].frmt_number(1234, "0.###E0")
1.234E3