Loading
Acerca de Salesforce Data 360
Funciones de fecha para fórmulas

Usted está aquí:

  1. Ayuda de Salesforce
  2. Documentos
  3. Datos 360

Funciones de fecha para fórmulas

Utilice funciones de fecha para ajustar o calcular valores desde fechas. Por ejemplo, puede agregar tiempo, encontrar tiempo hasta y extraer un día de la semana de campos de fecha. Los argumentos para funciones de fecha son campos de fecha.

Al ingresar una fórmula, utilice el nombre de la API del campo en la expresión, no la etiqueta. La sección de parámetros está rodeada por paréntesis. Por ejemplo, puede ingresar la siguiente expresión.

datediff(ClosedDate, CreatedDate)
Función de fecha Descripción Sintaxis
add_months Devuelve la fecha con el número especificado de meses tras la fecha de inicio.

add_months(startDate,num_months)

startDate es el campo de fecha en el que se calcula.

num_months es el número de meses agregados a startDate.
current_date Devuelve la fecha actual. current_date()
current_timestamp Devuelve la fecha y hora actuales. current_timestamp()
datediff Devuelve el número de días entre la fecha de inicio y la fecha de finalización.

datediff(endDate,startDate)

endDate es la última de las dos fechas entre las que está encontrando la diferencia.

startDate es la primera de las dos fechas entre las que está encontrando la diferencia.
date_add Devuelve la fecha con el número especificado de días tras la fecha de inicio.

date_add(startDate,num_days)

startDate es el campo de fecha en el que se calcula.

num_days es el número de días agregados a startDate. Solo se aceptan valores enteros estáticos.
date_format Convierte la marca de tiempo en un formato de fecha especificado.

date_format(field,'format')

field es una cadena o un campo/marca de tiempo de fecha para convertir al formato concreto.

'format' es el patrón de formato de fecha y hora a seguir.

Ejemplo: 

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

devuelve 2016
date_sub Devuelve el número especificado de días desde la fecha de inicio.

date_sub(startDate,num_days)

startDate es el campo de fecha en el que se calcula.

num_days es el número de días restados de startDate. Solo se aceptan valores enteros estáticos.
date_trunc Restablece la parte especificada de la marca de tiempo y todas las partes después a ésta a cero (o 01 para fecha y año). Especifique la parte de la marca de tiempo, fmt, con ‘year’, ‘quarter’, ‘month’, ‘week’, ‘day’, ‘hour’, ‘minute’ o ‘second’. Por ejemplo, dateTrunc para ‘year’ de 2019-05-01 12:31:32 devuelve 2019-01-01 00:00:00. Si sus datos son fecha y no fecha y hora, utilice la función trunc en su lugar.

date_trunc('format',timestamp)

'format' es el patrón de formato de fecha y hora a seguir.

timestamp es una cadena o fecha/marca de tiempo que se devuelve como una marca de tiempo de UNIX.

Ejemplo: 

date_trunc('week',CloseDate)

devuelve el lunes de la semana de la Fecha de cierre.
day Devuelve el componente día del mes de la fecha/marca de tiempo.

day(date)

date es el campo de fecha del que extraer el día del mes.
dayofmonth Devuelve el componente día del mes de la fecha/marca de tiempo.

dayofmonth(date)

date es el campo de fecha del que extraer el día del mes.
dayofweek Devuelve el componente día de la semana de la fecha/marca de tiempo. 1 = Domingo, 2 = Lunes, ..., 7 = Sábado.

dayofweek(date)

date es el campo de fecha del que extraer el día de la semana.
dayofyear Devuelve el componente día del año de la fecha/marca de tiempo.

dayofyear(date)

date es el campo de fecha del que extraer el día del año.
months_between Devuelve el número de meses entre dos marcas de tiempo. Calcula la diferencia basándose en 31 días por mes redondeada a 8 dígitos a menos que roundOff=false. Si marca de tiempo1 es posterior a marca de tiempo2, el resultado es positivo. Si marca de tiempo1 y marca de tiempo2 están en el mismo días del mes, o ambos son el último día del mes, el resultado es un entero y se ignora la hora del día.

months_between(timestamp2,timestamp1,roundOff(optional))

timestamp2 es una de las marcas de tiempo para comparar.

timestamp1 es la otra marca de tiempo para comparar.

roundOff(optional) es un booleano que determina si redondear el resultado. Este parámetro es opcional.
now Devuelve la fecha y la hora actuales en el formato especificado. now()
to_date Convierte la cadena de fecha al formato de fecha especificado. Devuelve nulo con entrada no válida.

to_date(field,'format(optional)')

field es un campo de cadena de fecha que desea convertir.

'format(optional)' es el patrón de formato de fecha y hora a seguir. Este parámetro es opcional. La función sigue reglas de selección en una fecha si el formato no está incluido.
to_timestamp Convierte la cadena de marca de tiempo al formato de marca de tiempo especificado.

to_timestamp(field,'format(optional)')

field es un campo de cadena de marca de tiempo que desea convertir.

'format(optional)' es el patrón de formato de marca de tiempo a seguir. Este parámetro es opcional. La función sigue reglas de selección en una marca de tiempo si el formato no está incluido.

Por ejemplo, 'M' o 'L' es el número de meses en un año que comienza desde 1. 

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

devuelve 

1

El valor AAAA/MM/DD es un año de 4 dígitos, un mes de 2 dígitos y un día del mes. 

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

devuelve

10-DEC-24 11.10.15.000000000 AM
to_unix_timestamp Devuelve la marca de tiempo UNIX de la hora especificada.

to_unix_timestamp(timestamp,format(optional)

timestamp es una cadena o fecha/marca de tiempo que se devuelve como una marca de tiempo de UNIX.

format(optional) es el patrón de formato de fecha/hora a seguir. format(optional) se ignora si timestamp no es una cadena. El valor predeterminado es "yyyy-MM-dd HH:mm:ss". Este parámetro es opcional.

Ejemplo: 

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

devuelve 

1460098800
trunc Sustituye la parte especificada de la marca de tiempo y todas las partes después, con ceros.

trunc(field,'format(optional)')

field es un campo de marca de tiempo.

'format(optional)' especifica la parte de la marca de tiempo para truncar. Los valores aceptados son "YEAR", "YYYY", "YY", "MON", "MONTH", "MM", "DAY", "DD", "HOUR", "MINUTE", "SECOND", "WEEK" y "QUARTER".

Ejemplo: 

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

devuelve 

2015-03-01T00:00:00

Consideraciones de funciones de fecha y hora

Tenga en cuenta estos comportamientos cuando trabaje con funciones de fecha y hora.

  • Estas funciones son relativas a cuando se ejecuta la transformación de datos por lotes.
    • now
    • current_date
    • current_timestamp
    • to_unix_timestamp
  • Todas las funciones de fecha y fecha y hora se basan en la zona horaria UTC.
  • Cuando la Admisión de Zona horaria personalizada está activada, las funciones de fecha y las funciones DateTime están separadas. Cuando se desactiva, las funciones se agrupan entre sí.
 
Cargando
Salesforce Help | Article