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

weekname - 指令碼與圖表函數

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

語法:  

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

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

依照預設,Qlik Sense 應用程式使用中斷的週 (由 BrokenWeeks 系統變數定義),因此週數計數在 1 月 1 日開始,並在 FirstWeekDay 系統變數的前一天結束,無論發生了多少天。

weekname 函數的圖表。

圖表顯示 weekname 函數可用來設定的年和週的範圍。

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

若您想要按週比較彙總,則 weekname() 函數很實用。

例如,若您想要按週查看產品的總銷售額。若要在應用程式中維護與 BrokenWeeks 環境變數的一致性,請使用 weekname() 而非 lunarweekname()。若應用程式正在使用未中斷的週,則第 1 週可能包含上一年 12 月中的日期,或排除目前年份 1 月的日期。若應用程式正在使用中斷的週,則第 1 週的天數可少於七天。

傳回的資料類型: 雙值

引數
引數 描述
date 要評估的時間戳記。
period_no shift 為整數,值 0 表示是包含 date 的週。負值的 shift 表示之前的週,正值表示之後的週。
first_week_day

指定一週開始的日期。如果忽略,將使用變數 FirstWeekDay 的值。

first_week_day 可能的值是對星期一使用 0、對星期二使用 1,對星期三使用 2,對星期四使用 3,對星期五使用 4,對星期六使用 5,並對星期日使用 6。

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

您可以在 first_week_day 引數中使用下列值設定一週開始的日期:

first_week_day 值
星期一 0
星期二 1
星期三 2
星期四 3
星期五 4
星期六 5
星期日 6

區域設定

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

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

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

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

範例 2 – period_no

範例 3 – first_week_day

範例 4 – 圖表物件範例

範例 5 – 情境

此頁面是否對您有幫助?

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