weekname - 指令碼與圖表函數

此函數會傳回顯示年度和週數的值，其基礎數值相當於包含 date 之週的第一天、第一毫秒的時間戳記。

語法：

WeekName(date[, period_no [, first_week_day [, broken_weeks [, reference_day]]]])

weekname() 函數判定日期落在哪一週並傳回週數和該週的年份。該週的第一天由 FirstWeekDay 系統變數決定。不過，您可以使用 weekname() 函數中的 first_week_day 引數變更該週的第一天。

在 Qlik Sense 中，建立應用程式時會擷取地區設定，對應的設定會儲存在指令碼中，作為環境變數。

北美應用程式開發人員通常會在指令碼中取得 Set BrokenWeeks=1;，對應至中斷的週。歐洲應用程式開發人員通常會在指令碼中取得 Set BrokenWeeks=0;，對應至未中斷的週。

若應用程式使用中斷的週，則週數計數在 1 月 1 日開始，並在 FirstWeekDay 系統變數的前一天結束，無論發生了多少天。

不過，若應用程式正在使用未中斷的週，則第 1 週可以在前一年或 1 月的開頭幾天開始。這取決於您如何使用 ReferenceDay 和 FirstWeekDay 系統變數。

Weekname 函數範例
日期	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 環境變數的一致性，請使用 weekname() 而非 lunarweekname()。若應用程式正在使用未中斷的週，則第 1 週可能包含上一年 12 月中的日期，或排除目前年份 1 月的日期。若應用程式正在使用中斷的週，則第 1 週的天數可少於七天。

傳回的資料類型：雙值

引數
引數	描述
timestamp	要評估的時間戳記。
period_no	shift 為整數，值 0 表示是包含 date 的週。負值的 shift 表示之前的週，正值表示之後的週。
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 週。依照預設，Qlik Sense 函數使用 4 作為參照日。這表示第 1 週必須包含 1 月 4 日，或者換言之，第 1 週必須始終至少在 1 月擁有 4 日。如需系統變數的更多資訊，請參閱 ReferenceDay

區域設定

除非另有說明，否則此主題中的範例皆使用下列日期格式：MM/DD/YYYY。日期格式是在資料載入指令碼的 SET DateFormat 陳述式中指定。由於地區設定和其他因素，您系統中的預設日期格式可能會不同。您可以變更以下範例中的格式，以滿足您的需求。或者，您可以在載入指令碼中變更格式，以符合這些範例。如需詳細資訊，請參閱 修改用於應用程式和指令碼的區域設定。

應用程式中的預設地區設定是根據使用者設定檔。這些地區格式設定與 Qlik Cloud 使用者介面中顯示的語言無關。Qlik Cloud 顯示的語言將與您正在使用的瀏覽器相同。

若您是應用程式建立者，可以為您建立的應用程式設定預設地區。如需詳細資訊，請參閱Qlik Cloud 分析中設定用於建立應用程式和指令碼的偏好區域設定。

以下範例假設：

Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;

函數範例
範例	結果
weekname('01/12/2013')	傳回 2013/02。
weekname('01/12/2013', -1)	傳回 2013/01。
weekname('01/12/2013', 0, 1)	傳回 2013/02。

範例 1 – 無其他引數的日期

概覽

開啟資料載入編輯器並將下面的載入指令碼新增至新的索引標籤。

載入指令碼包含：

包含一組 2021 年最後一週和 2022 年前兩週交易的資料集，這載入到稱為「Transactions」的表格中。
設定為 MM/DD/YYYY 格式的 DateFormat 系統變數。
設定為 1 的 BrokenWeeks 系統變數。
設定為 6 的 FirstWeekDay 系統變數。
前置載入包含下列內容：
- 設定為欄位「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	日期	week_day	week_number
8183	12/27/2021	星期一	2021/53
8184	12/28/2021	星期二	2021/53
8185	12/29/2021	星期三	2021/53
8186	12/30/2021	星期四	2021/53
8187	12/31/2021	星期五	2021/53
8188	01/01/2022	星期六	2022/01
8189	01/02/2022	星期日	2022/02
8190	01/03/2022	星期一	2022/02
8191	01/04/2022	星期二	2022/02
8192	01/05/2022	星期三	2022/02
8193	01/06/2022	星期四	2022/02
8194	01/07/2022	星期五	2022/02
8195	01/08/2022	星期六	2022/02
8196	01/09/2022	星期日	2022/03
8197	01/10/2022	星期一	2022/03
8198	01/11/2022	星期二	2022/03
8199	01/12/2022	星期三	2022/03
8200	01/13/2022	星期四	2022/03
8201	01/14/2022	星期五	2022/03

