您位於此處:
時間自訂欄位類型的考量事項
使用「時間」自訂欄位類型追蹤時間 (未繫結至日期),這對於時間管理、事件規劃和專案管理很實用。
您可以在建立自訂欄位時選取「時間」欄位類型。「時間」類型是未包含日期的時間戳記。「時間」欄位值的準確度為毫秒。日期/時間欄位值的準確度為秒。若您需要非為特定於單一日期的日期時間,請使用時間欄位類型。例如,使用該欄位類型來顯示營業時間,或在您要比較時間以計算持續時間時使用。
時間欄位行為
時間欄位值遵循以下行為。
- 在公式中,從
TIMEVALUE函數取得時間值。在公式中將TIMENOW、HOUR、MINUTE、SECOND和MILLISECOND函數與時間搭配使用。 - 「時間」欄位類型在中繼資料 API 中以 FieldType 列舉值表示。
- 儲存的時間欄位值會根據使用者的時區而儲存。在 Salesforce 中顯示時間值時,該值會符合儲存的時間。此時間不會根據使用者在「語言和時區」頁面上的「地區設定」設定,轉換為當地時區。
- 儲存的時間值會加上「Z」,但時間不是 UTC,而是儲存使用者的時區。當您使用 SOQL 或 API 查詢時間欄位值時,請忽略附加的「Z」。例如,使用者儲存時間,其時區為上午 7:00。當您透過 SOQL 查詢時,會傳回時間或 API 07:00:00.000Z。
- 時間以 24 小時的格式儲存。例如,07:00:00.000Z 為上午 7:00,而 19:00:00.000Z 為下午 7:00。
- 時間值增減的單位為毫秒。例如,Timefield1__c 的值為「5:00pm」:
- Timefield1__c + 600000 為「5:10pm」
- Timefield1__c - 600000 為 「4:50pm」
時間欄位不包含日期。因此,將時間值增加 25 小時等同於增加 1 小時。時間會在 24 小時後重新計算。
- 您可以在公式中將某個時間欄位減去另一個時間欄位。結果會顯示為毫秒。例如,TimeField1__c 的值為「10:00pm」,TimeField2__c 的值為「9:00pm」:
- TimeField1__c - TimeField2__c 為 3600000
結果一律不為負數。「減法」為使用 24 小時制的兩個時間值之間的差值。例如,計算營業時間的時數可以使用下列公式:
(ClosedTime - OpenTime) / 3600000.ClosedTime= 下午 5 點、OpenTime= 上午 8 點、ClosedTime - OpenTime= 9 個小時ClosedTime= 5 AM、OpenTime= 7 AM、ClosedTime - OpenTime= 22 小時
-
請在公式運算式中,針對文字引數使用國際日期格式 (ISO)。例如,使用 TIMEVALUE("11:30:00.000"),而非使用 TIMEVALUE("11:30 AM")。
時間欄位限制
使用從「時間」欄位類型建立的欄位時,請注意這些限制。時間欄位:
- 不支援流程產生器和結構描述產生器
- 時間欄位不支援建立 SOQL 查詢的自訂索引
- 外部物件內的標準對應關係無法使用時間欄位
在 Salesforce Classic 中設定時間欄位的格式
在 Salesforce Classic 中,設定時間值時,您有數個格式化選項。例如,您可以設定時間值以包含秒、毫秒、時區,並使用 24 小時標記法。
- 時間自訂欄位類型可使用 24 小時制。您可以將時間值以 HH:MM 的格式儲存,例如 14:40。
- 時間欄位支援以下的輸入格式。
h= 時 (1-12),H = 時 (0-23),m = 分,s = 秒,S= 毫秒,a= 上午或下午,Z= GMT 時區。格式 範例 hh:mm:ss aa 上午 10:30:25 AM hh:mm:ss.SSS a 10:30:25.125 AM HH:mm:ss.SSS 14:30:25.125 HH:mm:ss.SSSZ 14:30:25.125Z 顯示成 GMT hh:mm a 上午 10:30 AM hh:mma 10:30AM h a 4 PM ha 4PM H:mm 1:23 為上午 1:23 H 14 為下午 2:00 Hmm 123 為上午 01:23 HHmm 1434 為下午 02:34 - 當使用 Data Loader 載入值時,請使用 11:30:00.000Z 格式
- 使用 HH:MM:SS.MS 格式設定欄位的預設值,例如上午 10:30 的
TIMEVALUE("10:30:00.000")。
