날짜, 시각과 범위 카드
날짜 및 시각 카드는 Time 값을 비교할 수 있는 숫자나 표시 문자열로 바꾸거나, 일정 기간의 범위를 만듭니다. 이 장의 연산은 모두 표준 Quiver 카드와 transform table 변환에서 지원합니다.
날짜 구성 요소
다음 카드의 입력은 Time이고 출력은 Number입니다.
| 카드 | 반환값 |
|---|---|
| Day of month | 해당 월의 일자 |
| Day of week | 요일을 나타내는 숫자 |
| Hour of day | 하루 중 시각의 시간 값 |
| Month | 월을 나타내는 숫자 |
| Year | 연도 |
| Day of year | 해당 연도 안의 일자 순서 |
결과를 다른 시스템의 요일이나 월 코드와 결합할 때는 코드의 의미를 맞춰 사용합니다.
날짜 차이와 이동
Date difference
Time 값 두 개의 차이를 Number로 반환합니다. 단위는 Week, Day, Hour, Minute, Second와 Millisecond 중 하나를 선택합니다.
Shift date/time
Time 값에 지정한 주, 일, 시간, 분, 초 또는 밀리초 길이를 적용하여 이동한 Time 값을 반환합니다. 이동량과 단위를 정하여 후속 시간 조건에 사용할 수 있습니다.
기간 시작부터 입력 시각까지
아래 카드는 Time을 입력받아 Time range를 반환합니다. 단일 Time 출력과 구분합니다.
| 카드 | 범위 시작 | 범위 끝 |
|---|---|---|
| Day to date | 입력 날짜의 00:00 | 입력 시각 |
| Week to date | 입력이 속한 주의 첫날 00:00 | 입력 시각 |
| Month to date | 입력이 속한 달의 첫날 00:00 | 입력 시각 |
| Year to date | 입력이 속한 해의 1월 1일 00:00 | 입력 시각 |
Week to date의 주 시작일은 사용자 로캘에 따라 월요일 또는 일요일입니다. 모든 환경에서 월요일로 고정되어 있다고 가정하지 않습니다.
문자열을 시각으로 변환
String to date
String을 Time으로 변환합니다. 사용할 시간대를 사용자 로컬 시간, UTC 또는 지정한 시간대로 선택하고 필요하면 Day.js 형식을 지정합니다.
기본 날짜 순서는 미국식 월/일/연도입니다. 다른 순서나 월 이름을 가진 입력에는 그 구조에 맞는 형식을 지정합니다.
| 입력 예 | 명시할 형식 |
|---|---|
| 18/07/2023 | DD/MM/YYYY |
| July 18, 2023 | MMMM D, YYYY |
| 07/18/2023 | MM/DD/YYYY |
Day.js에서 대문자 MM은 월, 소문자 mm은 분입니다. 유효하지 않은 시간대나 날짜에는 Invalid timezone or date를 반환합니다.
Number to date
Number를 Time으로 변환합니다. Unix milliseconds와 Unix seconds 중 입력 숫자의 단위를 선택합니다.
예를 들어 객체 집합의 Date 속성을 숫자 집계한 결과를 후속 시간 카드에 전달하려면, 해당 숫자의 단위를 맞춘 뒤 Number to date로 변환할 수 있습니다.
Date to string
Date 입력을 String으로 바꿉니다. 출력 형식을 선택적으로 지정하며 예를 들어 YY-MMM-DD 형태를 사용할 수 있습니다. 이는 날짜를 문자열로 표시하는 경로이며 문자열을 파싱하는 String to date와 구분합니다.
시계열 양끝의 시각
| 카드 | 입력형 | 출력형 | 의미 |
|---|---|---|---|
| Time series start date | Time series | Time | 첫 관측의 시각 |
| Time series end date | Time series | Time | 마지막 관측의 시각 |
전체 시계열의 관측 범위를 다른 카드의 입력으로 사용할 때 활용합니다.
범위의 시작과 끝
| 카드 | 입력형 | 출력형 | 의미 |
|---|---|---|---|
| Range start | Number range 또는 Time range | Number 또는 Time | 범위의 시작값 |
| Range end | Number range 또는 Time range | Number 또는 Time | 범위의 끝값 |
숫자 범위이면 숫자를, 시간 범위이면 시각을 반환합니다. 대시보드에서 범위의 두 끝을 별도 입력이나 출력으로 연결할 때도 사용할 수 있습니다. 범위 표시와 매개변수 구성은 시간 및 값 범위, 시각 간 조건은 비교 카드를 참고합니다.
숫자 결과를 정수로 올림하거나 내릴 때는 Ceiling과 Floor를 구분하여 사용합니다.