Guía de referencia de los módulos Date/Time

Propiedad	Tipo	Descripción
years	Número	Un número de cuatro dígitos que representa el año de la fecha especificada.
months	Número	Representa el mes del año en la fecha especificada. Enero es igual a 1.
date	Número	Representa la fecha del mes en la fecha especificada.
hours	Número	Representa las horas del día de una fecha u hora específica.
minutes	Número	Representa los minutos de la hora de una fecha u hora específica.
seconds	Número	Representa los segundos del minuto de una fecha u hora específica.
milliseconds	Número	Representa los milisegundos del segundo de una fecha u hora específica.
offset	Cadena	El desplazamiento de Tiempo Universal Coordinado (UTC) en una cadena con formato ±HH:mm.
iso	Cadena	Cadena que representa la fecha u hora con formato estándar ISO-8601. P. ej., AAAA-MM-DDTHH:mm:ssZ
utc	Cadena	Cadena que representa la fecha u hora en UTC con formato estándar ISO-8601.
unix	Número	Un número que representa la marca de tiempo Unix de la fecha u hora.
isValid	Valor booleano	Un valor booleano que indica si la fecha u hora es válida o no.

Propiedad	Tipo	Descripción
years	Número	Un número entero que representa la cantidad de años transcurridos entre las dos fechas.
months	Número	Un número entero que representa la cantidad de meses transcurridos luego de calcular la cantidad de años entre las dos fechas.
days	Número	Un número entero que representa la cantidad de días transcurridos luego de calcular la cantidad de meses y años entre las dos fechas.
hours	Número	Un número entero que representa la cantidad de horas transcurridas luego de calcular la cantidad de días, meses y años entre las dos fechas.
minutes	Número	Un número entero que representa la cantidad de minutos transcurridos luego de calcular la cantidad de horas, días, meses y años entre las dos fechas.
seconds	Número	Un número entero que representa la cantidad de segundos transcurridos luego de calcular la cantidad de minutos, horas, días, meses y años entre las dos fechas.
milliseconds	Número	Un número entero que representa la cantidad de milisegundos transcurridos luego de calcular la cantidad de segundos, minutos, horas, días, meses y años entre las dos fechas.
iso	Cadena	Cadena que representa la duración con formato estándar ISO-8601.
humanized	Cadena	Cadena que representa el formato legible por el usuario de la hora. Respuesta similar al módulo Date/Time con formato relativo. P. ej., “2 años”.
isDuration	Valor booleano	Un valor booleano que indica si el objeto es de duración o no. Esto siempre será verdadero si el objeto es válido.
isValid	Valor booleano	Un valor booleano que indica si la fecha u hora es válida o no.
in	Objecto	Cada valor de este objeto es similar a la propiedad de esta tabla, pero omite todas las demás unidades de tiempo. P. ej., exactamente 2 años entre dos fechas serán 24 meses.

	Token	Resultado
Mes	M	1 2 ... 11 12
	Mo	1st 2nd ... 11th 12th
	MM	01 02 ... 11 12
	MMM	Jan Feb ... Nov Dec
	MMMM	January February ... November December
Quarter	Q	1 2 3 4
	Qo	1st 2nd 3rd 4th
Day of Month	D	1 2 ... 30 31
	Do	1st 2nd ... 30th 31st
	DD	01 02 ... 30 31
Day of Year	DDD	1 2 ... 364 365
	DDDo	1st 2nd ... 364th 365th
	DDDD	001 002 ... 364 365
Day of Week	d	0 1 ... 5 6
	do	0th 1st ... 5th 6th
	dd	Su Mo ... Fr Sa
	ddd	Sun Mon ... Fri Sat
	dddd	Sunday Monday ... Friday Saturday
Day of Week (ubicación)	e	0 1 ... 5 6
Day of Week (ISO)	E	1 2 ... 6 7
Week of Year	w	1 2 ... 52 53
	wo	1st 2nd ... 52nd 53rd
	ww	01 02 ... 52 53
Week of Year (ISO)	W	1 2 ... 52 53
	Wo	1st 2nd ... 52nd 53rd
	WW	01 02 ... 52 53
Year	YY	70 71 ... 29 30
	YYYY	1970 1971 ... 2029 2030
	Y	1970 1971 ... 9999 +10000 +10001 Nota: Esto se ajusta a la norma ISO-8601 para las fechas posteriores al año 9999
Week Year	gg	70 71 ... 29 30
	gggg	1970 1971 ... 2029 2030
Week Year (ISO)	GG	70 71 ... 29 30
	GGGG	1970 1971 ... 2029 2030
AM/PM	A	AM PM
	a	am pm
