# 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-TW/sense/November2025/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 設定的 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='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 | 8/6/97 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 | 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` 函數，時間戳記資料現在格式化為包含星期幾以及日期和時間的新格式。