Update fr-040.date-functions.md

scripts/docs/fr/070.fields/040.field-types/060.formula/fr-040.date-functions.md

@@ -0,0 +1,120 @@
+***
+
+titre : 'Fonctions de date'
+description: 'Cet article explique diverses fonctions de date qui peuvent être utilisées dans les champs de formule.'
+balises : \['Champs', 'Types de champs', 'Formule', 'Date et heure']
+mots-clés : \['Champs', 'Types de champs', 'Formule', 'Date et heure', 'Créer un champ de formule', 'Fonctions de date']
+------------------------------------------------------------------------------------------------------------------------
+
+Cette aide-mémoire fournit un guide de référence rapide pour diverses fonctions de date couramment utilisées dans l'analyse et la programmation des données. Chaque fonction est accompagnée de sa syntaxe, d'un exemple d'utilisation et d'une brève description.
+
+## DATETIME\_DIFF
+
+La fonction DATETIME\_DIFF calcule la différence entre deux dates dans différentes unités.
+
+#### Syntaxe
+
+```plaintext
+DATETIME_DIFF(date1, date2, ["milliseconds" | "ms" | "seconds" | "s" | "minutes" | "m" | "hours" | "h" | "days" | "d" | "weeks" | "w" | "months" | "M" | "quarters" | "Q" | "years" | "y"])
+```
+
+#### Échantillon
+
+```plaintext
+DATETIME_DIFF("2022/10/14", "2022/10/15", "seconds") => -86400
+```
+
+#### Remarque
+
+Cette fonction compare deux dates et renvoie la différence dans l'unité spécifiée. Les entiers positifs indiquent que la deuxième date est située dans le passé par rapport à la première, et vice versa pour les valeurs négatives.
+
+***
+
+## DATEAJOUTER
+
+La fonction DATEADD ajoute une valeur spécifiée à une date ou une date/heure.
+
+#### Syntaxe
+
+```plaintext
+DATEADD(date | datetime, value, ["day" | "week" | "month" | "year"])
+```
+
+#### Échantillon
+
+```plaintext
+DATEADD('2022-03-14', 1, 'day')     => 2022-03-15
+DATEADD('2022-03-14', 1, 'week')    => 2022-03-21
+DATEADD('2022-03-14', 1, 'month')   => 2022-04-14
+DATEADD('2022-03-14', 1, 'year')    => 2023-03-14
+```
+
+#### Exemple conditionnel
+
+```plaintext
+IF(NOW() < DATEADD(date, 10, 'day'), "true", "false") => If the current date is less than the specified date plus 10 days, it returns true. Otherwise, it returns false.
+```
+
+#### Remarque
+
+Cette fonction prend en charge les champs date et datetime et peut gérer les valeurs négatives.
+
+***
+
+## MAINTENANT
+
+La fonction MAINTENANT renvoie l'heure et le jour actuels.
+
+#### Syntaxe
+
+```plaintext
+NOW()
+```
+
+#### Échantillon
+
+```plaintext
+NOW() => 2022-05-19 17:20:43 (current date & time)
+```
+
+#### Exemple conditionnel
+
+```plaintext
+IF(NOW() < date, "true", "false") => If the current date is less than the specified date, it returns true. Otherwise, it returns false.
+```
+
+#### Remarque
+
+Cette fonction fournit l'heure et le jour actuels, prenant en charge les champs datetime et les valeurs négatives.
+
+***
+
+## JOUR DE LA SEMAINE
+
+La fonction WEEKDAY renvoie le jour de la semaine sous forme d'entier.
+
+#### Syntaxe
+
+```plaintext
+WEEKDAY(date, [startDayOfWeek])
+```
+
+#### Échantillon
+
+```plaintext
+WEEKDAY(NOW()) => If today is Monday, it returns 0.
+WEEKDAY(NOW(), "sunday") => If today is Monday, it returns 1.
+```
+
+#### Remarque
+
+Renvoie le jour de la semaine sous forme d'entier compris entre 0 et 6 (inclus), le lundi étant le jour de début par défaut. Le jour de début de la semaine peut éventuellement être modifié en le spécifiant comme deuxième argument.
+
+***
+
+## Articles Liés
+
+* [Opérateurs numériques et logiques](015.operators.md)
+* [Fonctions numériques](020.numeric-functions.md)
+* [Fonctions de chaîne](030.string-functions.md)
+* [Expressions conditionnelles](050.conditional-expressions.md)