Fonctions de dates

Les dates sont essentielles dans la gestion d'entreprise : échéances, délais, planification. Miel offre un ensemble complet de fonctions pour les manipuler.

Créer des dates

AUJOURDHUI()

Retourne la date du jour. C'est la fonction de date la plus utilisée.

JavaScript

AUJOURDHUI()                                 // Date du jour

// Calculer une date future
AUJOURDHUI() + 7                             // Dans 7 jours
AUJOURDHUI() + 30                            // Dans 30 jours

// Calculer une date passée
AUJOURDHUI() - 7                             // Il y a 7 jours

Bon à savoir : Vous pouvez ajouter ou soustraire des jours directement avec les opérateurs + et -.

DATE(jour, mois, année)

Crée une date à partir de ses composants (jour, mois, année).

JavaScript

DATE(15, 3, 2025)                            // 15 mars 2025
DATE(1, 1, 2026)                             // 1er janvier 2026
DATE(31, 12, 2024)                           // 31 décembre 2024

// Créer une date dynamique
DATE(1, {{mois}}, {{annee}})                 // Premier jour du mois spécifié

Attention : L'ordre des paramètres est jour, mois, année, conformément au format français.

Extraire des composants

Ces fonctions permettent d'extraire une partie spécifique d'une date.

ANNEE(date)

Extrait l'année d'une date (nombre à 4 chiffres).

JavaScript

ANNEE(AUJOURDHUI())                          // 2026 (si nous sommes en 2026)
ANNEE({{commande.dateCreation}})             // Année de création
ANNEE(DATE(15, 6, 2025))                     // 2025

MOIS(date)

Extrait le mois d'une date (0-11, où 0 = janvier).

JavaScript

MOIS(AUJOURDHUI())                           // 0 pour janvier, 11 pour décembre
MOIS(DATE(15, 3, 2025))                      // 2 (mars = mois 3, index 2)

Attention : Les mois sont indexés à partir de 0, pas de 1. Janvier = 0, Février = 1, ..., Décembre = 11.

JOUR(date)

Extrait le jour du mois d'une date (1-31).

JavaScript

JOUR(AUJOURDHUI())                           // 19 (si nous sommes le 19)
JOUR({{facture.dateEcheance}})               // Jour d'échéance
JOUR(DATE(25, 12, 2025))                     // 25

Calculs de périodes

Ces fonctions calculent des durées entre deux dates.

JOURS.ENTRE.INCLU(dateDebut, dateFin)

Calcule le nombre de jours entre deux dates, en incluant les deux bornes.

JavaScript

// Du 1er au 5 janvier = 5 jours
JOURS.ENTRE.INCLU(DATE(1, 1, 2025), DATE(5, 1, 2025))  // 5

// Nombre de jours depuis la création
JOURS.ENTRE.INCLU({{commande.dateCreation}}, AUJOURDHUI())

// Durée d'un projet
JOURS.ENTRE.INCLU({{projet.dateDebut}}, {{projet.dateFin}})

JOURS.OUVRES(dateDebut, dateFin)

Calcule le nombre de jours ouvrables (lundi à vendredi) entre deux dates, incluses.

JavaScript

// Jours ouvrés sur une semaine complète
JOURS.OUVRES(DATE(6, 1, 2025), DATE(12, 1, 2025))      // 5 (lun-ven)

// Jours ouvrés pour une mission
JOURS.OUVRES({{mission.dateDebut}}, {{mission.dateFin}})

// Calculer le coût d'une prestation
{{prestataire.tarifJournalier}} * JOURS.OUVRES({{mission.debut}}, {{mission.fin}})

Utile pour : Calculer des durées de mission, des coûts de prestation, des délais de livraison professionnels, etc.

Formatage

Ces fonctions transforment une date en texte lisible.

DDMMYYYY(date)

Formate une date au format français JJ/MM/AAAA.

JavaScript

DDMMYYYY(AUJOURDHUI())                       // "19/01/2026"
DDMMYYYY({{facture.dateEmission}})           // "15/03/2025"
DDMMYYYY(DATE(25, 12, 2025))                 // "25/12/2025"

MMMM(date)

Retourne le nom du mois en toutes lettres.

JavaScript

MMMM(AUJOURDHUI())                           // "janvier" (si janvier)
MMMM({{commande.dateCreation}})              // "mars", "avril", etc.

// Créer un libellé de période
CONCAT("Facture de ", MMMM({{facture.date}}), " ", ANNEE({{facture.date}}))

Exemples pratiques

Calculer une date d'échéance

JavaScript

// Échéance à 30 jours
{{facture.dateEmission}} + 30

// Échéance fin de mois suivant
var moisFacture = MOIS({{facture.dateEmission}});
var anneeFacture = ANNEE({{facture.dateEmission}});
SI moisFacture == 11
ALORS DATE(31, 1, anneeFacture + 1)
SINON DATE(28, moisFacture + 2, anneeFacture)
FINSI

Vérifier si une facture est en retard

JavaScript

SI {{facture.dateEcheance}} < AUJOURDHUI() ET {{facture.payee}} == false
ALORS "⚠️ En retard de " + (AUJOURDHUI() - {{facture.dateEcheance}}) + " jours"
SINON SI {{facture.dateEcheance}} == AUJOURDHUI()
ALORS "📌 Échéance aujourd'hui"
SINON "✓ Dans les temps"
FINSI

Filtrer les commandes du mois en cours

JavaScript

var commandes = CHERCHER.OBJETS(commande, {});
FILTRER(commandes,
  MOIS({{$.dateCreation}}) == MOIS(AUJOURDHUI())
  ET ANNEE({{$.dateCreation}}) == ANNEE(AUJOURDHUI())
)

Calculer le coût d'une prestation

JavaScript

var joursOuvres = JOURS.OUVRES({{mission.dateDebut}}, {{mission.dateFin}});
var tarifJournalier = {{consultant.tarifJournalier}};
var coutHT = joursOuvres * tarifJournalier;
var coutTTC = coutHT * 1.20;

CONCAT(
  joursOuvres, " jours × ", tarifJournalier, " € = ",
  FIXER.DECIMALES(coutTTC, 2), " € TTC"
)

Formater une période

JavaScript

CONCAT(
  "Du ", DDMMYYYY({{projet.dateDebut}}),
  " au ", DDMMYYYY({{projet.dateFin}}),
  " (", JOURS.ENTRE.INCLU({{projet.dateDebut}}, {{projet.dateFin}}), " jours)"
)

// Résultat: "Du 01/03/2025 au 31/05/2025 (92 jours)"

Prochaine étape

Continuez avec les fonctions numériques pour formater des montants, calculer des pourcentages et manipuler des nombres.

Fonctions numériques →← Fonctions de tableaux