Guida di riferimento a Date/Time

Proprietà	Type	Descrizione
years	Numero	Un numero di quattro cifre che rappresenta l'anno della data specificata.
months	Numero	Rappresenta il mese dell'anno nella data specificata. Gennaio è uguale a 1.
date	Numero	Rappresenta il giorno del mese nella data specificata.
hours	Numero	Rappresenta le ore del giorno di una data o di un'ora specifica.
minutes	Numero	Rappresenta i minuti nell'ora di una data o di un'ora specifica.
seconds	Numero	Rappresenta i secondi nel minuto di una data o di un'ora specifica.
milliseconds	Numero	Rappresenta i millisecondi nel secondo di una data o di un'ora specifica.
offset	Stringa	L'offset dall'UTC (Tempo coordinato universale) in una stringa formattata ±HH:mm.
iso	Stringa	Una stringa che rappresenta la data/ora in una stringa formattata secondo lo standard ISO-8601. Ad esempio YYYY-MM-DDTHH:mm:ssZ
utc	Stringa	Una stringa che rappresenta la data/ora UTC in una stringa formattata secondo lo standard ISO-8601.
unix	Numero	Un numero che rappresenta il timestamp unix di Date/Time.
isValid	Boolean	Valore booleano che indica se l'indicazione di data/ora è valida o meno.

Proprietà	Type	Descrizione
years	Numero	Un numero intero che rappresenta il numero di anni trascorsi tra le due date.
months	Numero	Un numero intero che rappresenta il numero di mesi trascorsi dopo il calcolo del numero di anni tra le due date.
days	Numero	Un numero intero che rappresenta il numero di giorni trascorsi dopo il calcolo del numero di mesi e anni tra le due date.
hours	Numero	Un numero intero che rappresenta il numero di ore trascorse dopo il calcolo del numero di giorni, mesi e anni tra le due date.
minutes	Numero	Un numero intero che rappresenta il numero di minuti trascorsi dopo il calcolo del numero di ore, giorni, mesi e anni tra le due date.
seconds	Numero	Un numero intero che rappresenta il numero di secondi trascorsi dopo il calcolo del numero di minuti, ore, giorni, mesi e anni tra le due date.
milliseconds	Numero	Un numero intero che rappresenta il numero di millisecondi trascorsi dopo il calcolo del numero di secondi, minuti, ore, giorni, mesi e anni tra le due date.
iso	Stringa	Una stringa che rappresenta la durata in una stringa formattata secondo lo standard ISO-8601.
humanized	Stringa	Una stringa che rappresenta il formato leggibile dall'uomo per l'ora. Risposta simile al modulo Format Date/Time con formattazione relativa. Ad es. '2 years'.
isDuration	Boolean	Valore booleano che indica se si tratta o no di un oggetto durata. Sarà sempre vero se l'oggetto è valido.
isValid	Boolean	Valore booleano che indica se l'indicazione di data/ora è valida o meno.
in	Object	Ogni valore in questo oggetto è simile alla proprietà in questa tabella, ma ignora tutte le altre unità di tempo. Ad esempio Esattamente 2 anni tra due date saranno 24 mesi.

	Token	Output
Mese	M	1 2 ... 11 12
	Mo	1° 2° ... 11° 12°
	MM	01 02 ... 11 12
	MMM	Gen Feb ... Nov Dic
	MMMM	Gennaio Febbraio ... Novembre Dicembre
Trimestre	Q	1 2 3 4
	Qo	1° 2° 3° 4°
Giorno del mese	D	1 2 ... 30 31
	Do	1 ° 2 ° ... 30° 31°
	DD	01 02 ... 30 31
Giorno dell'anno	DDD	1 2 ... 364 365
	DDDo	1° 2° ... 364° 365°
	DDDD	001 002 ... 364 365
Giorno della settimana	d	0 1 ... 5 6
	do	0° 1° ... 5° 6°
	dd	Do Lu ... Ve Sa
	ddd	Dom Lun ... Ven Sab
	dddd	Domenica Lunedì ... Venerdì Sabato
Giorno della settimana (locale)	e	0 1 ... 5 6
Giorno della settimana (ISO)	E	1 2 ... 6 7
Settimana dell'anno	w	1 2 ... 52 53
	wo	1° 2° ... 52° 53°
	ww	01 02 ... 52 53
Settimana dell'anno (ISO)	W	1 2 ... 52 53
	Wo	1° 2° ... 52° 53°
	WW	01 02 ... 52 53
