Skip to content

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.

  • [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

  • [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

  • [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.

  • [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.

  • [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]

    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.

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 color

    Returns 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 color

    Returns 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 zeros

    Adds 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 milliseconds

    Formats 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 pattern

    Formats 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