# Time - 脚本和图表功能
Time() 用于使用数据加载脚本的系统变量或操作系统（如果不提供格式字符串）中设置的时间格式，将表达式的格式设置为时间值格式。
语法：
Time(number[, format])
返回数据类型： 双
参数
| 参数 | 描述 |
| --- | --- |
| number | 可以设置数字的格式。 |
| format | 说明如何设置结果时间字符串格式的字符串。如果省略，则使用操作系统中设置的时间格式和小数位分隔符。
`Time` 功能支持多种格式选项，可用于不同的时间结构，例如：
`hh:mm:ss` - 以标准时间格式格式化时间值，并用前导零显示小时、分钟和秒。
`hh:mm TT` - 使用 12 小时格式，后缀为 AM/PM 。
`hh:mm` - 只显示小时和分钟，省略秒钟。
`hh.mm.ss` - 使用不同分隔符的时间格式，如用点号 (`.`) 代替冒号。
`hh TT` - 仅包括小时和 AM/PM。
`hh "Hrs" mm "Mins"` - 使用自定义文本显示时间，如 Hrs。
[数字格式和时间格式的描述](https://help.qlik.com/zh-CN/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |
示例：图表表达式
| 示例 | 结果 |
| --- | --- |
| `Time( 0.375 )` | 当 `TimeFormat` 设置为 `'hh:mm:ss'` 时，返回 `09:00:00`。 |
| `Time( 35648.375 )` | 当提供的 `Timeformat` 为 `'hh:mm:ss'` 时返回 `09:00:00`。 |
| `Time( 0.99999, 'hh-mm' )` | 通过忽略 `TimeFormat` 设置，返回 `23-59` ，因为格式是在度量中提供的。 |
## 示例 - Time 基本原理
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)
#### 图表表达式
概览
打开数据加载编辑器，并将下面的加载脚本添加到新部分。
加载脚本包含：
* 加载到名为 `Example` 的数据表中的数据集。
* 数据表中的以下字段：
* `TimeValue`
* `TimeFormat` 变量，其使用 `hh:mm:ss` 格式。
加载脚本
```
SET TimeFormat='hh:mm:ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```
结果
加载数据并打开工作表。创建新表并将该字段添加为维度：
* ` TimeValue
`
创建以下度量：
* `=Time(TimeValue )`，将值视为使用系统设置格式化的时间。
* `=Time(TimeValue, 'hh-mm' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh:mm:ss' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh:mm TT' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh:mm' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh.mm.ss' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh TT' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`，使用函数中供应的格式将值视为时间。
结果表
| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23:59:59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
结果显示了`Time` 函数如何根据函数表达式中提供的格式显示值。
## 示例 - 使用不同 TimeFormat 设置的时间基本特性
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)
#### 图表表达式
概览
打开数据加载编辑器，并将下面的加载脚本添加到新部分。
加载脚本包含：
* 加载到名为 `Example` 的数据表中的数据集。
* 数据表中的以下字段：
* `TimeValue`
* `TimeFormat` 变量，其使用 `hh.mm.ss` 格式。
加载脚本
```
SET TimeFormat='hh.mm.ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```
结果
加载数据并打开工作表。创建新表并将该字段添加为维度：
* ` TimeValue
`
创建以下度量：
* `=Time(TimeValue )`，将值视为使用系统设置格式化的时间。
* `=Time(TimeValue, 'hh-mm' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh:mm:ss' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh:mm TT' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh:mm' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh.mm.ss' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh TT' )`，使用函数中供应的格式将值视为时间。
* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`，使用函数中供应的格式将值视为时间。
结果表
| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
| 0.99999 | 23.59.59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 Hrs 59 Mins |
| 35648.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 Hrs 00 Mins |
结果显示了`Time` 函数如何根据函数表达式中提供的格式显示值。