yearstart - 스크립트 및 차트 함수

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

구문:

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

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

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

yearstart를 사용하는 경우

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

반환 데이터 유형: 이중

인수
인수	설명
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 값
월	값
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 문에 지정됩니다. 기본 날짜 형식은 지역 설정 및 기타 요인으로 인해 시스템에서 다를 수 있습니다. 아래 예의 형식을 요구 사항에 맞게 변경할 수 있습니다. 또는 이러한 예와 일치하도록 로드 스크립트의 형식을 변경할 수 있습니다. 자세한 내용은 앱 및 스크립트에 대한 지역 설정 수정를 참조하십시오.

앱의 기본 지역 설정은 사용자 프로필을 기반으로 합니다. 이러한 국가별 형식 설정은 Qlik Cloud 사용자 인터페이스에 표시되는 언어와 관련이 없습니다. 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 – 기본 예

개요

데이터 로드 편집기를 열고 새 섹션에 아래 로드 스크립트를 추가합니다.

로드 스크립트에는 다음이 포함됩니다.

‘Transactions’라는 테이블에 로드되는 2020년과 2022년 사이의 트랜잭션 집합이 포함된 데이터 집합.
DateFormat 시스템 변수 서식(MM/DD/YYYY)으로 제공된 날짜 필드.
다음을 포함하는 선행 LOAD 문:
- year_start 필드로 설정되는 yearstart() 함수.
- year_start_timestamp 필드로 설정되는 Timestamp() 함수.

로드 스크립트

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
       *, 
       yearstart(date) as year_start, 
       timestamp(yearstart(date)) as year_start_timestamp 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,01/13/2020,37.23 
8189,02/26/2020,17.17 
8190,03/27/2020,88.27 
8191,04/16/2020,57.42 
8192,05/21/2020,53.80 
8193,08/14/2020,82.06 
8194,10/07/2020,40.39 
8195,12/05/2020,87.21 
8196,01/22/2021,95.93 
8197,02/03/2021,45.89 
8198,03/17/2021,36.23 
8199,04/23/2021,25.66 
8200,05/04/2021,82.77 
8201,06/30/2021,69.98 
8202,07/26/2021,76.11
8203,12/27/2021,25.12 
8204,06/06/2022,46.23 
8205,07/18/2022,84.21 
8206,11/14/2022,96.24 
8207,12/12/2022,67.67 
];

결과

데이터를 로드하고 시트를 엽니다. 새 테이블을 만들고 다음 필드를 차원으로 추가합니다.

id
date
year_start
year_start_timestamp

결과 테이블
ID	날짜	year_start	year_start_timestamp
8188	01/13/2020	01/01/2020	1/1/2020 12:00:00 AM
8189	02/26/2020	01/01/2020	1/1/2020 12:00:00 AM
8190	03/27/2020	01/01/2020	1/1/2020 12:00:00 AM
8191	04/16/2020	01/01/2020	1/1/2020 12:00:00 AM
8192	05/21/2020	01/01/2020	1/1/2020 12:00:00 AM
8193	08/14/2020	01/01/2020	1/1/2020 12:00:00 AM
8194	10/07/2020	01/01/2020	1/1/2020 12:00:00 AM
8195	12/05/2020	01/01/2020	1/1/2020 12:00:00 AM
8196	01/22/2021	01/01/2021	1/1/2021 12:00:00 AM
8197	02/03/2021	01/01/2021	1/1/2021 12:00:00 AM
8198	03/17/2021	01/01/2021	1/1/2021 12:00:00 AM
8199	04/23/2021	01/01/2021	1/1/2021 12:00:00 AM
8200	05/04/2021	01/01/2021	1/1/2021 12:00:00 AM
8201	06/30/2021	01/01/2021	1/1/2021 12:00:00 AM
8202	07/26/2021	01/01/2021	1/1/2021 12:00:00 AM
8203	12/27/2021	01/01/2021	1/1/2021 12:00:00 AM
8204	06/06/2022	01/01/2022	1/1/2022 12:00:00 AM
8205	07/18/2022	01/01/2022	1/1/2022 12:00:00 AM
8206	11/14/2022	01/01/2022	1/1/2022 12:00:00 AM
8207	12/12/2022	01/01/2022	1/1/2022 12:00:00 AM

’year_start’ 필드는 yearstart() 함수를 사용하고 날짜 필드를 함수의 인수로 전달하여 선행 LOAD 문에서 만들어집니다.

yearstart() 함수는 날짜 값이 속하는 연도를 처음에 식별하고 해당 연도의 첫 번째 밀리초에 대한 타임스탬프를 반환합니다.

트랜잭션 8199가 4월 23일에 발생했으며 yearstart() 함수가 해당 연도의 시작을 식별함을 보여 주는 다이어그램입니다. — yearstart() 함수 및 트랜잭션 8199의 다이어그램.