「week_number」欄位在前置 LOAD 陳述式中的建立方式是使用 weekname() 函數並傳遞日期欄位，作為函數的引數。

weekname() 函數最初識別日期值落在哪一週並傳回交易發生的週數計數和年份。

FirstWeekDay 系統變數將星期日設為該週的第一天。BrokenWeeks 系統變數設定應用程式以使用中斷的週，表示第 1 週將從 1 月 1 日開始。

圖表顯示 weekname() 函數如何識別交易發生的週數和年份。 — 具有預設變數的 weekname() 函數圖表。

第 1 週從 1 月 1 日開始，這天是星期六，因此發生在此日期的交易會傳回值 2022/01 (年份和週數)。

圖表顯示 weekname() 函數如何識別交易 8192 發生的週數。 — weekname() 函數的圖表識別交易 8192 的週數。

因為應用程式使用中斷的週且一週的第一天是星期日，所以從 1 月 2 日到 1 月 8 日發生的交易會傳回值 2022/02 (2022 年第 2 週)。這種情況的範例會是發生在 1 月 5 日的交易 8192 並傳回「week_number」欄位的值 2022/02。

範例 2 – period_no

概覽

使用與第一個範例相同的資料集和情境。

不過，在此範例中，任務是要建立欄位「previous_week_number」，這傳回交易發生之前的年份和週數。

開啟資料載入編輯器並將以下載入指令碼新增至新的索引標籤。

載入指令碼

SET BrokenWeeks=1; 
SET FirstWeekDay=6; 
						
Transactions: 
   Load 
     *, 
     weekname(date,-1) as previous_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	日期	week_day	week_number
8183	12/27/2021	星期一	2021/52
8184	12/28/2021	星期二	2021/52
8185	12/29/2021	星期三	2021/52
8186	12/30/2021	星期四	2021/52
8187	12/31/2021	星期五	2021/52
8188	01/01/2022	星期六	2021/52
8189	01/02/2022	星期日	2021/53
8190	01/03/2022	星期一	2021/53
8191	01/04/2022	星期二	2021/53
8192	01/05/2022	星期三	2021/53
8193	01/06/2022	星期四	2021/53
8194	01/07/2022	星期五	2021/53
8195	01/08/2022	星期六	2022/01
8196	01/09/2022	星期日	2022/02
8197	01/10/2022	星期一	2022/02
8198	01/11/2022	星期二	2022/02
8199	01/12/2022	星期三	2022/02
8200	01/13/2022	星期四	2022/02
8201	01/14/2022	星期五	2022/02

因為 period_no 的值 -1 作為 weekname() 函數中的偏移引數使用，所以該函數首先會識別交易發生的週。然後這會查看前一週並識別該週的第一毫秒。

圖表顯示 period_no 負數偏移如何讓 weekname() 函數擷取上一週的週數。 — 具有 period_no 偏移值 -1 的 weekname() 函數圖表。

交易 8192 發生在 2022 年 1 月 5 日。weekname() 函數查看前一週，即 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	日期	week_day	week_number
8183	12/27/2021	星期一	2021/52
8184	12/28/2021	星期二	2021/53
8185	12/29/2021	星期三	2021/53
8186	12/30/2021	星期四	2021/53
8187	12/31/2021	星期五	2021/53
8188	01/01/2022	星期六	2022/01
8189	01/02/2022	星期日	2022/01
8190	01/03/2022	星期一	2022/01
8191	01/04/2022	星期二	2022/02
8192	01/05/2022	星期三	2022/02
8193	01/06/2022	星期四	2022/02
8194	01/07/2022	星期五	2022/02
8195	01/08/2022	星期六	2022/02
8196	01/09/2022	星期日	2022/02
8197	01/10/2022	星期一	2022/02
8198	01/11/2022	星期二	2022/03
8199	01/12/2022	星期三	2022/03
8200	01/13/2022	星期四	2022/03
8201	01/14/2022	星期五	2022/03

圖表顯示當星期二設定為一週的第一天時，weekname() 函數如何運作。 — weekname() 函數圖表以星期二作為該週的第一天。

因為 1 的 first_week_date 引數用於 weekname() 函數，所以這使用星期二作為該週的第一天。因此該函數判定 2021 年的第 53 週從 12 月 28 日星期二開始；此外，由於應用程式使用中斷的週，第 1 週於 2022 年 1 月 1 日開始，並於 2022 年 1 月 3 日星期一的最後一毫秒結束。

圖表顯示將星期二設定為該週的第一天如何讓 weekname() 函數為交易 8192 傳回不同的週數。 — 圖表顯示交易 8192 的週數並以星期二作為一週的第一天。

