yearend - 指令碼與圖表函數
此函數傳回的值相當於包含 date 的年份最後一天、最後一毫秒的時間戳記。預設的輸出格式為指令碼中所設定的 DateFormat。
語法:
YearEnd( date[, period_no[, first_month_of_year = 1]])
換言之,yearend() 函數判定日期落在哪一年。然後這會以日期格式傳回該年最後一毫秒的時間戳記。依照預設,該年的第一個月是 1 月。不過,您可以使用 yearend() 函數中的 first_month_of_year 引數變更要將哪個月設為第一個月。
什麼情況下使用
yearend() 函數在您想要計算以使用一年中尚未發生的部分時,作為運算式的一部分使用。例如,若您想要計算該年期間尚未發生的總利息。
傳回的資料類型: 雙值
引數 | 描述 |
---|---|
date | 要評估的時間戳記。 |
period_no | period_no 為整數,其中值 0 表示是包含 date 的年份。負值的 period_no 表示之前的年度,正值表示之後的年度。 |
first_month_of_year | 如果要使用不起始於 1 月的 (會計) 年度,可在 first_month_of_year 中指定介於 2 和 12 之間的值。 |
您可以在 first_month_of_year 引數中使用下列值設定一年的第一個月:
月 | 值 |
---|---|
二月 | 2 |
三月 | 3 |
四月 | 4 |
五月 | 5 |
六月 | 6 |
七月 | 7 |
八月 | 8 |
九月 | 9 |
十月 | 10 |
十一月 | 11 |
十二月 | 12 |
區域設定
除非另有說明,否則此主題中的範例皆使用下列日期格式:MM/DD/YYYY。日期格式是在資料載入指令碼的 SET DateFormat 陳述式中指定。由於地區設定和其他因素,您系統中的預設日期格式可能會不同。您可以變更以下範例中的格式,以滿足您的需求。或者,您可以在載入指令碼中變更格式,以符合這些範例。
應用程式中的預設地區設定是根據安裝 Qlik Sense 之電腦或伺服器的地區系統設定。若您存取的 Qlik Sense 伺服器設定為瑞典,資料載入編輯器將會對日期、時間和貨幣使用瑞典文地區設定。這些地區格式設定與 Qlik Sense 使用者介面中顯示的語言無關。Qlik Sense 顯示的語言將與您正在使用的瀏覽器相同。
範例 | 結果 |
---|---|
yearend('10/19/2001') | 傳回 12/31/2001 23:59:59。 |
yearend('10/19/2001', -1) | 傳回 12/31/2000 23:59:59。 |
yearend('10/19/2001', 0, 4) | 傳回 03/31/2002 23:59:59。 |