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

today - 指令碼與圖表函數

此函數會傳回目前日期。該函數會以 DateFormat 系統變數格式傳回值。

語法:  

today([ timer_mode])

傳回的資料類型: 雙值

today() 函數可用於載入指令碼圖表物件中。

預設 timer_mode 值為 1。

引數
引數 描述
timer_mode

可以具有下列值:

0 (最後完成資料載入的日子)
1 (函數叫用的日子)
2 (開啟應用程式的日子)

資訊備註如果我們在載入指令碼中使用函數,則 timer_mode=0 將產生最後完成資料載入的日子,而 timer_mode=1 將提供目前資料載入的日子。
函數範例
timer_mode 數值 用於載入指令碼的結果 用於圖表物件的結果
0 DateFormat 系統變數格式返回最新資料重新載入前,最後一筆成功資料重新載入的日期。 DateFormat 系統變數格式返回最新資料重新載入的日期。

1

DateFormat 系統變數格式返回最新資料重新載入的日期。 DateFormat 系統變數格式返回函數呼叫的日期。

2

DateFormat 系統變數格式返回使用者應用程式工作階段開始時的日期。這不會更新內容,除非使用者重新載入指令碼。 DateFormat 系統變數格式返回使用者應用程式工作階段開始的日期。新工作階段開始或應用程式資料重新載入時,即會重新整理內容。

什麼情況下使用

today() 函數常用於當作運算式中的元件。例如,這可用於計算截至目前日期之月份內彙總的利息。

下表提供 today() 函數傳回結果的解釋,並提供 timer_mode 引數的不同數值:

區域設定

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

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

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

範例 1 – 使用載入指令碼產生物件

範例 2 – 不使用載入指令碼產生物件

範例 3 – 情境

此頁面是否對您有幫助?

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