Guia de referência de Date/Time

Propriedade	Tipo	Descrição
years	Número	Um número de quatro dígitos que representa o ano da data especificada.
months	Número	Representa o mês do ano na data especificada. Janeiro é igual a 1.
date	Número	Representa a data do mês na data especificada.
hours	Número	Representa as horas no dia de uma data ou hora específica.
minutes	Número	Representa os minutos na hora de uma data ou hora específica.
seconds	Número	Representa os segundos no minuto de uma data ou hora específica.
milliseconds	Número	Representa os milissegundos no segundo de uma data ou hora específica.
offset	Cadeia de caracteres	O deslocamento do Tempo Universal Coordenado (UTC) em uma cadeia de caracteres formatada de ±HH:mm.
iso	Cadeia de caracteres	Uma sequência de caracteres que representa a data/hora em uma sequência de caracteres formatada padrão ISO-8601. Por exemplo: AAAA-MM-DDTHH:mm:ssZ
utc	Cadeia de caracteres	Uma sequência de caracteres que representa a data/hora em UTC na cadeia de caracteres formatada padrão ISO-8601.
unix	Número	Um número que representa o carimbo unix de Date/Time.
isValid	Booleano	Um valor booleano que representa a validade ou não da data/hora.

Propriedade	Tipo	Descrição
years	Número	Um número inteiro que representa o número de anos transcorridos entre as duas datas.
months	Número	Um número inteiro que representa o número de meses transcorridos depois de calcular o número de anos entre as duas datas.
days	Número	Um número inteiro que representa o número de dias transcorridos depois de calcular o número de meses e anos entre as duas datas.
hours	Número	Um número inteiro que representa o número de horas transcorridas depois de calcular o número de dias, meses e anos entre as duas datas.
minutes	Número	Um número inteiro que representa o número de minutos transcorridos depois de calcular o número de horas, dias, meses e anos entre as duas datas.
seconds	Número	Um número inteiro que representa o número de minutos transcorridos depois de calcular o número de minutos, horas, dias, meses e anos entre as duas datas.
milliseconds	Número	Um número inteiro que representa o número de minutos transcorridos depois de calcular o número de segundos, minutos, horas, dias, meses e anos entre as duas datas.
iso	Cadeia de caracteres	Uma cadeia de caracteres que representa a duração em uma cadeia de caracteres com formatação padrão ISO-8601.
humanized	Cadeia de caracteres	Uma cadeia de caracteres que representa o formato de tempo legível para humanos. Resposta semelhante ao módulo Format Date/Time com formatação relativa. Por exemplo, "2 anos".
isDuration	Booleano	Um valor booleano que indica se este é um objeto de duração ou não. Isso sempre será verdadeiro se o objeto for válido.
isValid	Booleano	Um valor booleano que representa a validade ou não da data/hora.
in	Object	Cada valor neste objeto é semelhante à propriedade nesta tabela, mas ignora todas as outras unidades de tempo. Por exemplo: exatamente 2 anos entre duas datas serão 24 meses.

	Token	Resultado
Month	M	1 2 ... 11 12
	Mo	1 2 ... 11 12
	MM	01 02 ... 11 12
	MMM	Jan Fev ... Nov Dez
	MMMM	Janeiro Fevereiro ... Novembro Dezembro
Quarter	Q	1 2 3 4
	Qo	1º 2º 3º 4º
Day of Month	D	1 2 ... 30 31
	Do	1 2 ... 30 31
	DD	01 02 ... 30 31
Day of Year	DDD	1 2 ... 364 365
	DDDo	1º 2º ... 364º 365º
	DDDD	001 002 ... 364 365
Day of Week	d	0 1 ... 5 6
	do	0º 1º ... 5º 6º
	dd	Do Se ... Se Sa
	ddd	Dom Seg ... Sex Sáb
	dddd	Domingo Segunda ... Sexta Sábado
Day of Week (Locale)	e	0 1 ... 5 6
Day of Week (ISO)	E	1 2 ... 6 7
Week of Year	w	1 2 ... 52 53
	wo	1º 2º ... 52º 53º
	ww	01 02 ... 52 53
Week of Year (ISO)	W	1 2 ... 52 53
	Wo	1º 2º ... 52º 53º
	WW	01 02 ... 52 53
