DATETIME_ADD

Syntaxe

Paramètres

Description

Cette fonction permet d'ajouter une quantité de temps à une expression de date et heure existante.

Remarques

• Permet d'ajuster une date et une heure sans prise en compte de fuseau horaire : La fonction DATETIME_ADD() opère sur le type DATETIME, étant indépendant du fuseau horaire. Cela garantit que les calculs temporels sont cohérents dans des contextes où seule l'heure locale civile compte, par exemple pour des horaires fixes ou des systèmes de réservation.
• Utilise une syntaxe explicite avec le mot-clé INTERVAL pour une meilleure lisibilité : L'ajout de l'intervalle se fait via le mot clef INTERVAL, ce qui rend la syntaxe claire et intuitive : DATETIME_ADD(datetime_expression, INTERVAL 5 DAY) indique clairement que 5 jours sont ajoutés. Cela rend les requêtes plus faciles à lire et à maintenir.
• Supporte de nombreuses unités de temps pour une grande flexibilité : La fonction accepte une large variété d'unités temporelles, de la microseconde (MICROSECOND) à l'année (YEAR). Cela permet d'effectuer des ajustements très fins (comme l'ajout de millisecondes) aussi bien que des calculs plus globaux (comme des années ou des trimestres).
• Convient pour des calculs récurrents ou des prévisions : Elle est particulièrement utile dans des cas comme le calcul de la date de prochaine échéance, la projection de dates futures (ajout de 3 mois à une date de début), ou la modélisation de calendriers. Ces opérations sont fréquentes dans les tableaux de bord ou les rapports automatisés.
• Le type de retour reste DATETIME, garantissant la cohérence : La fonction retourne toujours un objet DATETIME, quel que soit l'intervalle ajouté. Cela garantit que le type des données reste constant, évitant ainsi des conversions inutiles ou des erreurs de type dans les traitements suivants.
• Ne tient pas compte des décalages horaires ou de l'heure d'été : Contrairement aux fonctions sur TIMESTAMP, DATETIME_ADD() ne prend pas en compte les effets de changements d'heure (comme l'heure d'été). Cela peut être un avantage ou un inconvénient selon les besoins, mais il est important de le garder à l'esprit.
• Combinable avec des fonctions comme CURRENT_DATETIME() pour construire des dates dynamiques : On peut l'utiliser avec CURRENT_DATETIME() pour calculer des dates relatives à maintenant, comme DATETIME_ADD(CURRENT_DATETIME(), INTERVAL 1 WEEK). Cela est utile pour générer des plages de dates glissantes dans des rapports ou des alertes.
• Peut être utilisé dans des expressions conditionnelles pour des règles temporelles : DATETIME_ADD() s'intègre parfaitement dans des clauses CASE ou WHERE pour créer des règles basées sur des délais : par exemple, "si la date d'enregistrement + 30 jours est passée, alors envoyer un rappel". Cela permet d'implémenter des logiques métiers temporelles directement dans les requêtes SQL.