Loading
透過按一下而非程式碼擴充 Salesforce
時間自訂欄位類型的考量事項

時間自訂欄位類型的考量事項

使用「時間」自訂欄位類型追蹤時間 (未繫結至日期),這對於時間管理、事件規劃和專案管理很實用。

您可以在建立自訂欄位時選取「時間」欄位類型。「時間」類型是未包含日期的時間戳記。「時間」欄位值的準確度為毫秒。日期/時間欄位值的準確度為秒。若您需要非為特定於單一日期的日期時間,請使用時間欄位類型。例如,使用該欄位類型來顯示營業時間,或在您要比較時間以計算持續時間時使用。

時間欄位行為

時間欄位值遵循以下行為。

  • 在公式中,從 TIMEVALUE 函數取得時間值。在公式中將 TIMENOWHOURMINUTESECONDMILLISECOND 函數與時間搭配使用。
  • 「時間」欄位類型在中繼資料 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。
  • 時間欄位支援以下的輸入格式。
    格式 範例
    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
    h= 時 (1-12),H = 時 (0-23),m = 分,s = 秒,S= 毫秒,a= 上午或下午,Z= GMT 時區。
  • 當使用 Data Loader 載入值時,請使用 11:30:00.000Z 格式
  • 使用 HH:MM:SS.MS 格式設定欄位的預設值,例如上午 10:30 的 TIMEVALUE("10:30:00.000")
 
正在載入
Salesforce Help | Article