Ano	AA	70 71 ... 29 30
	AAAA	1970 1971 ... 2029 2030
	Y	1970 1971 ... 9999 +10000 +10001 Observação: está em conformidade com a norma ISO 8601 para datas após o ano de 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
Hora	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
Segundo fracionário	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 ou 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

O módulo Check Date/Time verifica uma data de entrada em relação às condições especificadas e encaminha o fluxo de trabalho acordo.

A maneira mais simples de usar isso é fazer referência a todo o objeto Date/Time.

 

Campos de Check Date/Time

• Date: uma entrada necessária a ser verificada. A entrada pode ser uma cadeia de caracteres com formatação ISO-8601, Unix Timestamp ou a saída estruturada do objeto Date/Time de outro módulo Date/Time.
• Condition: especifique a operação condicional a ser verificada em relação à data de entrada. Você poderá escolher entre as seguintes opções:
  • Day of Week: encaminha o fluxo de trabalho pelo caminho "Success" se a data corresponder a um dos dias selecionados.
  • Is Before another Date: encaminha o fluxo de trabalho para o caminho "Success" se a data for anterior (ou igual) a uma data de referência fornecida.
  • Is After another Date: encaminha o fluxo de trabalho para o caminho "Success" se a data for posterior (ou igual) a uma data de referência fornecida.
  • Is Between two Dates: encaminha o fluxo de trabalho para o caminho "Success" se a data for anterior (ou igual) e posterior (ou igual) a duas datas de referência fornecidas.
  • Is a Leap Year: encaminha o fluxo de trabalho pelo caminho "Sucess" se a data for um ano bissexto. Encaminhará o fluxo de trabalho para o caminho "Failed" se a data não estiver em um ano bissexto ou se não contiver um ano, por exemplo, se apenas o mês tiver sido inserido ou referenciado.

Datas de referência

Caso opte por verificar se uma data é anterior, posterior ou entre uma ou mais datas de referência, essas entradas são obrigatórias. A entrada pode ser uma cadeia de caracteres com formatação "ISO-8601", Unix Timestamp ou a saída estruturada do objeto Date/Time de outro módulo Date/Time.

Datas de referência inclusivas

Ao usar datas de referência, as datas são consideradas exclusivas por padrão (por exemplo, É antes e não é a mesmo que). Definir este parâmetro como "true" (verdadeiro) calculará a condição com base em datas de referência inclusivas (por exemplo, É antes ou igual a).

Módulo Compare Date/Time

O módulo Compare Date/Time compara dois objetos de Date/Time, resultando na diferença absoluta entre eles.

Campos de Compare Date/Time

• First Date: uma data de entrada necessária para comparar. A entrada pode ser uma cadeia de caracteres com formatação ISO-8601, Unix Timestamp ou a saída estruturada do objeto Date/Time de outro módulo Date/Time.
• Second Date: uma data de entrada necessária para comparar. A entrada pode ser uma cadeia de caracteres com formatação ISO-8601, Unix Timestamp ou a saída estruturada do objeto Date/Time de outro módulo Date/Time.
• Include End Date: se selecionado, a segunda data de entrada será incluída no cálculo. Por exemplo: De segunda a sexta-feira seriam cinco dias em vez de quatro.

Retornos de Compare Date/Time

Se o módulo for bem-sucedido, ele retornará um objeto de duração estruturado.

Módulo Current Date/Time

O módulo Current Date/Time retornará o momento atual no tempo como um objeto Date/Time estruturado que pode ser manipulado ou formatado.

Campos de Current Date/Time

