Merge pull request #8143 from chinjubiju9/patch-1

Update fr-040.date-functions.md

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

@@ -0,0 +1,121 @@
+***
+
+titre : 'Fonctions de date'
+description : 'Cet article explique diverses fonctions de date qui peuvent être utilisées dans les champs de formule.'
+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. Un résultat positif indique que la première date est postérieure à la seconde, tandis qu'un résultat négatif indique l'inverse.
+
+***
+
+## DATEADD
+
+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 elle est capable de 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, de 0 à 6, le lundi étant le jour de début par défaut. Il est possible de modifier le jour de début de la semaine en spécifiant un 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)