SourceType

시계 화면에 표시되는 실시간 값을 업데이트하는 데이터 소스의 값입니다.

Wear OS 4에서 도입되었습니다.

시간 및 날짜

워치 페이스 형식은 시간 및 날짜와 관련하여 다음 데이터 소스를 지원합니다.

UTC_TIMESTAMP
1970년 1월 1일 자정(UTC) 이후 경과된 밀리초 수입니다.
MILLISECOND
현재 시간의 ZonedDateTime 객체의 밀리초 필드를 나타내는 정수 값입니다. 이 값은 항상 0과 999 사이입니다(양 끝값 포함).
SECOND
현재 시간의 ZonedDateTime 객체의 초 필드를 나타내는 정수 값입니다. 이 값은 항상 0과 59 사이입니다(양 끝값 포함).
SECOND_Z
현재 시간의 ZonedDateTime 객체의 초 필드를 나타내는 문자열에, 길이가 2자가 되도록 선행 0이 추가된 값입니다. 이 값은 항상 00과 59 사이입니다(양 끝값 포함).
SECOND_MILLISECOND
현재 시간을 나타내는 ZonedDateTime 객체의 초 필드와 밀리초 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 0.0과 59.999 사이입니다(양 끝값 포함).
SECONDS_IN_DAY
HOUR_0_23, MINUTE, SECOND 값을 기준으로 현재 날짜의 경과된 시간(초)입니다. 이 값은 항상 0과 86399($ 24 * 60 * 60 - 1 $) 사이입니다(양 끝값 포함).
MINUTE
현재 시간의 ZonedDateTime 객체의 분 필드를 나타내는 정수 값입니다. 이 값은 항상 0과 59 사이입니다(양 끝값 포함).
MINUTE_Z
현재 시간의 ZonedDateTime 객체의 분 필드를 나타내는 문자열 값에, 길이가 2자가 되도록 선행 0이 추가된 값입니다. 이 값은 항상 00과 59 사이입니다(양 끝값 포함).
MINUTE_SECOND
현재 시간을 나타내는 ZonedDateTime 객체의 분 필드와 초 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 0.0과 $ 59 \frac{59}{60} $ 사이입니다(양 끝값 포함).
HOUR_0_11
현재 시간의 12시간 구성요소로, 0과 11 사이의 값(양 끝값 포함)으로 표시됩니다. 12:34 PM에서와 같이 현재 CLOCK_HOUR_OF_AMPM이 12인 경우 이 값은 0으로 변환됩니다.
HOUR_0_11_Z
현재 시간의 12시간 구성요소를 나타내는 문자열로, 00과 11 사이의 값(양 끝값 포함)입니다. Wear OS 기기의 현재 시간대를 사용합니다. 이 값이 10보다 작으면 선행 0이 추가됩니다.
HOUR_0_11_MINUTE
현재 시간을 나타내는 ZonedDateTime 객체의 수정된 CLOCK_HOUR_OF_AMPM 필드와 분 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 0.0과 $ 11 \frac{59}{60} $ 사이(양 끝값 포함)입니다.
HOUR_1_12
현재 시간의 12시간 구성요소로, 1과 12 사이의 값(양 끝값 포함)으로 표시됩니다. 0:12(오전 12:12)에서와 같이 현재 HOUR_OF_DAY가 0인 경우 이 값은 12로 변환됩니다.
HOUR_1_12_Z
현재 시간의 12시간 구성요소를 나타내는 문자열로, 01과 12 사이의 값(양 끝값 포함)입니다. Wear OS 기기의 현재 시간대를 사용합니다. 이 값이 10보다 작으면 선행 0이 추가됩니다.
HOUR_1_12_MINUTE
현재 시간을 나타내는 ZonedDateTime 객체의 CLOCK_HOUR_OF_AMPM 필드와 분 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 1.0과 $ 12 \frac{59}{60} $ 사이(양 끝값 포함)입니다.
HOUR_0_23
현재 시간의 24시간 구성요소로, 0과 23 사이의 값(양 끝값 포함)으로 표시됩니다. 24:13(익일 오전 12:13)에서와 같이 이 값이 24인 경우 이 값은 0으로 변환됩니다.
HOUR_0_23_Z
현재 시간의 24시간 구성요소를 나타내는 문자열로, 00과 23 사이의 값(양 끝값 포함)입니다. Wear OS 기기의 현재 시간대를 사용합니다. 이 값이 10보다 작으면 선행 0이 추가됩니다.
HOUR_0_23_MINUTE
현재 시간을 나타내는 ZonedDateTime 객체의 시간 필드와 분 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 0.0과 $ 23 \frac{59}{60} $ 사이(양 끝값 포함)입니다.
HOUR_1_24
현재 시간의 24시간 구성요소로, 1과 24 사이의 값(양 끝값 포함)으로 표시됩니다. 0:12(오전 12:12)에서와 같이 값이 0인 경우 이 값은 24로 변환됩니다.
HOUR_1_24_Z
현재 시간의 12시간 구성요소를 나타내는 문자열로, 01과 24 사이의 값(양 끝값 포함)입니다. Wear OS 기기의 현재 시간대를 사용합니다. 이 값이 10보다 작으면 선행 0이 추가됩니다.
HOUR_1_24_MINUTE
현재 시간을 나타내는 ZonedDateTime 객체의 수정된 시간 필드와 분 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 1.0과 $ 24 \frac{59}{60} $ 사이(양 끝값 포함)입니다.
DAY
현재 날짜의 ZonedDateTime 객체의 일 필드를 나타내는 정수 값입니다. 이 값은 항상 1과 31 사이입니다(양 끝값 포함).
DAY_Z
현재 날짜의 ZonedDateTime 객체의 일 필드를 나타내는 문자열 값에, 길이가 2자가 되도록 선행 0이 추가된 값입니다. 이 값은 항상 01과 31 사이입니다(양 끝값 포함).
DAY_HOUR
현재 날짜와 시간을 나타내는 ZonedDateTime 객체의 일 필드와 시간 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 1.0과 $ 31 \frac{23}{24} $ 사이(양 끝값 포함)입니다.
DAY_0_30
현재 날짜를 나타내는 ZonedDateTime 객체의 getDayOfMonth() 값에서 1을 뺀 수정된 버전입니다. 이 값은 항상 0과 30 사이입니다(양 끝값 포함).
DAY_0_30_HOUR
현재 날짜와 시간을 나타내는 ZonedDateTime 객체의 수정된 일 필드와 시간 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 0.0과 $ 30 \frac{23}{24} $ 사이(양 끝값 포함)입니다.
DAY_OF_YEAR
당해 연도가 시작된 후 경과된 일 수입니다. 이 값은 항상 1과 366 사이(양 끝값 포함)이며, 윤년이 아닌 해에는 최댓값이 365입니다.
DAY_OF_WEEK
현재 날짜를 나타내는 ZonedDateTime 객체의 getDayOfWeek() 값의 수정된 버전입니다. 워치 페이스 형식은 1 값을 할당하여 일요일을 나타내고 7 값을 할당하여 토요일을 나타냅니다.
DAY_OF_WEEK_F
현재 요일로, 전체 길이 문자열로 표현됩니다. 예를 들어 Sunday, Monday가 있습니다.
DAY_OF_WEEK_S
현재 요일로, 단축된 문자열로 표현됩니다. 예를 들어 Sun, Mon이 있습니다.
MONTH
현재 날짜의 ZonedDateTime 객체의 월 필드를 나타내는 정수 값입니다. 이 값은 항상 1과 12 사이입니다(양 끝값 포함).
MONTH_Z
현재 날짜의 ZonedDateTime 객체의 월 필드를 나타내는 문자열 값에, 길이가 2자가 되도록 선행 0이 추가된 값입니다. 이 값은 항상 01과 12 사이입니다(양 끝값 포함).
MONTH_F
현재 월로, 전체 길이 문자열로 표현됩니다. 예를 들어 January, December가 있습니다.
MONTH_S
현재 월로, 단축된 문자열로 표현됩니다. 예를 들어 Jan, Dec가 있습니다.
DAYS_IN_MONTH
현재 월의 일 수입니다. 이 값은 그레고리력의 2월에는 28 또는 29이고, 4월, 6월, 9월, 11월에는 30이고, 다른 모든 월에는 31입니다.
MONTH_DAY
현재 날짜를 나타내는 ZonedDateTime 객체의 월 필드와 수정된 일 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 1.0과 $ 12 \frac{29}{30} $ 사이(양 끝값 포함)입니다.
MONTH_0_11
현재 날짜를 나타내는 ZonedDateTime 객체의 getMonthValue() 값의 수정된 버전입니다. 이 값은 1월에 0 값을, 12월에 11 값을 할당합니다.
MONTH_0_11_DAY
현재 날짜를 나타내는 ZonedDateTime 객체의 수정된 월 필드와 수정된 일 필드를 결합한 부동 소수점 값입니다. 이 값은 항상 0.0과 $ 11 \frac{29}{30} $ 사이(양 끝값 포함)입니다.
YEAR
현재 날짜의 ZonedDateTime 객체의 연도 필드를 나타내는 정수 값입니다. 이 값은 항상 1902와 2100 사이(양 끝값 포함)가 되도록 고정됩니다.
YEAR_S
당해 연도의 마지막 2자리를 나타내는 2자리 정수입니다. 예를 들어 2023의 값은 23입니다.
YEAR_MONTH
현재 날짜를 나타내는 ZonedDateTime 객체의 연도 필드와 수정된 월 필드를 결합한 부동 소수점 값입니다. 2023년 1월은 2023.0으로, 2023년 12월은 $ 2023 \frac {11}{12} $로 표현됩니다.
YEAR_MONTH_DAY
현재 날짜를 나타내는 ZonedDateTime 객체의 연도 필드, 수정된 월 필드와 수정된 일 필드를 결합한 부동 소수점 값입니다. 2023년 1월 1일은 2023.0으로, 2023년 12월 31일은 $ 2023 \frac{11 \frac{29}{30}}{12} \approx 2023.9972 $로 표현됩니다.
WEEK_IN_MONTH
현재 날짜를 나타내는 ChronoField 객체의 ALIGNED_WEEK_OF_MONTH 값을 나타내는 정수입니다. 이 값은 항상 0과 5 사이입니다(양 끝값 포함).
WEEK_IN_YEAR
현재 날짜를 나타내는 ChronoField 객체의 ALIGNED_WEEK_OF_YEAR 값을 나타내는 정수입니다. 이 값은 항상 1과 53 사이입니다(양 끝값 포함).
IS_24_HOUR_MODE
사용자가 선택한 언어 및 환경설정을 기준으로, is24HourFormat()의 현재 반환 값과 동일한 불리언 값입니다.
IS_DAYLIGHT_SAVING_TIME
현재 언어의 TimeZone 객체에서 inDaylightTime()을 호출하고 현재 시간이 포함된 Date 객체를 전달하는 것과 동일한 불리언 값입니다. 현재 설정된 시간대가 이제 일광 절약 시간을 준수하는지 여부를 나타냅니다.
TIMEZONE
현재 언어의 TimeZone 객체에서 getDisplayName()을 호출하는 것과 동일한 문자열입니다. 전체 시간대 이름을 반환합니다. 예를 들어 겨울 뉴욕시 시간대의 경우 'Eastern Standard Time'이 반환됩니다.
TIMEZONE_ABB
현재 언어의 TimeZone 객체에 대해 getDisplayName()의 오버로드된 버전을 호출하는 것과 동일한 문자열입니다. 여기서 지정된 스타일은 SHORT입니다. 축약된 시간대 이름을 반환합니다. 예를 들어 겨울 뉴욕시 시간대의 경우 'EST'가 반환됩니다.
TIMEZONE_ID
현재 언어의 TimeZone 객체에서 getId()를 호출하는 것과 동일한 문자열입니다. IANA 시간대 ID 값을 반환합니다. 예를 들어 뉴욕시 시간대의 경우 America/New_York이 반환됩니다.
TIMEZONE_OFFSET
현재 언어의 TimeZone 객체에서 getRawOffset()을 호출하는 것과 동일한 문자열입니다. 이 값은 항상 -12와 +14 사이입니다(양 끝값 포함). 현재 시간대의 (일광 절약 시간이 아닌) 표준 시간을 얻으려면 UTC에 더해야 하는 값을 반환합니다.
TIMEZONE_OFFSET_DST
현재 언어의 TimeZone 객체에서 getOffset()에 현재 날짜를 전달하는 것과 동일한 문자열입니다. 이 값은 항상 -12와 +14 사이입니다(양 끝값 포함). 현재 현지 시간을 얻으려면 UTC에 더해야 하는 값을 반환합니다. 이때 필요한 경우 일광 절약 시간을 고려합니다.
AMPM_STATE
현재 시간이 정오 이전인지, 정오인지, 아니면 정오 이후인지를 나타내는 정수입니다. 가능한 값은 AM의 경우 0, PM의 경우 1입니다.
AMPM_POSITION

