Funzioni di data e ora

Variabili

now

Ottiene l’ora corrente in formato AAAA-MM-GG-hhss.

timestamp

Ottiene l’ora corrente come marca temporale Unix.

Funzioni

addSeconds (data; numero)

Restituisce una nuova data in seguito all’aggiunta di un determinato numero di secondi a una data. Per sottrarre i secondi, immettere un numero negativo.

Esempi:

addMinutes (data; numero) addminutes-date-number

Restituisce una nuova data in seguito all’aggiunta di un determinato numero di minuti a una data. Per sottrarre i minuti, immettere un numero negativo.

Esempi:

addHours (date; number) addhours-date-number

Restituisce una nuova data in seguito all’aggiunta di un determinato numero di ore a una data. Per sottrarre le ore, immettere un numero negativo.

Esempi:

addDays (data; numero) adddays-date-number

Restituisce una nuova data come risultato dell’aggiunta di un numero specificato di giorni a una data. Per sottrarre i giorni, immettere un numero negativo.

Esempi:

addWeekDays(date; number)

[Nuovo!]{class="badge informative"}

Aggiunge il numero di giorni della settimana alla data. Vengono aggiunti solo valori interi interi (i valori frazionari vengono arrotondati per difetto).

Esempi:

addWeekDays("2016-12-08T15:55:57.536Z"; 2)

Restituisce 2016-12-12T15:55:57.536Z
addWeekDays("2016-12-08T15:55:57.536Z"; -2)
Restituisce 2016-12-06T15:55:57.536Z

addMonths (data; numero)

Restituisce una nuova data in seguito all’aggiunta di un numero specificato di mesi a una data. Per sottrarre i mesi, immettere un numero negativo.

Esempi:

addYears (data; numero)

Restituisce una nuova data risultante dall’aggiunta di un numero specificato di anni a una data. Per sottrarre gli anni, immettere un numero negativo.

Esempi:

dayOfMonth(date)

[Nuovo!]{class="badge informative"}

Restituisce il giorno del mese per la data come numero compreso tra 1 e 31.

Esempi:

dayOfWeek(date)

[Nuovo!]{class="badge informative"}

Restituisce il giorno della settimana per la data come numero compreso tra 1 (domenica) e 7 (sabato).

Esempi:

daysInMonth(date)

[Nuovo!]{class="badge informative"}

Restituisce il numero totale di giorni nel mese della data specificata.

Esempi:

daysInSplitWeek(date)

[Nuovo!]{class="badge informative"}

Restituisce il numero totale di giorni della settimana compresi tra la data e la fine della settimana oppure la fine del mese, a seconda di quale dei due eventi si verifica per primo.

Esempi:

daysInYear(date)

[Nuovo!]{class="badge informative"}

Restituisce il numero totale di giorni nell’anno della data specificata (365 per un anno regolare, 366 per un anno bisestile).

Esempi:

dateMax(date1; date2; …)

[Nuovo!]{class="badge informative"}

Restituisce la data più recente dell’elenco.

Esempi:

dateMin(date1; date2; …)

[Nuovo!]{class="badge informative"}

Restituisce la data meno recente dall’elenco.

Esempi:

endOfMonth(date)

[Nuovo!]{class="badge informative"}

Restituisce l’ultimo momento del mese della data specificata, ovvero l’ultimo millisecondo dell’ultimo giorno (23:59:59.999). Tiene automaticamente conto del numero di giorni del mese, inclusi gli anni bisestili.

Esempi:

ora(data)

[Nuovo!]{class="badge informative"}

Restituisce l’ora della data sotto forma di numero compreso tra 0 e 23.

Esempi:

isWeekend(date)

[Nuovo!]{class="badge informative"}

Restituisce true se la data cade di sabato o domenica e false per qualsiasi altro giorno. Il risultato viene determinato nel fuso orario configurato dello scenario.

Esempi:

minuto(data)

[Nuovo!]{class="badge informative"}

Restituisce il minuto della data come numero compreso tra 0 e 59.

Esempi:

mese(data)

[Nuovo!]{class="badge informative"}

Restituisce il mese della data come numero compreso tra 1 e 12.