Anno	YY	70 71 ... 29 30
	AAAA	1970 1971 ... 2029 2030
	Y	1970 1971 ... 9999 +10000 +10001 Nota: è conforme allo standard ISO 8601 per le date successive all'anno 9999
Settimana dell'anno	gg	70 71 ... 29 30
	gggg	1970 1971 ... 2029 2030
Settimana dell'anno (ISO)	GG	70 71 ... 29 30
	GGGG	1970 1971 ... 2029 2030
AM/PM	A	AM PM
	a	am pm
Ora	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
Minuto	m	0 1 ... 58 59
	mm	00 01 ... 58 59
Secondo	s	0 1 ... 58 59
	ss	00 01 ... 58 59
Secondo frazionario	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..]
Fuso orario	z o zz	EST CST ... MST PST
	Z	-07:00 -06:00 ... +06:00 +07:00
	ZZ	-0700 -0600 ... +0600 +0700
Timestamp Unix	X	1360013296
Timestamp millisecondo Unix	x	1360013296123

 

Modulo Check Date/Time

Il modulo Check Date/Time verifica una data di immissione rispetto a condizioni specifiche e indirizza il flusso di lavoro di conseguenza.

Il modo più semplice per utilizzare questa funzione consiste nel fare riferimento all'intero oggetto data/ora.

 

Campi Check Date/Time

• Date: un input richiesto da verificare. L'input può essere una stringa formattata secondo ISO-8601, un timestamp Unix o l'output strutturato dell'oggetto Date/Time di un altro modulo Date/Time.
• Condition: specifica l'operazione condizionale da verificare rispetto alla data di input. È possibile scegliere tra le seguenti opzioni:
  • Day of Week: indirizza il flusso di lavoro lungo il percorso 'Success' se la data corrisponde a uno dei giorni selezionati.
  • Is Before another Date: indirizza il flusso di lavoro lungo il percorso 'Success' se la data è precedente (o uguale) a una data di riferimento fornita.
  • Is After another Date: indirizza il flusso di lavoro lungo il percorso 'Success' se la data è successiva (o uguale) a una data di riferimento fornita.
  • Is Between two Dates: indirizza il flusso di lavoro lungo il percorso 'Success' se la data è precedente e successiva (o uguale) a una data di riferimento fornita.
  • Is a Leap Year: indirizza il flusso di lavoro lungo il percorso 'Success' se la data è un anno bisestile. Indirizzerà il flusso di lavoro lungo il percorso 'Failed' se la data non è in un anno bisestile o se la data non contiene un anno, ad esempio se è stato inserito o fatto riferimento solo al mese.

Date di riferimento

Se si sceglie di verificare se una data è prima, dopo o tra una o più date di riferimento, questi input sono obbligatori. L'input può essere una stringa formattata secondo ISO-8601, un timestamp Unix o l'output strutturato dell'oggetto Date/Time di un altro modulo Date/Time.

Date di riferimento incluse

Quando si utilizzano date di riferimento, le date sono considerate escluse per impostazione predefinita (ad es. Is Before and not the same as). L'impostazione di questo parametro su true calcolerà la condizione in base alle date di riferimento incluse (ad es. Is Before or same as).

Modulo Compare Date/Time

Il modulo Compare Date/Time confronta due oggetti Date/Time, restituendo la differenza assoluta tra loro.

Campi Compare Date/Time

• First Date: una data di input obbligatoria da confrontare. L'input può essere una stringa formattata secondo ISO-8601, un timestamp Unix o l'output strutturato dell'oggetto Date/Time di un altro modulo Date/Time.
• Second Date: una data di input obbligatoria da confrontare. L'input può essere una stringa formattata secondo ISO-8601, un timestamp Unix o l'output strutturato dell'oggetto Date/Time di un altro modulo Date/Time.
• Include End Date: se selezionata, la seconda data di input è inclusa nel calcolo. Ad esempio Dal lunedì al venerdì sarebbero 5 giorni invece di 4.

Risultati di Compare Date/Time

Se il modulo ha esito positivo, restituirà un oggetto Duration strutturato.

Modulo Current Date/Time

Il modulo Current Date/Time restituirà l'ora corrente nel tempo come oggetto Date/Time strutturato che può essere manipolato o formattato.

Campi di Current Date/Time