트랜잭션 8199는 2021년 4월 23일에 발생했습니다. yearstart() 함수는 해당 연도의 첫 번째 밀리초, 즉 1월 1일 오전 12시를 반환합니다.

예 2 – period_no

개요

첫 번째 예와 동일한 데이터 집합 및 시나리오가 사용됩니다.

그러나 이 예에서 작업은 트랜잭션이 발생한 연도 이전 연도의 시작 날짜 타임스탬프를 반환하는 필드 'previous_year_start'를 만드는 것입니다.

로드 스크립트

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
       *, 
       yearstart(date,-1) as previous_year_start, 
       timestamp(yearstart(date,-1)) as previous_year_start_timestamp 
       ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,01/13/2020,37.23 
8189,02/26/2020,17.17 
8190,03/27/2020,88.27 
8191,04/16/2020,57.42 
8192,05/21/2020,53.80 
8193,08/14/2020,82.06 
8194,10/07/2020,40.39
8195,12/05/2020,87.21 
8196,01/22/2021,95.93 
8197,02/03/2021,45.89 
8198,03/17/2021,36.23 
8199,04/23/2021,25.66 
8200,05/04/2021,82.77 
8201,06/30/2021,69.98 
8202,07/26/2021,76.11 
8203,12/27/2021,25.12
8204,06/06/2022,46.23 
8205,07/18/2022,84.21
8206,11/14/2022,96.24 
8207,12/12/2022,67.67 
];

결과

데이터를 로드하고 시트를 엽니다. 새 테이블을 만들고 다음 필드를 차원으로 추가합니다.

id
date
previous_year_start
previous_ year_start_timestamp

결과 테이블
ID	날짜	previous_year_start	previous_year_start_timestamp
8188	01/13/2020	01/01/2019	1/1/2019 12:00:00 AM
8189	02/26/2020	01/01/2019	1/1/2019 12:00:00 AM
8190	03/27/2020	01/01/2019	1/1/2019 12:00:00 AM
8191	04/16/2020	01/01/2019	1/1/2019 12:00:00 AM
8192	05/21/2020	01/01/2019	1/1/2019 12:00:00 AM
8193	08/14/2020	01/01/2019	1/1/2019 12:00:00 AM
8194	10/07/2020	01/01/2019	1/1/2019 12:00:00 AM
8195	12/05/2020	01/01/2019	1/1/2019 12:00:00 AM
8196	01/22/2021	01/01/2020	1/1/2020 12:00:00 AM
8197	02/03/2021	01/01/2020	1/1/2020 12:00:00 AM
8198	03/17/2021	01/01/2020	1/1/2020 12:00:00 AM
8199	04/23/2021	01/01/2020	1/1/2020 12:00:00 AM
8200	05/04/2021	01/01/2020	1/1/2020 12:00:00 AM
8201	06/30/2021	01/01/2020	1/1/2020 12:00:00 AM
8202	07/26/2021	01/01/2020	1/1/2020 12:00:00 AM
8203	12/27/2021	01/01/2020	1/1/2020 12:00:00 AM
8204	06/06/2022	01/01/2021	1/1/2021 12:00:00 AM
8205	07/18/2022	01/01/2021	1/1/2021 12:00:00 AM
8206	11/14/2022	01/01/2021	1/1/2021 12:00:00 AM
8207	12/12/2022	01/01/2021	1/1/2021 12:00:00 AM

이 경우 period_no -1은 yearstart() 함수에서 오프셋 인수로 사용되므로 함수는 먼저 트랜잭션이 발생한 연도를 식별합니다. 그런 다음 1년 전을 찾아 해당 연도의 첫 번째 밀리초를 식별합니다.

period_no가 음수 1인 yearstart() 함수가 함수의 연도 범위를 1년 뒤로 배치하는 것을 보여 주는 다이어그램입니다. — period_no가 -1인 yearstart() 함수 다이어그램.

트랜잭션 8199는 2021년 4월 23일에 발생했습니다. yearstart() 함수는 'previous_year_start' 필드에 전년도의 첫 번째 밀리초(2020년 1월 1일 오전 12시)를 반환합니다.

예 3 – first_month_of_year

개요

첫 번째 예와 동일한 데이터 집합 및 시나리오가 사용됩니다.

그러나 이 예에서는 회사 정책이 4월 1일부터 시작되는 연도를 기준으로 합니다.

로드 스크립트

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
       *, 
       yearstart(date,0,4) as year_start, 
       timestamp(yearstart(date,0,4)) as year_start_timestamp 
       ; 
