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