Data tags
Every data tag you can use in texts and expressions, from time and date to battery, fitness and weather.
A data tag is a name in square brackets that stands for live data: [h] is the hour, [bat_w] the
watch battery. Put tags in a text layer to show them, or in an
expression to calculate with them. Both
editors list the tags by category, the same categories as below, with each tag’s current value.
A tag can give a different form in text than in an expression. In text, [m] shows the minute with a
leading zero (05); in an expression it’s the number 5. Where the two differ, the list says both.
This is the list for Wear OS 6 watch faces. Complications have their own tags for the data they show, listed in the editor while you edit a complication.
[ampm]Morning or afternoon marker
am or pm
[AMPM]Morning or afternoon marker
AM or PM
[ampm_c]Conditional morning or afternoon marker
Only has a value when the digital clock type is set to 12 - hour : am or pm
[AMPM_c]Conditional morning or afternoon marker
Only has a value when the digital clock type is set to 12 - hour : AM or PM
[h12]Hour for the 12-hour clock
two digits i.e. 1 - 12
[h12l]Hour for the 12-hour clock
In text: two digits with a leading zero as necessary i.e. 01 - 12
Text only, not in expressions.
[h24]Hour of the day for the 24-hour clock
two digits i.e. 0 - 23
[h24l]Hour of the day for the 24-hour clock
In text: two digits with a leading zero as necessary i.e. 00 - 23
Text only, not in expressions.
[h]Hour, respects digital clock type
Follows the 12 or 24 hour clock setting. Use
[h12]or[h24]to always show one of them.two digits i.e. 1 - 12, or 0 - 23
[h_type]Selected digital clock type in the Localization settings
In an expression: either 12 or 24
Expressions only, not in text.
[hl]Hour, respects the digital clock type
two digits with a leading zero as necessary i.e. 01 - 12 or 00 - 23
[ht]Hour tens digit
The tens digit of the current hour, for example, 1 for 12:03:47.
[hu]Hour unit digit
The units digit of the current hour, for example, 2 for 12:03:47.
[m]Minute within the hour
In text: two digits with a leading zero as necessary i.e. 00 - 59.
In an expression: i.e. 0 - 59.
[ms]Milliseconds within the second
In text: three digits with a leading zero as necessary i.e. 000 - 999.
In an expression: i.e. 0 - 999.
Not available on the ambient face.
[mt]Minutes tens digit
The tens digit of the current minute, for example, 0 for 12:03:47.
[mu]Minutes unit digit
The units digit of the current minute, for example, 3 for 12:03:47.
[s]Seconds within the minute
In text: two digits with a leading zero as necessary i.e. 00 - 59.
In an expression: i.e. 0 - 59.
Not available on the ambient face.
[st]Seconds tens digit
The tens digit of the current seconds, for example, 4 for 12:03:47.
Not available on the ambient face.
[su]Seconds unit digit
The units digit of the current seconds, for example, 7 for 12:03:47.
Not available on the ambient face.
[unix_ms]Unix timestamp in milliseconds
In an expression: Milliseconds since January 1, 1970 (midnight UTC/GMT).
Expressions only, not in text.
Not available on the ambient face.
Time zone
Section titled “Time zone”[tmzn]Timezone name
Returns the full time zone name, such as "Eastern Standard Time" for New York City's time zone during the winter.
[tmzn_abb]Timezone abbreviation
Returns an abbreviated time zone name, such as "EST" for New York City's time zone during the winter.
[tmzn_dst]Daylight saving time
Returns true while the watch's time zone is on daylight saving time. The preview follows the simulated date.
[tmzn_id]Timezone id
Returns an IANA time zone ID value, such as America/New_York for New York City's time zone
[tmzn_off]Timezone offset
Returns the value that should be added to UTC to get the standard time for the current time zone (not corrected for daylight saving time)
[tmzn_off_dst]Timezone offset dst
Returns the value that should be added to UTC to get the current local time, with daylight saving time taken into account if necessary.
[tmzn_off_min]Timezone offset minutes
Returns the number of minutes that should be added to UTC to get the standard time for the current time zone (not corrected for daylight saving time)
[tmzn_off_min_dst]Timezone offset minutes dst
Returns the number of minutes that should be added to UTC to get the current local time, with daylight saving time taken into account if necessary.
[day]Full day name
i.e. Sunday, Monday
[day_a]Abbreviated day name
i.e. Sun, Mon
[day_in_wk]Number of day in week
i.e. 1 - 7, where Sunday = 1
[day_in_year]Number of the current day in the year
i.e. 1 - 365, where the first day = 1
[day_n]Day of month
i.e. 1-31
[day_nl]Day of month, with leading zero
In text: i.e. 01-31
Text only, not in expressions.
[days_in_month]Number of days in the current month
number of days
[days_in_year]Number of days in the current year
number of days
[month]Full month name
i.e. January, February
[month_a]Abbreviated month name
i.e. Jan, Feb
[month_d]Month digit
i.e. 1-12
[month_n]Two digit month
i.e. 01-12
[week_in_mnth]Week of month
i.e. 1 - 5
[week_nr]Week number
i.e. 1 - 52
[year]Year
i.e. 2017
[year_a]Last two digits of year
In text: i.e. 00-99
In an expression: i.e. 0-99
Battery
Section titled “Battery”[bat_w]Watch battery level
i.e. 0 - 100
[bat_w_c]Watch battery charging
Indicates if the watch is currently charging
[bat_w_low]Watch battery low
Returns true when the watch reports a low battery, by the watch's own threshold. Always false while charging.
[bat_w_temp]Watch battery temperature
In Celsius or Fahrenheit depending on the temperature unit
Fitness
Section titled “Fitness”[lst_heart]Last measured heart rate
Last measured heart rate.
[step_goal]Step goal
Your daily step goal, as indicated in the settings.
[steps]Step count
Steps of the current day.
Weather
Section titled “Weather”[rain_chance]Chance of rain
The current expected chance of rain.
[temp]Current temperature
In the unit of the Weather metric setting. Put
[temp_metric]after it to show the matching sign.Metric is determined by the Weather metric setting.
[temp_max]Maximum temperature
Maximum temperature of the day.
[temp_metric]Current temperature metric
Metric sign, as chosen in the settings.
[temp_min]Minimum temperature
Minimum temperature of the day.
[uv_idx]UV index
0 to 2 : Safe, 3 - 7 : Seek shade, 8+ : Avoid
[weather]Current weather type
Description of current weather.
[weather_val]Current weather type number
Value of the current weather type: Unknown value (0), Clear (1), Cloudy (2), Fog (3), Heavy rain (4), Heavy snow (5), Rain (6), Snow (7), Sunny (8), Thunderstorm (9), Sleet (10), Light snow (11), Light rain (12), Mist (13), Partly cloudy (14), Windy (15)
[wthr_avlbl]Weather data available
Returns true if weather data is available. Use it to handle missing weather data correctly.
[wthr_dly]Daily weather forecast object
In an expression: Complete list of daily weather forecasts
Expressions only, not in text.
A list: pick an entry with [0], [1] and so on.
Members
- .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]Weather error
Returns true when loading the weather failed. Older weather data can still be available at the same time.
[wthr_hrly]Hourly weather forecast object
In an expression: Complete list of hourly weather forecasts
Expressions only, not in text.
A list: pick an entry with [0], [1] and so on.
Members
- .available
- .is_day
- .temperature
- .uv_index
- .weather_type
- .weather_type_n
[wthr_is_day]Weather is day
Returns true if the current condition applies during daylight. Useful because the length of day changes over the year.
[wthr_upd]Weather last updated
When the weather data was last refreshed, in milliseconds since January 1, 1970. ([unix_ms] - [wthr_upd]) / 60000 gives its age in minutes.
Sun and moon
Section titled “Sun and moon”[moon_days]Moon phase
Days since most recent new moon
[moon_type]Moon phase type
The current moon phase
[moon_type_id]Moon phase type id
Value of the current moon phase: New Moon (0), Evening Crescent (1), First Quarter (2), Waxing Gibbous (3), Full Moon (4), Waning Gibbous (5), Last Quarter (6), Morning Crescent (7)
[unread_cnt]Unread notification count
Only available on the watch. Only available for Wear OS watches.
Only has a value on the watch; the phone's preview shows a sample.
Global
Section titled “Global”[global]Global data
The values you set in the element’s global object.
In an expression: Globally defined variables and methods
Expressions only, not in text.
Utility functions
Section titled “Utility functions”These aren’t data, but helpers for expressions.
[color]Color functions
In an expression: Quick and easy available functions to create and manipulate colors
Expressions only, not in text.
[color].rgb()RGB colorReturns a color formed of red (r), green (g) and blue (b). Where r, g & b are assumed to be between 0 and 255.
[color].rgb(255,0,0)
#FF0000[color].rgb(0, 255, 0)
#00FF00
[color].argb()ARGB colorReturns a color formed of alpha (a), red (r), green (g) and blue (b), each between 0 and 255. An alpha of 0 is fully transparent and 255 is fully opaque.
[color].argb(128, 255, 0, 0)
#FF0000[color].argb(64, 0, 255, 0)
#00FF00
[frmt]Formatting functions
In an expression: Quick and easy available functions to format text
Expressions only, not in text.
[frmt].lzero()Leading zerosAdds leading zeros to the input. Pads the input with leading zeros until the requested number of characters has been reached.
[frmt].lzero(2, 2)
02[frmt].lzero(20, 2)
20
[frmt].frmt_ms()Format millisecondsFormats milliseconds (ms) to hh:mm:ss:ms. Optional parameter options, controls which parts are included. (defaults to): options = { hh : false, mm : true, ss : true, ms : true, sep : ':' } each option controls if that part is included.
[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()Number patternFormats a number with a pattern: "#,###" adds thousands separators, "0.00" always shows two decimals and "0.###E0" writes it in scientific notation. Write the pattern as text in the expression.
[frmt].frmt_number(1234567, "#,###")
1,234,567[frmt].frmt_number(3.14159, "0.00")
3.14[frmt].frmt_number(1234, "0.###E0")
1.234E3