• Offset: come definire l'offset UTC per l'input. È possibile impostare offset orari da -12:00 a +12:00 ore oppure è possibile avere un maggiore controllo sull'offset UTC con le seguenti opzioni.
  • None: l'input verrà analizzato così com'è! Se nella stringa di input non è definito alcun offset, non verrà applicato alcun offset. Se si analizza una stringa che include un offset (ad esempio una stringa formattata secondo ISO-8601), l'offset verrà impostato sullo stesso offset della stringa. Ad esempio, 2017-07-02T21:30:00-07:00 avrà un offset di -07:00 ore.
  • Timezone Offset: scegli un fuso orario da cui calcolare l'offset UTC. Questo calcolo tiene conto di eventuali ore legali che possono sussistere in determinati fusi orari in determinate date.
  • Lat/Long Offset: specifica una posizione da una stringa di latitudine e longitudine separata da una virgola (,). L'ora legale sarà inclusa nel calcolo dell'offset. Ad esempio, 47.650499,-122.350070 sarebbe America/Los_Angeles e calcolerebbe fino a -08:00 in inverno e -07:00 in estate.
  • Custom Offset: consente di definire un offset personalizzato nel formato ±HH:mm. Ad esempio Più otto ore e mezza: +08:30

Dati restituiti da Current Date/Time

Se la stringa di input viene analizzata correttamente, il modulo restituisce un oggetto Date/Time strutturato.

Modulo Format Date/Time

Il modulo Format Date/Time formatterà un oggetto Date/Time strutturato in qualsiasi stringa definita dall'utente.

Campi di Format Date/Time

• Date: un input obbligatorio da formattare in una stringa. L'input può essere una stringa formattata secondo ISO-8601, un timestamp Unix o l'output strutturato dell'oggetto Date/Time di un altro modulo Date/Time.
• Format: il formato dell'output restituito. Scegliere una delle opzioni comuni, utilizzare i token Date/Time per creare un formato personalizzato oppure specificare un altro oggetto Date/Time per un formato relativo.

Dati restituiti da Format Date/Time

I seguenti formati saranno mostrati con una data di esempio dell'11 marzo 1952 alle 8.15.

ISO 8601

Output del formato nel formato data/ora secondo lo standard ISO-8601 (AAAA-MM-GGTHH:mm:ssZ) – 1952-03-11T08:15:00+00:00

YYYY-MM-DD

1952-03-11

MM/DD/YYYY

03/11/1952

DD/MM/YYYY

11/03/1952

MM/DD

03/11

DD/MM

11/03

HH:mm

08:15

HH:mm:ss

08:15:00

Formato personalizzato

Utilizza i token di Format Date/Time per creare una stringa con formato personalizzato. I caratteri non token sono ammessi per creare una stringa, ad esempio Do of MMMM, YYYY – 11 marzo 1952

Formato relativo

Fornire un altro oggetto Date/Time per formattare relativamente l'input. L'unità di tempo viene arrotondata per difetto alla più grande unità di cambiamento, ad esempio Fornendo una stringa di data/ora standard 'ISO-8601' come 1952-03-13T09:15:00+00:00, l'output sarà '2 giorni fa' invece di '2 giorni e 23 ore fa'. Questo è un modo semplice per ottenere formati umanizzati, se hai bisogno di maggiore granularità vedi Confronta modulo data/ora e l'oggetto Duration risultante.

Modulo Manipulate Date/Time

Il modulo Manipulate Date/Time può manipolare un oggetto Date/Time strutturato aggiungendo, sottraendo o impostando unità di tempo.

 

Campi di Manipulate Date/Time

• Operation: manipola la data di input scegliendo di aggiungere, sottrarre o impostare unità di tempo.
  • Add: manipola la data di input aggiungendo unità di tempo.
  • Subtract: manipola la data di input sottraendo unità di tempo.
  • Set: manipola la data di input impostando unità di tempo.
• Date: un input da manipolare obbligatoriamente. L'input può essere una stringa formattata secondo ISO-8601, un timestamp Unix o l'output strutturato dell'oggetto Date/Time di un altro modulo Date/Time.
• Years: quanti anni aggiungere o sottrarre dalla data di input. Se si utilizza l'operazione Set, imposta l'anno (ad esempio 1952).
• Months: quanti mesi aggiungere o sottrarre dalla data di input. Se si utilizza l'operazione Set, imposta l'anno (1 - 12).
• Days: quanti giorni aggiungere o sottrarre dalla data di input. Se si utilizza l'operazione Set, imposta la data del mese.
• Hours: quante ore aggiungere o sottrarre dalla data di input. Se si utilizza l'operazione Set, imposta l'ora (0 - 23).
• Minutes: quanti minuti aggiungere o sottrarre dalla data di input. Se si utilizza l'operazione Set, imposta il minuto (0 - 59).
• Seconds: quanti secondi aggiungere o sottrarre dalla data di input. Se si utilizza l'operazione Set, imposta il secondo (0 - 59).
• Duration: oltre ad aggiungere o sottrarre un'unità di tempo è anche possibile aggiungere o sottrarre una durata. Questo è rappresentato come una stringa di durata ISO-8601 standard o un oggetto Duration dall'output del modulo Compare Date/Time.

