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

weekend - 指令碼與圖表函數

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

語法:  

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

傳回的資料類型: 雙值

weekend() 函數判定日期落在哪一週。然後以日期格式傳回該週最後一毫秒的時間戳記。該週的第一天由 FirstWeekDay 環境變數決定。但是,這可由 weekend() 函數中的 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

什麼情況下使用

weekend() 函數通常在使用者想要計算使用特定日期的每週剩餘日子時,作為運算式的一部分使用。例如,若使用者想要計算該週期間尚未發生的總利息,即可使用此函數。

下列範例假設:

SET FirstWeekDay=0;

 

範例 結果
weekend('01/10/2013') 傳回 01/12/2013 23:59:59
weekend('01/10/2013', -1) 傳回 01/05/2013 23:59:59.
weekend('01/10/2013', 0, 1) 傳回 01/14/2013 23:59:59

區域設定

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

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

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

範例:  

若您想要週和週數的 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

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

Weekend 函數範例
日期 ISO 週結束 US 週結束
Sat 2020 Dec 26 2020-12-27 12/26/2020
Sun 2020 Dec 27 2020-12-27 1/2/2021
Mon 2020 Dec 28 2021-01-03 1/2/2021
Tue 2020 Dec 29 2021-01-03 1/2/2021
Wed 2020 Dec 30 2021-01-03 1/2/2021
Thu 2020 Dec 31 2021-01-03 1/2/2021
Fri 2021 Jan 1 2021-01-03 1/2/2021
Sat 2021 Jan 2 2021-01-03 1/2/2021
Sun 2021 Jan 3 2021-01-03 1/9/2021
Mon 2021 Jan 4 2021-01-10 1/9/2021
Tue 2021 Jan 5 2021-01-10 1/9/2021
資訊備註在 ISO 欄中,一週在星期日結束,而在 US 欄中,在星期六結束。

範例 1 – 基本範例

範例 2 – period_no

範例 3 – first_week_day

範例 4 – 圖表物件範例

範例 5 – 情境

此頁面是否對您有幫助?

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