Load
* 
Inline  
[
id,date,amount 
8188,01/13/2020,37.23 
8189,02/26/2020,17.17 
8190,03/27/2020,88.27 
8191,04/16/2020,57.42 
8192,05/21/2020,53.80 
8193,08/14/2020,82.06 
8194,10/07/2020,40.39 
8195,12/05/2020,87.21 
8196,01/22/2021,95.93 
8197,02/03/2021,45.89 
8198,03/17/2021,36.23 
8199,04/23/2021,25.66 
8200,05/04/2021,82.77 
8201,06/30/2021,69.98 
8202,07/26/2021,76.11 
8203,12/27/2021,25.12 
8204,06/06/2022,46.23 
8205,07/18/2022,84.21 
8206,11/14/2022,96.24 
8207,12/12/2022,67.67 
];

결과

데이터를 로드하고 시트를 엽니다. 새 테이블을 만들고 다음 필드를 차원으로 추가합니다.

id
date
year_start
year_start_timestamp

결과 테이블
ID	날짜	year_start	year_start_timestamp
8188	01/13/2020	04/01/2019	4/1/2019 12:00:00 AM
8189	02/26/2020	04/01/2019	4/1/2019 12:00:00 AM
8190	03/27/2020	04/01/2019	4/1/2019 12:00:00 AM
8191	04/16/2020	04/01/2020	4/1/2020 12:00:00 AM
8192	05/21/2020	04/01/2020	4/1/2020 12:00:00 AM
8193	08/14/2020	04/01/2020	4/1/2020 12:00:00 AM
8194	10/07/2020	04/01/2020	4/1/2020 12:00:00 AM
8195	12/05/2020	04/01/2020	4/1/2020 12:00:00 AM
8196	01/22/2021	04/01/2020	4/1/2020 12:00:00 AM
8197	02/03/2021	04/01/2020	4/1/2020 12:00:00 AM
8198	03/17/2021	04/01/2020	4/1/2020 12:00:00 AM
8199	04/23/2021	04/01/2021	4/1/2021 12:00:00 AM
8200	05/04/2021	04/01/2021	4/1/2021 12:00:00 AM
8201	06/30/2021	04/01/2021	4/1/2021 12:00:00 AM
8202	07/26/2021	04/01/2021	4/1/2021 12:00:00 AM
8203	12/27/2021	04/01/2021	4/1/2021 12:00:00 AM
8204	06/06/2022	04/01/2022	4/1/2022 12:00:00 AM
8205	07/18/2022	04/01/2022	4/1/2022 12:00:00 AM
8206	11/14/2022	04/01/2022	4/1/2022 12:00:00 AM
8207	12/12/2022	04/01/2022	4/1/2022 12:00:00 AM

이 경우 yearstart() 함수에서 first_month_of_year 인수 4를 사용하므로 해당 연도의 첫 번째 날이 4월 1일로 설정되고 해당 연도의 마지막 날이 3월 31일로 설정됩니다.

연도의 첫 번째 달을 4월로 설정한 yearstart() 함수를 보여 주는 다이어그램입니다. — 4월을 첫 번째 달로 설정한 yearstart() 함수의 다이어그램.

트랜잭션 8199는 2021년 4월 23일에 발생했습니다. yearstart() 함수가 연도의 시작을 4월 1일로 설정하고 이를 트랜잭션의 'year_start' 값으로 반환하기 때문입니다.

예 4 – 차트 개체 예

개요

첫 번째 예와 동일한 데이터 집합 및 시나리오가 사용됩니다.

그러나 이 예에서 데이터 집합은 변경되지 않고 응용 프로그램에 로드됩니다. 트랜잭션이 발생한 연도의 시작 날짜 타임스탬프를 반환하는 계산은 응용 프로그램의 차트 개체에서 측정값으로 만들어집니다.

로드 스크립트

Transactions: 
Load 
*
Inline  
[ 
id,date,amount 
8188,01/13/2020,37.23 
8189,02/26/2020,17.17 
8190,03/27/2020,88.27 
8191,04/16/2020,57.42 
8192,05/21/2020,53.80 
8193,08/14/2020,82.06 
8194,10/07/2020,40.39 
8195,12/05/2020,87.21 
8196,01/22/2021,95.93 
8197,02/03/2021,45.89 
8198,03/17/2021,36.23 
8199,04/23/2021,25.66 
8200,05/04/2021,82.77 
8201,06/30/2021,69.98 
8202,07/26/2021,76.11 
8203,12/27/2021,25.12 
8204,06/06/2022,46.23 
8205,07/18/2022,84.21 
8206,11/14/2022,96.24 
8207,12/12/2022,67.67 
];

결과

데이터를 로드하고 시트를 엽니다. 새 테이블을 만들고 다음 필드를 차원으로 추가합니다.

id
date

트랜잭션이 발생한 연도를 계산하려면 다음 측정값을 만듭니다.

