# Fonctions de date

{% hint style="success" %}
Les fonctions sur les formules sont disponibles dans chacune des sous-pages dédiées :&#x20;

* [Opérateurs](/ksaar-documentation/les-elements/les-formules/operateurs.md)
* [Fonctions de texte](/ksaar-documentation/les-elements/les-formules/fonctions-de-texte.md)
* [Fonctions mathématiques](/ksaar-documentation/les-elements/les-formules/fonctions-mathematiques.md)
* [Fonctions de date](/ksaar-documentation/les-elements/les-formules/fonctions-de-date.md)
* [Fonctions de formatage](/ksaar-documentation/les-elements/les-formules/fonctions-de-formatage.md)
* [Fonctions de liste](/ksaar-documentation/les-elements/les-formules/fonctions-de-liste.md)
* [Fonctions sur des champs Ksaar](/ksaar-documentation/les-elements/les-formules/fonctions-sur-des-champs-ksaar.md)
* [Fonctions de Logique et autres](/ksaar-documentation/les-elements/les-formules/fonctions-de-logique-et-autres.md)

Des exemples de formules prêtes à l'emploi se trouvent ici : [Bibliothèque de formules classiques](/ksaar-documentation/les-elements/les-formules/bibliotheque-de-formules-classiques.md)
{% endhint %}

{% hint style="info" %}
Les formules `DATE_RANGE`, `DATE_RANGE_BEGIN` et `DATE_RANGE_END` sont documentées dans la section[Fonctions sur des champs Ksaar](/ksaar-documentation/les-elements/les-formules/fonctions-sur-des-champs-ksaar.md#plage-de-dates-plage-de-dates-avec-heure)sur la page des fonctions sur les champs Ksaar.
{% endhint %}

<details>

<summary>DATE</summary>

#### Résumé

La fonction `DATE` crée une date à partir d'une année, d'un mois et d'un jour fournis. La date retournée est sur le fuseau horaire de Paris.

#### Syntaxe

`DATE(année, mois, jour)`

#### Exemple

* `DATE(2023, 10, 20)` → `20/10/2023`

</details>

<details>

<summary>DATE_ADD</summary>

#### Résumé

La fonction `DATE_ADD` ajoute un intervalle spécifié à une date donnée. Vous pouvez retrouver la liste des unités possibles [ici](https://day.js.org/docs/en/manipulate/add#list-of-all-available-units).

#### Syntaxe

* `DATE_ADD(date, intervalle, unité)`

#### Exemple

Pour : {Date} = 20/10/2023

* `DATE_ADD({Date}, 5, 'day')` → `25/10/2023`

</details>

<details>

<summary>DATE_DIFF</summary>

#### Résumé

La fonction `DATE_DIFF` renvoie la différence entre deux dates. Vous pouvez retrouver la liste des unités possibles [ici](https://day.js.org/docs/en/manipulate/add#list-of-all-available-units).

#### Syntaxe

* `DATE_DIFF(fin, début, 'unité')`&#x20;
* Le paramètre `unité` est attendu entre guillemets

#### Exemple

Pour : {Date de fin} = 20/10/2023 et {Date de début} = 01/10/2023

* `DATE_DIFF({Date de fin}, {Date de début}, 'days')` → `19`&#x20;

</details>

<details>

<summary>DAY</summary>

#### Résumé

La fonction `DAY` renvoie le jour du mois pour une date donnée.

#### Syntaxe

* `DAY(date)`

#### Exemple

Pour : {Date} = 20/10/2023

* `DAY({Date})` → `20`

</details>

<details>

<summary>HOUR</summary>

#### Résumé

La fonction `HOUR` renvoie l'heure d'une date et heure donnée.

#### Syntaxe

* `HOUR(datetime)`

#### Exemple

Pour : {Date et Heures} = 20/10/2023 14:30:25

* `HOUR({Date et Heures})` → `14`

</details>

<details>

<summary>ISO_WEEK_NUM</summary>

#### Résumé

La fonction `ISO_WEEK_NUM` renvoie le numéro de semaine ISO pour une date donnée. (Remarque : [une explication des semaines ISO](https://fr.wikipedia.org/wiki/Num%C3%A9rotation_ISO_des_semaines))

#### Syntaxe

* `ISO_WEEK_NUM(date)`

#### Exemple

Pour : {Date} = 20/10/2023

* `ISO_WEEK_NUM({Date})` → `42`

</details>

<details>

<summary>MINUTE</summary>

#### Résumé

La fonction `MINUTE` renvoie les minutes d'une date et heure donnée.

#### Syntaxe

* `MINUTE(datetime)`

#### Exemple

Pour : {Date et Heures} = 20/10/2023 14:30:25

* `MINUTE({Date et Heures})` → `30`

</details>

<details>

<summary>MONTH</summary>

#### Résumé

La fonction `MONTH` renvoie le mois pour une date donnée.

#### Syntaxe

* `MONTH(date)`

#### Exemple

Pour : {Date} = 20/10/2023

* `MONTH({Date})` → `10`

</details>

<details>

<summary>PARSE_DATE</summary>

#### Résumé

La fonction `PARSE_DATE` analyse une chaîne de caractères représentant une date en utilisant le format fourni et renvoie une date. La date retournée est sur le fuseau horaire de Paris.\
Vous pouvez retrouver la liste des formats possibles [ici](https://day.js.org/docs/en/display/format#list-of-all-available-formats).

#### Syntaxe

`PARSE_DATE(texte, format)`

#### Exemple

* `PARSE_DATE("20/10/2023 12:10", "DD/MM/YYYY HH:mm")` → `2023-10-20 12:10`

{% hint style="info" %}
Si votre date d'entrée est au format UTC, indiquez un de ces formats :&#x20;

* YYYY-MM-DDTHH:mm:ssZ\[Z]
* YYYY-MM-DDTHH:mm:ss\[Z]
* YYYY-MM-DDTHH:mm:ssZ
* YYYY-MM-DDTHH:mm:ss.SSS\[Z]
  {% endhint %}

</details>

<details>

<summary>SECOND</summary>

#### Résumé

La fonction `SECOND` renvoie les secondes d'une date et heure donnée.

#### Syntaxe

* `SECOND(datetime)`

#### Exemple

Pour : {Date et Heures} = 20/10/2023 14:30:25

* `SECOND({Date et Heures})` → `25`

</details>

<details>

<summary>WEEKDAY</summary>

#### Résumé

La fonction `WEEKDAY` renvoie le jour de la semaine pour une date donnée. Le dimanche correspond à 1, le lundi à 2 et ainsi de suite jusqu'au samedi à 7.

#### Syntaxe

* `WEEKDAY(date)`

#### Exemple

Pour : {Date} = 20/10/2023

* `WEEKDAY({Date})` → `6`

</details>

<details>

<summary>YEAR</summary>

#### Résumé

La fonction `YEAR` renvoie l'année pour une date donnée.

#### Syntaxe

* `YEAR(date)`

#### Exemple

Pour : {Date} = 20/10/2023

* `YEAR({Date})` → `2023`

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ksaar.gitbook.io/ksaar-documentation/les-elements/les-formules/fonctions-de-date.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
