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

weekstart - 指令碼與圖表函數

此功能傳回的值相當於包含 date的行事曆週第一天、第一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 DateFormat

語法:  

WeekStart(timestamp [, period_no [, first_week_day ]])

傳回的資料類型: 雙值

weekstart() 函數判定日期落在哪一週。然後以日期格式傳回該週第一毫秒的時間戳記。該週的第一天由 FirstWeekDay 環境變數決定。但是,這可由 weekstart() 函數中的 first_week_day 引數取代。

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

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

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

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

什麼情況下使用

weekstart() 函數通常在使用者想要計算使用一週中已經過的部分時,作為運算式的一部分使用。例如,若使用者想要計算員工目前為止在一週中所賺取的總工資,即可使用此函數。

下列範例假設:

SET FirstWeekDay=0;
函數範例
範例 結果
weekstart('01/12/2013') 傳回 01/07/2013
weekstart('01/12/2013', -1 ) 傳回 11/31/2012
weekstart('01/12/2013', 0, 1) 傳回 01/08/2013

區域設定

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

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

範例:  

若您想要週和週數的 ISO 設定,確認指令碼中有下列內容:

Set DateFormat ='YYYY-MM-DD'; Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; //(use unbroken weeks) Set ReferenceDay =4; // Jan 4th is always in week 1

若您想要 US 設定,確認指令碼中有下列內容:

Set DateFormat ='M/D/YYYY'; Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; //(use broken weeks) Set ReferenceDay =1; // Jan 1st is always in week 1

以上範例從 weekstart() 函數產生下列內容:

Weekstart 函數範例
日期 ISO 週開始 US 週開始
Sat 2020 Dec 26 2020-12-21 12/20/2020
Sun 2020 Dec 27 2020-12-21 12/27/2020
Mon 2020 Dec 28 2020-12-28 12/27/2020
Tue 2020 Dec 29 2020-12-28 12/27/2020
Wed 2020 Dec 30 2020-12-28 12/27/2020
Thu 2020 Dec 31 2020-12-28 12/27/2020
Fri 2021 Jan 1 2020-12-28 12/27/2020
Sat 2021 Jan 2 2020-12-28 12/27/2020
Sun 2021 Jan 3 2020-12-28 1/3/2021
Mon 2021 Jan 4 2021-01-04 1/3/2021
Tue 2021 Jan 5 2021-01-04 1/3/2021
資訊備註在 ISO 欄中,一週在星期一開始,而在 US 欄中,在星期日開始。

範例 1 – 無其他引數

範例 2 – period_no

範例 3 – first_week_day

範例 4 – 圖表物件範例

範例 5 – 情境

此頁面是否對您有幫助?

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