week - 스크립트 및 차트 함수

이 함수는 입력한 날짜에 해당하는 주차를 나타내는 정수를 반환합니다.

구문:

week(timestamp [, first_week_day [, broken_weeks [, reference_day]]])

반환 데이터 유형: 정수

인수
인수	설명
timestamp	평가할 날짜 또는 타임스탬프입니다.
first_week_day	주의 시작 요일을 지정합니다. 생략하면 변수 FirstWeekDay의 값이 사용됩니다. first_week_day에 가능한 값은 월요일에 0, 화요일에 1, 수요일에 2, 목요일에 3, 금요일에 4, 토요일에 5, 일요일에 6입니다. 시스템 변수에 대한 자세한 내용은 FirstWeekDay를 참조하십시오.
broken_weeks	broken_weeks를 지정하지 않으면 BrokenWeeks 변수의 값이 주를 분리할지 여부를 정의하는 데 사용됩니다. 시스템 변수에 대한 자세한 내용은 BrokenWeeks를 참조하십시오.
reference_day	reference_day를 지정하지 않으면 ReferenceDay 변수의 값이 1주차를 정의하기 위한 기준일로 설정할 1월 날짜를 정의하는 데 사용됩니다. 기본적으로 Qlik Sense 함수는 4를 기준일로 사용합니다. 이는 1주차에 1월 4일이 포함되어야 한다는 의미입니다. 혹은 달리 말하면 1주차에 항상 1월이 4일 이상이 있어야 합니다. 시스템 변수에 대한 자세한 내용은 ReferenceDay를 참조하십시오.

week() 함수는 날짜가 속하는 주를 확인하고 주차를 반환합니다.

Qlik Sense에서는 앱이 만들어질 때 지역 설정을 가져오고 해당 설정은 스크립트에 환경 변수로 저장됩니다. 이들은 주차를 확인하는 데 사용됩니다.

따라서 대부분의 유럽 앱 개발자는 ISO 8601 정의에 해당하는 다음과 같은 환경 변수를 얻습니다.

Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; // Use unbroken weeks Set ReferenceDay =4; // Jan 4th is always in week 1

북미 앱 개발자는 종종 다음과 같은 환경 변수를 얻습니다.

Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; // Use broken weeks Set ReferenceDay =1; // Jan 1st is always in week 1

주의 첫 번째 요일은 FirstWeekDay 시스템 변수에 의해 결정됩니다. week() 함수의 first_week_day 인수를 사용하여 주의 첫 번째 요일을 변경할 수도 있습니다.

응용 프로그램이 분리된 주를 사용하는 경우 주차 계산은 발생한 일 수에 관계없이 1월 1일에 시작하여 FirstWeekDay 시스템 변수 이전 날에 끝납니다.

응용 프로그램이 분리되지 않은 주를 사용하는 경우 1주는 전년도 또는 1월의 처음 며칠에 시작할 수 있습니다. 이는 FirstWeekDay 및 ReferenceDay 환경 변수의 사용 방법에 따라 다릅니다.

사용 시기

The week() 함수는 주별로 집계를 비교하려는 경우에 유용합니다. 예를 들어, 주별 제품의 총 판매량을 보고 싶을 때 사용할 수 있습니다. 사용자가 응용 프로그램의 BrokenWeeks, FirstWeekDay 또는 ReferenceDay 시스템 변수를 사용하지 않아도 되는 계산을 원할 때 weekname()보다 week() 함수를 선택합니다.

예를 들어 주별 제품의 총 판매액을 보려는 경우.

응용 프로그램이 분리되지 않은 주를 사용하는 경우 1주차는 전년도 12월의 날짜를 포함하거나 현재 연도의 1월 날짜를 제외할 수 있습니다. 응용 프로그램에서 분리된 주를 사용하는 경우 1주차에는 7일 미만이 포함될 수 있습니다.

국가별 설정

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

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

앱 작성자인 경우 만든 앱의 기본 지역을 설정할 수 있습니다. 자세한 내용은 Qlik Cloud 분석에서 앱 및 스크립트 만들기를 위한 기본 지역 설정 지정을 참조하십시오.

아래의 예는 다음과 같이 가정합니다.

Set DateFormat= 'MM/DD/YYYY'; Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;

함수 예
예	결과
week('12/28/2021')	52를 반환합니다.
week(44614)	8을 반환합니다(02/22/2022에 대한 일련 번호임).
week('01/03/2021')	53을 반환합니다.
week('01/03/2021',6)	1을 반환합니다.

예 1 - 기본 시스템 변수

