기본 콘텐츠로 건너뛰기

yearstart - 스크립트 및 차트 함수

이 함수는 date를 포함하는 연도의 첫 번째 날의 시작에 해당하는 타임스탬프를 반환합니다. 기본 출력 형식은 스크립트에 설정된 DateFormat입니다.

구문:  

YearStart(date[, period_no[, first_month_of_year]])

즉, yearstart() 함수는 이 날짜가 속하는 연도를 확인합니다. 그런 다음 해당 연도의 첫 번째 밀리초에 대한 타임스탬프를 날짜 서식으로 반환합니다. 연도의 첫 번째 달은 기본적으로 1월입니다. 그러나 yearstart() 함수의 first_month_of_year 인수를 사용하여 첫 번째로 설정되는 월을 변경할 수 있습니다.

yearstart() 함수가 처리할 수 있는 시간 범위를 보여 주는 함수 다이어그램.

yearstart() 함수가 지정된 연도 기간 내의 날짜를 식별하고 해당 연도에 속하는 날짜에 대한 연도 시작의 타임스탬프를 반환하는 것을 보여 주는 다이어그램입니다.

yearstart() 함수는 지금까지 경과된 연도의 분수를 사용하도록 계산하려는 경우 표현식의 일부로 사용됩니다. 예를 들어 연간 누계로 누적된 이자를 계산하려는 경우.

반환 데이터 유형: dual

인수
인수 설명
date 평가할 날짜입니다.
period_no period_no는 정수이며, 값 0은 date를 포함하는 연도를 나타냅니다. period_no가 음수 값일 경우 이전 연도, 양수 값일 경우 다음 연도를 나타냅니다.
first_month_of_year 1월에 시작되지 않는 (회계)연도를 사용하려는 경우 first_month_of_year에 2와 12 사이의 값을 지정하십시오.

first_month_of_year argument에서 다음 달을 사용할 수 있습니다.

first_month_of_year 값
Month Value
2월  2
3월 3
4월 4
5월 5
6월 6
7월 7
8월 8
9월 9
10월 10
11월  11
12월 12

국가별 설정

달리 지정하지 않는 한 이 항목의 예에서는 다음 날짜 형식을 사용합니다. YYYY/MM/DD. 날짜 형식은 데이터 로드 스크립트의 SET DateFormat 문에 지정됩니다. 기본 날짜 형식은 지역 설정 및 기타 요인으로 인해 시스템에서 다를 수 있습니다. 아래 예의 형식을 요구 사항에 맞게 변경할 수 있습니다. 또는 이러한 예와 일치하도록 로드 스크립트의 형식을 변경할 수 있습니다. 자세한 내용은 앱 지역 설정 수정를 참조하십시오.

앱의 기본 지역 설정은 ID 공급자 설정, 시스템 설정 또는 브라우저 설정의 조합을 기반으로 합니다. 이러한 국가별 형식 설정은 Qlik Cloud 사용자 인터페이스에 표시되는 언어와 관련이 없습니다. Qlik Cloud는 사용 중인 브라우저와 동일한 언어로 표시됩니다.

앱 작성자인 경우 만든 앱의 기본 지역을 설정할 수 있습니다. 자세한 내용은 앱 생성을 위한 기본 지역 설정을 참조하십시오.

함수 예
결과
yearstart('10/19/2001') 01/01/2001 00:00:00을 반환합니다.
yearstart('10/19/2001',-1) 01/01/2000 00:00:00을 반환합니다.
yearstart('10/19/2001',0,4) 04/01/2001 00:00:00을 반환합니다.

예 1 – 기본 예

예 2 – period_no

예 3 – first_month_of_year

예 4 – 차트 개체 예

예 5 – 시나리오