Hour	H	0 1 ... 22 23
	HH	00 01 ... 22 23
	h	1 2 ... 11 12
	hh	01 02 ... 11 12
	k	1 2 ... 23 24
	kk	01 02 ... 23 24
Minute	m	0 1 ... 58 59
	mm	00 01 ... 58 59
Second	s	0 1 ... 58 59
	ss	00 01 ... 58 59
Fractional Second	S	0 1 ... 8 9
	SS	00 01 ... 98 99
	SSS	000 001 ... 998 999
	SSSS ... SSSSSSSSS	000[0..] 001[0..] ... 998[0..] 999[0..]
Time Zone	z o zz	EST CST ... MST PST
	Z	-07:00 -06:00 ... +06:00 +07:00
	ZZ	-0700 -0600 ... +0600 +0700
Unix Timestamp	X	1360013296
Unix Millisecond Timestamp	x	1360013296123

 

Módulo Check Date/Time

El módulo Check Date/Time verifica una fecha de entrada de acuerdo con las condiciones especificadas y direcciona el flujo de trabajo en consecuencia.

La forma más sencilla de usarlo es hacer referencia al objeto Date/Time completo.

 

Campos del módulo Check Date/Time

• Date: Una entrada obligatoria que debe comprobarse. La entrada puede ser una cadena con formato ISO-8601, una marca de tiempo Unix o el resultado de un objeto Date/Time estructurado de otro módulo Date/Time.
• Condition: Especifique la operación condicional para comparar con la fecha de entrada. Puede elegir entre las siguientes opciones:
  • Day of Week: Envía el flujo de trabajo por la ruta “Success” si la fecha coincide con uno de los días seleccionados.
  • Is Before another Date: Envía el flujo de trabajo por la ruta “Success” si la fecha es anterior (o igual) a una fecha de referencia proporcionada.
  • Is After another Date: Envía el flujo de trabajo por la ruta “Success” si la fecha es posterior (o igual) a una fecha de referencia proporcionada.
  • Is Between two Dates: Envía el flujo de trabajo por la ruta “Success” si la fecha es anterior (o igual) y posterior (o igual) a dos fechas de referencia proporcionadas.
  • Is a Leap Year: Envía el flujo de trabajo por la ruta “Success” si la fecha corresponde a un año bisiesto. Enviará el flujo de trabajo por la ruta “Failed” si la fecha no corresponde a un año bisiesto o si la fecha no contiene un año, p. ej., si solo se indicó el mes.

Fechas de referencia

Si desea verificar si una fecha es anterior o posterior a una fecha, o si se encuentra entre dos o más fechas de referencia, se requieren estas entradas. Estas entradas pueden ser una cadena con formato ISO-8601, una marca de tiempo Unix o el resultado de un objeto Date/Time estructurado de otro módulo Date/Time.

Fechas de referencia inclusivas

Al usar fechas de referencia, las fechas se consideran exclusivas de forma predeterminada (p. ej., es anterior y no es igual a). Al establecer este parámetro en verdadero, se calculará la condición en función de las fechas de referencia inclusivas (p. ej., es anterior o igual a).

Módulo Compare Date/Time

El módulo Compare Date/Time compara dos objetos Date/Time, lo que genera una diferencia absoluta entre ellos.

Campos del módulo Compare Date/Time

• First Date: Una fecha de entrada obligatoria para comparar. La entrada puede ser una cadena con formato ISO-8601, una marca de tiempo Unix o el resultado de un objeto Date/Time estructurado de otro módulo Date/Time.
• Second Date: Una fecha de entrada obligatoria con la que se hará la comparación. La entrada puede ser una cadena con formato ISO-8601, una marca de tiempo Unix o el resultado de un objeto Date/Time estructurado de otro módulo Date/Time.
• Include End Date: Si se selecciona esta opción, la segunda fecha de entrada se incluye en el cálculo. P. ej., entre el lunes y el viernes habría 5 días en lugar de 4.

Datos arrojados del módulo Compare Date/Time

Si el módulo se ejecuta correctamente, devolverá un objeto Duration estructurado.

Módulo Current Date/Time

El módulo Current Date/Time arrojará el momento en el tiempo actual como un objeto Date/Time estructurado que se puede manipular y se le puede asignar un formato.

Campos del módulo Current Date/Time

