此函數會傳回目前時間的時間戳記。該函數會以 TimeStamp 系統變數格式傳回值。預設 timer_mode 值為 1。
語法：
now([ timer_mode])
傳回的資料類型： 雙值
now() 函數可用於載入指令碼或圖表物件中。
| 引數 | 描述 |
|---|---|
| timer_mode |
可以具有下列值： 0 (最後完成資料載入的時間) 資訊備註如果您在資料載入指令碼中使用函數，則 timer_mode=0 將產生最後完成資料載入的時間，並且 timer_mode=1 將提供目前資料載入中函數呼叫的時間。
|
什麼情況下使用
now() 函數常用於當作運算式中的元件。例如，這可用來計算產品生命週期的剩餘時間。若運算式需要使用一天中的部分，會使用 now() 函數而非 today() 函數。
下表提供 now() 函數傳回結果的解釋，並提供 timer_mode 引數的不同數值：
| timer_mode 數值 | 用於載入指令碼的結果 | 用於圖表物件的結果 |
|---|---|---|
| 0 | 以 TimeStamp 系統變數格式傳回最新資料載入前，最後一筆成功資料載入的時間戳記。 | 以 TimeStamp 系統變數格式傳回最新資料載入的時間戳記。 |
|
1 |
以 TimeStamp 系統變數格式傳回最新資料載入的時間戳記。 | 以 TimeStamp 系統變數格式傳回函數呼叫的時間戳記。 |
|
2 |
以 TimeStamp 系統變數格式傳回使用者應用程式工作階段開始時的時間戳記。這不會更新內容，除非使用者重新載入指令碼。 | 以 TimeStamp 系統變數格式傳回使用者應用程式工作階段開始時的時間戳記。新工作階段開始或應用程式資料重新載入時，即會重新整理內容。 |
區域設定
除非另有說明，否則此主題中的範例皆使用下列日期格式：MM/DD/YYYY。日期格式是在資料載入指令碼的 SET DateFormat 陳述式中指定。由於地區設定和其他因素，您系統中的預設日期格式可能會不同。您可以變更以下範例中的格式，以滿足您的需求。或者，您可以在載入指令碼中變更格式，以符合這些範例。如需詳細資訊，請參閱 修改用於應用程式和指令碼的區域設定。
應用程式中的預設地區設定是根據使用者設定檔。這些地區格式設定與 Qlik Cloud 使用者介面中顯示的語言無關。Qlik Cloud 顯示的語言將與您正在使用的瀏覽器相同。
若您是應用程式建立者，可以為您建立的應用程式設定預設地區。如需詳細資訊，請參閱Qlik Cloud 分析 中設定用於建立應用程式和指令碼的偏好區域設定。
範例 1 – 使用載入指令碼產生物件
概覽
開啟資料載入編輯器並將下面的載入指令碼新增至新的索引標籤。
此範例使用 now() 函數建立三項變數。每個變數都會使用其中一個 timer_mode 個選項示範其效果。
對於示範用途的變數，載入指令碼並在短時間後第二次載入指令碼。這會造成 now(0) 和 now(1) 變數顯示不同數值，藉此正確示範其用途。
載入指令碼
LET vPreviousDataLoad = now(0);
LET vCurrentDataLoad = now(1);
LET vApplicationOpened = now(2);結果
第二次載入資料後，使用以下指示建立三個文字方塊。
首先，為先前載入的資料建立文字方塊。
請執行下列動作：
-
使用文字與影像圖表物件，建立文字方塊。
-
將下列量值新增至物件：
=vPreviousDataLoad
-
在外觀之下，選取 Show titles 並將標題「Previous Reload Time」(先前載入時間) 新增至物件。
接下來，為目前正在載入的資料建立文字方塊。
請執行下列動作：
-
使用文字與影像圖表物件，建立文字方塊。
-
將下列量值新增至物件：
=vCurrentDataLoad
-
在外觀之下，選取 Show titles 並將標題「Current Reload Time」(目前載入時間) 新增至物件。
建立最後一個文字方塊，以顯示應用程式中的使用者工作階段何時開始。
請執行下列動作：
-
使用文字與影像圖表物件，建立文字方塊。
-
將下列量值新增至物件：
=vApplicationOpened
-
在外觀之下，選取 Show titles 並將標題「User Session Started」(使用者工作階段已開始) 新增至物件。
now() 載入指令碼變數
上方影像顯示每個建立變數的範例值。例如，數值可能如下所示：
-
先前的載入時間：6/22/2022 8:54:03 AM
-
目前的載入時間： 6/22/2022 9:02:08 AM
-
使用者工作階段已開始：6/22/2022 8:40:40 AM
範例 2 – 不使用載入指令碼產生物件
概覽
在此範例中，您將會使用 now() 函數建立三個圖表物件，而不需將任何變數或資料載入到應用程式中。每個圖表物件都會使用其中一個 timer_mode 選項示範其效果。
此範例沒有載入指令碼。
請執行下列動作：
-
開啟資料載入編輯器。
-
在不變更現有載入指令碼的情況下，按一下載入資料。
-
在短時間後，第二次載入指令碼。
結果
第二次載入資料後，建立三個文字方塊。
首先，建立最新資料重新載入的文字方塊。
請執行下列動作：
-
使用文字與影像圖表物件，建立文字方塊。
-
新增下列量值。
=now(0)
-
在外觀之下，選取顯示標題並將標題「最新資料重新載入」新增至物件。
接下來，建立顯示目前時間的文字方塊。
請執行下列動作：
-
使用文字與影像圖表物件，建立文字方塊。
-
新增下列量值：
=now(1)
-
在外觀之下，選取顯示標題並將標題「目前時間」新增至物件。
建立最後一個文字方塊，以顯示應用程式中的使用者工作階段何時開始。
請執行下列動作：
-
使用文字與影像圖表物件，建立文字方塊。
-
新增下列量值：
=now(2)
-
在外觀之下，選取顯示標題並將標題「使用者工作階段已開始」新增至物件。
now() 圖表物件範例
上方影像顯示每個建立物件的範例值。例如，數值可能如下所示：
-
最新資料載入：6/22/2022 9:02:08 AM
-
目前時間： 6/22/2022 9:25:16 AM
-
使用者工作階段已開始：6/22/2022 8:40:40 AM
「最新資料重新載入」圖表物件使用 0 的 timer_mode 值。這會傳回最後一次成功重新載入資料的時間戳記。
「目前時間」圖表物件使用 1 個 timer_mode 值。這會傳回根據系統時鐘顯示的目前時間。如果工作表或物件重新整理，即會更新此數值。
「使用者工作階段已開始」的圖表物件使用 2 的 timer_mode 值。這會傳回應用程式已開啟且使用者工作階段已開始的時間戳記。