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 并向对象添加标题“上次重新加载时间”。

接下来，为当前正在加载的数据创建一个文本框。

执行以下操作：

1. 使用文本和图像图表对象，创建一个文本框。

2. 将以下度量值添加到对象：

   =vCurrentDataLoad

3. 在外观下，选择 Show titles 并向对象添加标题“当前重新加载时间”。

创建最后一个文本框，以显示用户在应用程序中的会话何时启动。

执行以下操作：

1. 使用文本和图像图表对象，创建一个文本框。

2. 将以下度量值添加到对象：

   =vApplicationOpened

3. 在外观下，选择 Show titles 并向对象添加标题“用户会话已开始”。

上图显示了每个已创建变量的示例值。例如，这些值可以如下所示：

• 上次重新加载时间：06/22/2022

• 当前重新加载时间：06/23/2022

• 用户会话开始：06/23/2022

概述

以下示例使用 today() 函数创建三个图表对象。每个图表对象都使用其中一个 timer_mode 选项来演示其效果。

此示例没有加载脚本。

结果

第二次加载数据后，创建三个文本框。

首先，为最新数据重新加载创建一个文本框。

执行以下操作：

1. 使用文本和图像图表对象，创建一个文本框。

2. 添加以下度量：

   =today(0)

3. 在外观下，选择 Show titles 并将标题“最新数据重新加载”添加到对象。

接下来，创建一个文本框以显示当前时间。

执行以下操作：

1. 使用文本和图像图表对象，创建一个文本框。

2. 添加以下度量：

   =today(1)

3. 在外观下，选择 Show titles 并向对象添加标题“当前时间”。

创建最后一个文本框，以显示用户在应用程序中的会话何时启动。

执行以下操作：

1. 使用文本和图像图表对象，创建一个文本框。

2. 添加以下度量：

   =today(2)

3. 在外观下，选择 Show titles 并向对象添加标题“用户会话开始”。

上图显示了每个已创建对象的示例值。例如，这些值可以如下所示：

• 最后数据重新加载时间：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，以返回该期间产生的实际利率。然后将结果乘以贷款的起始余额，以返回本月迄今为止累计的利息。

由于表达式内的 today() 函数中使用值 1 作为 timer_mode 参数，因此每次刷新图表对象时（通过打开应用程序、刷新页面、在工作表之间移动等），返回的日期将为当前日期，结果将相应刷新。