날짜 및 시간 함수
Qlik Sense 날짜 및 시간 함수는 날짜와 시간 값을 변환하는 데 사용됩니다. 모든 함수는 데이터 로드 스크립트와 차트 표현식 모두에서 사용할 수 있습니다.
이 함수는 1899년 12월 30일 이후의 일 수와 동일한 날짜-시간 일련 번호를 기준으로 합니다. 정수 값은 날짜를 나타내고 소수 값은 해당 날짜의 시간을 나타냅니다.
Qlik Sense는 파라메타의 숫자 값을 사용하므로 숫자는 날짜 또는 시간으로 서식이 지정되지 않았을 때도 파라메타로 유효합니다. 파라메타가 문자열인 경우와 같이 숫자 값에 해당하지 않는 경우 Qlik Sense는 날짜 및 시간 환경 변수에 따라 문자열을 해석하려고 시도합니다.
파라메타에 사용된 시간 서식이 환경 변수로 설정된 서식과 일치하지 않을 경우 Qlik Sense에서 정확한 해석을 수행할 수 없게 됩니다. 이 문제를 해결하려면 설정을 변경하거나 해석 함수를 사용하십시오.
이 예의 각 함수에는 기본 시간 및 날짜 서식인 hh:mm:ss와 YYYY-MM-DD (ISO 8601)이 사용됩니다.
날짜 또는 시간 함수를 사용하여 타임스탬프를 처리할 때 날짜 또는 시간 함수에 지리적 위치가 포함되어 있지 않으면 Qlik Sense는 일광 절약 시간 파라메타를 무시합니다.
예를 들어 ConvertToLocalTime( filetime('Time.qvd'), 'Paris')은 일광 절약 시간 매개 변수를 사용하고 ConvertToLocalTime(filetime('Time.qvd'), 'GMT-01:00')은 일광 절약 시간 매개 변수를 사용하지 않습니다.
각 함수에 대한 간단한 설명과 구문을 보려면 각 함수에서 드롭다운을 사용하십시오. 자세한 내용은 구문 설명에서 해당 함수 이름을 클릭하십시오.
시간의 정수 표현식
이 함수는 expression의 분위수가 표준 숫자 해석에 따라 시간으로 해석될 경우 초를 나타내는 정수를 반환합니다.
second(expression)
이 함수는 expression의 분위수가 표준 숫자 해석에 따라 시간으로 해석될 경우 분을 나타내는 정수를 반환합니다.
minute(expression)
이 함수는 expression의 분위수가 표준 숫자 해석에 따라 시간으로 해석될 경우 시간을 나타내는 정수를 반환합니다.
hour(expression)
이 함수는 expression의 분위수가 표준 숫자 해석에 따라 날짜로 해석될 경우 일을 나타내는 정수를 반환합니다.
day(expression)
이 함수는 ISO 8601에 따른 주 번호를 나타내는 정수를 반환합니다. 주 번호는 표준 숫자 해석에 따라 표현식의 날짜 해석을 통해 계산됩니다.
week(expression)
이 함수는 환경 변수 MonthNames로 정의되고 1~12 사이의 정수인 월 이름이 포함된 이중 값을 반환합니다. 월은 표준 숫자 해석에 따라 표현식의 날짜 해석을 통해 계산됩니다.
month(expression)
이 함수는 expression이 표준 숫자 해석에 따라 날짜로 해석될 경우 연도를 나타내는 정수를 반환합니다.
year(expression)
이 함수는 다음을 포함하는 이중 값을 반환합니다.
- 환경 변수 DayNames로 정의한 날짜 이름.
- 주의 명목상 이름(0~6)에 해당하는 0~6 사이의 정수.
weekday(date)
타임스탬프 함수
이 함수는 현재 시간의 타임스탬프를 반환합니다. 이 함수는 TimeStamp 시스템 변수 서식으로 값을 반환합니다. 기본 timer_mode 값은 1입니다.
now([ timer_mode])
이 함수는 지정된 표준 시간대에 대한 현재 시간의 타임스탬프를 반환합니다.
localtime([timezone [, ignoreDST ]])
Make 함수
이 함수는 연도 YYYY, 월 MM, 일 DD에서 계산한 날짜를 반환합니다.
makedate(YYYY [ , MM [ , DD ] ])
이 함수는 시간 hh, 분 mm, 초 ss에서 계산한 시간을 반환합니다.
maketime(hh [ , mm [ , ss [ .fff ] ] ])
기타 날짜 함수
이 함수는 startdate를 기준으로 n개월 후의 날짜, 또는 n이 음수일 경우는 startdate를 기준으로 n개월 전의 날짜를 반환합니다.
addmonths(startdate, n , [ , mode])
이 함수는 startdate를 기준으로 n년 후의 날짜, 또는 n이 음수일 경우는 startdate를 기준으로 n년 전의 날짜를 반환합니다.
addyears(startdate, n)
이 함수는 스크립트를 마지막으로 로드한 날짜의 연도 내에 입력 타임스탬프가 포함되는지 파악하고, 포함되는 경우 True, 포함되지 않는 경우 False를 반환합니다.
yeartodate(date [ , yearoffset [ , firstmonth [ , todaydate] ] ])
표준 시간대 함수
이 함수는 Qlik 엔진이 실행 중인 컴퓨터에 정의된 표준 시간대를 반환합니다.
timezone( )
이 함수는 지역 설정에서 유추한 현재 Greenwich Mean Time을 반환합니다.
GMT( )
현재 Coordinated Universal Time을 반환합니다.
UTC( )
Windows에 정의된 일광 절약 시간제 시간의 현재 조정 내용을 반환합니다.
UTC 또는 GMT 타임스탬프를 이중 값 형태의 현지 시간으로 변환합니다. place는 전 세계 여러 도시, 장소, 표준 시간대로 지정할 수 있습니다.
converttolocaltime(timestamp [, place [, ignore_dst=false]])
시간 설정 함수
이 함수는 timestamp 및 year 를 입력으로 사용하여 입력에 지정된 year 로 timestamp 를 업데이트합니다.
setdateyear (timestamp, year)
이 함수는 timestamp, month 및 year 를 입력으로 사용하여 입력에 지정된 year및 month 로 timestamp 를 업데이트합니다.
setdateyearmonth (timestamp, year, month)
In... 함수
timestamp가 base_date를 포함하는 연도에 속할 경우 이 함수는 True를 반환합니다.
inyear(date, basedate , shift [, first_month_of_year = 1])
이 함수는 timestamp가 base_date의 마지막 밀리초까지 포함하여 base_date를 포함한 연도의 일부에 속할 경우 True를 반환합니다.
inyeartodate (date, basedate , shift [, first_month_of_year = 1])
timestamp가 base_date를 포함하는 분기에 속할 경우 이 함수는 True를 반환합니다.
inquarter (date, basedate , shift [, first_month_of_year = 1])
이 함수는 timestamp가 base_date의 마지막 밀리초까지 포함하여 base_date를 포함한 분기의 일부에 속할 경우 True를 반환합니다.
inquartertodate (date, basedate , shift [, first_month_of_year = 1])
timestamp가 base_date를 포함하는 월에 속할 경우 이 함수는 True를 반환합니다.
inmonth(date, basedate , shift)
이 함수는 date가 basedate의 마지막 밀리초까지 포함하여 basedate를 포함한 월의 일부에 속할 경우True를 반환합니다.
inmonthtodate (date, basedate , shift)
이 함수는 타임스탬프가 기준 날짜와 같은 월, 2개월, 분기, 4개월 기간 또는 6개월 내에 속하는지 찾습니다. 또한 타임스탬프가 이전 기간 또는 다음 기간 내에 속하는지도 알아낼 수 있습니다.
inmonths(n, date, basedate , shift [, first_month_of_year = 1])
이 함수는 타임스탬프가 base_date의 마지막 밀리초를 포함하여 월, 2개월, 분기, 4개월 기간 또는 6개월 기간에 속하는지 여부를 찾습니다. 또한 타임스탬프가 이전 기간 또는 다음 기간 내에 속하는지도 알아낼 수 있습니다.
inmonthstodate (n, date, basedate , shift [, first_month_of_year = 1])
timestamp가 base_date를 포함하는 주에 속할 경우 이 함수는 True를 반환합니다.
inweek(date, basedate , shift [, weekstart])
이 함수는 timestamp가 base_date의 마지막 밀리초까지 포함하여 base_date를 포함한 주의 일부에 속할 경우 True를 반환합니다.
inweektodate (date, basedate , shift [, weekstart])
이 함수는 timestamp가 base_date를 포함하는 음력 주 안에 있는지 확인합니다. Qlik Sense에서 음력 주는 1월 1일을 주의 첫 번째 날로 계산하여 정의되며, 연도의 마지막 주를 제외하고 각 주는 정확히 7일을 포함합니다.
inlunarweek (date, basedate , shift [, weekstart])
이 함수는 timestamp가 base_date의 마지막 밀리초까지 포함하여 음력 주의 일부에 속하는지 확인합니다. Qlik Sense에서 음력 주는 1월 1일을 주의 첫 번째 날로 계산하여 정의되며, 연도의 마지막 주를 제외하고 정확히 7일이 포함됩니다.
inlunarweektodate (date, basedate , shift [, weekstart])
timestamp가 base_timestamp를 포함하는 날에 속할 경우 이 함수는 True를 반환합니다.
inday(timestamp, basetimestamp , shift [, daystart])
이 함수는 timestamp가 base_timestamp의 정확한 밀리초까지 포함하여 base_timestamp를 포함한 날의 일부에 속할 경우 True를 반환합니다.
indaytotime(timestamp, basetimestamp , shift [, daystart])
Start ... end 함수
이 함수는 date를 포함하는 연도의 첫 번째 날의 시작에 해당하는 타임스탬프를 반환합니다. 기본 출력 형식은 스크립트에 설정된 DateFormat입니다.
yearstart( date [, shift = 0 [, first_month_of_year = 1]])
이 함수는 date를 포함하는 연도의 마지막 날의 마지막 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 기본 출력 형식은 스크립트에 설정된 DateFormat입니다.
yearend( date [, shift = 0 [, first_month_of_year = 1]])
이 함수는 date를 포함한 연도의 첫 번째 날의 첫 번째 밀리초의 타임스탬프에 해당하는 기본 숫자 값을 사용하여 네 자리 연도를 표시 값으로 반환합니다.
yearname(date [, shift = 0 [, first_month_of_year = 1]] )
이 함수는 date를 포함하는 분기의 첫 번째 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 기본 출력 형식은 스크립트에 설정된 DateFormat입니다.
quarterstart(date [, shift = 0 [, first_month_of_year = 1]])
이 함수는 date를 포함하는 분기의 마지막 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 기본 출력 형식은 스크립트에 설정된 DateFormat입니다.
quarterend(date [, shift = 0 [, first_month_of_year = 1]])
이 함수는 해당 분기의 첫 번째 날의 첫 번째 밀리초의 타임스탬프에 해당하는 기본 숫자 값으로 분기의 월(MonthNames 스크립트 변수에 따라 서식 지정) 및 연도를 보여주는 표시 값을 반환합니다.
quartername(date [, shift = 0 [, first_month_of_year = 1]])
이 함수는 date를 포함하는 월의 첫 번째 날의 첫 번째 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 기본 출력 형식은 스크립트에 설정된 DateFormat입니다.
monthstart(date [, shift = 0])
이 함수는 date를 포함하는 월의 마지막 날의 마지막 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 기본 출력 형식은 스크립트에 설정된 DateFormat입니다.
monthend(date [, shift = 0])
이 함수는 해당 월의 첫 번째 날의 첫 번째 밀리초의 타임스탬프에 해당하는 기본 숫자 값으로 월(MonthNames 스크립트 변수에 따라 서식 지정) 및 연도를 보여주는 표시 값을 반환합니다.
monthname(date [, shift = 0])
이 함수는 기준일을 포함하는 월, 2개월, 분기, 4개월 기간 또는 6개월의 첫 번째 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 또한 이전 기간 또는 다음 기간에 대한 타임스탬프를 찾을 수도 있습니다.기본 출력 형식은 스크립트에 설정된 DateFormat입니다.
monthsstart(n, date [, shift = 0 [, first_month_of_year = 1]])
이 함수는 기준일을 포함하는 월, 2개월, 분기, 4개월 기간 또는 6개월의 마지막 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 또한 이전 기간 또는 다음 기간에 대한 타임스탬프를 찾을 수도 있습니다.
monthsend(n, date [, shift = 0 [, first_month_of_year = 1]])
이 함수는 연도뿐 아니라 기간의 월 범위(MonthNames 스크립트 변수에 따라 서식 지정)를 나타내는 표시 값도 반환합니다. 기본 숫자 값은 기준일을 포함하는 월, 2개월, 분기, 4개월 기간 또는 6개월의 첫 번째 밀리초의 타임스탬프에 해당합니다.
monthsname(n, date [, shift = 0 [, first_month_of_year = 1]])
이 함수는 date를 포함하는 캘린더 주의 첫 번째 날의 첫 번째 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 기본 출력 형식은 스크립트에 설정된 DateFormat입니다.
weekstart(date [, shift = 0 [,weekoffset = 0]])
이 함수는 date를 포함하는 캘린더 주의 마지막 날(일요일)의 마지막 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 기본 출력 형식은 스크립트에 설정된 DateFormat입니다.
weekend(date [, shift = 0 [,weekoffset = 0]])
이 함수는 date를 포함한 주의 첫 번째 날의 첫 번째 밀리초의 타임스탬프에 해당하는 기본 숫자 값으로 연도 및 주차를 보여주는 값을 반환합니다.
weekname(date [, shift = 0 [,weekoffset = 0]])
이 함수는 date를 포함하는 음력 주의 첫 번째 날의 첫 번째 밀리초의 타임스탬프에 해당하는 값을 반환합니다. Qlik Sense에서 음력 주는 1월 1일을 주의 첫 번째 날로 계산하여 정의되며, 연도의 마지막 주를 제외하고 정확히 7일이 포함됩니다.
lunarweekstart(date [, shift = 0 [,weekoffset = 0]])
이 함수는 date를 포함하는 음력 주의 마지막 날의 마지막 밀리초의 타임스탬프에 해당하는 값을 반환합니다. Qlik Sense에서 음력 주는 1월 1일을 주의 첫 번째 날로 계산하여 정의되며, 연도의 마지막 주를 제외하고 정확히 7일이 포함됩니다.
lunarweekend(date [, shift = 0 [,weekoffset = 0]])
이 함수는 date를 포함한 음력 주의 첫 번째 날의 첫 번째 밀리초의 타임스탬프에 해당하는 음력 주차와 연도를 보여주는 표시 값을 반환합니다. Qlik Sense에서 음력 주는 1월 1일을 주의 첫 번째 날로 계산하여 정의되며, 연도의 마지막 주를 제외하고 정확히 7일이 포함됩니다.
lunarweekname(date [, shift = 0 [,weekoffset = 0]])
이 함수는 time 인수에 포함된 날의 첫 번째 밀리초가 있는 타임스탬프에 해당하는 값을 반환합니다. 기본 출력 형식은 스크립트에 설정된 TimestampFormat입니다.
daystart(timestamp [, shift = 0 [, dayoffset = 0]])
이 함수는 time에 포함된 날의 마지막 밀리초의 타임스탬프에 해당하는 값을 반환합니다. 기본 출력 형식은 스크립트에 설정된 TimestampFormat입니다.
dayend(timestamp [, shift = 0 [, dayoffset = 0]])
이 함수는 time을 포함한 날의 첫 번째 밀리초의 타임스탬프에 해당하는 기본 숫자 값으로 날짜를 표시하는 값을 반환합니다.
dayname(timestamp [, shift = 0 [, dayoffset = 0]])
날짜 계수 함수
age 함수는 date_of_birth에 태어난 사람이 timestamp의 시간에 (만으로) 몇 살인지 반환합니다.
age(timestamp, date_of_birth)
networkdays 함수는 선택적으로 나열된 holiday를 고려하여 start_date(포함)와 end_date(포함) 사이의 근무일(월요일 ~ 금요일)의 수를 반환합니다.
networkdays (start:date, end_date {, holiday})
firstworkdate 함수는 선택적으로 나열된 공휴일을 고려하여 no_of_workdays(월요일 ~ 금요일)가 end_date 이전에 끝나게 되는 가장 최근의 시작 날짜를 반환합니다. end_date 및 holiday은 유효한 날짜 또는 타임스태프여야 합니다.
firstworkdate(end_date, no_of_workdays {, holiday} )
lastworkdate 함수는 선택적으로 나열된 holiday를 고려하여 start_date에 시작하는 경우 no_of_workdays(월요일-금요일)가 끝나는 가장 빠른 끝 날짜를 반환합니다. start_date 및 holiday는 유효한 날짜 또는 타임스탬프여야 합니다.
lastworkdate(start_date, no_of_workdays {, holiday})
이 함수는 타임스탬프가 속하는 연도의 일수를 계산합니다. 해당 연도의 첫 날의 첫 번째 밀리초로부터 계산되지만 첫 번째 월은 오프셋 지정할 수 있습니다.
daynumberofyear(date[,firstmonth])
이 함수는 타임스탬프가 속하는 분기의 일수를 계산합니다. 마스터 캘린더를 만들 때 사용하는 함수입니다.
daynumberofquarter(date[,firstmonth])