Funciones de fecha y hora en Adobe Workfront Fusion

Requisitos de acceso

Debe tener el siguiente acceso para utilizar la funcionalidad de este artículo:

Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación de Workfront.

Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.

Variables

now

timestamp

Funciones

addSeconds (fecha; número)

Devuelve una nueva fecha como resultado de agregar un número determinado de segundos a una fecha. Para restar segundos, introduzca un número negativo.

addMinutes (fecha; número) addminutes-date-number

Devuelve una nueva fecha como resultado de agregar un número determinado de minutos a una fecha. Para restar minutos, introduzca un número negativo.

addHours (fecha; número) addhours-date-number

Devuelve una nueva fecha como resultado de agregar un número determinado de horas a una fecha. Para restar horas, introduzca un número negativo.

addDays (fecha; número) adddays-date-number

Devuelve una nueva fecha como resultado de agregar un número determinado de días a una fecha. Para restar días, introduzca un número negativo.

addMonths (fecha; número)

Devuelve una nueva fecha como resultado de agregar un número determinado de meses a una fecha. Para restar meses, introduzca un número negativo.

addYears (fecha; número)

Devuelve una nueva fecha como resultado de agregar un número determinado de años a una fecha. Para restar años, introduzca un número negativo.

setSecond (fecha; número)

Esta función devuelve una nueva fecha con los segundos especificados en parámetros.

Especifique un número del 0 al 59. Si el número está fuera de ese intervalo, la función devuelve un segundo desde el minuto anterior (para un número negativo) o un minuto posterior (para un número positivo).

Si necesita especificar un número fuera del intervalo, le recomendamos que utilice​ addSeconds, tal como se describe más arriba en la sección addSeconds (fecha; número).

setMinute (fecha; número)

Esta función devuelve una nueva fecha con los minutos especificados en los parámetros.

Especifique un número del 0 al 59. Si el número está fuera de ese intervalo, la función devuelve un minuto desde la hora anterior (para un número negativo) o una hora posterior (para un número positivo).

Si necesita especificar un número fuera del intervalo, le recomendamos que utilice addMinutes, tal como se describe anteriormente en addMinutes (fecha; número).

setHour (date; number)

Esta función devuelve una nueva fecha con la hora especificada en parámetros.

Especifique un número del 0 al 23. Si el número está fuera de este intervalo, la función devuelve una hora desde el día anterior (para un número negativo) o un día posterior (para un número positivo).

Si necesita especificar un número fuera del intervalo, le recomendamos que utilice addHours, tal como se describe anteriormente en addHours (fecha; número).

setDay (fecha; número/nombre del día en inglés)

Esta función devuelve una nueva fecha con el día especificado en parámetros.

Puede utilizar esta función para establecer el día de la semana, con domingo como 1 y sábado como 7. Si especifica un número del 1 al 7, la fecha resultante se encuentra dentro de la semana actual (de domingo a sábado). Si el número está fuera de ese intervalo, la función devuelve un día de la semana anterior (para un número negativo) o de la semana siguiente (para un número positivo).

Si necesita especificar un número fuera del intervalo, le recomendamos que utilice addDays, tal como se describe anteriormente en addDays (fecha; número).

setDate (fecha; número)

Esta función devuelve una nueva fecha con el día del mes especificado en parámetros.

Especifique un número del 1 al 31. Si el número está fuera de este intervalo, la función devuelve un día del mes anterior (para un número negativo) o del mes siguiente (para un número positivo).

setMonth (fecha; número/nombre del mes en inglés)

Esta función devuelve una nueva fecha con el mes especificado en parámetros.

Especifique un número del 1 al 12. Si el número está fuera de este intervalo, la función devuelve el mes del año anterior (para un número negativo) o del año siguiente (para un número positivo).

setYear (fecha; número)

Devuelve una nueva fecha con el año especificado en parámetros.

formatDate (fecha; formato; [timezone])

Utilice esta función cuando tenga un valor Date como, por ejemplo, 12-10-2021 20:30, que desea formatear como un valor de texto, como Dec 10, 2021 8:30 PM.

Esto resulta útil, por ejemplo, cuando necesita cambiar el formato de fecha de una aplicación o servicio web al de una aplicación o servicio web conectado en el mismo escenario.

Para obtener más información, consulte Fecha y Texto en el artículo Tipos de datos de elementos en Adobe Workfront Fusion.

Parámetros

Si se proporciona un tipo diferente, se aplica coerción de tipo. Para obtener más información, consulte Coerción de tipos en Adobe Workfront Fusion.

