콘텐츠로 이동

데이터 태그

텍스트와 표현식에 쓸 수 있는 모든 데이터 태그를 시간과 날짜부터 배터리, 피트니스, 날씨까지 각 태그가 무엇을 표시하는지와 함께 정리했어요.

데이터 태그는 대괄호 안에 쓴 이름으로, 실시간 데이터를 나타내요. [h]는 시, [bat_w]는 워치 배터리예요. 태그를 텍스트 레이어에 넣으면 값이 표시되고, 표현식에 넣으면 계산에 쓸 수 있어요. 두 편집기 모두 아래와 같은 카테고리별로 태그를 나열하고, 각 태그의 현재 값을 보여 줘요.

태그는 텍스트에서와 표현식에서 다른 형태를 낼 수 있어요. 텍스트에서 [m]은 앞에 0을 붙인 분(05)을 표시하고, 표현식에서는 숫자 5예요. 두 형태가 다르면 목록에 둘 다 나와 있어요.

이 목록은 Wear OS 6 워치 페이스용이에요. 컴플리케이션에는 표시하는 데이터에 맞는 별도의 태그가 있고, 컴플리케이션을 편집하는 동안 편집기에 나와요.

  • [ampm]

    오전 또는 오후 표시

    am 또는 pm

  • [AMPM]

    오전 또는 오후 표시

    AM 또는 PM

  • [ampm_c]

    조건부 오전 또는 오후 표시

    디지털 시계 형식이 12시간제일 때만 값이 있어요: am 또는 pm

  • [AMPM_c]

    조건부 오전 또는 오후 표시

    디지털 시계 형식이 12시간제일 때만 값이 있어요: AM 또는 PM

  • [h12]

    12시간제 시계의 시

    두 자리, 예: 1 - 12

  • [h12l]

    12시간제 시계의 시

    텍스트에서: 두 자리, 필요하면 앞에 0 추가, 예: 01 - 12

    텍스트 전용이며 표현식에서는 쓸 수 없어요.

  • [h24]

    24시간제 시계의 시

    두 자리, 예: 0 - 23

  • [h24l]

    24시간제 시계의 시

    텍스트에서: 두 자리, 필요하면 앞에 0 추가, 예: 00 - 23

    텍스트 전용이며 표현식에서는 쓸 수 없어요.

  • [h]

    시, 디지털 시계 형식을 따름

    12시간제 또는 24시간제 설정을 따라요. 항상 둘 중 하나로 표시하려면 [h12]나 [h24]를 쓰세요.

    두 자리, 예: 1 - 12 또는 0 - 23

  • [h_type]

    현지화 설정에서 선택한 디지털 시계 형식

    표현식에서: 12 또는 24

    표현식 전용이며 텍스트에서는 쓸 수 없어요.

  • [hl]

    시, 디지털 시계 형식을 따름

    두 자리, 필요하면 앞에 0 추가, 예: 01 - 12 또는 00 - 23

  • [ht]

    시의 십의 자리

    현재 시의 십의 자리 숫자예요. 예를 들어 12:03:47이면 1이에요.

  • [hu]

    시의 일의 자리

    현재 시의 일의 자리 숫자예요. 예를 들어 12:03:47이면 2예요.

  • [m]

    시간 내의 분

    텍스트에서: 두 자리, 필요하면 앞에 0 추가, 예: 00 - 59.

    표현식에서: 예: 0 - 59.

  • [ms]

    초 내의 밀리초

    텍스트에서: 세 자리, 필요하면 앞에 0 추가, 예: 000 - 999.

    표현식에서: 예: 0 - 999.

    앰비언트 화면에서는 사용할 수 없어요.

  • [mt]

    분의 십의 자리

    현재 분의 십의 자리 숫자예요. 예를 들어 12:03:47이면 0이에요.

  • [mu]

    분의 일의 자리

    현재 분의 일의 자리 숫자예요. 예를 들어 12:03:47이면 3이에요.

  • [s]

    분 내의 초

    텍스트에서: 두 자리, 필요하면 앞에 0 추가, 예: 00 - 59.

    표현식에서: 예: 0 - 59.

    앰비언트 화면에서는 사용할 수 없어요.

  • [st]

    초의 십의 자리

    현재 초의 십의 자리 숫자예요. 예를 들어 12:03:47이면 4예요.

    앰비언트 화면에서는 사용할 수 없어요.

  • [su]

    초의 일의 자리

    현재 초의 일의 자리 숫자예요. 예를 들어 12:03:47이면 7이에요.

    앰비언트 화면에서는 사용할 수 없어요.

  • [unix_ms]

    밀리초 단위 Unix 타임스탬프

    표현식에서: 1970년 1월 1일(UTC/GMT 자정) 이후 경과한 밀리초예요.

    표현식 전용이며 텍스트에서는 쓸 수 없어요.

    앰비언트 화면에서는 사용할 수 없어요.

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

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

    두 자리 월

    예: 01-12

  • [week_in_mnth]

    월 중 주차

    예: 1 - 5

  • [week_nr]

    주 번호

    예: 1 - 52

  • [year]

    연도

    예: 2017

  • [year_a]

    연도의 마지막 두 자리

    텍스트에서: 예: 00-99

    표현식에서: 예: 0-99

  • [bat_w]

    시계 배터리 잔량

    예: 0 - 100

  • [bat_w_c]

    시계 배터리 충전 중

    시계가 현재 충전 중인지 나타내요

  • [bat_w_low]

    시계 배터리 부족

    시계 자체 기준으로 배터리가 부족하다고 알릴 때 true를 반환해요. 충전 중에는 항상 false예요.

  • [bat_w_temp]

    시계 배터리 온도

    온도 단위에 따라 섭씨 또는 화씨

  • [lst_heart]

    마지막 측정 심박수

    마지막으로 측정한 심박수예요.

  • [step_goal]

    걸음 목표

    설정에서 지정한 일일 걸음 목표예요.

  • [steps]

    걸음 수

    오늘의 걸음 수예요.

  • [rain_chance]

    강수 확률

    현재 예상 강수 확률이에요.

  • [temp]

    현재 기온

    날씨 단위 설정의 단위로 표시돼요. 뒤에 [temp_metric]을 넣으면 맞는 기호가 표시돼요.

    단위는 날씨 단위 설정에 따라 정해져요.

  • [temp_max]

    최고 기온

    오늘의 최고 기온이에요.

  • [temp_metric]

    현재 온도 단위

    설정에서 선택한 단위 기호예요.

  • [temp_min]

    최저 기온

    오늘의 최저 기온이에요.

  • [uv_idx]

    자외선 지수

    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]

    시간별 일기예보 객체

    표현식에서: 시간별 일기예보 전체 목록

    표현식 전용이며 텍스트에서는 쓸 수 없어요.

    목록: [0], [1] 등으로 항목을 선택해요.

    멤버

    • .available
    • .is_day
    • .temperature
    • .uv_index
    • .weather_type
    • .weather_type_n
  • [wthr_is_day]

    낮 시간 여부

    현재 날씨 상태가 낮 시간에 해당하면 true를 반환해요. 낮의 길이는 일 년 동안 바뀌므로 유용해요.

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

    전역 데이터

    요소의 전역 객체에서 설정한 값이에요.

    표현식에서: 전역으로 정의된 변수 및 메서드

    표현식 전용이며 텍스트에서는 쓸 수 없어요.

데이터가 아니라 표현식에 쓰는 도우미예요.

  • [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()앞자리 0

    입력값 앞에 0을 추가해요. 요청한 글자 수가 될 때까지 입력값 앞을 0으로 채워요

    • [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"은 항상 소수점 둘째 자리까지 보여 주며, "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