# Time 指令碼與圖表函數
Time() 將運算式的格式設定為時間值，使用在資料載入指令碼或作業系統 (除非提供格式字串) 的系統變數中設定的時間格式。
語法：
Time(number[, format])
傳回的資料類型： 雙值
引數
| 引數 | 描述 |
| --- | --- |
| number | 要格式設定的數字。 |
| format | 說明如何對所產生時間字串進行格式設定的字串。如果省略，則會使用作業系統中設定的時間格式和小數點分隔符號。
`Time` 函數支援多種不同時間結構的格式選項，例如：
`hh:mm:ss`—以標準時間格式來格式化時間值，並以前導零顯示小時、分鐘和秒。
`hh:mm TT` — 使用含有 AM/PM 後置詞的 12 小時格式。
`hh:mm` — 僅顯示小時和分鐘，省略秒。
`hh.mm.ss`—使用不同分隔符號的時間格式，例如以句號 (`.`) 取代冒號。
`hh TT` — 僅包括小時和 AM/PM。
`hh "Hrs" mm "Mins"` — 以自訂文字顯示時間，例如 Hrs。
[數字格式與時間格式的描述](https://help.qlik.com/zh-TW/sense/May2026/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 設定的 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` 函數如何根據函數運算式中提供的格式顯示值。