시간 문자열 안에서 AM 또는 PM 표시가 나타나야 하는 위치를 나타내는 정수입니다. 다음 값 중 하나를 포함합니다.

  • 0은 AM 또는 PM이 문자열의 시작 부분에 나타나야 함을 의미합니다(예: AM 12:03).
  • 1은 AM 또는 PM이 문자열의 끝에 나타나야 함을 의미합니다(예: 12:03 AM).
  • -1은 문자열에서 AM 또는 PM이 어디에 나타나야 하는지 알 수 없음을 의미합니다.
AMPM_STRING

현재 시간의 AM 또는 PM 상태를 나타내는 2자리 문자열입니다. 값은 'AM' 또는 'PM'입니다.

달의 위상

워치 페이스 형식은 달의 위상과 관련하여 다음 데이터 소스를 지원합니다.

MOON_PHASE_POSITION
가장 최근 신월 이후 경과된 일 수를 나타내는 정수 값입니다. 이 값은 항상 0과 28 사이입니다(양 끝값 포함).
MOON_PHASE_TYPE

현재 달의 위상을 인코딩하는 정수입니다. 가능한 값은 다음과 같습니다.

  • 0: 가장 최근 신월
  • 1: 초승달
  • 2: 상현달
  • 3: 상현망간의 달
  • 4: 보름달
  • 5: 하현망간의 달
  • 6: 하현달
  • 7: 그믐달
