此函数用于返回当前时间的时间戳。函数以 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 并向对象添加标题“上次重新加载时间”。
接下来，为当前正在加载的数据创建一个文本框。
执行以下操作：
-
使用文本和图像图表对象，创建一个文本框。
-
将以下度量值添加到对象：
=vCurrentDataLoad
-
在外观下，选择 Show titles 并向对象添加标题“当前重新加载时间”。
创建最后一个文本框，以显示用户在应用程序中的会话何时启动。
执行以下操作：
-
使用文本和图像图表对象，创建一个文本框。
-
将以下度量值添加到对象：
=vApplicationOpened
-
在外观下，选择 Show titles 并向对象添加标题“用户会话已开始”。
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。这将返回应用程序打开和用户会话开始的时间戳。