Funzioni per data e ora
Funzioni per estrarre componenti di data e ora ed eseguire calcoli sulle date.
Gestione dei timestamp
In ProcessMind, i timestamp sono memorizzati come numeri che rappresentano i millisecondi trascorsi dal 1° gennaio 1970, l’epoca Unix. Le funzioni per le date operano su questi valori di timestamp.
Pattern comuni
-
Estrarre le parti della data:
year(StartTime) // 2024 month(StartTime) // 3 (March) day(StartTime) // 15 -
Calcolare la durata:
dateDiff(StartTime, EndTime, "minute") dateDiff(StartTime, EndTime, "hour") dateDiff(StartTime, EndTime, "day") -
Creare intervalli temporali:
bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening") -
Aggiungere tempo a una data:
dateAdd(StartTime, 7, "day") // Add 7 days dateAdd(StartTime, -1, "month") // Subtract 1 month
now
()Restituisce il timestamp UTC corrente, espresso in millisecondi dall'epoca Unix.
| Valore restituito | numero |
| Esempi | now() → 1708963200000 Timestamp corrente |
year
(timestamp)Estrae l'anno da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | year(StartTime) → 2024 | |||
| Vedi anche |
month
(timestamp)Estrae il mese, da 1 a 12, da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | month(StartTime) → 3 Marzo | |||
| Vedi anche |
day
(timestamp)Estrae il giorno del mese, da 1 a 31, da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | day(StartTime) → 18 | |||
| Vedi anche |
hour
(timestamp)Estrae l'ora, da 0 a 23, da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | hour(StartTime) → 14 14:00 | |||
| Vedi anche |
minute
(timestamp)Estrae i minuti, da 0 a 59, da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | minute(StartTime) → 30 | |||
| Vedi anche |
second
(timestamp)Estrae i secondi, da 0 a 59, da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | second(StartTime) → 45 | |||
| Vedi anche |
dayOfWeek
(timestamp)Restituisce il giorno della settimana, dove 1 è lunedì e 7 è domenica, a partire da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | dayOfWeek(StartTime) → 1 Lunedì | |||
| Vedi anche |
dayName
(timestamp)Restituisce il giorno della settimana in formato testuale a partire da un timestamp.
| Parametri |
| |||
| Valore restituito | stringa | |||
| Esempi | dayName(StartTime) → Lunedì | |||
| Vedi anche |
monthName
(timestamp)Restituisce il nome del mese a partire da un timestamp.
| Parametri |
| |||
| Valore restituito | stringa | |||
| Esempi | monthName(StartTime) → Marzo | |||
| Vedi anche |
quarter
(timestamp)Restituisce il trimestre, da 1 a 4, a partire da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | quarter(StartTime) → 1 T1 (gen-mar) | |||
| Vedi anche |
weekOfYear
(timestamp)Restituisce il numero della settimana ISO, da 1 a 53, a partire da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | weekOfYear(StartTime) → 12 Settimana 12 del 2024 | |||
| Vedi anche |
dayOfYear
(timestamp)Restituisce il giorno dell'anno, da 1 a 366, a partire da un timestamp.
| Parametri |
| |||
| Valore restituito | numero | |||
| Esempi | dayOfYear(StartTime) → 78 78º giorno dell'anno (18 marzo 2024) | |||
| Vedi anche |
dateAdd
(timestamp, amount, unit)Aggiunge una quantità di tempo specificata a un timestamp.
| Parametri |
| |||||||||
| Valore restituito | numero | |||||||||
| Esempi | dateAdd(StartTime, 7, "day") → timestamp + 7 giorni dateAdd(StartTime, -1, "month") → timestamp - 1 mese dateAdd(1710766245000, 1, "day") → 1710852645000 Aggiunge 1 giorno al 18 marzo 2024 | |||||||||
| Vedi anche |
dateDiff
(startTimestamp, endTimestamp, unit)Calcola la differenza tra due timestamp nell'unità specificata.
| Parametri |
| |||||||||
| Valore restituito | numero | |||||||||
| Esempi | dateDiff(StartTime, EndTime, "minute") → 150 Durata in minuti dateDiff(StartTime, EndTime, "hour") → 2.5 | |||||||||
| Note | Restituisce un valore decimale che rappresenta la differenza esatta. | |||||||||
| Vedi anche |
isBusinessDay
(timestamp)Verifica se un timestamp ricade in un giorno lavorativo, dal lunedì al venerdì.
| Parametri |
| |||
| Valore restituito | booleano | |||
| Esempi | isBusinessDay(StartTime) → true Se StartTime è un giorno feriale | |||
| Vedi anche |
workingDaysBetween
(startTimestamp, endTimestamp)Conta i giorni lavorativi, dal lunedì al venerdì, tra due timestamp.
| Parametri |
| ||||||
| Valore restituito | numero | ||||||
| Esempi | workingDaysBetween(StartTime, EndTime) → Numero di giorni feriali tra le date workingDaysBetween(1710766245000, 1711371045000) → 5 5 giorni lavorativi tra lunedì 18 marzo e lunedì 25 marzo 2024 | ||||||
| Note | Helper approssimativo per il backend e il calendario lavorativo. Non tiene conto delle festività, ma solo dei fine settimana. | ||||||
| Vedi anche |
toUtc
(timestamp, offsetHours)Converte un timestamp locale in UTC sottraendo l'offset.
| Parametri |
| ||||||
| Valore restituito | numero | ||||||
| Esempi | toUtc(StartTime, 2) → StartTime - 2 ore Conversione da UTC+2 toUtc(1710766245000, 2) → 1710759045000 Converte il timestamp da UTC+2 a UTC | ||||||
| Note | La conversione del fuso orario supporta attualmente scostamenti UTC numerici espressi in ore, non i nomi dei fusi orari IANA. | ||||||
| Vedi anche |
toLocal
(timestamp, offsetHours)Converte un timestamp UTC in ora locale aggiungendo l'offset.
| Parametri |
| ||||||
| Valore restituito | numero | ||||||
| Esempi | toLocal(StartTime, -5) → StartTime - 5 ore Converti in EST toLocal(1710766245000, -5) → 1710748245000 Converti il timestamp UTC in EST (UTC-5) | ||||||
| Note | La conversione del fuso orario supporta attualmente scostamenti UTC numerici espressi in ore, non i nomi dei fusi orari IANA. | ||||||
| Vedi anche |
convertTimezone
(timestamp, fromOffset, toOffset)Converte un timestamp da un fuso orario a un altro.
| Parametri |
| |||||||||
| Valore restituito | numero | |||||||||
| Esempi | convertTimezone(StartTime, 1, -5) → timestamp modificato di 6 ore Da CET a EST convertTimezone(1710766245000, 1, -5) → 1710744645000 Converti da UTC+1 a UTC-5 | |||||||||
| Note | La conversione del fuso orario supporta attualmente scostamenti UTC numerici espressi in ore, non i nomi dei fusi orari IANA. | |||||||||
| Vedi anche |
Argomenti correlati
- Panoramica delle espressioni: tutte le funzioni delle espressioni.