Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

날짜, 시각과 범위 카드

날짜 및 시각 카드는 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/2023DD/MM/YYYY
July 18, 2023MMMM D, YYYY
07/18/2023MM/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 dateTime seriesTime첫 관측의 시각
Time series end dateTime seriesTime마지막 관측의 시각

전체 시계열의 관측 범위를 다른 카드의 입력으로 사용할 때 활용합니다.

범위의 시작과 끝

카드입력형출력형의미
Range startNumber range 또는 Time rangeNumber 또는 Time범위의 시작값
Range endNumber range 또는 Time rangeNumber 또는 Time범위의 끝값

숫자 범위이면 숫자를, 시간 범위이면 시각을 반환합니다. 대시보드에서 범위의 두 끝을 별도 입력이나 출력으로 연결할 때도 사용할 수 있습니다. 범위 표시와 매개변수 구성은 시간 및 값 범위, 시각 간 조건은 비교 카드를 참고합니다.

숫자 결과를 정수로 올림하거나 내릴 때는 Ceiling과 Floor를 구분하여 사용합니다.