Risultati di Manipulate Date/Time

Se la stringa di input viene analizzata correttamente, il modulo restituisce un oggetto Date/Time strutturato.

Modulo Parse Date/Time

Il modulo Parse Date/Time analizzerà una data in un oggetto Date/Time strutturato che può essere manipolato o formattato.

Insieme alle date leggibili dall'uomo, questo modulo può analizzare le stringhe a standard ISO-8601, le stringhe a standard RFC 2822, i timestamp Unix o l'output di un altro modulo Parse Date/Time. Se l'input non è valido, verrà restituito un oggetto Date/Time non valido.

 

Campi di Parse Date/Time

• Date: un input necessario da analizzare in un oggetto Date/Time strutturato. L'input può essere in qualsiasi stringa leggibile dall'uomo, ISO-8601, RFC 2822, timestamp Unix o l'output di un altro modulo Parse Date/Time.
• Locale: un input facoltativo per fornire le impostazioni locali dell'input. Le impostazioni locali vengono utilizzate per differire tra i modelli comuni, ad esempio il 5 aprile 2017 può essere 04/05/2017 nelle impostazioni locali USA o 05/04/2017 nelle impostazioni locali del Regno Unito. Questi modelli sono estremamente difficili da distinguere, pertanto si consiglia di specificare le impostazioni locali appropriate per soddisfare le proprie esigenze. L'impostazione predefinita è il formato americano (en).
• UTC Offset: come definire l'offset UTC per l'input. È possibile impostare offset orari da -12:00 a +12:00 ore oppure è possibile avere un maggiore controllo sull'offset UTC con le seguenti opzioni.
  • None: l'input verrà analizzato così com'è! Se nella stringa di input non è definito alcun offset, non verrà applicato alcun offset. Se si analizza una stringa che include un offset (ad esempio una stringa formattata ISO-8601), l'offset verrà impostato sullo stesso offset della stringa. Ad esempio, 2017-07-02T21:30:00-07:00 avrà un offset di -07:00 ore.
  • Timezone Offset: scegli un fuso orario da cui calcolare l'offset UTC. Questo calcolo tiene conto di eventuali ore legali che possono sussistere in determinati fusi orari in determinate date.
  • Lat/Long Offset: specifica una posizione da una stringa di latitudine e longitudine separata da una virgola (,). L'ora legale sarà inclusa nel calcolo dell'offset. Ad esempio, 47.650499,-122.350070 sarebbe America/Los_Angeles e calcolerebbe fino a -08:00 in inverno e -07:00 in estate.
  • Custom Offset: consente di definire un offset personalizzato nel formato ±HH:mm. Ad esempio Più otto ore e mezza: +08:30

Risultati di Parse Date/Time

Se la stringa di input viene analizzata correttamente, il modulo restituisce un oggetto Date/Time strutturato.

Modulo Round Date/Time

Il modulo Round Date/Time restituirà l'inizio o la fine di un'unità di tempo specificata di un determinato oggetto Date/Time strutturato.

Campi di Round Date/Time

• Start/End: arrotonda l'input all'inizio o alla fine dell'unità di tempo specificata.
  • Start: arrotonda all'inizio di un'unità di tempo. Ad esempio, le 8.15 diventeranno le 8.00
  • End: arrotonda alla fine di un'unità di tempo. Ad esempio, le 8.15 diventeranno le 8.59
• Date: un input richiesto che deve essere arrotondato per eccesso o per difetto per unità specificata. L'input può essere una stringa formattata secondo ISO-8601, un timestamp Unix o l'output strutturato dell'oggetto Date/Time di un altro modulo Date/Time.
• Unit of Time: l'unità di tempo a cui desideri arrotondare per eccesso o per difetto. È possibile scegliere tra le seguenti opzioni:
  • Year
  • Quarter
  • Month
  • Week
  • Day
  • Hour
  • Minute

Primo giorno della settimana

Il primo giorno della settimana può variare in tutto il mondo, quindi quando l'unità di tempo selezionata è settimana, questa opzione consente di impostare quale giorno è considerato l'inizio della settimana.

Risultati di Round Date/Time

Se la stringa di input viene analizzata correttamente, il modulo restituisce un oggetto Date/Time strutturato.