개요

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

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

2021년의 마지막 주와 2022년의 처음 2주 동안의 트랜잭션 집합이 포함된 데이터 집합이며, Transactions라는 테이블에 로드됩니다.
DateFormat 시스템 변수(MM/DD/YYYY) 서식으로 제공된 날짜 필드.
트랜잭션이 발생한 연도 및 주차를 반환하는 필드 week_number 만들기.
각 트랜잭션 날짜의 요일 값을 표시하는 week_day라는 필드 만들기.

로드 스크립트

SET DateFormat='MM/DD/YYYY';
SET FirstWeekDay=6;
SET BrokenWeeks=1;
SET ReferenceDay=0;

Transactions:
    Load
        *,
        WeekDay(date) as week_day,
        Week(date) as week_number
        ;
Load
*
Inline 
[
id,date,amount
8183,12/27/2021,58.27
8184,12/28/2021,67.42
8185,12/29/2021,23.80
8186,12/30/2021,82.06
8187,12/31/2021,40.56
8188,01/01/2022,37.23
8189,01/02/2022,17.17
8190,01/03/2022,88.27
8191,01/04/2022,57.42
8192,01/05/2022,53.80
8193,01/06/2022,82.06
8194,01/07/2022,40.56
8195,01/08/2022,53.67
8196,01/09/2022,26.63
8197,01/10/2022,72.48
8198,01/11/2022,18.37
8199,01/12/2022,45.26
8200,01/13/2022,58.23
8201,01/14/2022,18.52
];

결과

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

id
date
week_day
week_number

결과 테이블
id	date	week_day	week_number
8183	12/27/2021	Mon	53
8184	12/28/2021	Tue	53
8185	12/29/2021	Wed	53
8186	12/30/2021	Thu	53
8187	12/31/2021	Fri	53
8188	01/01/2022	Sat	1
8189	01/02/2022	Sun	2
8190	01/03/2022	Mon	2
8191	01/04/2022	Tue	2
8192	01/05/2022	Wed	2
8193	01/06/2022	Thu	2
8194	01/07/2022	Fri	2
8195	01/08/2022	Sat	2
8196	01/09/2022	Sun	3
8197	01/10/2022	Mon	3
8198	01/11/2022	Tue	3
8199	01/12/2022	Wed	3
8200	01/13/2022	Thu	3
8201	01/14/2022	Fri	3

week_number 필드는 week() 함수를 사용하고 date 필드를 함수의 인수로 전달하여 선행 LOAD 문에서 만들어집니다.

다른 매개 변수는 함수에 전달되지 않으므로 week() 함수에 영향을 미치는 다음 기본 변수가 적용됩니다.

BrokenWeeks: 주 계산은 1월 1일에 시작됨
FirstWeekDay: 한 주의 첫날은 일요일

주 함수가 날짜를 해당 주차로 나누는 방법을 보여 주는 다이어그램입니다. — 기본 시스템 변수를 사용하는 week() 함수의 다이어그램

응용 프로그램이 기본 BrokenWeeks 시스템 변수를 사용하기 때문에 1주차는 토요일인 1월 1일에 시작됩니다.

기본 FirstWeekDay 시스템 변수로 인해 주는 일요일에 시작됩니다. 1월 1일 이후의 첫 번째 일요일은 2주차가 시작되는 1월 2일에 발생합니다.

예 2 – first_week_day

개요

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

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

트랜잭션이 발생한 연도 및 주차를 반환하는 필드 week_number 만들기.
각 트랜잭션 날짜의 요일 값을 표시하는 week_day라는 필드 만들기.

이 예에서는 근무 주의 시작을 화요일로 설정하려고 합니다.

로드 스크립트

SET DateFormat='MM/DD/YYYY';
SET FirstWeekDay=6;
SET BrokenWeeks=1;
SET ReferenceDay=0;

Transactions:
    Load
        *,
        WeekDay(date) as week_day,
        Week(date,1) as week_number
        ;
Load
*
Inline 
[
id,date,amount
8183,12/27/2022,58.27
8184,12/28/2022,67.42
8185,12/29/2022,23.80
8186,12/30/2022,82.06
8187,12/31/2021,40.56
8188,01/01/2022,37.23
8189,01/02/2022,17.17
8190,01/03/2022,88.27
8191,01/04/2022,57.42
8192,01/05/2022,53.80
8193,01/06/2022,82.06
8194,01/07/2022,40.56
8195,01/08/2022,53.67
8196,01/09/2022,26.63
8197,01/10/2022,72.48
8198,01/11/2022,18.37
8199,01/12/2022,45.26
8200,01/13/2022,58.23
8201,01/14/2022,18.52
];

