跳到主要內容 跳至補充內容

weekyear - 指令碼與圖表函數

此函數會根據環境變數傳回週數所屬於的年份。週數的範圍介於 1 和約 52 之間。

語法:  

weekyear(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 週。依照預設,Qlik Sense 函數使用 4 作為參照日。這表示第 1 週必須包含 1 月 4 日,或者換言之,第 1 週必須始終至少在 1 月擁有 4 日。

如需系統變數的更多資訊,請參閱 ReferenceDay

weekyear() 函數判定日期落在一年中的哪一週。然後這會傳回與該週數對應的年份。

BrokenWeeks 設定為 0 (false),weekyear() 將會傳回與 year() 相同的內容。

weekyear() 函數範圍的圖表

顯示 weekyear() 函數評估的時間範圍的圖表。

但是,若 BrokenWeeks 系統變數設為使用未中斷的週,第 1 週只能根據 ReferenceDay 系統變數中指定的值,包含 1 月中的特定天數。

例如,若使用 ReferenceDay 的值 4,第 1 週只能至少包括 1 月中的四天。第 1 週有可能包括前一年 12 月的日期,或是一年最後一週的數字有可能包括下一年 1 月的日期。在此類情況下,weekyear() 函數會傳回 year() 函數的不同值。

使用未中斷的週時,weekyear() 函數範圍的圖表

顯示 weekyear() 函數如何處理未中斷的週的圖表。

若您想要按年份比較彙總,則 weekyear() 函數很實用。例如,若您想要按年份查看產品的總銷售額。若使用者想要在應用程式中保留與 BrokenWeeks 系統變數的一致性,即會選擇 weekyear() 函數,而不是 year()

區域設定

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

應用程式中的預設地區設定是根據安裝 Qlik Sense 之電腦或伺服器的地區系統設定。若您存取的 Qlik Sense 伺服器設定為瑞典,資料載入編輯器將會對日期、時間和貨幣使用瑞典文地區設定。這些地區格式設定與 Qlik Sense 使用者介面中顯示的語言無關。Qlik Sense 顯示的語言將與您正在使用的瀏覽器相同。

函數範例
範例 結果
weekyear('12/30/1996',0,0,4)傳回 1997,因為 1997 年第 1 週開始於 12/30/1996
weekyear('01/02/1997',0,0,4)傳回 1997
weekyear('12/28/1997',0,0,4)傳回 1997
weekyear('12/30/1997',0,0,4) 傳回 1998,因為 1998 年第 1 週開始於 12/29/1997
weekyear('01/02/1999',0,0,4)傳回 1998,因為 1998 年第 53 週結束於 01/03/1999
相關主題
主題 互動
week - 指令碼與圖表函數傳回根據 ISO 8601 代表週數的整數
year - 指令碼與圖表函數當運算式根據標準數字解譯的方式可解譯為日期時,傳回代表年份的整數。

範例 1 - 中斷的週

範例 2 - 未中斷的週

範例 3 – 圖表物件範例

範例 4 – 情境

此頁面是否對您有幫助?

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