***

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)