결과

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

id
date
week_day
week_number

결과 테이블
id	date	week_day	week_number
8183	12/27/2021	Mon	52
8184	12/28/2021	Tue	53
8185	12/29/2021	Wed	53
8186	12/30/2021	Thu	53
8187	12/31/2021	Fri	53
8188	01/01/2022	Sat	1
8189	01/02/2022	Sun	1
8190	01/03/2022	Mon	1
8191	01/04/2022	Tue	2
8192	01/05/2022	Wed	2
8193	01/06/2022	Thu	2
8194	01/07/2022	Fri	2
8195	01/08/2022	Sat	2
8196	01/09/2022	Sun	2
8197	01/10/2022	Mon	2
8198	01/11/2022	Tue	3
8199	01/12/2022	Wed	3
8200	01/13/2022	Thu	3
8201	01/14/2022	Fri	3

응용 프로그램은 여전히 분리된 주를 사용하고 있습니다. 그러나 first_week_day 인수는 week() 함수에서 1로 설정되었습니다. 이렇게 하면 주의 첫 번째 요일이 화요일로 설정됩니다.

응용 프로그램은 기본 BrokenWeeks 시스템 변수를 사용하므로 1주차는 토요일인 1월 1일에 시작됩니다.

week() 함수의 first_week_day 인수는 첫 번째 요일을 화요일로 설정합니다. 따라서 53주차는 2021년 12월 28일에 시작됩니다.

그러나 이 함수가 여전히 분리된 주를 사용하므로 1월 1일 이후의 첫 번째 화요일이 1월 3일이기 때문에 1주차는 2일만 됩니다.

예 3 – unbroken_weeks

개요

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

이 로드 스크립트에는 첫 번째 예와 동일한 데이터 집합 및 시나리오가 포함되어 있습니다.

이 예에서는 분리되지 않은 주를 사용합니다.

로드 스크립트

SET DateFormat='MM/DD/YYYY';
SET FirstWeekDay=6;
SET BrokenWeeks=1;
SET ReferenceDay=0;

Transactions:
    Load
        *,
        WeekDay(date) as week_day,
        Week(date,6,0) as week_number
        ;
Load
*
Inline 
[
id,date,amount
8183,12/27/2022,58.27
8184,12/28/2022,67.42
8185,12/29/2022,23.80
8186,12/30/2022,82.06
8187,12/31/2021,40.56
8188,01/01/2022,37.23
8189,01/02/2022,17.17
8190,01/03/2022,88.27
8191,01/04/2022,57.42
8192,01/05/2022,53.80
8193,01/06/2022,82.06
8194,01/07/2022,40.56
8195,01/08/2022,53.67
8196,01/09/2022,26.63
8197,01/10/2022,72.48
8198,01/11/2022,18.37
8199,01/12/2022,45.26
8200,01/13/2022,58.23
8201,01/14/2022,18.52
];

결과

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

id
date
week_day
week_number

여기에 대체 텍스트를 추가하세요........!!!!!! — week() 함수의 다이어그램, 차트 개체 예

결과 테이블
id	date	week_day	week_number
8183	12/27/2021	Mon	52
8184	12/28/2021	Tue	52
8185	12/29/2021	Wed	52
8186	12/30/2021	Thu	52
8187	12/31/2021	Fri	52
8188	01/01/2022	Sat	52
8189	01/02/2022	Sun	1
8190	01/03/2022	Mon	1
8191	01/04/2022	Tue	1
8192	01/05/2022	Wed	1
8193	01/06/2022	Thu	1
8194	01/07/2022	Fri	1
8195	01/08/2022	Sat	1
8196	01/09/2022	Sun	2
8197	01/10/2022	Mon	2
8198	01/11/2022	Tue	2
8199	01/12/2022	Wed	2
8200	01/13/2022	Thu	2
8201	01/14/2022	Fri	2

first_week_date 매개 변수는 1로 설정되어 화요일을 주의 첫 번째 요일로 만듭니다. broken_weeks 매개 변수는 0으로 설정하여 이 함수가 분리되지 않은 주를 사용하도록 합니다. 마지막으로 세 번째 매개 변수는 reference_day를 2로 설정합니다.

first_week_date 매개 변수는 6으로 설정되어 일요일을 주의 첫 번째 요일로 만듭니다. broken_weeks 매개 변수는 0으로 설정되어 이 함수가 분리되지 않은 주를 사용하도록 합니다.

