데이터 태그
텍스트와 표현식에 쓸 수 있는 모든 데이터 태그를 시간과 날짜부터 배터리, 피트니스, 날씨까지 각 태그가 무엇을 표시하는지와 함께 정리했어요.
데이터 태그는 대괄호 안에 쓴 이름으로, 실시간 데이터를 나타내요. [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