• Offset: Cómo definir el desplazamiento de UTC para la entrada. Se pueden establecer compensaciones por hora de -12:00 horas a +12:00 horas; o bien, puede tener un mayor control del desplazamiento de UTC mediante las siguientes opciones.
  • None: La entrada se analizará tal como está. Si no hay un desplazamiento definido en la cadena de entrada, no se aplicará ningún desplazamiento. Si analiza una cadena que incluye un desplazamiento (por ejemplo, una cadena con formato ISO-8601), este se establecerá en el mismo valor que el desplazamiento de la cadena. P. ej., 2017-07-02T21:30:00-07:00 tendrá un desplazamiento de -07:00 horas.
  • Timezone Offset: Elija una zona horaria para calcular el desplazamiento de UTC. Este cálculo representa el horario de verano que se adopta en ciertas zonas horarias durante determinados períodos.
  • Lat/Long Offset: Especifique una ubicación a partir de una cadena de latitud y longitud separada por una coma (,). El horario de verano se tendrá en cuenta para calcular el desplazamiento. P. ej., 47.650499,-122.350070 sería Estados Unidos/Los_Angeles, y se calcularía con -08:00 horas en invierno y -07:00 horas en verano.
  • Custom Offset: Defina un desplazamiento personalizado con el formato ±HH:mm. P. ej., ocho horas y media más: +08:30

Datos arrojados del módulo Current Date/Time

Si la cadena de entrada se analiza correctamente, el módulo arrojará un objeto Date/Time estructurado.

Módulo Format Date/Time

El módulo Format Date/Time dará formato a un objeto Date/Time estructurado para cualquier cadena definida por el usuario.

Campos del módulo Format Date/Time

• Date: Entrada obligatoria a la que se le dará formato en una cadena. La entrada puede ser una cadena con formato ISO-8601, una marca de tiempo Unix o el resultado de un objeto Date/Time estructurado de otro módulo Date/Time.
• Format: El formato del resultado arrojado. Elija entre las opciones comunes, utilice tokens de fecha/hora para crear un formato personalizado o especifique otro objeto Date/Time para un formato relativo.

Datos arrojados del módulo Format Date/Time

Los siguientes formatos se mostrarán con una fecha de ejemplo del 11 de marzo de 1952 a las 8:15 a.m.

ISO-8601

Muestra el formato de acuerdo con la norma ISO-8601 (AAAA-MM-DDTHH:mm:ssZ) - 1952-03-11T08:15:00+00:00

AAAA-MM-DD

1952-03-11

MM/DD/AAAA

03/11/1952

DD-MM-AAAA

11/03/1952

MM/DD

03/11

DD/MM

11/03

HH:mm

08:15

HH:mm:ss

08:15:00

Formato personalizado

Utilice los tokens del módulo Format Date/Time para crear una cadena con formato personalizado. Las cadenas también pueden contener caracteres que no son tokens, p. ej., D de MMMM de AAAA - 11 de marzo de 1952

Formato relativo

Proporcione otro objeto Date/Time para aplicar un formato relativo a la entrada. La unidad de tiempo se redondea a la unidad de cambio más grande, p. ej.: proporcione una cadena de fecha/hora estándar “ISO-8601” de 1952-03-13T09:15:00+00:00 y el resultado será “hace 2 días” en lugar de “hace 2 días y 23 horas”. Esta es una forma sencilla de obtener formatos humanizados. Si necesita más detalles, consulte el módulo Compare Date/Time y el objeto Duration resultante.

Módulo Manipulate Date/Time

El módulo Manipulate Date/Time permite manipular un objeto Date/Time estructurado al sumar, restar o definir unidades de tiempo.

 

Campos del módulo Manipulate Date/Time

• Operation: Manipule la fecha de entrada al optar por sumar, restar o definir unidades de tiempo.
  • Add: Manipule la fecha de entrada al sumar unidades de tiempo.
  • Substract: Manipule la fecha de entrada al restar unidades de tiempo.
  • Set: Manipule la fecha de entrada al definir unidades de tiempo.
• Date: Entrada requerida que se manipulará. La entrada puede ser una cadena con formato ISO-8601, una marca de tiempo Unix o el resultado de un objeto Date/Time estructurado de otro módulo Date/Time.
• Years: Cuántos años se deben sumar o restar de la fecha de entrada. Si utiliza la operación Set, se definirá el año (p. ej., 1952).
• Months: Cuántos meses se deben sumar o restar de la fecha de entrada. Si utiliza la operación Set, se definirá el mes (p. ej., 1 a 12).
• Days: Cuántos días se deben sumar o restar de la fecha de entrada. Si utiliza la operación Set, se definirá la fecha del mes.
• Hours: Cuántas horas se deben sumar o restar de la fecha de entrada. Si utiliza la operación Set, se definirá la hora (0 a 23).
• Minutes: Cuántos minutos se deben sumar o restar de la fecha de entrada. Si utiliza la operación Set, se definirá el minuto (0 a 59).
• Seconds: Cuántos segundos se deben sumar o restar de la fecha de entrada. Si utiliza la operación Set, se definirá el segundo (0 a 59).
• Duration: Además de sumar o restar una unidad de tiempo, también es posible sumar o restar una duración. Esto se representa como una cadena de duración estándar ISO-8601 o un objeto Duration del resultado del módulo Compare Date/Time.