분리되지 않은 주를 사용하면 1주차가 반드시 1월 1일에 시작되는 것은 아닙니다. 대신 최소 4일이 필요합니다. 따라서 데이터 집합에서 52주차는 2022년 1월 1일 토요일에 끝납니다. 그런 다음 1주차는 FirstWeekDay 시스템 변수에서 시작되며 이는 1월 2일 일요일입니다. 이번 주는 다음 1월 8일 토요일에 종료됩니다.

예 4 – reference_day

개요

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

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

세 번째 예와 동일한 데이터 집합 및 시나리오.
트랜잭션이 발생한 연도 및 주차를 반환하는 필드 week_number 만들기.
각 트랜잭션 날짜의 요일 값을 표시하는 week_day라는 필드 만들기.

또한 다음 조건을 충족해야 합니다.

근무 주가 화요일에 시작됩니다.
회사는 분리되지 않은 주를 사용합니다.
reference_day 값은 2입니다. 즉, 1주차의 1월 최소 일수는 2입니다.

로드 스크립트

SET DateFormat='MM/DD/YYYY';
SET FirstWeekDay=6;
SET BrokenWeeks=1;
SET ReferenceDay=0;

Transactions:
    Load
        *,
        WeekDay(date) as week_day,
        Week(date,1,0,2) as week_number
        ;
Load
*
Inline 
[
id,date,amount
8183,12/27/2022,58.27
8184,12/28/2022,67.42
8185,12/29/2022,23.80
8186,12/30/2022,82.06
8187,12/31/2021,40.56
8188,01/01/2022,37.23
8189,01/02/2022,17.17
8190,01/03/2022,88.27
8191,01/04/2022,57.42
8192,01/05/2022,53.80
8193,01/06/2022,82.06
8194,01/07/2022,40.56
8195,01/08/2022,53.67
8196,01/09/2022,26.63
8197,01/10/2022,72.48
8198,01/11/2022,18.37
8199,01/12/2022,45.26
8200,01/13/2022,58.23
8201,01/14/2022,18.52
];

결과

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

id
date
week_day
week_number

결과 테이블
id	date	week_day	week_number
8183	12/27/2021	Mon	52
8184	12/28/2021	Tue	1
8185	12/29/2021	Wed	1
8186	12/30/2021	Thu	1
8187	12/31/2021	Fri	1
8188	01/01/2022	Sat	1
8189	01/02/2022	Sun	1
8190	01/03/2022	Mon	1
8191	01/04/2022	Tue	2
8192	01/05/2022	Wed	2
8193	01/06/2022	Thu	2
8194	01/07/2022	Fri	2
8195	01/08/2022	Sat	2
8196	01/09/2022	Sun	2
8197	01/10/2022	Mon	2
8198	01/11/2022	Tue	3
8199	01/12/2022	Wed	3
8200	01/13/2022	Thu	3
8201	01/14/2022	Fri	3

first_week_date 매개 변수는 1로 설정되어 화요일을 주의 첫 번째 요일로 만듭니다. broken_weeks 매개 변수는 0으로 설정되어 이 함수가 분리되지 않은 주를 사용하도록 합니다. 마지막으로 세 번째 매개 변수는 reference_day 매개 변수를 2로 설정합니다.

이 함수에서 분리되지 않은 주를 사용하고 reference_day 값 2를 매개 변수로 사용하는 경우 1주차는 1월의 2일만 포함하면 됩니다. 첫 번째 날이 화요일이므로 1주차는 2021년 12월 28일에 시작하여 2022년 1월 3일 월요일에 끝납니다.

예 5 – 차트 개체 예

개요

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

이 로드 스크립트에는 첫 번째 예와 동일한 데이터 집합 및 시나리오가 포함되어 있습니다.

그러나 이 예에서는 변경되지 않은 데이터 집합이 응용 프로그램에 로드됩니다. 주차를 반환하는 계산은 차트 개체에서 측정값으로 만들어집니다.

로드 스크립트

Transactions:
Load
*
Inline 
[
id,date,amount
8183,12/27/2022,58.27
8184,12/28/2022,67.42
8185,12/29/2022,23.80
8186,12/30/2022,82.06
8187,12/31/2021,40.56
8188,01/01/2022,37.23
8189,01/02/2022,17.17
8190,01/03/2022,88.27
8191,01/04/2022,57.42
8192,01/05/2022,53.80
8193,01/06/2022,82.06
8194,01/07/2022,40.56
8195,01/08/2022,53.67
8196,01/09/2022,26.63
8197,01/10/2022,72.48
8198,01/11/2022,18.37
8199,01/12/2022,45.26
8200,01/13/2022,58.23
8201,01/14/2022,18.52
];

