# Timestamp#指令碼與圖表函數
Timestamp#() 將運算式作為日期和時間值進行評估，使用在資料載入指令碼或作業系統 (除非提供格式字串) 中設定的時間戳記格式。
語法：
timestamp#(text[, format])
傳回的資料類型： 雙值
引數
| 引數 | 描述 |
| --- | --- |
| text | 要評估的文字字串。 |
| format | 描述應用於解讀文字字串的格式字串。如果省略，則會使用作業系統中設定的簡短日期格式、時間格式和小數點分隔符號。ISO 8601 支援時間戳記。
`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-TW/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |
範例：圖表運算式
| 範例 | 結果 |
| --- | --- |
| `Timestamp#('12-03-2023 10:25:30', 'DD-MM-YYYY hh:mm:ss')` | 傳回 `12-03-2023 10:25:30` |
| `Timestamp#('2023/03/15 13:45', 'YYYY/MM/DD hh:mm')` | 傳回 `2023/03/15 13:45` |
## 範例 - Timestamp# 基礎事項
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/timestamp_hash.htm)
#### 載入指令碼
概述
開啟資料載入編輯器並將下面的載入指令碼新增至新的區段。
載入指令碼包含：
* 載入到稱為 `Example` 之資料表格的資料集。
* 資料表格中的欄位如下：
* `InputString`
* 使用 `Timestamp#` 函數將運算式視為日期和時間值的前置載入。執行時，這會建立名為 `TimeStamp_InputString` 的附加欄位。
載入指令碼
```
SET DateFormat='M/D/YYYY'
Example:
Load *,
Timestamp(Timestamp#(InputString)) as TimeStamp_InputString;
LOAD * INLINE [
InputString
2015-09-15T12:13:14
1952-10-16T13:14:00+0200
1109-03-01T14:15
];
```
結果
載入資料並開啟工作表。建立新的表格並將這些欄位新增為維度：
* ` InputString
`
* `TimeStamp_InputString`
結果表格
| InputString | TimeStamp\_InputString |
| --- | --- |
| 1109-03-01T14:15 | 3/1/1109 2:15:00 PM |
| 1952-10-16T13:14:00+0200 | 10/16/1952 11:14:00 AM |
| 2015-09-15T12:13:14 | 9/15/2015 12:13:14 PM |
在此範例中，您可以看到如何使用 `Timestamp#` 函數將字串值評估為時間戳記。
## 範例 - Timestamp# 使用情境
[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/InterpretationFunctions/timestamp_hash.htm)
#### 載入指令碼
概述
事件記錄中的資料包含您想要使用的時間戳記格式。
開啟資料載入編輯器並將下面的載入指令碼新增至新的區段。
載入指令碼包含：
* 載入到稱為 `Example` 之資料表格的資料集。
* 資料表格中的欄位如下：
* `Event`
* `EventDateTime`
* 前置載入使用 `Timestamp#` 函數將 `EventDateTime` 欄位中的值轉換為系統可以理解的日期和時間格式。執行時，這會建立名為 `EventTimestamp` 的附加欄位。
載入指令碼
```
SET TimestampFormat='M/D/YYYY h:mm:ss[.fff] TT';
Example:
LOAD
Event,
EventDateTime,
Timestamp#(EventDateTime, 'DD-MM-YYYY hh:mm:ss') AS EventTimestamp
INLINE [
Event, EventDateTime
"Login", "12-03-2023 10:25:30"
"Logout", "12-03-2023 12:45:10"
"Login", "13-03-2023 09:10:15"
"Logout", "13-03-2023 17:30:20"
"Login", "14-03-2023 08:00:00"
];
```
結果
載入資料並開啟工作表。建立新的表格並將這些欄位新增為維度：
* ` Event
`
* `EventDateTime`
* `EventTimestamp`
建立下列量值：
* `=Timestamp(EventTimestamp)`，用來檢視時間戳記，其格式使用載入指令碼中提供的格式作為預設設定。
結果表格
| 事件 | EventDateTime | EventTimestamp | Timestamp(EventTimestamp) |
| --- | --- | --- | --- |
| 登入 | 12-03-2023 10:25:30 | 12-03-2023 10:25:30 | 3/12/2023 10:25:30 AM |
| 登入 | 13-03-2023 09:10:15 | 13-03-2023 09:10:15 | 3/13/2023 9:10:15 AM |
| 登入 | 14-03-2023 08:00:00 | 14-03-2023 08:00:00 | 3/14/2023 8:00:00 AM |
| 登出 | 12-03-2023 12:45:10 | 12-03-2023 12:45:10 | 3/12/2023 12:45:10 PM |
| 登出 | 13-03-2023 17:30:20 | 13-03-2023 17:30:20 | 3/13/2023 5:30:20 PM |
在此範例中，您可以看到如何使用 `Timestamp#` 函數轉換值。