• Offset: como definir o deslocamento de UTC para a entrada. Os deslocamentos por hora de -12:00 horas a +12:00 horas podem ser definidos ou você pode ter maior controle sobre o deslocamento de UTC com as opções a seguir.
  • None: a entrada será analisada como está! Se não houver deslocamento definido na cadeia de caracteres de entrada, nenhum deslocamento será aplicado. Se você estiver analisando uma cadeia de caracteres que inclui um deslocamento (por exemplo, uma cadeia de caracteres com formatação ISO-8601), o deslocamento será definido como o mesmo do deslocamento da cadeia de caracteres. Por exemplo, 2017-07-02T21:30:00-07:00 terá um deslocamento de -07:00 horas.
  • Timezone Offset: escolha um fuso horário para calcular o deslocamento de UTC. Esse cálculo é responsável por qualquer horário de verão que possa ocorrer em determinados fusos horários em datas específicas.
  • Lat/Long Offset: especifique um local a partir de uma cadeia de caracteres de latitude e longitude separada por uma vírgula (,). O horário de verão será incluído no cálculo do deslocamento. Por exemplo, 47.650499, -122.350070 seria América/Los_Angeles e calcularia para -08:00 no inverno e -07:00 no verão.
  • Custom Offset: defina um deslocamento personalizado no formato de ±HH:mm. Por exemplo: mais oito horas e meia: +08:30

Dados retornados de Current Date/Time

Se a cadeia de caracteres de entrada for analisada com sucesso, o módulo retornará um objeto Date/Time estruturado.

Módulo Format Date/Time

O módulo Format Date/Time formatará um objeto Date/Time estruturado para qualquer cadeia de caracteres definida pelo usuário.

Campos de Format Date/Time

• Data: uma entrada necessária a ser formatada em uma cadeia de caracteres. A entrada pode ser uma cadeia de caracteres com formatação ISO-8601, Unix Timestamp ou a saída estruturada do objeto Date/Time de outro módulo Date/Time.
• Format: o formato da saída retornada. Escolha uma das opções comuns, use tokens de Date/Time para criar um formato personalizado ou especifique outro objeto Date/Time para um formato relativo.

Dados retornados de Format Date/Time

Os formatos a seguir serão mostrados com uma data de exemplo de 11 de março de 1952 às 8h15.

ISO-8601

Saída do formato no formato de data e hora padrão 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

Use tokens de Date/Time Format para criar uma cadeia de caracteres de formato personalizado. Os caracteres que não são tokens também podem criar uma cadeia de caracteres, por exemplo: Do de MMMM, AAAA – 11 de março de 1952

Formato relativo

Forneça outro objeto Date/Time para formatar relativamente a entrada. A unidade de tempo é arredondada para a maior unidade de mudança, por exemplo: forneça uma sequência de data/hora padrão "ISO-8601" de 1952-03-13T09:15:00+00:00 e a saída será "2 dias atrás" em vez de "2 dias e 23 horas atrás". Esta é uma maneira simples de obter formatos humanizados. Se precisar de mais granularidade, consulte o módulo Compare Date/Time e o objeto de duração resultante.

Módulo Manipulate Date/Time

O módulo Manipulate Date/Time pode manipular um objeto Date/Time estruturado adicionando, subtraindo ou definindo unidades de tempo.

 

Campos de Manipulate Date/Time

• Operation: manipule a data de entrada escolhendo adicionar, subtrair ou definir unidades de tempo.
  • Add: manipule a data de entrada adicionando unidades de tempo.
  • Subtract: manipule a data de entrada subtraindo unidades de tempo.
  • Set: manipule a data de entrada definindo unidades de tempo.
• Date: uma entrada necessária a ser manipulada. A entrada pode ser uma cadeia de caracteres com formatação ISO-8601, Unix Timestamp ou a saída estruturada do objeto Date/Time de outro módulo Date/Time.
• Years: quantos anos adicionar ou subtrair da data de entrada. Se estiver usando a operação Set, define o ano (por exemplo, 1952).
• Months: quantos meses adicionar ou subtrair da data de entrada. Se estiver usando a operação Set, define o mês (1 - 12).
• Days: quantos dias adicionar ou subtrair da data de entrada. Se estiver usando a operação Set, define a data do mês.
• Hours: quantas horas adicionar ou subtrair da data de entrada. Se estiver usando a operação Set, define a hora (0 - 23).
• Minutes: quantos minutos adicionar ou subtrair da data de entrada. Se estiver usando a operação Set, define a hora (0 - 59).
• Seconds: quantos segundos adicionar ou subtrair da data de entrada. Se estiver usando a operação Set, define a hora (0 - 59).
• Duration: além de adicionar ou subtrair uma unidade de tempo, também é possível adicionar ou subtrair uma duração. Isso é representado como uma cadeia de caracteres de duração padrão ISO-8601 ou um objeto de duração da saída do módulo Compare Date/Time.