결과

다음과 같이 하십시오.

데이터를 로드하고 시트를 엽니다. 새 테이블을 만듭니다.
다음 필드를 차원으로 추가합니다.
- id
- date
다음으로 다음 측정값을 만듭니다.

=week (date)
각 트랜잭션 날짜의 요일 값을 표시하는 측정값, week_day를 만듭니다.

=weekday(date)

결과 테이블
id	date	=week(date)	=weekday(date)
8183	12/27/2021	53	Mon
8184	12/28/2021	53	Tue
8185	12/29/2021	53	Wed
8186	12/30/2021	53	Thu
8187	12/31/2021	53	Fri
8188	01/01/2022	1	Sat
8189	01/02/2022	2	Sun
8190	01/03/2022	2	Mon
8191	01/04/2022	2	Tue
8192	01/05/2022	2	Wed
8193	01/06/2022	2	Thu
8194	01/07/2022	2	Fri
8195	01/08/2022	2	Sat
8196	01/09/2022	3	Sun
8197	01/10/2022	3	Mon
8198	01/11/2022	3	Tue
8199	01/12/2022	3	Wed
8200	01/13/2022	3	Thu
8201	01/14/2022	3	Fri

week_number 필드는 week() 함수를 사용하고 date 필드를 함수의 인수로 전달하여 선행 LOAD 문에서 만들어집니다.

다른 매개 변수는 함수에 전달되지 않으므로 week() 함수에 영향을 미치는 다음 기본 변수가 적용됩니다.

BrokenWeeks: 주 계산은 1월 1일에 시작됨
FirstWeekDay: 한 주의 첫날은 일요일

응용 프로그램이 기본 BrokenWeeks 시스템 변수를 사용하기 때문에 1주차는 토요일인 1월 1일에 시작됩니다.

기본 FirstWeekDay 시스템 변수로 인해 주는 일요일에 시작됩니다. 1월 1일 이후의 첫 번째 일요일은 2주차가 시작되는 1월 2일에 발생합니다.

예 6 – 시나리오

개요

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

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

Transactions라는 테이블에 로드되는 2019년의 마지막 주와 2020년의 처음 2주 동안의 트랜잭션 집합을 포함하는 데이터 집합.
DateFormat 시스템 변수(MM/DD/YYYY) 서식으로 제공된 날짜 필드.

응용 프로그램은 주로 대시보드에서 분리된 주를 사용합니다. 그러나 최종 사용자는 분리되지 않은 주를 사용하여 주별 총 판매를 표시하는 차트 개체를 원합니다. 기준일은 1월 2일이어야 하며 주는 화요일에 시작해야 합니다. 데이터 모델에서 이 차원을 사용할 수 없는 경우에도 week() 함수를 차트에서 계산된 차원으로 사용하여 이를 달성할 수 있습니다.

로드 스크립트

SET BrokenWeeks=1;
SET ReferenceDay=0;
SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*
Inline 
[
id,date,amount
8183,12/27/2019,58.27
8184,12/28/2019,67.42
8185,12/29/2019,23.80
8186,12/30/2019,82.06
8187,12/31/2019,40.56
8188,01/01/2020,37.23
8189,01/02/2020,17.17
8190,01/03/2020,88.27
8191,01/04/2020,57.42
8192,01/05/2020,53.80
8193,01/06/2020,82.06
8194,01/07/2020,40.56
8195,01/08/2020,53.67
8196,01/09/2020,26.63
8197,01/10/2020,72.48
8198,01/11/2020,18.37
8199,01/12/2020,45.26
8200,01/13/2020,58.23
8201,01/14/2020,18.52
];

결과

다음과 같이 하십시오.

데이터를 로드하고 시트를 엽니다. 새 테이블을 만듭니다.
다음 계산된 차원을 만듭니다.

=week(date)
다음으로, 다음 집계 측정값을 만듭니다.

=sum(amount)
측정값의 숫자 형식을 화폐로 설정합니다.
정렬 메뉴를 선택하고 계산된 차원에 대해 사용자 지정 정렬을 제거합니다.
숫자순 정렬 및 사전순 정렬 옵션을 선택 취소합니다.

결과 테이블
week(date)	sum(amount)
52	$125.69
53	$146.42
1	$200.09
2	$347.57
3	$122.01

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

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

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