Funzioni per date e orari
Funzioni per estrarre componenti di data e ora ed eseguire operazioni aritmetiche sulle date.
Utilizzare i timestamp
In ProcessMind, i timestamp sono memorizzati come numeri che rappresentano i millisecondi trascorsi dal 1° gennaio 1970 (epoca Unix). Le funzioni per le date operano su questi valori.
Modelli ricorrenti
-
Estrarre componenti della data:
year(StartTime) // 2024 month(StartTime) // 3 (March) day(StartTime) // 15 -
Calcolare una 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 in millisecondi dall’epoca Unix.
| Valori restituiti | numero |
| Esempi | now() → 1708963200000 Timestamp corrente |
year
(timestamp)Estrae l’anno da un timestamp.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | year(StartTime) → 2024 | |||
| Vedi anche |
month
(timestamp)Estrae il mese (1-12) da un timestamp.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | month(StartTime) → 3 Marzo | |||
| Vedi anche |
day
(timestamp)Estrae il giorno del mese (1-31) da un timestamp.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | day(StartTime) → 18 | |||
| Vedi anche |
hour
(timestamp)Estrae l’ora (0-23) da un timestamp.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | hour(StartTime) → 14 14:00 | |||
| Vedi anche |
minute
(timestamp)Estrae i minuti (0-59) da un timestamp.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | minute(StartTime) → 30 | |||
| Vedi anche |
second
(timestamp)Estrae i secondi (0-59) da un timestamp.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | second(StartTime) → 45 | |||
| Vedi anche |
dayOfWeek
(timestamp)Restituisce il giorno della settimana corrispondente a un timestamp, dove 1=lunedì e 7=domenica.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | dayOfWeek(StartTime) → 1 Lunedì | |||
| Vedi anche |
dayName
(timestamp)Restituisce il nome del giorno della settimana corrispondente a un timestamp.
| Parametri |
| |||
| Valori restituiti | stringa | |||
| Esempi | dayName(StartTime) → Lunedì | |||
| Vedi anche |
monthName
(timestamp)Restituisce il nome del mese corrispondente a un timestamp.
| Parametri |
| |||
| Valori restituiti | stringa | |||
| Esempi | monthName(StartTime) → Marzo | |||
| Vedi anche |
quarter
(timestamp)Restituisce il trimestre (1-4) corrispondente a un timestamp.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | quarter(StartTime) → 1 T1 (gen-mar) | |||
| Vedi anche |
weekOfYear
(timestamp)Restituisce il numero della settimana ISO (1-53) corrispondente a un timestamp.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | weekOfYear(StartTime) → 12 Settimana 12 del 2024 | |||
| Vedi anche |
dayOfYear
(timestamp)Restituisce il giorno dell’anno (1-366) corrispondente a un timestamp.
| Parametri |
| |||
| Valori restituiti | numero | |||
| Esempi | dayOfYear(StartTime) → 78 78º giorno dell’anno (18 marzo 2024) | |||
| Vedi anche |
dateAdd
(timestamp, amount, unit)Aggiunge un intervallo di tempo specificato a un timestamp.
| Parametri |
| |||||||||
| Valori restituiti | numero | |||||||||
| Esempi | dateAdd(StartTime, 7, "day") → timestamp + 7 giorni dateAdd(StartTime, -1, "month") → timestamp - 1 mese dateAdd(1710766245000, 1, "day") → 1710852645000 Aggiunge un giorno al 18 marzo 2024 | |||||||||
| Vedi anche |
dateDiff
(startTimestamp, endTimestamp, unit)Calcola la differenza tra due timestamp nell’unità specificata.
| Parametri |
| |||||||||
| Valori restituiti | 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 corrisponde a un giorno lavorativo, dal lunedì al venerdì.
| Parametri |
| |||
| Valori restituiti | booleano | |||
| Esempi | isBusinessDay(StartTime) → true Se StartTime corrisponde a un giorno feriale | |||
| Vedi anche |
workingDaysBetween
(startTimestamp, endTimestamp)Conta i giorni lavorativi, dal lunedì al venerdì, compresi tra due timestamp.
| Parametri |
| ||||||
| Valori restituiti | 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 | Funzione ausiliaria approssimativa per il backend e il calendario lavorativo. Non considera le festività, ma solo i fine settimana. | ||||||
| Vedi anche |
toUtc
(timestamp, offsetHours)Converte un timestamp locale in UTC sottraendo la differenza rispetto al fuso orario.
| Parametri |
| ||||||
| Valori restituiti | 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 le differenze numeriche rispetto a UTC, espresse in ore, ma non i nomi dei fusi orari IANA. | ||||||
| Vedi anche |
toLocal
(timestamp, offsetHours)Converte un timestamp UTC in ora locale aggiungendo la differenza rispetto al fuso orario.
| Parametri |
| ||||||
| Valori restituiti | numero | ||||||
| Esempi | toLocal(StartTime, -5) → StartTime - 5 ore Conversione in EST toLocal(1710766245000, -5) → 1710748245000 Converte il timestamp UTC in EST (UTC-5) | ||||||
| Note | La conversione del fuso orario supporta attualmente le differenze numeriche rispetto a UTC, espresse in ore, ma non i nomi dei fusi orari IANA. | ||||||
| Vedi anche |
convertTimezone
(timestamp, fromOffset, toOffset)Converte un timestamp da un fuso orario a un altro.
| Parametri |
| |||||||||
| Valori restituiti | numero | |||||||||
| Esempi | convertTimezone(StartTime, 1, -5) → timestamp con una variazione di -6 ore Da CET a EST convertTimezone(1710766245000, 1, -5) → 1710744645000 Converte da UTC+1 a UTC-5 | |||||||||
| Note | La conversione del fuso orario supporta attualmente le differenze numeriche rispetto a UTC, espresse in ore, ma non i nomi dei fusi orari IANA. | |||||||||
| Vedi anche |
Argomenti correlati
- Panoramica delle espressioni: tutte le funzioni delle espressioni.
Progettazione. Analisi. Miglioramento. Costruisca un’architettura dei processi integrata e mantenga il controllo.
Acceda subito, senza carta di credito né attese. Trasformi il modo in cui opera la Sua organizzazione in una progettazione dei processi chiara e interconnessa.
Definisca l’architettura dei processi, le responsabilità e i controlli, e allinei ruoli e compiti a ogni livello.
Inizi la prova gratuita e crei una base affidabile per governare, gestire e migliorare costantemente i processi della Sua organizzazione.