Valor devuelto y tipo

El formatDate función devuelve una representación de texto del valor Date dado según el formato y la zona horaria especificados. El tipo de datos es Texto.

INFO

Ejemplos: Tanto el escenario como la zona horaria web se establecieron en Europe/Prague en estos ejemplos.

• formatDate(1. Date created;MM/DD/YYYY)

  Devuelve 10/01/2018

• formatDate(1. Date created; YYYY-MM-DD hh:mm A)

  Devuelve 2018-10-01 09:32 AM

• formatDate(1. Date created;DD.MM.YYYY HH:mm;UTC)

  Devuelve 01.10.2018 07:32

• formatDate(now;DD.MM.YYYY HH:mm)

  Devuelve 19.03.2019 15:30

parseDate (texto; formato; [timezone])

Utilice esta función cuando tenga un valor de texto que represente una fecha (como 12-10-2019 20:30 o Aug 18, 2019 10:00 AM) y desea convertirlo (analizarlo) en un valor Date (una representación binaria legible por máquina). Para obtener más información, consulte Fecha y Texto en el artículo Tipos de datos de elementos en Adobe Workfront Fusion.

Parámetros

La segunda columna indica el tipo esperado. Si se proporciona un tipo diferente, se aplica coerción de tipo. Para obtener más información, consulte Coerción de tipos en Adobe Workfront Fusion.

Si se proporciona un tipo diferente, se aplica coerción de tipo. Para obtener más información, consulte Coerción de tipos en Adobe Workfront Fusion.

Valor devuelto y tipo

Esta función convierte una cadena de texto en una fecha, según el formato y la zona horaria que especifique. El tipo de datos del valor es Fecha.

dateDifference (Date1; Date2; Unit)

Devuelve un número que representa la diferencia entre las dos fechas, expresada en la unidad especificada.

Fecha2 se resta de Fecha1.

Utilice uno de los siguientes valores de tiempo para unit parámetro:

Si no se especifica ninguna unidad, la función devuelve la diferencia en milisegundos.

Ejemplos adicionales

Cómo calcular el n-º día de la semana del mes

Esta sección está adaptada para Workfront Fusion desde el Exceljet página web que explica cómo obtener el enésimo día de la semana de un mes.

Si necesita calcular una fecha correspondiente al n-º día de la semana del mes (por ejemplo, primer martes, tercer viernes, etc.), puede utilizar la siguiente fórmula:

{{addDays(setDate(1.date; 1); 1.n * 7 - formatDate(addDays(setDate(1.date; 1); "-" + 1.dow); "E"))}}

La fórmula contiene los siguientes elementos:

Si desea calcular solo un caso específico, por ejemplo, cada segundo miércoles, puede reemplazar los elementos 1.n y 2.dow en la fórmula con los números correspondientes. Para el segundo miércoles del mes actual, se utilizarían los siguientes valores:

Explicación:

Cálculo de días entre fechas

Una posibilidad es utilizar la siguiente expresión:

{{round((2.value - 1.value) / 1000 / 60 / 60 / 24)}}

Cómo calcular el último día/milisegundo del mes

Cuando se especifica un intervalo de fechas, por ejemplo, en un módulo de búsqueda, si el intervalo abarca todo el mes anterior como un intervalo cerrado (el intervalo que incluye ambos puntos límite), se debe calcular el último día del mes.

01-09-2019 ≤ D ≤ 30-09-2019

La fórmula siguiente muestra una forma de calcular el último día del mes anterior:

{{addDays(setDate(now; 1); -1)}}

En algunos casos, debe calcular no solo el último día del mes, sino literalmente su último milisegundo:

01-09-2019 T00:00:00.000Z ≤ D ≤ 2019-09-30T23:59:59,999Z

Esta fórmula muestra una forma de calcular el último milisegundo del mes anterior:

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD"; "UTC") - 1; "x")}}

Si necesita que el resultado utilice la configuración de zona horaria, omita el argumento UTC:

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD") - 1; "x")}}

Sin embargo, es preferible utilizar el intervalo de semiapertura en su lugar (el intervalo que excluye uno de sus puntos límite), especificando el primer día del mes siguiente en su lugar y sustituyendo el operador "menor o igual que" por "menor que" de la siguiente manera:

2019-09-01 ≤ D < 2019-10-01

2019-09-01T00:00:00.000Z ≤ D < 2019-10-01T00:00:00.000Z