交易 8192 發生在 2022 年 1 月 5 日。因此，使用星期二的 first_week_day 參數，weekname() 函數會傳回「week_number」欄位的值 2022/02。

範例 4 – 圖表物件範例

概覽

使用與第一個範例相同的資料集和情境。

不過，在此範例中，資料集保持不變並且會載入到應用程式中。會建立傳回交易發生週數年份的計算，作為應用程式圖表物件中的量值。

載入指令碼

SET BrokenWeeks=1; 
Transactions: 
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 (date)

若要計算交易發生的該週開始時間，建立下列量值：

=weekname(date)

結果表格
id	日期	=weekday(date)	=weekname(date)
8183	12/27/2021	星期一	2021/53
8184	12/28/2021	星期二	2021/53
8185	12/29/2021	星期三	2021/53
8186	12/30/2021	星期四	2021/53
8187	12/31/2021	星期五	2021/53
8188	01/01/2022	星期六	2022/01
8189	01/02/2022	星期日	2022/02
8190	01/03/2022	星期一	2022/02
8191	01/04/2022	星期二	2022/02
8192	01/05/2022	星期三	2022/02
8193	01/06/2022	星期四	2022/02
8194	01/07/2022	星期五	2022/02
8195	01/08/2022	星期六	2022/02
8196	01/09/2022	星期日	2022/03
8197	01/10/2022	星期一	2022/03
8198	01/11/2022	星期二	2022/03
8199	01/12/2022	星期三	2022/03
8200	01/13/2022	星期四	2022/03
8201	01/14/2022	星期五	2022/03

「week_number」欄位在圖表物件中的建立為量值方式是使用 weekname() 函數並傳遞日期欄位，作為函數的引數。

weekname() 函數最初識別日期值落在哪一週並傳回交易發生的週數計數和年份。

FirstWeekDay 系統變數將星期日設為該週的第一天。BrokenWeeks 系統變數設定應用程式以使用中斷的週，表示第 1 週從 1 月 1 日開始。

圖表顯示第 1 週從 1 月 1 月開始，並以星期日作為該週的第一天。 — 圖表顯示以星期日作為該週第一天的週數。

因為應用程式使用中斷的週且一週的第一天是星期日，所以從 1 月 2 日到 1 月 8 日發生的交易會傳回值 2022/02，即 2022 年第 2 週。請注意，交易 8192 發生在 1 月 5 日並為「week_number」欄位傳回值 2022/02。

範例 5 – 情境

概覽

開啟資料載入編輯器並將下面的載入指令碼新增至新的索引標籤。

載入指令碼包含：

包含一組 2019 年最後一週和 2020 年前兩週交易的資料集，這載入到稱為「Transactions」的表格中。
設定為 0 的 BrokenWeeks 系統變數。
設定為 2 的 ReferenceDay 系統變數。
設定為 MM/DD/YYYY 格式的 DateFormat 系統變數。

載入指令碼

SET BrokenWeeks=0;  
SET ReferenceDay=2;  
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 
];

結果

載入資料並開啟工作表。建立新的表格。

使用下列運算式建立計算維度：

=weekname(date)

若要計算總銷售額，建立下列彙總量值：

=sum(amount)

將量值的數字格式設定為金錢。

結果表格
weekname(date)	=sum(amount)
2019/52	$125.69
2020/01	$346.51
2020/02	$347.57
2020/03	$122.01

若要展示在此情境下使用 weekname() 函數的結果，新增下列欄位作為維度：

date

具有日期欄位的結果表格
weekname(date)	日期	=sum(amount)
2019/52	12/27/2019	$58.27
2019/52	12/28/2019	$67.42
2020/01	12/29/2019	$23.80
2020/01	12/30/2019	$82.06
2020/01	12/31/2019	$40.56
2020/01	01/01/2020	$37.23
2020/01	01/02/2020	$17.17
2020/01	01/03/2020	$88.27
2020/01	01/04/2020	$57.42
2020/02	01/05/2020	$53.80
2020/02	01/06/2020	$82.06
2020/02	01/07/2020	$40.56
2020/02	01/08/2020	$53.67
2020/02	01/09/2020	$26.63
2020/02	01/10/2020	$72.48
2020/02	01/11/2020	$18.37
2020/03	01/12/2020	$45.26
2020/03	01/13/2020	$58.23
2020/03	01/14/2020	$18.52

因為應用程式使用中斷的週，且由於 ReferenceDay 系統變數，第 1 週需要至少有兩天落在 1 月，因此 2020 年第 1 週包括從 2019 年 12 月 29 日起的交易。

此頁面是否對您有幫助？

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們可以如何改善！

在此留下意見回饋