MOON_PHASE_TYPE_STRING

현재 달의 위상을 나타내는 문자열입니다. 가능한 값은 다음과 같습니다.

  • New Moon: 가장 최근 신월 이후 경과된 일 수가 0.5일 미만이거나 27.5일 초과인 경우.
  • Evening Crescent: 가장 최근 신월 이후 경과된 일 수가 0.5일 이상 6.5일 미만인 경우.
  • First Quarter: 가장 최근 신월 이후 경과된 일 수가 6.5일 이상 7.5일 미만인 경우.
  • Waxing Gibbous: 가장 최근 신월 이후 경과된 일 수가 7.5일 이상 13.5일 미만인 경우.
  • Full Moon: 가장 최근 신월 이후 경과된 일 수가 13.5일 이상 14.5일 미만인 경우.
  • Waning Gibbous: 가장 최근 신월 이후 경과된 일 수가 14.5일 이상 20.5일 미만인 경우.
  • Last Quarter: 가장 최근 신월 이후 경과된 일 수가 20.5일 이상 21.5일 미만인 경우.
  • Morning Crescent: 가장 최근 신월 이후 경과된 일 수가 21.5일 이상 27.5일 미만인 경우.

언어

워치 페이스 형식은 사용자의 언어와 관련하여 다음 데이터 소스를 지원합니다.

