# Timestamp 脚本和图表功能
TimeStamp() 用于使用数据加载脚本的系统变量或操作系统（如果不提供格式字符串）中设置的时间戳格式，将表达式的格式设置为日期和时间值格式。
语法：
Timestamp(number[, format])
返回数据类型： 双
参数
| 参数 | 描述 |
| --- | --- |
| number | 可以设置数字的格式。 |
| format | 说明如何设置结果时间戳字符串格式的字符串。如果省略，则使用操作系统中设置的缩写日期格式、时间格式和小数位分隔符。
`Timestamp` 功能支持多种格式选项，可用于不同的时间结构，例如：
`DD/MM/YYYY`：只关注日期（例如：`15/11/2024`）。
`YYYY-MM-DD hh:mm:ss`：显示完整的时间戳（例如：`2024-11-15 13:30:45`）。
`MMM DD, YYYY`：显示月份和年份的简写（例如：`Nov 15, 2024`）。
`hh:mm:ss TT` ：只显示 12 小时格式的时间（例如：`01:30:45 PM`）
`HH:mm:ss`：以 24 小时格式显示时间（例如：`13:30:45`）
`wwww, MMM DD YYYY`：显示星期和日期完整日（例如：`Friday, Nov 15 2024`）
`YYYY-MM-DD hh:mm:ss.fff`：包括毫秒（例如：`2024-11-15 13:30:45.123`）。
[数字格式和时间格式的描述](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |
示例：图表表达式
| 示例 | 结果 |
| --- | --- |
| `Timestamp( 35648 )` | 当 `TimestampFormat` 为 `YY-MM-DD hh:mm:ss` 时返回 `97-08-06 00:00:00`。 |
| `Timestamp(35648,'YYYY-MM-DD hh.mm')` | 当提供的格式 为 `YYYY-MM-DD hh.mm` 时返回 `1997-08-06 00.00`。 |
| `Timestamp( 35648,'M/D/YYYY h:mm:ss[.fff] TT')` | 当提供的格式 为 `M/D/YYYY h:mm:ss[.fff] TT` 时返回 `8/6/1997 12:00:00 AM`。 |
| `Timestamp( 35648,'www, DD MMM YYYY hh:mm TT')` | 当提供的格式 为 `www, DD MMM YYYY hh:mm TT` 时返回 `Wed, 06 Aug 1997 12:00 AM`。 |
## 示例 - Timestamp 基本原理
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.htm)
#### 图表表达式
概述
打开数据加载编辑器，并将下面的加载脚本添加到新部分。
加载脚本包含：
* 加载到名为 `Example` 的数据表中的数据集。
* 数据表中的以下字段：
* `TimeStampValue`
* `TimestampFormat` 变量，其使用 `YY-MM-DD hh:mm:ss` 格式。
加载脚本
```
SET TimestampFormat='YY-MM-DD hh:mm:ss';
Example:
Load * inline [
TimeStampValue
35648.375
35648
36648.875
36648.8756789
];
```
结果
加载数据并打开工作表。创建新表并将该字段添加为维度：
* `TimeStampValue`
创建以下度量：
* `=Timestamp(TimeStampValue)`，将值视为使用系统设置的时间戳格式。
* `=Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm')`，使用函数中供应的格式将值视为时间戳格式。
* `=Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT')`，使用函数中供应的格式将值视为时间戳格式。
* `=Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff')`，使用函数中供应的格式将值视为时间戳格式。
* `=Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT')`，使用函数中供应的格式将值视为时间戳格式。
* `=Timestamp(TimeStampValue,'wwww, MMM DD YYYY')`，使用函数中供应的格式将值视为时间戳格式。
结果表
| TimeStampValue | Timestamp(TimeStampValue) | Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm' | Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT') | Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff') | Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT') | Timestamp(TimeStampValue,'wwww, MMM DD YYYY') |
| --- | --- | --- | --- | --- | --- | --- |
| 35648 | 97-08-06 00:00:00 | 1997-08-06 00.00 | 8/6/1997 12:00:00 AM | 1997-08-06 00:00:00.000 | Wed, 06 Aug 1997 12:00 AM | Wednesday, Aug 06 1997 |
| 35648.375 | 97-08-06 09:00:00 | 1997-08-06 09.00 | 8/6/1997 9:00:00 AM | 1997-08-06 09:00:00.000 | Wed, 06 Aug 1997 09:00 AM | Wednesday, Aug 06 1997 |
| 36648.875 | 00-05-02 21:00:00 | 2000-05-02 21.00 | 5/2/2000 9:00:00 PM | 2000-05-02 21:00:00.000 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 |
| 36648.8756789 | 00-05-02 21:00:58 | 2000-05-02 21.00 | 5/2/2000 9:00:58 PM | 2000-05-02 21:00:58.657 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 |
结果显示了 `TimestampFormat` 函数如何使用不同的格式参数显示数值。
## 示例 - 使用不同 TimestampFormat 设置的时间戳基本特性
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.htm)
#### 图表表达式
概述
打开数据加载编辑器，并将下面的加载脚本添加到新部分。
加载脚本包含：
* 加载到名为 `Example` 的数据表中的数据集。
* 数据表中的以下字段：
* `TimeStampValue`
* `TimestampFormat` 变量，其使用 `YY-MM-DD hh:mm:ss` 格式。
加载脚本
```
SET TimestampFormat='M/D/YY hh:mm:ss';
Example:
Load * inline [
TimeStampValue
35648.375
35648
36648.875
36648.8756789
];
```
结果
加载数据并打开工作表。创建新表并将该字段添加为维度：
* `TimeStampValue`
创建以下度量：
* `=Timestamp(TimeStampValue)`，将值视为使用系统设置的时间戳格式。
* `=Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm')`，使用函数中供应的格式将值视为时间戳格式。
* `=Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT')`，使用函数中供应的格式将值视为时间戳格式。
* `=Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff')`，使用函数中供应的格式将值视为时间戳格式。
* `=Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT')`，使用函数中供应的格式将值视为时间戳格式。
* `=Timestamp(TimeStampValue,'wwww, MMM DD YYYY')`，使用函数中供应的格式将值视为时间戳格式。
结果表
| TimeStampValue | Timestamp(TimeStampValue) | Timestamp(TimeStampValue,'YYYY-MM-DD hh.mm' | Timestamp(TimeStampValue,'M/D/YYYY h:mm:ss[.fff] TT') | Timestamp(TimeStampValue,'YYYY-MM-DD hh:mm:ss.fff') | Timestamp(TimeStampValue,'www, DD MMM YYYY hh:mm TT') | Timestamp(TimeStampValue,'wwww, MMM DD YYYY') |
| --- | --- | --- | --- | --- | --- | --- |
| 35648 | 8/6/97 00:00:00 | 1997-08-06 00.00 | 8/6/1997 12:00:00 AM | 1997-08-06 00:00:00.000 | Wed, 06 Aug 1997 12:00 AM | Wednesday, Aug 06 1997 |
| 35648.375 | 1997-08-06 9:00:00 | 1997-08-06 09.00 | 8/6/1997 9:00:00 AM | 1997-08-06 09:00:00.000 | Wed, 06 Aug 1997 09:00 AM | Wednesday, Aug 06 1997 |
| 36648.875 | 5/2/00 21:00:00 | 2000-05-02 21.00 | 5/2/2000 9:00:00 PM | 2000-05-02 21:00:00.000 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 |
| 36648.8756789 | 5/2/00 21:00:58 | 2000-05-02 21.00 | 5/2/2000 9:00:58 PM | 2000-05-02 21:00:58.657 | Tue, 02 May 2000 09:00 PM | Tuesday, May 02 2000 |
结果显示了 `TimestampFormat` 函数如何使用不同的格式参数显示数值。
## 示例 - 更改客户订单的时间戳格式
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Timestamp.htm)
#### 图表表达式
概述
打开数据加载编辑器，并将下面的加载脚本添加到新部分。
加载脚本包含：
* 加载到名为 `Example` 的数据表中的数据集。
* 数据表中有以下字段：
* `Customer`
* `CustomerName`
* `OrderTimestamp`
加载脚本
```
Example:
Load * inline [
OrderID, CustomerName, OrderTimestamp
1, Alice, 2024-02-20 11:00:00
2, Bob, 2024-03-01 15:30:00
3, Charlie, 2024-04-12 09:45:00
4, David, 2024-05-21 21:10:00
5, Eve, 2024-06-30 14:25:00
];
```
结果
加载数据并打开工作表。创建新表并将这些字段添加为维度：
* `OrderID`
* `CustomerName`
创建以下度量：
* `=Timestamp(OrderTimestamp, 'WWWW, DD MMM YYYY hh:mm TT')`，以显示星期几、日期和时间的格式显示订单时间戳。
结果表
| OrderID | CustomerName | Timestamp(OrderTimestamp, 'WWWW, DD MMM YYYY hh:mm TT') |
| --- | --- | --- |
| 1 | Alice | Tuesday, 20 Feb 2024 11:00 AM |
| 2 | Bob | Friday, 01 Mar 2024 03:30 PM |
| 3 | Charlie | Friday, 12 Apr 2024 09:45 AM |
| 4 | David | Tuesday, 21 May 2024 09:10 PM |
| 5 | Eve | Sunday, 30 Jun 2024 02:25 PM |
使用 `Timestamp` 函数，时间戳数据现在的格式包括星期几和日期时间的新格式。