# today - 脚本和图表函数

此函数用于返回系统时钟的当前日期。

语法：

today([ timer\_mode])

**返回数据类型：**双

参数：

Today 参数

| 参数 | 说明 |
| --- | --- |
| timer\_mode | 可以具有以下值：<br><br><ul> <li>0（最后完成数据加载的日期）</li> <li>1（函数调用的日期）</li> <li>2（文档打开的日期）</li> </ul><br><br>信息注释如果在加载脚本中使用此函数，则 timer\_mode=0 将会生成最后完成数据加载的日期，而 timer\_mode=1 将会提供当前数据加载的日期。 |

示例和结果：

示例和结果

| 示例 | 结果 |
| --- | --- |
| `Today(  0)` | 返回最后完成数据加载的日期。 |
| `Today(  1)` | 在图表表达式中使用时，此函数返回函数调用的日期。<br><br>在加载脚本中使用时，此函数返回当前数据加载开始时的日期。 |
| `Today(  2)` | 返回打开文档的日期。 |