LANGUAGE_LOCALE_NAME
Wear OS 기기의 현재 언어를 나타내는 문자열로, 2자 길이의 ISO 639-1 언어 코드, 밑줄, 그리고 2자 길이의 ISO 3166-1 지역 코드로 표현됩니다. 미국 영어는 en_US로 표현됩니다.

건강 데이터

워치 페이스 형식은 사용자의 건강 데이터와 관련하여 다음 데이터 소스를 지원합니다.

STEP_COUNT
Wear OS 기기 센서에 따른, 사용자가 지금까지 걸은 걸음 수입니다.
STEP_GOAL
사용자가 일일 걸음 수 목표로 선택한 걸음 수입니다. 이 값은 1000보다 작지 않습니다.
STEP_PERCENT
사용자가 오늘 걸음 수 목표 중 달성한 진행 상황을 나타내는 정수로, 반올림된 백분율로 표시됩니다. 이 값은 항상 0과 100 사이입니다(양 끝값 포함).
HEART_RATE
Wear OS 기기 센서에 따른, 사용자의 현재 심박수입니다. 이 값은 항상 0과 240 사이입니다(양 끝값 포함).
HEART_RATE_Z
Wear OS 기기 센서에 따른, 사용자의 현재 심박수를 나타내는 문자열입니다. 이 값은 왼쪽에 값의 길이가 최소 2자가 되도록 필요한 만큼의 0이 채워집니다. 따라서 사용자의 심박수가 65이면 값은 65입니다. 따라서 사용자의 심박수가 0이면 값은 00입니다.