=yearstart(date)
=timestamp(yearstart(date))

결과 테이블
ID	날짜	=yearstart(date)	=timestamp(yearstart(date))
8188	06/06/2022	01/01/2022	1/1/2022 12:00:00 AM
8189	07/18/2022	01/01/2022	1/1/2022 12:00:00 AM
8190	11/14/2022	01/01/2022	1/1/2022 12:00:00 AM
8191	12/12/2022	01/01/2022	1/1/2022 12:00:00 AM
8192	01/22/2021	01/01/2021	1/1/2021 12:00:00 AM
8193	02/03/2021	01/01/2021	1/1/2021 12:00:00 AM
8194	03/17/2021	01/01/2021	1/1/2021 12:00:00 AM
8195	04/23/2021	01/01/2021	1/1/2021 12:00:00 AM
8196	05/04/2021	01/01/2021	1/1/2021 12:00:00 AM
8197	06/30/2021	01/01/2021	1/1/2021 12:00:00 AM
8198	07/26/2021	01/01/2021	1/1/2021 12:00:00 AM
8199	12/27/2021	01/01/2021	1/1/2021 12:00:00 AM
8200	01/13/2020	01/01/2020	1/1/2020 12:00:00 AM
8201	02/26/2020	01/01/2020	1/1/2020 12:00:00 AM
8202	03/27/2020	01/01/2020	1/1/2020 12:00:00 AM
8203	04/16/2020	01/01/2020	1/1/2020 12:00:00 AM
8204	05/21/2020	01/01/2020	1/1/2020 12:00:00 AM
8205	08/14/2020	01/01/2020	1/1/2020 12:00:00 AM
8206	10/07/2020	01/01/2020	1/1/2020 12:00:00 AM
8207	12/05/2020	01/01/2020	1/1/2020 12:00:00 AM

‘start_of_year’ 측정값은 yearstart() 함수를 사용하고 날짜 필드를 함수의 인수로 전달하여 차트 개체에서 만들어집니다.

yearstart() 함수는 날짜 값이 속하는 연도를 처음에 식별하고 해당 연도의 첫 번째 밀리초에 대한 타임스탬프를 반환합니다.

트랜잭션 8199가 발생한 연도와 해당 연도 시작의 타임스탬프를 식별하는 yearstart() 함수를 보여 주는 다이어그램입니다. — yearstart() 함수 및 트랜잭션 8199의 다이어그램.

트랜잭션 8199는 2021년 4월 23일에 발생했습니다. yearstart() 함수는 해당 연도의 첫 번째 밀리초, 즉 1월 1일 오전 12시를 반환합니다.

예 5 – 시나리오

개요

데이터 로드 편집기를 열고 새 섹션에 아래 로드 스크립트를 추가합니다.

로드 스크립트에는 다음이 포함됩니다.

'Loans'라는 테이블에 로드되는 데이터 집합. 테이블에는 다음 필드가 포함됩니다.
- 대출 ID.
- 연초 잔액.
- 연간 각 대출에 부과되는 단순 이자율.

최종 사용자는 해당 연초부터 현재까지 각 대출에 대해 발생한 현재 이자를 대출 ID별로 표시하는 차트 개체를 원합니다.

로드 스크립트

Loans: 
Load 
* 
Inline  
[ 
loan_id,start_balance,rate 
8188,$10000.00,0.024 
8189,$15000.00,0.057 
8190,$17500.00,0.024 
8191,$21000.00,0.034 
8192,$90000.00,0.084 
];

결과

데이터를 로드하고 시트를 엽니다. 새 테이블을 만들고 다음 필드를 차원으로 추가합니다.

loan_id
start_balance

누적 이자를 계산하려면 다음 측정값을 만듭니다.

=start_balance*(rate*(today(1)-yearstart(today(1)))/365)

측정값의 숫자 형식을 화폐로 설정합니다.

결과 테이블
loan_id	start_balance	=start_balance(rate(today(1)-yearstart(today(1)))/365)
8188	$10000.00	$39.73
8189	$15000.00	$339.66
8190	$17500.00	$166.85
8191	$21000.00	$283.64
8192	$90000.00	$3003.29

오늘 날짜를 유일한 인수로 사용하는 yearstart() 함수는 현재 연도의 시작 날짜를 반환합니다. 이 표현식은 현재 날짜에서 해당 결과를 빼서 올해 지금까지 경과한 일 수를 반환합니다.

그런 다음 이 값에 이자율을 곱하고 365로 나누어 해당 기간의 유효 이자율을 반환합니다. 해당 기간의 유효 이자율에 대출 시작 잔액을 곱하여 올해 지금까지 발생한 이자를 반환합니다.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 알려 주십시오!

여기에 피드백을 남겨주십시오.