now - 指令碼與圖表函數
此函數會傳回目前時間的時間戳記。該函數會以 TimeStamp 系統變數格式傳回值。預設 timer_mode 值為 1。
語法:
now([ timer_mode])
傳回的資料類型: 雙值
now() 函數可用於載入指令碼或圖表物件中。
引數 | 描述 |
---|---|
timer_mode |
可以具有下列值: 0 (最後完成資料載入的時間) 資訊備註如果您在資料載入指令碼中使用函數,則 timer_mode=0 將產生最後完成資料載入的時間,並且 timer_mode=1 將提供目前資料載入中函數呼叫的時間。
|
提示備註now() 函數有高效能影響,若該函數用於表格的運算式內,可能會造成捲動問題。若這樣的使用方式沒有嚴格的必要性,建議改用 today() 函數。若在版面配置中需要使用 now(),建議在可行情況下使用非預設設定 now(0) 或 now(2),因為這不需要常數重新計算
什麼情況下使用
now() 函數常用於當作運算式中的元件。例如,這可用來計算產品生命週期的剩餘時間。若運算式需要使用一天中的部分,會使用 now() 函數而非 today() 函數。
下表提供 now() 函數傳回結果的解釋,並提供 timer_mode 引數的不同數值:
timer_mode 數值 | 用於載入指令碼的結果 | 用於圖表物件的結果 |
---|---|---|
0 | 以 TimeStamp 系統變數格式傳回最新資料載入前,最後一筆成功資料載入的時間戳記。 | 以 TimeStamp 系統變數格式傳回最新資料載入的時間戳記。 |
1 |
以 TimeStamp 系統變數格式傳回最新資料載入的時間戳記。 | 以 TimeStamp 系統變數格式傳回函數呼叫的時間戳記。 |
2 |
以 TimeStamp 系統變數格式傳回使用者應用程式工作階段開始時的時間戳記。這不會更新內容,除非使用者重新載入指令碼。 | 以 TimeStamp 系統變數格式傳回使用者應用程式工作階段開始時的時間戳記。新工作階段開始或應用程式資料重新載入時,即會重新整理內容。 |
區域設定
除非另有說明,否則此主題中的範例皆使用下列日期格式:MM/DD/YYYY。日期格式是在資料載入指令碼的 SET DateFormat 陳述式中指定。由於地區設定和其他因素,您系統中的預設日期格式可能會不同。您可以變更以下範例中的格式,以滿足您的需求。或者,您可以在載入指令碼中變更格式,以符合這些範例。
應用程式中的預設地區設定是根據安裝 Qlik Sense 之電腦或伺服器的地區系統設定。若您存取的 Qlik Sense 伺服器設定為瑞典,資料載入編輯器將會對日期、時間和貨幣使用瑞典文地區設定。這些地區格式設定與 Qlik Sense 使用者介面中顯示的語言無關。Qlik Sense 顯示的語言將與您正在使用的瀏覽器相同。