기기 센서

워치 페이스 형식은 기기의 센서와 관련하여 다음 데이터 소스를 지원합니다.

ACCELEROMETER_IS_SUPPORTED
시계 화면이 현재 Wear OS 기기의 센서에서 가속도계 데이터를 가져올 수 있는지 여부를 나타내는 불리언 값입니다.
ACCELEROMETER_X
Wear OS 기기의 가속도계에 따른, x축의 현재 선형 가속을 나타내는 부동 소수점 값입니다. 양수 값은 시계 화면이 하늘 또는 천장을 향했을 때 Wear OS 기기가 오른쪽으로 가속하고 있음을 나타냅니다.
ACCELEROMETER_Y
Wear OS 기기의 가속도계에 따른, y축의 현재 선형 가속을 나타내는 부동 소수점 값입니다. 양수 값은 시계 화면이 하늘 또는 천장을 향했을 때 Wear OS 기기가 시계 화면의 12시(위쪽) 방향으로 가속하고 있음을 나타냅니다.
ACCELEROMETER_Z

Wear OS 기기의 가속도계에 따른, z축의 현재 선형 가속을 나타내는 부동 소수점 값입니다. 양수 값은 시계 화면이 하늘 또는 천장을 향했을 때 Wear OS 기기가 하늘 또는 천장 쪽으로 가속하고 있음을 나타냅니다.

ACCELEROMETER_ANGLE_X

x축을 기준으로 현재 각가속도를 도 단위로 나타내는 부동 소수점 값입니다. 이 값은 항상 $ [-90.0, 90.0 $] 범위 내에 있습니다.

ACCELEROMETER_ANGLE_Y

y축을 기준으로 현재 각가속도를 도 단위로 나타내는 부동 소수점 값입니다. 이 값은 항상 $ [-90.0, 90.0 $] 범위 내에 있습니다.

ACCELEROMETER_ANGLE_Z

z축을 기준으로 현재 각가속도를 도 단위로 나타내는 부동 소수점 값입니다. 이 값은 항상 $ [-90.0, 90.0 $] 범위 내에 있습니다.

ACCELEROMETER_ANGLE_XY

ACCELEROMETER_ANGLE_X와 ACCELEROMETER_ANGLE_Y의 합인 부동 소수점 값입니다.

기기 배터리

워치 페이스 형식은 기기의 현재 배터리 상태와 관련하여 다음 데이터 소스를 지원합니다.

BATTERY_PERCENT
Wear OS 기기의 현재 배터리 충전 상태를 백분율로 나타내는 정수입니다. 값 100은 배터리가 완전히 충전되었음을 나타내고 값 0은 배터리가 매우 부족함을 나타냅니다.
BATTERY_CHARGING_STATUS
Wear OS 기기의 배터리가 충전 중인지 여부를 나타내는 불리언입니다. 배터리 충전이 완료되어 완충된 경우 이 값은 true입니다.
BATTERY_IS_LOW
Wear OS 기기의 배터리가 부족한지 나타내는 불리언입니다. 이에 대한 정확한 임곗값은 제조업체에 따라 다릅니다. 배터리가 충전 중인 경우 이 값은 false입니다.
BATTERY_TEMPERATURE_CELSIUS
Wear OS 기기 배터리의 온도를 섭씨로 나타내는 부동 소수점 값입니다. 이 값은 배터리의 섭씨 0.1도 단위로 표현되는 원시 온도를 10으로 나누어 구해집니다.
BATTERY_TEMPERATURE_FAHRENHEIT
Wear OS 기기 배터리의 온도를 화씨로 나타내는 부동 소수점 값입니다. 섭씨 온도에서 변환한 값입니다.

알림

워치 페이스 형식은 기기의 알림과 관련된 다음 데이터 소스를 지원합니다.

UNREAD_NOTIFICATION_COUNT
사용자가 아직 읽지 않은 Wear OS 기기에 전달된 알림 수를 나타내는 문자열입니다.