您在此处:
时间自定义字段类型的注意事项
使用时间自定义字段类型跟踪未绑定到日期的时间,这对时间管理、事件计划和项目管理非常有用。
您可以在创建自定义字段时选择时间字段类型。时间类型是不包含日期的时间戳。时间字段值的精度以毫秒为单位。日期/时间字段值的精度以秒为单位。在您需要并非特定于一个日期的当日时间时,使用时间字段类型。例如,将其用于显示工作时间,或如果您想要比较当日时间,以计算持续时间。
时间字段行为
时间字段值遵循这些行为。
- 在公式中,从
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 点,OpenTime= 早上 7 点,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 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 hh:mma 10:30AM h a 4 PM ha 4PM H:mm 1:23 是 1:23 AM H 14 是 14:00 AM 嗯 123 是 1:23 AM HHmm 1434 是 14:34 AM - 在使用 Data Loader 加载值时,使用 11:30:00.000Z 格式。
- 使用 HH:MM:SS.MS 格式为字段设置默认值,例如上午 10:30 的
TIMEVALUE("10:30:00.000")。

