Loading
关于 Salesforce Data 360
公式的日期函数

您在此处：

  1. Salesforce 帮助
  2. 文档
  3. Data 360

公式的日期函数

使用日期函数调整或计算日期值。例如，您可以添加时间，查找到期时间，并从日期字段提取周几。日期函数的参数是日期字段。

在输入公式时，在表达式中使用字段的 API 名称，而不是标签。参数部分用括号括起来。例如，您可以输入以下表达式。

datediff(ClosedDate, CreatedDate)
日期函数 描述 语法
add_months 返回具有在开始日期之后指定月数的日期。

add_months(startDate,num_months)

startDate 是开始计算的日期字段。

num_months 是添加到 startDate 的月数。
current_date 返回当前日期。 current_date()
current_timestamp 返回当前日期和时间。 current_timestamp()
datediff 返回开始日期和结束日期之间的天数。

datediff(endDate,startDate)

endDate 是您发现存在差异的两个日期中较晚的日期。

startDate 是您发现存在差异的两个日期中较早的日期。
date_add 返回具有在开始日期之后指定天数的日期。

date_add(startDate,num_days)

startDate 是开始计算的日期字段。

num_days 是添加到 startDate 的天数。仅接受静态整数值。
date_format 将时间戳转换为指定日期格式。

date_format(field,'format')

field 是转换为指定格式的日期字段/时间戳或字符串。

'format' 是需要遵从的日期和时间格式模式。

示例： 

date_format('2016-04-08', 'y')

returns 2016
date_sub 移除距离开始日期的指定天数。

date_sub(startDate,num_days)

startDate 是开始计算的日期字段。

num_days 是从 startDate 减去的天数。仅接受静态整数值。
date_trunc 将时间戳的指定部分及其之后的所有部分重置为零（或适用于日期和年份的 01）。指定时间戳部分 (fmt)，带有“年”、“季度”、“月”、“周”、“日”、“小时”、“分钟”或“秒”。例如，对于 2019-05-01 12:31:32 的“年”，dateTrunc 将返回 2019-01-01 00:00:00。如果您的数据是日期，而不是日期时间，则使用 trunc 函数。

date_trunc('format',timestamp)

'format' 是需要遵从的日期和时间格式模式。

timestamp 是返回为 UNIX 时间戳的日期/时间戳或字符串。

示例： 

date_trunc('week',CloseDate)

返回结束日期所在周的周一。
day 返回日期/时间戳的几月几日组件。

day(date)

date 是提取几月几日的日期字段。
dayofmonth 返回日期/时间戳的几月几日组件。

dayofmonth(date)

date 是提取几月几日的日期字段。
dayofweek 返回日期/时间戳的周几组件。1 = 周日、2 = 周一、...、7 = 周六。

dayofweek(date)

date 是提取周几的日期字段。
dayofyear 返回日期/时间戳的年中几日组件。

dayofyear(date)

date 是提取一年中的第几日的日期字段。
months_between 返回两个时间戳之间的月数。根据每月 31 天计算差值（四舍五入为 8 位数字），除非 roundOff = false。如果 timestamp1 晚于 timestamp2，结果是正数。如果 timestamp1 和 timestamp2 在一个月的同一天，或者两个时间戳在一个月的最后一天，结果将是整数，并且忽略当天的时间。

months_between(timestamp2,timestamp1,roundOff(optional))

timestamp2 是要比较的其中一个时间戳。

Timestamp1 是要比较的另一个时间戳。

roundOff(optional) 是确定是否四舍五入结果的布尔值。此参数是可选的。
now 使用指定格式，返回当前日期和时间。 now()
to_date 将日期字符串转换为指定日期格式。使用无效输入，返回空值。

to_date(field,'format(optional)')

field 是您要转换的日期字符串字段。

'format(optional)' 是需要遵从的日期和时间格式模式。此参数是可选的。如果未包含格式，函数会遵从将规则转换为日期。
to_timestamp 将时间戳字符转换为指定时间戳格式。

to_timestamp(field,'format(optional)')

field 是您要转换的时间戳字符串字段。

'format(optional)' 是需要遵从的时间戳格式模式。此参数是可选的。如果未包含格式，函数会遵从将规则转换时间戳。

例如，'M' 或 'L' 是从 1 开始的一年中的月数。 

to_timestamp('2020-01-01', 'M')

返回 

1

值 YYYY/MM/DD 是 4 位数字年份、2 位数字月份和月份中的某一天。 

TO_TIMESTAMP('2024/12/10 11:10:15', 'YYYY/MM/DD HH:MI:SS')

返回

10-DEC-24 11.10.15.000000000 AM
to_unix_timestamp 返回指定时间的 UNIX 时间戳。

to_unix_timestamp(timestamp,format(optional)

timestamp 是返回为 UNIX 时间戳的日期/时间戳或字符串。

format(optional) 是需要遵从的日期/时间格式模式。如果 timestamp 不是字符串，将忽略 format(optional)。默认值是“yyyy-MM-dd HH:mm:ss”。此参数是可选的。

示例：

to_unix_timestamp('2016-04-08', 'yyyy-MM-dd')

返回 

1460098800
trunc 使用 0，替换时间戳指定部分及之后的所有部分。

trunc(field,'format(optional)')

field 是时间戳字段。

'format(optional)' 指定要截断的时间戳部分。接受的值是“YEAR”、“YYYY”、“YY”、“MON”、“MONTH”、“MM”、“DAY”、“DD”、“HOUR”、“MINUTE”、“SECOND”、“WEEK”和“QUARTER”。

示例： 

trunc('2015-03-05T09:32:05.359', 'MM')

返回 

2015-03-01T00:00:00

日期和时间函数注意事项

在使用日期和时间函数时，请谨记这些行为。

  • 这些函数与批处理数据转换的运行时间相关。
    • now
    • current_date
    • current_timestamp
    • to_unix_timestamp
  • 所有日期和日期时间函数都基于 UTC 时区。
  • 启用自定义时区支持后，日期函数和日期时间函数将彼此独立。在禁用时，函数会一起分组。
 
正在加载
Salesforce Help | Article