Sur cette page

Fonctions de date et d’heure

Fonctions d’extraction des composantes de date et d’heure et de calcul sur les dates.

Utiliser les horodatages

Dans ProcessMind, les horodatages sont stockés sous forme de nombres représentant les millisecondes écoulées depuis le 1er janvier 1970 (époque Unix). Les fonctions de date utilisent ces valeurs d’horodatage.

Motifs courants

  • Extraire les composantes 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 une durée à 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.

Valeurs renvoyées nombre
Exemples
now() → 1708963200000

Horodatage actuel

year

(timestamp)

Extrait l’année d’un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
year(StartTime) → 2024
Voir aussi

month

(timestamp)

Extrait le mois (1-12) d’un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
month(StartTime) → 3

Mars

Voir aussi

day

(timestamp)

Extrait le jour du mois (1-31) d’un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
day(StartTime) → 18
Voir aussi

hour

(timestamp)

Extrait l’heure (0-23) d’un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
hour(StartTime) → 14

14 h

Voir aussi

minute

(timestamp)

Extrait les minutes (0-59) d’un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
minute(StartTime) → 30
Voir aussi

second

(timestamp)

Extrait les secondes (0-59) d’un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
second(StartTime) → 45
Voir aussi

dayOfWeek

(timestamp)

Renvoie le jour de la semaine correspondant à un horodatage, avec 1 pour lundi et 7 pour dimanche.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
dayOfWeek(StartTime) → 1

Lundi

Voir aussi

dayName

(timestamp)

Renvoie le nom du jour de la semaine correspondant à un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées chaîne
Exemples
dayName(StartTime) → Lundi
Voir aussi

monthName

(timestamp)

Renvoie le nom du mois correspondant à un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées chaîne
Exemples
monthName(StartTime) → Mars
Voir aussi

quarter

(timestamp)

Renvoie le trimestre (1-4) correspondant à un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
quarter(StartTime) → 1

T1 (janv.-mars)

Voir aussi

weekOfYear

(timestamp)

Renvoie le numéro de semaine ISO (1-53) correspondant à un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
weekOfYear(StartTime) → 12

Semaine 12 de 2024

Voir aussi

dayOfYear

(timestamp)

Renvoie le jour de l’année (1-366) correspondant à un horodatage.

Paramètres
timestamp number Valeur de l’horodatage
Valeurs renvoyées nombre
Exemples
dayOfYear(StartTime) → 78

78e jour de l’année (18 mars 2024)

Voir aussi

dateAdd

(timestamp, amount, unit)

Ajoute une durée définie à un horodatage.

Paramètres
timestamp number Horodatage de départ
amount number Durée à ajouter ; une valeur négative est possible
unit string Unité : 'year', 'month', 'day', 'hour', 'minute', 'second'
Valeurs renvoyées 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 l’écart entre deux horodatages dans l’unité indiquée.

Paramètres
startTimestamp number Horodatage de début
endTimestamp number Horodatage de fin
unit string Unité : 'day', 'hour', 'minute', 'second'
Valeurs renvoyées nombre
Exemples
dateDiff(StartTime, EndTime, "minute") → 150

Durée en minutes

dateDiff(StartTime, EndTime, "hour") → 2.5
Remarques

Renvoie une valeur décimale correspondant à l’écart exact.

Voir aussi

isBusinessDay

(timestamp)

Vérifie si un horodatage correspond à un jour ouvré, du lundi au vendredi.

Paramètres
timestamp number Horodatage à vérifier
Valeurs renvoyées 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
startTimestamp number Horodatage de début
endTimestamp number Horodatage de fin
Valeurs renvoyées 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 auxiliaire approximative pour le calendrier métier côté serveur. Elle ne tient compte que des week-ends, pas des jours fériés.

Voir aussi

toUtc

(timestamp, offsetHours)

Convertit un horodatage local en UTC en soustrayant le décalage horaire.

Paramètres
timestamp number Horodatage local
offsetHours number Décalage horaire en heures
Valeurs renvoyées nombre
Exemples
toUtc(StartTime, 2) → StartTime - 2 heures

Convertir depuis UTC+2

toUtc(1710766245000, 2) → 1710759045000

Convertir l’horodatage de UTC+2 en UTC

Remarques

La conversion de fuseau horaire accepte actuellement les décalages UTC numériques 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 horaire.

Paramètres
timestamp number Horodatage UTC
offsetHours number Décalage horaire en heures
Valeurs renvoyées nombre
Exemples
toLocal(StartTime, -5) → StartTime - 5 heures

Convertir en heure de l’Est des États-Unis (EST)

toLocal(1710766245000, -5) → 1710748245000

Convertir l’horodatage UTC en heure de l’Est des États-Unis (EST, UTC-5)

Remarques

La conversion de fuseau horaire accepte actuellement les décalages UTC numériques en heures, mais pas les noms de fuseaux horaires IANA.

Voir aussi

convertTimezone

(timestamp, fromOffset, toOffset)

Convertit un horodatage d’un fuseau horaire à un autre.

Paramètres
timestamp number Horodatage à convertir
fromOffset number Décalage horaire du fuseau source, en heures
toOffset number Décalage horaire du fuseau cible, en heures
Valeurs renvoyées nombre
Exemples
convertTimezone(StartTime, 1, -5) → horodatage décalé de -6 heures

Heure d’Europe centrale (CET) vers heure de l’Est des États-Unis (EST)

convertTimezone(1710766245000, 1, -5) → 1710744645000

Convertir de UTC+1 en UTC-5

Remarques

La conversion de fuseau horaire accepte actuellement les décalages UTC numériques en heures, mais pas les noms de fuseaux horaires IANA.

Voir aussi

Sujets connexes

Concevez de meilleurs processus. Bâtissez une architecture cohérente. Gardez la maîtrise.

Accédez immédiatement à la plateforme, sans carte bancaire ni attente. Représentez clairement le fonctionnement de votre organisation dans des modèles de processus reliés entre eux.

Définissez l’architecture des processus, les responsabilités et les contrôles, puis clarifiez les rôles à chaque niveau.

Démarrez votre essai gratuit et posez les bases d’une gouvernance, d’une gestion et d’une amélioration continue de vos processus.