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

앱의 기본 국가별 설정은 Qlik Sense가 설치된 컴퓨터 또는 서버의 국가별 시스템 설정을 기반으로 합니다. 액세스하는 Qlik Sense 서버가 스웨덴으로 설정된 경우 데이터 로드 편집기는 날짜, 시간 및 통화에 대해 스웨덴 지역 설정을 사용합니다. 이러한 국가별 형식 설정은 Qlik Sense 사용자 인터페이스에 표시되는 언어와 관련이 없습니다. Qlik Sense는 사용 중인 브라우저와 동일한 언어로 표시됩니다.

함수 예
예	결과
yearstart('10/19/2001')	Returns 01/01/2001 00:00:00.
yearstart('10/19/2001',-1)	Returns 01/01/2000 00:00:00.
yearstart('10/19/2001',0,4)	Returns 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	date	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	date	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	date	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	date	=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로 나누어 해당 기간의 유효 이자율을 반환합니다. 해당 기간의 유효 이자율에 대출 시작 잔액을 곱하여 올해 지금까지 발생한 이자를 반환합니다.

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

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

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