Esempi:

second(date)

[Nuovo!]{class="badge informative"}

Restituisce il secondo della data come numero compreso tra 0 e 59.

Esempi:

startOfMonth(date)

[Nuovo!]{class="badge informative"}

Restituisce il primo momento del mese della data specificata, ovvero la mezzanotte del primo giorno (00:00:00.000). Il risultato dipende dal fuso orario.

Esempi:

weekDayDiff(date2; date1)

[Nuovo!]{class="badge informative"}

Restituisce il numero di giorni feriali tra due date, tenendo conto dei timestamp in tali giorni. Ad esempio, se l’ora di inizio è 15:00, il giorno di inizio non verrà conteggiato come giorno intero.

Esempi:

workMinutesDiff(date1; date2)

[Nuovo!]{class="badge informative"}

Restituisce il numero di minuti lavorativi programmati tra due date, in base a una pianificazione standard da lunedì a venerdì, dalle 9.00 alle 17.00.

Esempi:

year(date)

[Nuovo!]{class="badge informative"}

Restituisce l’anno della data sotto forma di numero a 4 cifre.

Esempi:

setSecond (date; number)

Questa funzione restituisce una nuova data con i secondi specificati nei parametri.

Specificare un numero compreso tra 0 e 59. Se il numero non rientra nell’intervallo, la funzione restituisce un secondo dal minuto precedente (per un numero negativo) o dal minuto successivo (per un numero positivo).

Se devi specificare un numero non compreso nell’intervallo, ti consigliamo di utilizzare ​ addSeconds, come descritto in precedenza nella sezione addSeconds (date; number).

Esempi:

setMinute (data; numero)

Questa funzione restituisce una nuova data con i minuti specificati nei parametri.

Specificare un numero compreso tra 0 e 59. Se il numero non rientra nell’intervallo, la funzione restituisce un minuto dall’ora precedente (per un numero negativo) o dall’ora successiva (per un numero positivo).

Se è necessario specificare un numero non compreso nell’intervallo, è consigliabile utilizzare addMinutes, come descritto in precedenza in addMinutes (date; number).

Esempi:

setHour (data; numero)

Questa funzione restituisce una nuova data con l’ora specificata nei parametri.

Specificare un numero compreso tra 0 e 23. Se il numero non rientra in questo intervallo, la funzione restituisce un’ora dal giorno precedente (per un numero negativo) o dal giorno successivo (per un numero positivo).

Se è necessario specificare un numero non compreso nell’intervallo, è consigliabile utilizzare addHours, come descritto in precedenza in addHours (date; number).

Esempi:

setDay (data; numero/nome del giorno in inglese)

Questa funzione restituisce una nuova data con il giorno specificato nei parametri.

È possibile utilizzare questa funzione per impostare il giorno della settimana, con domenica 1 e sabato 7. Se specifichi un numero compreso tra 1 e 7, la data risultante rientra nella settimana corrente (da domenica a sabato). Se il numero non è compreso nell’intervallo, la funzione restituisce un giorno della settimana precedente (per un numero negativo) o della settimana successiva (per un numero positivo).

Se è necessario specificare un numero non compreso nell’intervallo, è consigliabile utilizzare addDays, come descritto in precedenza in addDays (date; number).

Esempi:

setDate (date; number)

Questa funzione restituisce una nuova data con il giorno del mese specificato nei parametri.

Specifica un numero compreso tra 1 e 31. Se il numero non rientra in questo intervallo, la funzione restituisce un giorno del mese precedente (per un numero negativo) o del mese successivo (per un numero positivo).

Esempi:

setMonth (data; numero/nome del mese in inglese)

Questa funzione restituisce una nuova data con il mese specificato nei parametri.

Specifica un numero compreso tra 1 e 12. Se il numero non rientra in questo intervallo, la funzione restituisce il mese dell’anno precedente (per un numero negativo) o dell’anno successivo (per un numero positivo).

Esempi:

setYear (data; numero)

Restituisce una nuova data con l’anno specificato nei parametri.

Esempio:

formatDate (date; format; [timezone])

