weekname() 함수는 날짜가 속하는 주를 결정하고 주 수와 해당 주의 연도를 반환합니다. 주의 첫 번째 요일은 FirstWeekDay 시스템 변수에 의해 결정됩니다. 그러나 weekname() 함수의 first_week_day 인수를 사용하여 주의 첫 번째 요일을 변경할 수도 있습니다.
Qlik Sense에서는 앱이 만들어질 때 지역 설정을 가져오고 해당 설정은 스크립트에 환경 변수로 저장됩니다.
북미 앱 개발자는 스크립트에서 종종 분리된 주에 해당하는 Set BrokenWeeks=1;을 가져옵니다. 유럽 앱 개발자는 스크립트에서 종종 분리되지 않은 주에 해당하는 Set BrokenWeeks=0;을 가져옵니다.
응용 프로그램이 분리된 주를 사용하는 경우 주차 계산은 발생한 일 수에 관계없이 1월 1일에 시작하여 FirstWeekDay 시스템 변수 전날에 끝납니다.
그러나 응용 프로그램이 분리되지 않은 주를 사용하는 경우 1주차는 전년도 또는 1월의 처음 며칠에 시작할 수 있습니다. 이는 ReferenceDay 및 FirstWeekDay 시스템 변수를 사용하는 방법에 따라 다릅니다.
Weekname 함수의 예
Date
ISO 주 이름
US 주 이름
Sat 2020 Dec 26
2020/52
2020/52
Sun 2020 Dec 27
2020/52
2020/53
Mon 2020 Dec 28
2020/53
2020/53
Tue 2020 Dec 29
2020/53
2020/53
Wed 2020 Dec 30
2020/53
2020/53
Thu 2020 Dec 31
2020/53
2020/53
Fri 2021 Jan 1
2020/53
2021/01
Sat 2021 Jan 2
2020/53
2021/01
Sun 2021 Jan 3
2020/53
2021/02
Mon 2021 Jan 4
2021/01
2021/02
Tue 2021 Jan 5
2021/01
2021/02
사용 시기
weekname() 함수는 주별로 집계를 비교하려는 경우에 유용합니다.
예를 들어 주별 제품의 총 판매액을 보려는 경우. 응용 프로그램에서 BrokenWeeks 환경 변수와의 일관성을 유지하려면 lunarweekname() 대신 weekname()을 사용합니다. 응용 프로그램이 분리되지 않은 주를 사용하는 경우 1주차는 전년도 12월의 날짜를 포함하거나 현재 연도의 1월 날짜를 제외할 수 있습니다. 응용 프로그램에서 분리된 주를 사용하는 경우 1주차에는 7일 미만이 포함될 수 있습니다.
반환 데이터 유형: dual
인수
인수
설명
timestamp
평가할 날짜 또는 타임스탬프입니다.
period_no
shift는 정수이며, 값 0은 date를 포함하는 주를 나타냅니다. shift가 음수 값일 경우 이전 주, 양수 값일 경우 다음 주를 나타냅니다.
first_week_day
주의 시작 요일을 지정합니다. 생략하면 변수 FirstWeekDay의 값이 사용됩니다.
first_week_day에 가능한 값은 월요일에 0, 화요일에 1, 수요일에 2, 목요일에 3, 금요일에 4, 토요일에 5, 일요일에 6입니다.
reference_day를 지정하지 않으면 ReferenceDay 변수의 값이 1주차를 정의하기 위한 기준일로 설정할 1월 날짜를 정의하는 데 사용됩니다. 기본적으로 Qlik Sense 함수는 4를 기준일로 사용합니다. 이는 1주차에 1월 4일이 포함되어야 한다는 의미입니다. 혹은 달리 말하면 1주차에 항상 1월이 4일 이상이 있어야 합니다.
달리 지정하지 않는 한 이 항목의 예에서는 다음 날짜 형식을 사용합니다. YYYY/MM/DD. 날짜 형식은 데이터 로드 스크립트의 SET DateFormat 문에 지정됩니다. 기본 날짜 형식은 지역 설정 및 기타 요인으로 인해 시스템에서 다를 수 있습니다. 아래 예의 형식을 요구 사항에 맞게 변경할 수 있습니다. 또는 이러한 예와 일치하도록 로드 스크립트의 형식을 변경할 수 있습니다.
앱의 기본 국가별 설정은 Qlik Sense가 설치된 컴퓨터 또는 서버의 국가별 시스템 설정을 기반으로 합니다. 액세스하는 Qlik Sense 서버가 스웨덴으로 설정된 경우 데이터 로드 편집기는 날짜, 시간 및 통화에 대해 스웨덴 지역 설정을 사용합니다. 이러한 국가별 형식 설정은 Qlik Sense 사용자 인터페이스에 표시되는 언어와 관련이 없습니다. Qlik Sense는 사용 중인 브라우저와 동일한 언어로 표시됩니다.
아래의 예는 다음과 같이 가정합니다.
Set FirstWeekDay=0;
Set BrokenWeeks=0;
Set ReferenceDay=4;
함수 예
예
결과
weekname('01/12/2013')
2013/02를 반환합니다.
weekname('01/12/2013', -1)
Returns 2013/01.
weekname('01/12/2013', 0, 1)
2013/02를 반환합니다.
예 1 – 추가 인수가 없는 날짜
개요
데이터 로드 편집기를 열고 아래의 로드 스크립트를 새 탭에 추가합니다.
로드 스크립트에는 다음이 포함됩니다.
'Transactions'라는 테이블에 로드되는 2021년의 마지막 주와 2022년의 처음 2주 동안의 트랜잭션 집합을 포함하는 데이터 집합.
MM/DD/YYYY 서식으로 설정된 DateFormat 시스템 변수.
1으로 설정된 BrokenWeeks 시스템 변수.
6로 설정된 FirstWeekDay 시스템 변수.
다음을 포함하는 선행 LOAD:
'week_number' 필드로 설정된 weekday() 함수. 트랜잭션이 발생한 연도와 주 수를 반환하합니다.
'week_day'라는 필드로 설정된 weekname() 함수. 각 트랜잭션 날짜의 요일 값을 표시합니다.
로드 스크립트
SET BrokenWeeks=1;
SET DateFormat='MM/DD/YYYY';
SET FirstWeekDay=6;
Transactions:
Load
*,
WeekDay(date) as week_day,
Weekname(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
2021/53
8184
12/28/2021
Tue
2021/53
8185
12/29/2021
Wed
2021/53
8186
12/30/2021
Thu
2021/53
8187
12/31/2021
Fri
2021/53
8188
01/01/2022
Sat
2022/01
8189
01/02/2022
Sun
2022/02
8190
01/03/2022
Mon
2022/02
8191
01/04/2022
Tue
2022/02
8192
01/05/2022
Wed
2022/02
8193
01/06/2022
Thu
2022/02
8194
01/07/2022
Fri
2022/02
8195
01/08/2022
Sat
2022/02
8196
01/09/2022
Sun
2022/03
8197
01/10/2022
Mon
2022/03
8198
01/11/2022
Tue
2022/03
8199
01/12/2022
Wed
2022/03
8200
01/13/2022
Thu
2022/03
8201
01/14/2022
Fri
2022/03
’week_number’ 필드는 weekname() 함수를 사용하고 날짜 필드를 함수의 인수로 전달하여 선행 LOAD 문에서 만들어집니다.
weekname() 함수는 처음에 날짜 값이 속하는 주를 식별하고 트랜잭션이 발생한 연도와 주 수 개수를 반환합니다.
FirstWeekDay 시스템 변수는 일요일을 주의 첫 번째 요일로 설정합니다. BrokenWeeks 시스템 변수는 분리된 주를 사용하도록 응용 프로그램을 설정합니다. 즉, 1주차는 1월 1일에 시작됩니다.
1주차는 토요일인 1월 1일에 시작하므로 이 날짜에 발생한 트랜잭션은 값 2022/01(연도 및 주 수)을 반환합니다.
응용 프로그램이 분리된 주를 사용하고 첫 번째 요일이 일요일이기 때문에 1월 2일부터 1월 8일까지 발생한 트랜잭션은 값 2022/02(2022년의 주 수 2)를 반환합니다. 이에 대한 예는 1월 5일에 발생한 트랜잭션 8192이며 'week_number' 필드의 값 2022/02를 반환합니다.
예 2 – period_no
개요
첫 번째 예와 동일한 데이터 집합 및 시나리오가 사용됩니다.
그러나 이 예에서 작업은 트랜잭션이 발생한 이전 연도 및 주 수를 반환하는 필드 'previous_week_number'를 만드는 것입니다.
period_no-1은 weekname() 함수에서 오프셋 인수로 사용되므로 함수는 먼저 트랜잭션이 발생한 주를 식별합니다. 그런 다음 1주일 전을 찾아 해당 주의 첫 번째 밀리초를 식별합니다.
트랜잭션 8192는 2022년 1월 5일에 발생했습니다. weekname() 함수는 1주일 전인 2021년 12월 30일을 찾아 해당 날짜의 주 수와 연도를 반환합니다(2021/53).
예 3 – first_week_day
개요
첫 번째 예와 동일한 데이터 집합 및 시나리오가 사용됩니다.
그러나 이 예에서 회사 정책은 근무 주를 화요일에 시작하는 것입니다.
데이터 로드 편집기를 열고 다음의 로드 스크립트를 새 탭에 추가합니다.
로드 스크립트
SET BrokenWeeks=1;
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
weekday(date) as week_day,
weekname(date,0,1) 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
2021/52
8184
12/28/2021
Tue
2021/53
8185
12/29/2021
Wed
2021/53
8186
12/30/2021
Thu
2021/53
8187
12/31/2021
Fri
2021/53
8188
01/01/2022
Sat
2022/01
8189
01/02/2022
Sun
2022/01
8190
01/03/2022
Mon
2022/01
8191
01/04/2022
Tue
2022/02
8192
01/05/2022
Wed
2022/02
8193
01/06/2022
Thu
2022/02
8194
01/07/2022
Fri
2022/02
8195
01/08/2022
Sat
2022/02
8196
01/09/2022
Sun
2022/02
8197
01/10/2022
Mon
2022/02
8198
01/11/2022
Tue
2022/03
8199
01/12/2022
Wed
2022/03
8200
01/13/2022
Thu
2022/03
8201
01/14/2022
Fri
2022/03
weekname() 함수에서 first_week_date 인수 1을 사용하므로 화요일을 주의 첫 번째 요일로 사용합니다. 따라서 이 함수는 2021년 53주가 12월 28일 화요일에 시작한다고 결정합니다. 그리고 분리된 주를 사용하는 응용 프로그램으로 인해 1주차는 2022년 1월 1일에 시작하여 2022년 1월 3일 월요일의 마지막 밀리초에 끝납니다.
트랜잭션 8192는 2022년 1월 5일에 발생했습니다. 따라서 화요일의 first_week_day 매개 변수를 사용하여 weekname() 함수는 'week_number' 필드의 값 2022/02를 반환합니다.
예 4 – 차트 개체 예
개요
첫 번째 예와 동일한 데이터 집합 및 시나리오가 사용됩니다.
그러나 이 예에서 데이터 집합은 변경되지 않고 응용 프로그램에 로드됩니다. 트랜잭션이 발생한 연도의 주 수를 반환하는 계산은 응용 프로그램의 차트 개체에서 측정값으로 만들어집니다.
'week_number' 필드는 weekname() 함수를 사용하고 함수의 인수로 날짜 필드를 전달하여 차트 개체에서 측정값으로 만들어집니다.
weekname() 함수는 처음에 날짜 값이 속하는 주를 식별하고 트랜잭션이 발생한 연도와 주 수 개수를 반환합니다.
FirstWeekDay 시스템 변수는 일요일을 주의 첫 번째 요일로 설정합니다. BrokenWeeks 시스템 변수는 분리된 주를 사용하도록 응용 프로그램을 설정합니다. 즉, 1주차는 1월 1일에 시작됩니다.
응용 프로그램이 분리된 주를 사용하고 첫 번째 요일이 일요일이기 때문에 1월 2일부터 1월 8일까지 발생한 트랜잭션은 값 2022/02(2022년의 두 번째 주)를 반환합니다. 트랜잭션 8192는 1월 5일에 발생했으며 'week_number' 필드에 대한 값 2022/02를 반환합니다.
예 5 – 시나리오
개요
데이터 로드 편집기를 열고 아래의 로드 스크립트를 새 탭에 추가합니다.
로드 스크립트에는 다음이 포함됩니다.
'Transactions'라는 테이블에 로드되는 2019년의 마지막 주와 2020년의 처음 2주 동안의 트랜잭션 집합을 포함하는 데이터 집합.