Retornos de Manipulate Date/Time

Se a cadeia de caracteres de entrada for analisada com sucesso, o módulo retornará um objeto Date/Time estruturado.

Módulo Parse Date/Time

O módulo Parse Date/Time analisará uma data em um objeto Date/Time estruturado que pode ser manipulado ou formatado.

Juntamente com datas legíveis para humanos, este módulo pode analisar cadeias de caracteres padrão ISO-8601, padrão RFC 2822, Unix Timestamps ou a saída de outro módulo Parse Date/Time. Se a entrada for inválida, um objeto Invalid Date/Time será retornado.

 

Campos de Parse Date/Time

• Date: uma entrada necessária a ser analisada em um objeto Date/Time estruturado. A entrada pode estar em qualquer cadeia de caracteres legível para humanos, ISO-8601, RFC 2822, Unix Timestamp ou a saída de outro módulo Parse Date/Time.
• Locale: uma entrada opcional para fornecer a localidade da entrada. A localidade é usada para distinguir padrões comuns, por exemplo, 5 de abril de 2017 pode ser 04/05/2017 na localidade dos EUA ou 05/04/2017 na localidade do Reino Unido. Esses padrões são extremamente difíceis de distinguir e, por isso, é recomendável que você especifique a localidade apropriada para atender às suas necessidades. O padrão é o formato americano (en).
• UTC Offset: como definir o deslocamento de UTC para a entrada. Os deslocamentos por hora de -12:00 horas a +12:00 horas podem ser definidos ou você pode ter maior controle sobre o deslocamento de UTC com as opções a seguir.
  • None: a entrada será analisada como está! Se não houver deslocamento definido na cadeia de caracteres de entrada, nenhum deslocamento será aplicado. Se você estiver analisando uma cadeia de caracteres que inclui um deslocamento (por exemplo, uma cadeia de caracteres com formatação "ISO-8601"), o deslocamento será definido como o mesmo do deslocamento da cadeia de caracteres. Por exemplo, 2017-07-02T21:30:00-07:00 terá um deslocamento de -07:00 horas.
  • Timezone Offset: escolha um fuso horário para calcular o deslocamento de UTC. Esse cálculo é responsável por qualquer horário de verão que possa ocorrer em determinados fusos horários em datas específicas.
  • Lat/Long Offset: especifique um local a partir de uma cadeia de caracteres de latitude e longitude separada por uma vírgula (,). O horário de verão será incluído no cálculo do deslocamento. Por exemplo, 47.650499, -122.350070 seria América/Los_Angeles e calcularia para -08:00 no inverno e -07:00 no verão.
  • Custom Offset: defina um deslocamento personalizado no formato de ±HH:mm. Por exemplo: mais oito horas e meia: +08:30

Retornos de Parse Date/Time

Se a cadeia de caracteres de entrada for analisada com sucesso, o módulo retornará um objeto Date/Time estruturado.

Módulo Round Date/Time

O módulo Round Date/Time retornará o início ou o fim de uma unidade de tempo especificada de um determinado objeto Date/Time estruturado.

Campos de Round Date/Time

• Start/End: arredonde a entrada para o início ou fim da unidade de tempo especificada.
  • Start: arredonde para o início de uma unidade de tempo. Por exemplo, 8h15 se tornará 8h00
  • End: arredonde para o fim de uma unidade de tempo. Por exemplo, 8h15 se tornará 8h59
• Date: uma entrada necessária a ser arredondada para cima ou para baixo pela unidade especificada. A entrada pode ser uma cadeia de caracteres com formatação ISO-8601, Unix Timestamp ou a saída estruturada do objeto Date/Time de outro módulo Date/Time.
• Unit of Time: a unidade de tempo em que você deseja arredondar para cima ou para baixo. Você poderá escolher entre as seguintes opções:
  • Year
  • Quarter
  • Month
  • Week
  • Day
  • Hour
  • Minute

Primeiro dia da semana

O primeiro dia da semana pode ser diferente em todo o mundo, portanto, quando a unidade de tempo selecionada for Week, esta opção permite que você defina qual dia é considerado o início da semana.

Retornos de Round Date/Time

Se a cadeia de caracteres de entrada for analisada com sucesso, o módulo retornará um objeto Date/Time estruturado.