Langage d’expression
Créez des attributs calculés, définissez des conditions et transformez les données avec le langage d’expression de ProcessMind.
Sur cette page
Fonctions de date et d’heure
Fonctions permettant d’extraire les composants d’une date ou d’une heure et d’effectuer des calculs de dates.
Utiliser les horodatages
Dans ProcessMind, les horodatages sont stockés sous forme de nombres représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970, l’époque Unix. Les fonctions de date utilisent ces valeurs d’horodatage.
Motifs courants
-
Extraire les composants d’une date :
year(StartTime) // 2024 month(StartTime) // 3 (March) day(StartTime) // 15 -
Calculer une durée :
dateDiff(StartTime, EndTime, "minute") dateDiff(StartTime, EndTime, "hour") dateDiff(StartTime, EndTime, "day") -
Créer des intervalles de temps :
bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening") -
Ajouter du temps à une date :
dateAdd(StartTime, 7, "day") // Add 7 days dateAdd(StartTime, -1, "month") // Subtract 1 month
now
()Renvoie l’horodatage UTC actuel, en millisecondes depuis l’époque Unix.
| Valeur renvoyée | nombre |
| Exemples | now() → 1708963200000 Horodatage actuel |
year
(timestamp)Extrait l’année d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | year(StartTime) → 2024 | |||
| Voir aussi |
month
(timestamp)Extrait le mois, de 1 à 12, d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | month(StartTime) → 3 Mars | |||
| Voir aussi |
day
(timestamp)Extrait le jour du mois, de 1 à 31, d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | day(StartTime) → 18 | |||
| Voir aussi |
hour
(timestamp)Extrait l’heure, de 0 à 23, d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | hour(StartTime) → 14 2 PM | |||
| Voir aussi |
minute
(timestamp)Extrait les minutes, de 0 à 59, d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | minute(StartTime) → 30 | |||
| Voir aussi |
second
(timestamp)Extrait les secondes, de 0 à 59, d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | second(StartTime) → 45 | |||
| Voir aussi |
dayOfWeek
(timestamp)Renvoie le jour de la semaine, 1 = lundi et 7 = dimanche, à partir d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | dayOfWeek(StartTime) → 1 Lundi | |||
| Voir aussi |
dayName
(timestamp)Renvoie le nom du jour de la semaine à partir d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | string | |||
| Exemples | dayName(StartTime) → Lundi | |||
| Voir aussi |
monthName
(timestamp)Renvoie le nom du mois à partir d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | string | |||
| Exemples | monthName(StartTime) → Mars | |||
| Voir aussi |
quarter
(timestamp)Renvoie le trimestre, de 1 à 4, à partir d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | quarter(StartTime) → 1 T1 (janv.-mars) | |||
| Voir aussi |
weekOfYear
(timestamp)Renvoie le numéro de semaine ISO, de 1 à 53, à partir d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | weekOfYear(StartTime) → 12 Semaine 12 de 2024 | |||
| Voir aussi |
dayOfYear
(timestamp)Renvoie le jour de l’année, de 1 à 366, à partir d’un horodatage.
| Paramètres |
| |||
| Valeur renvoyée | nombre | |||
| Exemples | dayOfYear(StartTime) → 78 78e jour de l’année (18 mars 2024) | |||
| Voir aussi |
dateAdd
(timestamp, amount, unit)Ajoute une durée donnée à un horodatage.
| Paramètres |
| |||||||||
| Valeur renvoyée | nombre | |||||||||
| Exemples | dateAdd(StartTime, 7, "day") → horodatage + 7 jours dateAdd(StartTime, -1, "month") → horodatage - 1 mois dateAdd(1710766245000, 1, "day") → 1710852645000 Ajouter 1 jour au 18 mars 2024 | |||||||||
| Voir aussi |
dateDiff
(startTimestamp, endTimestamp, unit)Calcule la différence entre deux horodatages dans l’unité indiquée.
| Paramètres |
| |||||||||
| Valeur renvoyée | nombre | |||||||||
| Exemples | dateDiff(StartTime, EndTime, "minute") → 150 Durée en minutes dateDiff(StartTime, EndTime, "hour") → 2.5 | |||||||||
| Remarques | Renvoie une valeur décimale représentant la différence exacte. | |||||||||
| Voir aussi |
isBusinessDay
(timestamp)Vérifie si un horodatage correspond à un jour ouvré, du lundi au vendredi.
| Paramètres |
| |||
| Valeur renvoyée | booléen | |||
| Exemples | isBusinessDay(StartTime) → true Si StartTime correspond à un jour de semaine | |||
| Voir aussi |
workingDaysBetween
(startTimestamp, endTimestamp)Compte les jours ouvrés, du lundi au vendredi, entre deux horodatages.
| Paramètres |
| ||||||
| Valeur renvoyée | nombre | ||||||
| Exemples | workingDaysBetween(StartTime, EndTime) → Nombre de jours de semaine entre les dates workingDaysBetween(1710766245000, 1711371045000) → 5 5 jours ouvrés entre le lundi 18 mars et le lundi 25 mars 2024 | ||||||
| Remarques | Fonction d’aide approximative pour le backend et le calendrier professionnel. Elle ne tient pas compte des jours fériés, mais uniquement des week-ends. | ||||||
| Voir aussi |
toUtc
(timestamp, offsetHours)Convertit un horodatage local en UTC en soustrayant le décalage.
| Paramètres |
| ||||||
| Valeur renvoyée | nombre | ||||||
| Exemples | toUtc(StartTime, 2) → StartTime - 2 heures Convertir depuis UTC+2 toUtc(1710766245000, 2) → 1710759045000 Convertir l’horodatage d’UTC+2 vers UTC | ||||||
| Remarques | La conversion de fuseau horaire prend actuellement en charge les décalages UTC numériques exprimés en heures, mais pas les noms de fuseaux horaires IANA. | ||||||
| Voir aussi |
toLocal
(timestamp, offsetHours)Convertit un horodatage UTC en heure locale en ajoutant le décalage.
| Paramètres |
| ||||||
| Valeur renvoyée | nombre | ||||||
| Exemples | toLocal(StartTime, -5) → StartTime - 5 heures Convertir en EST toLocal(1710766245000, -5) → 1710748245000 Convertir l'horodatage UTC en EST (UTC-5) | ||||||
| Remarques | La conversion de fuseau horaire prend actuellement en charge les décalages UTC numériques exprimés en heures, mais pas les noms de fuseaux horaires IANA. | ||||||
| Voir aussi |
convertTimezone
(timestamp, fromOffset, toOffset)Convertit un horodatage d'un fuseau horaire vers un autre.
| Paramètres |
| |||||||||
| Valeur renvoyée | nombre | |||||||||
| Exemples | convertTimezone(StartTime, 1, -5) → horodatage décalé de -6 heures De CET à EST convertTimezone(1710766245000, 1, -5) → 1710744645000 Convertir de UTC+1 vers UTC-5 | |||||||||
| Remarques | La conversion de fuseau horaire prend actuellement en charge les décalages UTC numériques exprimés en heures, mais pas les noms de fuseaux horaires IANA. | |||||||||
| Voir aussi |
Sujets associés
- Vue d’ensemble des expressions : toutes les fonctions d’expression.