Utilizzare questa funzione quando si dispone di un valore Data, ad esempio 12-10-2021 20:30, che si desidera formattare come valore Testo, ad esempio Dec 10, 2021 8:30 PM.

Questo è utile, ad esempio, quando devi modificare il formato della data di un’app o di un servizio web con quello di un’app o di un servizio web connesso nello stesso scenario.

Per ulteriori informazioni, vedere Date and Text nell’articolo Tipi di dati elemento.

Parametri

Se viene fornito un tipo diverso, viene applicata la coercizione del tipo. Per ulteriori informazioni, vedere Tipo di coercizione.

Valore e tipo restituiti

La funzione formatDate restituisce una rappresentazione testuale del valore Data specificato in base al formato e al fuso orario specificati. Il tipo di dati è Testo.

Esempi: In questi esempi, il fuso orario Scenario e Web sono entrambi impostati su Europe/Prague.

parseDate (testo; formato; [fuso orario])

Utilizzare questa funzione quando si dispone di un valore Text che rappresenta una data (ad esempio 12-10-2019 20:30 o Aug 18, 2019 10:00 AM) e si desidera convertirlo (analizzarlo) in un valore Date (una rappresentazione leggibile da un computer binario). Per ulteriori informazioni, vedere Date and Text nell’articolo Tipi di dati elemento.

Parametri

La seconda colonna indica il tipo previsto. Se viene fornito un tipo diverso, viene applicata la coercizione del tipo. Per ulteriori informazioni, vedere Tipo di coercizione.

Se viene fornito un tipo diverso, viene applicata la coercizione del tipo. Per ulteriori informazioni, vedere Tipo di coercizione.

Valore e tipo restituiti

Questa funzione converte una stringa di testo in una data, in base al formato e al fuso orario specificati. Il tipo di dati del valore è Data.

Esempi: Negli esempi seguenti, il valore di Data restituito è espresso in base allo standard ISO 8601, ma il tipo di dati del risultato è Date.

dataDifferenza (Data1; Data2; Unità)

Restituisce un numero che rappresenta la differenza tra le due date, espresso nell’unità specificata.

Data2 viene sottratto da Data1.

Utilizzare uno dei valori di tempo seguenti per il parametro unit:

Se non viene specificata alcuna unità, la funzione restituisce la differenza in millisecondi.

Esempi:

Altri esempi

Come calcolare l’n-esimo giorno della settimana nel mese

Questa sezione è stata adattata per Workfront Fusion dalla pagina Web Exceljet che spiega come ottenere l’ennesimo giorno della settimana in un mese.

Per calcolare una data corrispondente all’ennesimo giorno della settimana del mese, ad esempio primo martedì, terzo venerdì e così via, è possibile utilizzare la formula seguente:

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

La formula contiene i seguenti elementi:

Se si desidera calcolare solo un caso specifico, ad esempio ogni due mercoledì, è possibile sostituire gli elementi 1.n e 2.dow nella formula con i numeri corrispondenti. Per il secondo mercoledì del mese corrente, vengono utilizzati i seguenti valori:

Spiegazione:

Come calcolare i giorni tra le date

Una possibilità consiste nell’utilizzare la seguente espressione:

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

Come calcolare l’ultimo giorno/millisecondo del mese

Quando si specifica un intervallo di date, ad esempio in un modulo di ricerca, se l’intervallo si estende sull’intero mese precedente come intervallo chiuso (l’intervallo che include entrambi i punti limite), è necessario calcolare l’ultimo giorno del mese.

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

La formula seguente mostra un modo per calcolare l’ultimo giorno del mese precedente:

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

In alcuni casi, è necessario calcolare non solo l’ultimo giorno del mese, ma letteralmente il suo ultimo millisecondo:

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

Questa formula mostra un modo per calcolare l’ultimo millisecondo del mese precedente:

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

Se è necessario che il risultato utilizzi l’impostazione del fuso orario, ometti l’argomento UTC:

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

Tuttavia, è preferibile utilizzare l’intervallo semi-aperto (l’intervallo che esclude uno dei suoi punti limite), specificando il primo giorno del mese successivo e sostituendo l’operatore “minore o uguale a” con “minore di” come segue:

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

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