---
schema_version: "1"
id: 3be297363382e4b5bf247a374d35723b3baddc2e43ff9a96354148b632d69b89
title: Fonctions de date
collection: tableau
version: next
locale: fr-fr
portal_url: https://docs.salesforce.com/tableau/next/fr-fr/pro/desktop/functions_functions_date.md
canonical_url: https://help.tableau.com/v0.0/pro/desktop/fr-fr/functions_functions_date.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 163168dd8a5efd78764c2f08c1224365912b3c6d8b4072874e1770577a6d614e
description: Reference for Tableau date functions used in calculations.
---
[Passer au contenu principal](#main-content)

# Fonctions de date

Les dates sont un élément commun à de nombreuses sources de données. Si un champ contient des dates reconnaissables, il aura un type de données **date** ou **date heure**. Les champs de date qui sont utilisés dans la visualisation, reçoivent un ensemble spécial de fonctionnalités, y compris une hiérarchie de dates automatique, des options de filtre spécifiques à la date et des options de formatage de date spécialisées. L’utilisation de dates dans les calculs exige souvent de recourir à des fonctions spécifiques aux dates.

## Se familiariser avec d’autres concepts de date

Les fonctions de date font parfois référence à des éléments spécifiques à la date, y compris l’argument `date_part`, le paramètre facultatif `[start_of_week]` et les expressions littérales de date (#). Ces fonctions sont traitées plus en détail à la fin de cette rubrique.

Il existe plusieurs autres sujets intéressants, mais qui ne font pas partie des fonctions de date :

- Mettre en forme l’affichage d’une date dans une visualisation : [Formats de date personnalisés](https://help.tableau.com/v0.0/pro/desktop/fr-fr/dates_custom_date_formats.htm)
- Définir les propriétés de date par défaut : [Propriétés de date pour une source de données](https://help.tableau.com/v0.0/pro/desktop/fr-fr/date_properties.htm)
- Travailler avec des dates fiscales : [Dates fiscales](https://help.tableau.com/v0.0/pro/desktop/fr-fr/dates_fiscal.htm)
- Utiliser le calendrier ISO-8601 : [Calendrier ISO-8601 basé sur les semaines](https://help.tableau.com/v0.0/pro/desktop/fr-fr/dates_calendar.htm)

> [!TIP]
> 
> **Conseil** : votre champ est déjà reconnu comme une date (il comporte une icône de date dans le volet Données) et vous essayez de contrôler la manière dont il apparaît dans la visualisation ? Vous devrez peut-être le formater plutôt que d’utiliser une fonction de date. Par exemple, vous souhaitez afficher le 22 septembre 2024 sous la forme 24/09. Cette fonction est gérée via le formatage de la date, et non par un calcul.  
>   
> Voir [Formats de date personnalisés](https://help.tableau.com/v0.0/pro/desktop/fr-fr/dates_custom_date_formats.htm) ainsi que les rubriques connexes pour savoir comment utiliser des champs de date. Les fonctions de date de cette page vous permettent de manipuler les champs calculés de dates, mais pas de définir leur format d’affichage.

## Fonctions de date disponibles dans Tableau

### DATE

Fonction de conversion de type qui transforme les expressions de chaîne et de nombre en dates, tant qu’elles sont dans un format reconnaissable.

<table class="table--plain"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DATE(expression)</code></td></tr><tr><td>Résultat</td><td>Date</td></tr><tr><td>Définition</td><td>Renvoie une date en fonction d’une <code>&lt;expression&gt;</code> de nombre, de chaîne ou de date.</td></tr><tr><td>Exemple</td><td><pre>DATE([Employee Start Date])</pre><pre>DATE("September 22, 2018") </pre><pre xml:space="preserve">DATE("9/22/2018")</pre><pre>DATE(#2018-09-22 14:52#)</pre></td></tr><tr><td>Remarques</td><td><p>Contrairement à <code><a href="#DATEPARS" class="xref">DATEPARSE</a></code>, il n’est pas nécessaire de fournir un modèle car <code>DATE</code> reconnaît automatiquement de nombreux formats de date standard. Si toutefois <code>DATE</code> ne reconnaît pas l’entrée, essayez d’utiliser <code>DATEPARSE</code> et de spécifier le format.</p><p><code><a href="#MAKEDATE" class="xref">MAKEDATE</a></code> est une autre fonction similaire, mais <code>MAKEDATE</code> nécessite la saisie de valeurs numériques pour l’année, le mois et le jour.</p></td></tr></tbody></table>

### DATEADD

Ajoute un nombre spécifié de parties de date (mois, jours, etc.) à la date de début.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DATEADD(date_part, interval, date)</code></td></tr><tr><td>Résultat</td><td>Date</td></tr><tr><td>Définition</td><td>Renvoie la <code>&lt;date&gt;</code> spécifiée avec l’<code>&lt;interval&gt;</code> numérique spécifié ajouté à l’élément <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code> spécifié de cette date. par exemple en ajoutant trois mois ou 12 jours à une date de début.</td></tr><tr><td>Exemple</td><td><p>Repousser toutes les dates d’échéance d’une semaine</p><pre>DATEADD('week', 1, [due date])</pre><p>Ajouter 280&nbsp;jours à la date du 20 février 2021</p><pre xml:space="preserve">DATEADD('day', 280, #2/20/21#) = #November 27, 2021#</pre></td></tr><tr><td>Remarques</td><td>Prend en charge les dates ISO 8601.</td></tr></tbody></table>

### DATEDIFF

Renvoie le nombre de parties de date (semaines, années, etc.) entre deux dates.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DATEDIFF(date_part, date1, date2, [start_of_week])</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie la différence entre <code>&lt;date1&gt;</code> et <code>&lt;date2&gt;</code> exprimée en unités de <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code>. Par exemple, soustrayez les dates entre la date d’entrée et de sortie d’une personne dans un groupe pour voir combien de temps elle est restée dans le groupe.</td></tr><tr><td>Exemple</td><td><p>Nombre de jours entre le 25 mars 1986 et le 20 février 2021</p><pre>DATEDIFF('day', #3/25/1986#, #2/20/2021#) = 12,751</pre><p>Combien de mois une personne est restée dans un groupe</p><pre>DATEDIFF('month', [date joined band], [date left band])</pre></td></tr><tr><td>Remarques</td><td>Prend en charge les dates ISO 8601.</td></tr></tbody></table>

### DATENAME

Renvoie le nom de la partie de date spécifiée sous forme de chaîne discrète.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DATENAME(date_part, date, [start_of_week])</code></td></tr><tr><td>Résultat</td><td>Chaîne</td></tr><tr><td>Définition</td><td>Renvoie <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code> de <code>&lt;date&gt;</code> sous la forme d’une chaîne.</td></tr><tr><td>Exemple</td><td><pre>DATENAME('year', #3/25/1986#) = "1986"</pre><pre>DATENAME('month', #1986-03-25#) = "March"</pre></td></tr><tr><td>Remarques</td><td><p>Prend en charge les dates ISO 8601.</p><p>Un calcul très similaire est <a href="#DATEPART" class="xref">DATEPART</a>, qui renvoie la valeur de la partie de date spécifiée sous la forme d’un entier continu. La fonction <code>DATEPART</code> peut être plus rapide car il s’agit d’une opération numérique.</p><p>En modifiant les attributs du résultat du calcul (dimension ou mesure, continu ou discret) et le formatage de la date, les résultats de <code>DATEPART</code> et <code>DATENAME</code> peuvent être formatés pour être identiques.</p><p>Une fonction inverse est <a href="#DATEPARS" class="xref">DATEPARSE</a>, qui prend une valeur de chaîne et la formate en tant que date.</p></td></tr></tbody></table>

### DATEPARSE

Renvoie des chaînes spécifiquement formatées en tant que dates.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DATEPARSE(date_format, date_string)</code></td></tr><tr><td>Résultat</td><td>Date</td></tr><tr><td>Définition</td><td>L’argument <code>&lt;date_format&gt;</code> décrit comment le champ <code>&lt;date_string&gt;</code> est disposé. Étant donné que le champ de type chaîne peut être disposé de multiples manières, <code>&lt;date_format&gt;</code> doit correspondre exactement. Pour une explication complète et des détails de mise en forme, consultez <a href="https://help.tableau.com/current/pro/desktop/fr-fr/data_dateparse.htm" target="_blank">Convertir un champ en un champ de date</a>.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986#</pre></td></tr><tr><td>Remarques</td><td><p><code><a href="#top" class="xref">DATE</a></code> est une fonction similaire qui reconnaît automatiquement de nombreux formats de date standard. <code>DATEPARSE</code> peut être une meilleure option si <code>DATE</code> ne reconnaît pas le modèle d’entrée.</p><p><code><a href="#MAKEDATE" class="xref">MAKEDATE</a></code> est une autre fonction similaire, mais <code>MAKEDATE</code> nécessite la saisie de valeurs numériques pour l’année, le mois et le jour.</p><p>Les fonctions inverses, qui séparent les dates et renvoient la valeur de leurs parties, sont <code><a href="#DATEPART" class="xref">DATEPART</a></code> (sortie entier) et <code><a href="#DATENAME" class="xref">DATENAME</a></code> (sortie chaîne).</p></td></tr><tr><td>Limitations de la base de données</td><td><p>La fonction <code>DATEPARSE</code> est disponible dans les connecteurs suivants&nbsp;: connexions aux fichiers Excel et texte non hérités, Amazon EMR Hadoop Hive, Cloudera Hadoop, Google Sheets, Hortonworks Hadoop Hive, MapR Hadoop Hive, MySQL, Oracle, PostgreSQL et extraits Tableau. Certains formats peuvent ne pas être disponibles pour toutes les connexions.</p><p><code>DATEPARSE</code> n’est pas pris en charge sur les variantes Hive. Seuls Denodo, Drill et Snowflake sont pris en charge.</p></td></tr></tbody></table>

### DATEPART

Renvoie le nom de la partie de date spécifiée sous la forme d’un entier.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DATEPART(date_part, date, [start_of_week])</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code> de <code>&lt;date&gt;</code> sous la forme d’un nombre entier.</td></tr><tr><td>Exemple</td><td><pre>DATEPART('year', #1986-03-25#) = 1986</pre><pre>DATEPART('month', #1986-03-25#) = 3</pre></td></tr><tr><td>Remarques</td><td><p>Prend en charge les dates ISO 8601.</p><p>Un calcul très similaire, <code><a href="#DATENAME" class="xref">DATENAME</a></code>, renvoie le nom de la partie de date spécifiée sous la forme d’une chaîne discrète. La fonction <code>DATEPART</code> peut être plus rapide car il s’agit d’une opération numérique. En modifiant les attributs du champ (dimension ou mesure, continu ou discret) et le formatage de la date, les résultats de <code>DATEPART</code> et <code>DATENAME</code> peuvent être formatés pour être identiques.</p><p>Une fonction inverse est <code><a href="#DATEPARS" class="xref">DATEPARSE</a></code>, qui prend une valeur de chaîne et la formate en tant que date.</p></td></tr></tbody></table>

### DATETRUNC

Cette fonction peut être considérée comme un arrondi de date. Il prend une date spécifique et renvoie une version de cette date avec la spécificité souhaitée. Étant donné que chaque date doit avoir une valeur pour le jour, le mois, le trimestre et l’année, `DATETRUNC` définit les valeurs comme la valeur la plus basse pour chaque partie de date jusqu’à la partie de date spécifiée. Pour plus d’informations, référez-vous à l’exemple.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DATETRUNC(date_part, date, [start_of_week])</code></td></tr><tr><td>Résultat</td><td>Date</td></tr><tr><td>Définition</td><td>Tronque la <code>&lt;date&gt;</code> selon le degré de précision indiqué par la valeur <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code>. Cette fonction renvoie une nouvelle date. Par exemple, lorsque vous tronquez une date qui se situe au milieu du mois au niveau mois, cette fonction renvoie le premier jour du mois.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">DATETRUNC('day', #9/22/2018#) = #9/22/2018#</pre><pre xml:space="preserve">DATETRUNC('iso-week', #9/22/2018#) = #9/17/2018#</pre><p>(le lundi de la semaine contenant le 9/22/2018)</p><pre xml:space="preserve">DATETRUNC(quarter, #9/22/2018#) = #7/1/2018# </pre><p>(le premier jour du trimestre contenant le 9/22/2018)</p><p class="note">Remarque&nbsp;: pour la semaine et l’iso-semaine, <code>start_of_week</code> entre en jeu. Les semaines ISO commencent toujours le lundi. Pour les paramètres régionaux de cet exemple, un paramètre non spécifié <code>start_of_week</code> signifie que la semaine commence le dimanche.</p></td></tr><tr><td>Remarques</td><td><p>Prend en charge les dates ISO 8601.</p><p>Il est déconseillé d’utiliser <code>DATETRUNC</code> par exemple pour cesser d’afficher l’heure d’un champ date/heure dans une visualisation. Si vous souhaitez tronquer l’affichage d’une date plutôt que d’arrondir sa précision, <a href="https://help.tableau.com/current/pro/desktop/fr-fr/dates_custom_date_formats.htm" target="_blank">ajustez la mise en forme</a>.</p><p>Par exemple, <code>DATETRUNC('day', #5/17/2022 3:12:48 PM#)</code>, s’il est formaté dans la visualisation pour afficher les secondes, s’affichera sous la forme <code>5/17/2022 12:00:00 AM</code>. La valeur est tronquée au jour, mais l’affichage passe aux secondes.</p></td></tr></tbody></table>

### DAY

Renvoie le jour du mois (1-31) sous la forme d’un entier.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>DAY(date)</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie le jour d’une <code>&lt;date&gt;</code> donnée sous la forme d’un entier.</td></tr><tr><td>Exemple</td><td><pre>Day(#September 22, 2018#) = 22</pre></td></tr><tr><td>Remarques</td><td>Voir également <code><a href="#WEEK" class="xref">WEEK</a></code>, <code><a href="#MONTH" class="xref">MONTH</a></code>, <code><a href="#QUARTER" class="xref">QUARTER</a></code>, <code><a href="#YEAR" class="xref">YEAR</a></code> et les équivalents ISO.</td></tr></tbody></table>

### ISDATE

Vérifie si la chaîne est un format de date valide.

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>ISDATE(string)</code></td></tr><tr><td>Résultat</td><td>Booléen</td></tr><tr><td>Définition</td><td>Renvoie la valeur true si une <code>&lt;string&gt;</code> donnée est une date valide.</td></tr><tr><td>Exemple</td><td><pre>ISDATE(09/22/2018) = true</pre><pre>ISDATE(22SEP18) = false</pre></td></tr><tr><td>Remarques</td><td>L’argument requis doit être une chaîne. ISDATE ne peut pas être utilisé pour un champ avec un type de données de date. Le calcul renverra une erreur.</td></tr></tbody></table>

### ISOQUARTER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>ISOQUARTER(date)</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie le trimestre basé sur les semaines ISO8601 d’une <code>&lt;date&gt;</code> donnée sous la forme d’un nombre entier.</td></tr><tr><td>Exemple</td><td><pre>ISOQUARTER(#1986-03-25#) = 1</pre></td></tr><tr><td>Remarques</td><td>Voir également <code><a href="#ISOWEEK" class="xref">ISOWEEK</a></code>, <code><a href="#ISOWEEKDAY" class="xref">ISOWEEKDAY</a></code>, <code><a href="#ISOYEAR" class="xref">ISOYEAR</a></code> et les équivalents non-ISO.</td></tr></tbody></table>

### ISOWEEK

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>ISOWEEK(date)</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie la semaine basée sur les semaines ISO8601 d’une <code>&lt;date&gt;</code> donnée sous la forme d’un nombre entier.</td></tr><tr><td>Exemple</td><td><pre>ISOWEEK(#1986-03-25#) = 13</pre></td></tr><tr><td>Remarques</td><td>Voir également <code><a href="#ISOWEEKDAY" class="xref">ISOWEEKDAY</a></code>, <code><a href="#ISOQUARTER" class="xref">ISOQUARTER</a></code>, <code><a href="#ISOYEAR" class="xref">ISOYEAR</a></code> et les équivalents non-ISO.</td></tr></tbody></table>

### ISOWEEKDAY

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>ISOWEEKDAY(date)</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie le jour de la semaine basé sur les semaines ISO8601 d’une <code>&lt;date&gt;</code> donnée sous la forme d’un nombre entier.</td></tr><tr><td>Exemple</td><td><pre>ISOWEEKDAY(#1986-03-25#) = 2</pre></td></tr><tr><td>Remarques</td><td>Voir également <code><a href="#ISOWEEK" class="xref">ISOWEEK</a></code>, <code><a href="#ISOQUARTER" class="xref">ISOQUARTER</a></code>, <code><a href="#ISOYEAR" class="xref">ISOYEAR</a></code> et les équivalents non-ISO.</td></tr></tbody></table>

### ISOYEAR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>ISOYEAR(date)</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie l’année basée sur les semaines ISO8601 d’une <code>&lt;date&gt;</code> donnée sous la forme d’un nombre entier.</td></tr><tr><td>Exemple</td><td><pre>ISOYEAR(#1986-03-25#) = 1,986</pre></td></tr><tr><td>Remarques</td><td>Voir également <code><a href="#ISOWEEK" class="xref">ISOWEEK</a></code>, <code><a href="#ISOWEEKDAY" class="xref">ISOWEEKDAY</a></code>, <code><a href="#ISOQUARTER" class="xref">ISOQUARTER</a></code> et les équivalents non-ISO.</td></tr></tbody></table>

### MAKEDATE

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>MAKEDATE(year, month, day)</code></td></tr><tr><td>Résultat</td><td>Date</td></tr><tr><td>Définition</td><td>Renvoie une valeur de date créée à partir des valeurs <code>&lt;year&gt;</code>, <code>&lt;month&gt;</code> et <code>&lt;day&gt;</code> spécifiées.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">MAKEDATE(1986,3,25) = #1986-03-25#</pre></td></tr><tr><td>Remarques</td><td><p class="note"><b>Remarque</b>&nbsp;: les valeurs saisies incorrectement seront ajustées dans une date, par exemple <code>MAKEDATE(2020,4,31) = May 1, 2020</code> plutôt que de renvoyer une erreur indiquant qu’il n’y a pas de 31e jour d’avril.</p><p>Disponible pour les extraits de données Tableau. Vérifiez la disponibilité dans d’autres sources de données.</p><p><code>MAKEDATE</code> requiert des entrées numériques pour les parties d’une date. Si vos données sont une chaîne qui devrait être une date, essayez la fonction <code><a href="#top" class="xref">DATE</a></code>. <code>DATE</code> reconnaît automatiquement de nombreux formats de date standard. Si <code>DATE</code> ne reconnaît pas l’entrée, essayez d’utiliser <code><a href="#DATEPARS" class="xref">DATEPARSE</a></code>.</p></td></tr></tbody></table>

### MAKEDATETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>MAKEDATETIME(date, time)</code></td></tr><tr><td>Résultat</td><td>Datetime</td></tr><tr><td>Définition</td><td>Renvoie des données de date/heure composées d’une <code>&lt;date&gt;</code> et d’une <code>&lt;time&gt;</code>. La date peut être une information de type date, date/heure ou chaîne. L’heure doit être une information de type date/heure.</td></tr><tr><td>Exemple</td><td><pre>MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#</pre><pre>MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#</pre></td></tr><tr><td>Remarques</td><td><p>Cette fonction est disponible uniquement pour les connexions compatibles MySQL (pour Tableau,ce sont MySQL et Amazon Aurora).</p><p><code><a href="#MAKETIME" class="xref">MAKETIME</a></code> est une fonction similaire disponible pour les extraits de données Tableau et certaines autres sources de données.</p></td></tr></tbody></table>

### MAKETIME

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>MAKETIME(hour, minute, second)</code></td></tr><tr><td>Résultat</td><td>Datetime</td></tr><tr><td>Définition</td><td>Renvoie une valeur de date créée à partir des valeurs <code>&lt;hour&gt;</code>, <code>&lt;minute&gt;</code> et <code>&lt;second&gt;</code> spécifiées.</td></tr><tr><td>Exemple</td><td><pre>MAKETIME(14, 52, 40) = #1/1/1899 14:52:40#</pre></td></tr><tr><td>Remarques</td><td><p>Étant donné que Tableau ne prend pas en charge un type de données d’heure, mais uniquement une date et heure, la sortie est une date et heure. La partie date du champ sera 1/1/1899.</p><p>Fonction similaire à <code><a href="#MAKEDATETIME" class="xref">MAKEDATETIME</a></code>, qui n’est disponible que pour les connexions compatibles MYSQL.</p></td></tr></tbody></table>

### MAX

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>MAX(expression)</code> ou <code>MAX(expr1, expr2)</code></td></tr><tr><td>Résultat</td><td>Même type de données que l’argument, ou <code>NULL</code>si une partie de l’argument est une valeur null.</td></tr><tr><td>Définition</td><td><p>Renvoie la valeur maximum des deux arguments, qui doivent être du même type de données.</p><p><code>MAX</code> peut également être appliqué à un seul champ en tant qu’agrégation.</p></td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">MAX(4,7) = 7<br>MAX(#3/25/1986#, #2/20/2021#) = #2/20/2021# <br>MAX([Name]) = "Zander"</pre></td></tr><tr><td>Remarques</td><td><p><b>Pour les chaînes</b></p><p><code>MAX</code> est généralement la valeur qui vient en dernier dans l’ordre alphabétique.</p><p class="note">Pour les sources de données de base de données, la valeur de la chaîne <code>MAX</code> est la valeur la plus élevée dans la séquence de tri définie par la base de données pour cette colonne.</p><p><b>Pour les dates</b></p><p>Pour les dates, <code>MAX</code> est la date la plus récente. Si <code>MAX</code> est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si <code>MAX</code> est une comparaison, le résultat conservera la hiérarchie de dates.</p><p><b>En tant qu’agrégation</b></p><p><code>MAX(expression)</code> est une fonction d’agrégation et renvoie un seul résultat agrégé. Elle s’affiche sous la forme <code>AGG(expression)</code> dans la visualisation.</p><p><b>En tant que comparaison</b></p><p><code>MAX(expr1, expr2)</code> compare les deux valeurs et renvoie une valeur au niveau des lignes.</p><p>Voir également <code><a href="#MIN" class="xref">MIN</a></code>.</p></td></tr></tbody></table>

### MIN

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>MIN(expression)</code> ou <code>MIN(expr1, expr2)</code></td></tr><tr><td>Résultat</td><td>Même type de données que l’argument, ou <code>NULL&nbsp;</code>si une partie de l’argument est une valeur null.</td></tr><tr><td>Définition</td><td><p>Renvoie la valeur minimum des deux arguments, qui doivent être du même type de données.</p><p><code>MIN </code> peut également être appliqué à un seul champ en tant qu’agrégation.</p></td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">MIN(4,7) = 4<br>MIN(#3/25/1986#, #2/20/2021#) = #3/25/1986#<br>MIN([Name]) = "Abebi"</pre></td></tr><tr><td>Remarques</td><td><p><b>Pour les chaînes</b></p><p><code>MIN</code> est généralement la valeur qui vient en premier dans l’ordre alphabétique.</p><p class="note">Pour les sources de données de base de données, la valeur de la chaîne <code>MIN</code> est la valeur la plus faible dans la séquence de tri définie par la base de données pour cette colonne.</p><p><b>Pour les dates</b></p><p>Pour les dates, <code>MIN</code> est la date la plus récente. Si <code>MIN</code> est une agrégation, le résultat n’aura pas de hiérarchie de dates. Si <code>MIN</code> est une comparaison, le résultat conservera la hiérarchie de dates.</p><p><b>En tant qu’agrégation</b></p><p><code>MIN(expression)</code> est une fonction d’agrégation et renvoie un seul résultat agrégé. Elle s’affiche sous la forme <code>AGG(expression)</code> dans la visualisation.</p><p><b>En tant que comparaison</b></p><p><code>MIN(expr1, expr2)</code> compare les deux valeurs et renvoie une valeur au niveau des lignes.</p><p>Voir également <code><a href="#MAX" class="xref">MAX</a></code>.</p></td></tr></tbody></table>

### MONTH

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>MONTH(date)</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie le mois d’une <code>&lt;date&gt;</code> donnée sous la forme d’un entier.</td></tr><tr><td>Exemple</td><td><pre>MONTH(#1986-03-25#) = 3</pre></td></tr><tr><td>Remarques</td><td>Voir également <code><a href="#DAY" class="xref">DAY</a></code>, <code><a href="#WEEK" class="xref">WEEK</a></code>, <code><a href="#QUARTER" class="xref">QUARTER</a></code>, <code><a href="#YEAR" class="xref">YEAR</a></code> et les équivalents ISO</td></tr></tbody></table>

### NOW

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>NOW()</code></td></tr><tr><td>Résultat</td><td>Datetime</td></tr><tr><td>Définition</td><td>Renvoie la date et l’heure actuelles du système local.</td></tr><tr><td>Exemple</td><td><pre>NOW() = 1986-03-25 1:08:21 PM</pre></td></tr><tr><td>Remarques</td><td><p><code>NOW</code> ne prend pas d’argument.</p><p>Voir aussi <code><a href="#TODAY" class="xref">TODAY</a></code>, un calcul similaire qui renvoie une date au lieu d’une date/heure.</p><p>Si la source de données est une connexion en direct, la date et l’heure du système peuvent être dans un autre fuseau horaire. Pour plus d’informations sur la résolution de ce problème, consultez la <a href="https://kb.tableau.com/articles/issue/now-function-returns-utc-time?lang=fr-fr">Base de connaissances</a>.</p></td></tr></tbody></table>

### QUARTER

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>QUARTER(date)</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie le trimestre d’une <code>&lt;date&gt;</code> donnée sous la forme d’un entier.</td></tr><tr><td>Exemple</td><td><pre>QUARTER(#1986-03-25#) = 1</pre></td></tr><tr><td>Remarques</td><td>Voir également <code><a href="#DAY" class="xref">DAY</a></code>, <code><a href="#WEEK" class="xref">WEEK</a></code>, <code><a href="#MONTH" class="xref">MONTH</a></code>, <code><a href="#YEAR" class="xref">YEAR</a></code> et les équivalents ISO</td></tr></tbody></table>

### TODAY

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>TODAY()</code></td></tr><tr><td>Résultat</td><td>Date</td></tr><tr><td>Définition</td><td>Renvoie la date du système local actuel.</td></tr><tr><td>Exemple</td><td><pre>TODAY() = 1986-03-25</pre></td></tr><tr><td>Remarques</td><td><p><code>TODAY</code> ne prend pas d’argument.</p><p>Voir aussi <a href="#NOW" class="xref">NOW</a>, un calcul similaire qui renvoie une date/heure au lieu d’une date.</p><p>Si la source de données est une connexion en direct, la date du système peut être dans un autre fuseau horaire. Pour plus d’informations sur la résolution de ce problème, consultez la <a href="https://kb.tableau.com/articles/issue/now-function-returns-utc-time?lang=fr-fr">Base de connaissances</a>.</p></td></tr></tbody></table>

### WEEK

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>WEEK(date)</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie la semaine d’une <code>&lt;date&gt;</code> donnée sous la forme d’un entier.</td></tr><tr><td>Exemple</td><td><pre>WEEK(#1986-03-25#) = 13</pre></td></tr><tr><td>Remarques</td><td>Voir également <code><a href="#DAY" class="xref">DAY</a></code>, <code><a href="#MONTH" class="xref">MONTH</a></code>, <code><a href="#QUARTER" class="xref">QUARTER</a></code>, <code><a href="#YEAR" class="xref">YEAR</a></code> et les équivalents ISO</td></tr></tbody></table>

### YEAR

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col></colgroup><tbody><tr><td>Syntaxe</td><td><code>YEAR(date)</code></td></tr><tr><td>Résultat</td><td>Entier</td></tr><tr><td>Définition</td><td>Renvoie l’année d’une <code>&lt;date&gt;</code> donnée sous la forme d’un entier.</td></tr><tr><td>Exemple</td><td><pre xml:space="preserve">YEAR(#1986-03-25#) = 1,986</pre></td></tr><tr><td>Remarques</td><td>Voir également <code><a href="#DAY" class="xref">DAY</a></code>, <code><a href="#WEEK" class="xref">WEEK</a></code>, <code><a href="#MONTH" class="xref">MONTH</a></code>, <code><a href="#QUARTER" class="xref">QUARTER</a></code> et les équivalents ISO</td></tr></tbody></table>

## date\_part

De nombreuses fonctions de date dans Tableau prennent l’argument `date_part`, qui est une constante de chaîne indiquant à la fonction la partie d’une date à prendre en compte, comme le jour, la semaine, le trimestre, etc. Les valeurs de `date_part` valides que vous pouvez utiliser sont :

| date\_part | Valeurs |
| --- | --- |
| `'year'` | Année exprimée à l’aide de quatre chiffres |
| `'quarter'` | 1-4 |
| `'month'` | 1-12 ou « Janvier », « Février », etc. |
| `'dayofyear'` | Jour de l’année ; 1 correspond au 1er janvier, 32 correspond au 1er février, etc. |
| `'day'` | 1-31 |
| `'weekday'` | 1-7 ou « Dimanche », « Lundi », etc. |
| `'week'` | 1-52 |
| `'hour'` | 0-23 |
| `'minute'` | 0-59 |
| `'second'` | 0-60 |
| `'iso-year'` | Année ISO 8601 à quatre chiffres |
| `'iso-quarter'` | 1-4 |
| `'iso-week'` | 1-52, le début de la semaine est toujours un lundi |
| `'iso-weekday'` | 1-7, le début de la semaine est toujours un lundi |

## Paramètre `[start_of_week]`

Certaines fonctions utilisent le paramètre facultatif`[start_of_week]`. Le paramètre `start_of_week` peut être utilisé pour spécifier le jour qui est considéré comme le premier jour de la semaine, tel que « Dimanche » ou « Lundi ». S’il est omis, le début de la semaine est déterminé par la source de données. Consultez la section [Propriétés de date pour une source de données](https://help.tableau.com/v0.0/pro/desktop/fr-fr/date_properties.htm).

Pour les exemples ci-dessous, le 22 septembre est un dimanche et le 24 septembre est un mardi. La fonction DATEDIFF est utilisée pour calculer les semaines entre ces dates.

`DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'monday') = 1`

- Étant donné que start\_of\_week est ici « monday », ces dates correspondent à des semaines différentes.

`DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'sunday') = 0`

- Etant donné que start\_of\_week est ici « sunday », ces dates sont dans la même semaine.

## Expression littérale de date (#)

Les exemples utilisent souvent le symbole dièse (#) avec des expressions de date. Il s’agit de l’expression littérale de date, similaire à l’utilisation de guillemets pour les chaînes de texte. Elle indique à Tableau que la valeur à l’intérieur des symboles est une date.

Sans les expressions littérales de date, les dates peuvent être interprétées comme divers autres types de données. Par exemple :

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">Format</td><td style="font-weight: bold;">Type de données</td><td style="font-weight: bold;">Valeur</td></tr><tr><td>'March 25, 1986'</td><td>Chaîne</td><td>'March 25, 1986'</td></tr><tr><td>#3/25/1986#</td><td>Date</td><td>#3/25/1986#</td></tr><tr><td>03/25/1986</td><td>Décimal flottant</td><td>0,00006042</td></tr><tr><td>1986-03-25</td><td>Entier</td><td>1958</td></tr><tr><td>March 25, 1986</td><td>-</td><td>non valide</td></tr></tbody></table>

![Volet Données avec différentes icônes de format de date mises en surbrillance.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/datefunc_dateformats.png)

Pour plus d’informations, consultez [Syntaxe des expressions littérales](https://help.tableau.com/v0.0/pro/desktop/fr-fr/functions_operators.htm#literals).

## Créer un calcul de date

Entraînez-vous à créer un calcul de date à l’aide de l’exemple de source de données Superstore.

1. Dans Tableau Desktop, connectez-vous à la source de données **Sample - Superstore** enregistrée qui est fournie avec Tableau.
2. Ouvrez une feuille de calcul.
3. Dans le volet **Données**, sous Dimensions, faites glisser Order Date (Date de commande) sur l’étagère Lignes.
4. Sur l’étagère **Lignes**, cliquez sur l’icône plus (**+**) dans le champ **YEAR(Order Date)**.
    
    QUARTER(Order Date) est ajouté à l’étagère Lignes et la vue se met à jour.
    
    ![Une table affichant les données de commande par année et trimestre.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/datefunctions2.png)
5. Dans l’étagère Lignes, cliquez sur l’icône plus (**+**) dans le champ QUARTER(Order Date) pour explorer en cascade jusqu’à MONTH(Order Date).
    
    ![Une table affichant l’année, le trimestre et le mois des dates de commande.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/datefunctions3.png)
6. Sélectionnez Analyse > Créer un champ calculé.
7. Dans l’éditeur de calcul qui s’ouvre, procédez comme suit :

- Nommez le champ calculé Date du trimestre.
- Entrez la formule suivante : `DATETRUNC('quarter', [Order Date])`
- Lorsque vous avez terminé, cliquez sur **OK**.
    
    Le nouveau champ calculé de date apparaît sous **Dimensions** dans le volet **Données**. Comme vos autres champs, vous pouvez l’utiliser dans une ou plusieurs visualisations.

9. Dans le volet **Données** sous Dimensions, faites glisser Date du trimestre vers l’étagère Lignes et placez-le à droite de MONTH(Order Date). La visualisation se met à jour avec les valeurs d’année. Ceci se produit parce que Tableau récapitule les données jusqu’au plus haut niveau de détail.
10. Sur l’étagère Lignes, faites un clic droit sur YEAR(Quarter Date) et sélectionnez Date exacte.
11. Sur l’étagère Lignes, faites à nouveau un clic droit sur YEAR(Quarter Date) et sélectionnez Discret.
    
    La visualisation se met à jour avec la date exacte du trimestre pour chaque ligne de la table.
    
    ![Une table qui affiche les dates de commande par année, trimestre, mois et date du trimestre.](/tableau/next/fr-fr/pro/desktop/fr-fr/Img/datefunctions1.png)