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

yearstart - 指令碼與圖表函數

此函數傳回的時間戳記相當於包含 date 的年份的第一天開始。預設的輸出格式為指令碼中所設定的 DateFormat

語法:  

YearStart(date[, period_no[, first_month_of_year]])

換言之,yearstart() 函數判定日期落在哪一年。然後這會以日期格式傳回該年第一毫秒的時間戳記。依照預設,該年的第一個月是 1 月;不過,您可以使用 yearstart() 函數中的 first_month_of_year 引數變更要將哪個月設為第一個月。

yearstart() 函數圖表顯示該函數可涵蓋的時間範圍。

圖表顯示 yearstart() 函數識別給定年份期間內的日期,並為落在該給定年份的日期傳回年份開始的時間戳記。

yearstart() 函數在您想要計算以使用一年中目前已經過的部分時,作為運算式的一部分使用。例如,若您想要計算年初至今累積的利息。

傳回的資料類型: 雙值

引數
引數 描述
date 要評估的時間戳記。
period_no period_no 為整數,其中值 0 表示是包含 date 的年份。負值的 period_no 表示之前的年度,正值表示之後的年度。
first_month_of_year 如果要使用不起始於 1 月的 (會計) 年度,可在 first_month_of_year 中指定介於 2 和 12 之間的值。

下列月份可用於 first_month_of_year argument

first_month_of_year 值
二月  2
三月 3
四月 4
五月 5
六月 6
七月 7
八月 8
九月 9
十月 10
十一月  11
十二月 12

區域設定

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

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

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

函數範例
範例 結果
yearstart('10/19/2001') Returns 01/01/2001 00:00:00.
yearstart('10/19/2001',-1) Returns 01/01/2000 00:00:00.
yearstart('10/19/2001',0,4) Returns 04/01/2001 00:00:00.

範例 1 – 基本範例

範例 2 – period_no

範例 3 – first_month_of_year

範例 4 – 圖表物件範例

範例 5 – 情境

此頁面是否對您有幫助?

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