Datos arrojados del módulo Manipulate Date/Time

Si la cadena de entrada se analiza correctamente, el módulo arrojará un objeto Date/Time estructurado.

Módulo Parse Date/Time

El módulo Parse Date/Time arrojará una fecha en un objeto Date/Time estructurado que se puede manipular y se le puede asignar un formato.

Junto con las fechas legibles por el ser humano, este módulo puede analizar cadenas estándar ISO-8601, cadenas estándar RFC 2822, marcas de tiempo Unix o el resultado de otro módulo Parse Date/Time. Si la entrada no es válida, arrojará un objeto Date/Time no válido.

 

Campos del módulo Parse Date/Time

• Date: Una entrada obligatoria que se analizará en un objeto Date/Time estructurado. La entrada puede estar en cualquier cadena legible por el ser humano, ISO-8601, RFC 2822, marca de tiempo Unix o el resultado de otro módulo Parse Date/Time.
• Locale: Opcional para indicar la configuración regional de la entrada. La configuración regional se utiliza para distinguir patrones comunes, p. ej, el 5 de abril de 2017 puede ser 04/05/2017 en la configuración regional de EE. UU. o 05/04/2017 en la configuración regional del Reino Unido. Estos patrones son extremadamente difíciles de distinguir, por lo que se recomienda especificar la configuración regional adecuada para satisfacer sus necesidades. El formato predeterminado es el estadounidense (en).
• UTC Offset: Cómo definir el desplazamiento de UTC para la entrada. Se pueden establecer compensaciones por hora de -12:00 horas a +12:00 horas; o bien, puede tener un mayor control del desplazamiento de UTC mediante las siguientes opciones.
  • None: La entrada se analizará tal como está. Si no hay un desplazamiento definido en la cadena de entrada, no se aplicará ningún desplazamiento. Si analiza una cadena que incluye un desplazamiento (por ejemplo, una cadena con formato “ISO-8601”), este se establecerá en el mismo valor que el desplazamiento de la cadena. P. ej., 2017-07-02T21:30:00-07:00 tendrá un desplazamiento de -07:00 horas.
  • Timezone Offset: Elija una zona horaria para calcular el desplazamiento de UTC. Este cálculo representa el horario de verano que se adopta en ciertas zonas horarias durante determinados períodos.
  • Lat/Long Offset: Especifique una ubicación a partir de una cadena de latitud y longitud separada por una coma (,). El horario de verano se tendrá en cuenta para calcular el desplazamiento. P. ej., 47.650499,-122.350070 sería Estados Unidos/Los_Angeles, y se calcularía con -08:00 horas en invierno y -07:00 horas en verano.
  • Custom Offset: Defina un desplazamiento personalizado con el formato ±HH:mm. P. ej., ocho horas y media más: +08:30

Datos arrojados del módulo Parse Date/Time

Si la cadena de entrada se analiza correctamente, el módulo arrojará un objeto Date/Time estructurado.

Módulo Round Date/Time

El módulo Round Date/Time arrojará el inicio o el final de una unidad de tiempo especificada de un objeto Date/Time estructurado determinado.

Campos del módulo Round Date/Time

• Start/End: Redondea la entrada al inicio o al final de la unidad de tiempo especificada.
  • Start: Redondea la entrada al inicio de una unidad de tiempo. P. ej., 8:15 a.m. se convertirá en 8:00 a.m.
  • End: Redondea la entrada al final de una unidad de tiempo. P. ej., 8:15 a.m. se convertirá en 8:59 a.m.
• Date: Entrada requerida que se redondeará hacia arriba o hacia abajo según la unidad especificada. La entrada puede ser una cadena con formato ISO-8601, una marca de tiempo Unix o el resultado de un objeto Date/Time estructurado de otro módulo Date/Time.
• Unit of Time: La unidad de tiempo a la que desea redondear hacia arriba o hacia abajo. Puede elegir entre las siguientes opciones:
  • Year
  • Quarter
  • Month
  • Week
  • Day
  • Hour
  • Minute

First Day of Week

El primer día de la semana puede varias en diferentes partes del mundo, por lo que cuando la unidad de tiempo seleccionada es Week, esta opción le permite indicar qué día se considera el primero de la semana.

Datos que arroja el módulo Round Date/Time

Si la cadena de entrada se analiza correctamente, el módulo arrojará un objeto Date/Time estructurado.