today - 指令碼與圖表函數

概覽

下列範例使用 today() 函數建立三項變數。每個變數都會使用其中一個 timer_mode 個選項示範其效果。

對於示範用途的變數，重新載入指令碼並在 24 小時後第二次重新載入指令碼。這會造成 today(0) 和 today(1) 變數顯示不同數值，藉此正確示範其用途。

載入指令碼

LET vPreviousDataLoad = today(0);
LET vCurrentDataLoad = today(1);
LET vApplicationOpened = today(2);

結果

第二次載入資料後，使用以下指示建立三個文字方塊。

首先，為先前載入的資料建立文字方塊。

請執行下列動作：

1. 使用文字與影像圖表物件，建立文字方塊。

2. 將下列量值新增至物件：

   =vPreviousDataLoad

3. 在外觀之下，選取 Show titles 並將標題「Previous Reload Time」(先前載入時間) 新增至物件。

接下來，為目前正在載入的資料建立文字方塊。

請執行下列動作：

1. 使用文字與影像圖表物件，建立文字方塊。

2. 將下列量值新增至物件：

   =vCurrentDataLoad

3. 在外觀之下，選取 Show titles 並將標題「Current Reload Time」(目前載入時間) 新增至物件。

建立最後一個文字方塊，以顯示應用程式中的使用者工作階段何時開始。

請執行下列動作：

1. 使用文字與影像圖表物件，建立文字方塊。

2. 將下列量值新增至物件：

   =vApplicationOpened

3. 在外觀之下，選取 Show titles 並將標題「User Session Started」(使用者工作階段已開始) 新增至物件。

上方影像顯示每個建立變數的範例值。例如，數值可能如下所示：

• 先前的重新載入時間：06/22/2022

• 目前的重新載入時間：06/23/2022

• 使用者工作階段開始時間：06/23/2022

概覽

下列範例使用 today() 函數建立三項圖表物件。每個圖表物件都會使用其中一個 timer_mode 選項示範其效果。

此範例沒有載入指令碼。

結果

第二次載入資料後，建立三個文字方塊。

首先，建立最新資料重新載入的文字方塊。

請執行下列動作：

1. 使用文字與影像圖表物件，建立文字方塊。

2. 新增下列量值。

   =today(0)

3. 在外觀之下，選取顯示標題並將標題「最新資料重新載入」新增至物件。

接下來，建立顯示目前時間的文字方塊。

請執行下列動作：

1. 使用文字與影像圖表物件，建立文字方塊。

2. 新增下列量值：

   =today(1)

3. 在外觀之下，選取顯示標題並將標題「目前時間」新增至物件。

建立最後一個文字方塊，以顯示應用程式中的使用者工作階段何時開始。

請執行下列動作：

1. 使用文字與影像圖表物件，建立文字方塊。

2. 新增下列量值：

   =today(2)

3. 在外觀之下，選取顯示標題並將標題「使用者工作階段已開始」新增至物件。

上方影像顯示每個建立物件的範例值。例如，數值可能如下所示：

• 最新資料重新載入：06/23/2022

• 目前時間： 06/23/2022

• 使用者工作階段開始時間：06/23/2022

「最新資料重新載入」圖表物件使用 0 的 timer_mode 值。這會傳回最後一次成功重新載入資料的時間戳記。

「目前時間」圖表物件使用 1 個 timer_mode 值。這會傳回根據系統時鐘顯示的目前時間。如果工作表或物件重新整理，即會更新此數值。

「使用者工作階段已開始」的圖表物件使用 2 的 timer_mode 值。這會傳回應用程式已開啟且使用者工作階段已開始的時間戳記。

概覽

開啟資料載入編輯器並將下面的載入指令碼新增至新的索引標籤。

載入指令碼包含：

• 資料集包含一系列貸款餘額，其位於稱為 Loans 的表格。

• 表格資料具有貸款 ID 欄位、月初餘額，以及在每年每筆貸款收取的單利率。

最終使用者希望圖表物件按貸款 ID 顯示月初至今每筆貸款已累積的目前利息。雖然應用程式每週僅重新載入一次，但使用者還是希望每次物件或應用程式重新整理後，也會重新整理結果的內容。

載入指令碼

Loans:
Load
*
Inline 
[
loan_id,start_balance,rate
8188,$10000.00,0.024
8189,$15000.00,0.057
8190,$17500.00,0.024
8191,$21000.00,0.034
8192,$90000.00,0.084
];

結果

請執行下列動作：

1. 載入資料並開啟工作表。 建立新的表格。

2. 新增下列欄位作為維度。

   • loan_id

   • start_balance

3. 接下來，建立量值以計算累積的利息：

   =start_balance*(rate*(today(1)-monthstart(today(1)))/365)

4. 將量值的數字格式設定為金錢。

monthstart() 函數使用傳回今日日期的 today() 函數作為其唯一引數，傳回目前月份的開始日期。以目前日期減去該結果後，再次使用 today() 函數，運算式會傳回本月目前已經過的天數。

然後此值乘以利率並除以 365，以傳回此期間產生的有效利率。然後該結果乘以貸款的開始餘額，以傳回本月目前已累積的利息。

因為 1 的值已作為運算式內 today() 函數的 timer_mode 引數，所以每次重新整理圖形物件時 (方法是開啟應用程式、重新整理頁面、在工作表之間移動等)，傳回的日期會針對目前日期，且結果會隨之重新整理。