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

# Fonctions de date

Les dates sont monnaie courante dans de nombreuses sources de données. Si un champ contient des dates reconnaissables, il aura un type de données **date** ou **date-heure**. Lorsque des champs de date sont utilisés dans la visualisation, ils bénéficient d’un ensemble de fonctionnalités particulières, notamment des options de descente automatique dans la hiérarchie de dates, des options de filtre spécifiques aux dates et des options spécialisées de format de date. L’utilisation de dates dans les calculs nécessite souvent l’utilisation de 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 aux dates, notamment l’argument `date_part` le paramètre `[start_of_week]` et les expressions littérales de date (#). Ces fonctions sont décrites de manière détaillée à la fin de cette rubrique.

Voici d’autres rubriques qui pourraient se révéler intéressantes mais ne font pas partie des fonctions de date :

- Mettre en forme le mode d’affichage d’une date dans une visualisation : [Formats de date personnalisés](https://help.tableau.com/v0.0/public/desktop/fr-ca/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/public/desktop/fr-ca/date_properties.htm)
- Utiliser des dates fiscales : [Dates fiscales](https://help.tableau.com/v0.0/public/desktop/fr-ca/dates_fiscal.htm)
- Utiliser le calendrier ISO-8601 : [Calendrier ISO-8601 basé sur les semaines](https://help.tableau.com/v0.0/public/desktop/fr-ca/dates_calendar.htm)

> [!TIP]
> 
> **Conseil** : Votre champ est-il 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 façon 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 que 22 septembre 2024 s’affiche comme 09/24. Cette opération se fait par une mise en forme de la date, et non par un calcul.  
>   
> Consultez [Formats de date personnalisés](https://help.tableau.com/v0.0/public/desktop/fr-ca/dates_custom_date_formats.htm) et des rubriques connexes pour travailler avec des champs de date. Les fonctions de date de cette page vous permettent de manipuler les champs calculés de dates, sans définir leur format d’affichage.

## Fonctions de date disponibles dans Tableau

### DATE

Fonction de conversion de type qui transforme les expressions de chaînes et de nombres 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’un nombre, d’une chaîne ou d’une <code>&lt;expression&gt;</code>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 une tendance 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 préciser 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 le numéro spécifié <code>&lt;interval&gt;</code> ajouté à l’élément <code>&lt;<a href="#arg" class="xref">date_part</a>&gt;</code> spécifié de cette date. Par exemple, le fait d’ajouter trois mois ou 12&nbsp;jours à une date de début.</td></tr><tr><td>Exemple</td><td><p>Reporter 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&nbsp;février&nbsp;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, le fait de soustraire les dates auxquelles une personne a intégré ou quitté un groupe pour déterminer le temps passé au sein du groupe.</td></tr><tr><td>Exemple</td><td><p>Nombre de jours entre le 25&nbsp;mars&nbsp;1986 et le 20&nbsp;février&nbsp;2021</p><pre>DATEDIFF('day', #3/25/1986#, #2/20/2021#) = 12,751</pre><p>Nombre de mois qu’une personne a passé 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 la forme d’une 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. <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 la mise en forme de la date, les résultats de <code>DATEPART</code> et <code>DATENAME</code> peuvent être mis en forme pour être identiques.</p><p><a href="#DATEPARS" class="xref">DATEPARSE</a> est une fonction inverse qui prend une valeur de chaîne et la met sous la forme d’une date.</p></td></tr></tbody></table>

### DATEPARSE

Renvoie des chaînes de caractères spécifiquement mises en forme sous la forme de 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 explications détaillées sur la mise en forme, consultez <a href="https://help.tableau.com/current/pro/desktop/fr-ca/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> est une option idéale 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 de l’entier) et <code><a href="#DATENAME" class="xref">DATENAME</a></code> (sortie de chaîne de caractères).</p></td></tr><tr><td>Limites de la base de données</td><td><p><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 d’une date donnée sous la forme d’un nombre 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 est <code><a href="#DATENAME" class="xref">DATENAME</a></code>, qui renvoie le nom de la partie de date spécifiée sous la forme d’une chaîne discrète. <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 la mise en forme de la date, les résultats de <code>DATEPART</code> et <code>DATENAME</code> peuvent être mis en forme pour être identiques.</p><p><code><a href="#DATEPARS" class="xref">DATEPARSE</a></code> est une fonction inverse qui prend une valeur de chaîne et la met sous la forme d’une date.</p></td></tr></tbody></table>

### DATETRUNC

Cette fonction peut être considérée comme un arrondi de date. Elle prend une date spécifique et renvoie une version de cette date avec la précision 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 la valeur la plus faible pour chaque partie de date jusqu’à la partie de date spécifiée. Consultez l’exemple pour plus d’information.

<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> au niveau 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 sur lequel tombe le 22/09/2018)</p><pre xml:space="preserve">DATETRUNC(quarter, #9/22/2018#) = #7/1/2018# </pre><p>(le premier jour du trimestre sur lequel tombe le 22/09/2018)</p><p class="note">Remarque&nbsp;: pour la semaine et la valeur iso-week, le <code>start_of_week</code> est pris en considération. La valeur ISO-8601 commence toujours le lundi. Pour les paramètres régionaux de cet exemple, une valeur <code>start_of_week</code> non spécifiée indique que le début de la semaine est un dimanche.</p></td></tr><tr><td>Remarques</td><td><p>Prend en charge les dates ISO 8601.</p><p>Vous ne devez pas utiliser <code>DATETRUNC</code> pour, par exemple, cesser d’afficher l’heure d’un champ de date 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-ca/dates_custom_date_formats.htm" target="_blank">ajustez la mise en forme</a>.</p><p>Par exemple, si <code>DATETRUNC('day', #5/17/2022 3:12:48 PM#)</code> est mis en forme dans la visualisation pour s’afficher avec des secondes, il sera affiché comme étant <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 aussi <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 doit pas être utilisé pour un champ dont le type de données est une date&nbsp;: 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&nbsp;ISO8601 basé sur les semaines d’une <code>&lt;date&gt;</code> donnée sous la forme d’un entier.</td></tr><tr><td>Exemple</td><td><pre>ISOQUARTER(#1986-03-25#) = 1</pre></td></tr><tr><td>Remarques</td><td>Consultez aussi <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 leurs é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&nbsp;ISO8601 basée sur les semaines d’une <code>&lt;date&gt;</code> donnée sous la forme d’un entier.</td></tr><tr><td>Exemple</td><td><pre>ISOWEEK(#1986-03-25#) = 13</pre></td></tr><tr><td>Remarques</td><td>Consultez aussi <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 leurs é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&nbsp;ISO8601 basé sur les semaines d’une <code>&lt;date&gt;</code> donnée sous la forme d’un entier.</td></tr><tr><td>Exemple</td><td><pre>ISOWEEKDAY(#1986-03-25#) = 2</pre></td></tr><tr><td>Remarques</td><td>Consultez aussi <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 leurs é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&nbsp;ISO8601 basée sur les semaines d’une <code>&lt;date&gt;</code> donnée sous la forme d’un entier.</td></tr><tr><td>Exemple</td><td><pre>ISOYEAR(#1986-03-25#) = 1,986</pre></td></tr><tr><td>Remarques</td><td>Consultez aussi <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 leurs é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 de l’<code>&lt;year&gt;</code>, du <code>&lt;month&gt;</code> et du <code>&lt;day&gt;</code> spécifiés.</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 erronées seront corrigées dans une date, par exemple <code>MAKEDATE(2020,4,31) = May 1, 2020</code> au lieu de renvoyer une erreur qui indique que le mois d’avril n’a pas 31&nbsp;jours.</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> a besoin d’entrées numériques pour les parties d’une date. Si vos données sont une chaîne qui doit ê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 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, 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 de l’<code>&lt;hour&gt;</code>, du <code>&lt;minute&gt;</code> et du <code>&lt;second&gt;</code> spécifiés.</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>Comme Tableau ne prend pas en charge le type de données heure, mais seulement le type date-heure, la sortie est une valeur datetime. La partie date du champ sera 1/1/1899.</p><p>Fonction similaire à <code><a href="#MAKEDATETIME" class="xref">MAKEDATETIME</a></code>, disponible uniquement pour les connexions compatibles avec 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 nulle.</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 dans une 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>La valeur <code>MAX</code> vient généralement en dernier dans l’ordre alphabétique.</p><p class="note">Pour les sources de données de la base de données, la valeur de chaîne <code>MAX</code> est 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, la valeur <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>Comme agrégation</b></p><p><code>MAX(expression)</code> est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que <code>AGG(expression)</code> dans la visualisation.</p><p><b>Comme comparaison</b></p><p><code>MAX(expr1, expr2)</code> compare les deux valeurs et renvoie une valeur de niveau ligne.</p><p>Voir aussi <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 nulle.</td></tr><tr><td>Définition</td><td><p>Renvoie la valeur minimale des deux&nbsp;arguments, qui doivent être du même type de données.</p><p><code>MIN </code>peut également être appliqué à un seul champ dans une 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>La valeur <code>MIN</code> vient généralement en premier dans l’ordre alphabétique.</p><p class="note">Pour les sources de données de la base de données, la valeur de chaîne <code>MIN</code> est la plus basse 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, la valeur <code>MIN</code> est la date la plus proche. 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>Comme agrégation</b></p><p><code>MIN(expression)</code> est une fonction d’agrégation et renvoie un seul résultat agrégé. Cette fonction s’affiche en tant que <code>AGG(expression)</code> dans la visualisation.</p><p><b>Comme comparaison</b></p><p><code>MIN(expr1, expr2)</code> compare les deux valeurs et renvoie une valeur de niveau ligne.</p><p>Voir aussi <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 aussi <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> n’utilise pas un argument.</p><p>Consultez aussi <code><a href="#TODAY" class="xref">TODAY</a></code>, un calcul similaire qui renvoie une date plutôt qu’un élément datetime.</p><p>Si la source de données est une connexion en direct, la date et l’heure du système peuvent indiquer un autre fuseau horaire. Pour plus d’information sur la résolution de ce problème, consultez <a href="https://kb.tableau.com/articles/issue/now-function-returns-utc-time?lang=fr-ca">la 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 aussi <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 actuelle du système local.</td></tr><tr><td>Exemple</td><td><pre>TODAY() = 1986-03-25</pre></td></tr><tr><td>Remarques</td><td><p><code>TODAY</code> n’utilise pas un argument.</p><p>Consultez aussi <a href="#NOW" class="xref">NOW</a>, un calcul similaire qui renvoie une valeur datetime plutôt qu’une date.</p><p>Si la source de données est une connexion en direct, la date du système peut indiquer un autre fuseau horaire. Pour plus d’information sur la résolution de ce problème, consultez <a href="https://kb.tableau.com/articles/issue/now-function-returns-utc-time?lang=fr-ca">la 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 aussi <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 aussi <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

Plusieurs fonctions de date dans Tableau utilisent l’argument `date_part`, une chaîne constante qui demande à la fonction la partie d’une date à considérer, par exemple le jour, la semaine, le trimestre, etc. Les valeurs `date_part` valides que vous pouvez utiliser sont les suivantes :

| 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 |

## Le paramètre `[start_of_week]`

Certaines fonctions possèdent le paramètre facultatif `[start_of_week]`. Vous pouvez utiliser le paramètre `start_of_week` pour spécifier le jour à considérer comme le premier jour de la semaine, par exemple « dimanche » ou « lundi ». S’il est omis, le début de la semaine est déterminé par la source de données. Consultez [Propriétés de date pour une source de données](https://help.tableau.com/v0.0/public/desktop/fr-ca/date_properties.htm).

Pour les exemples ci-dessous, le 22 septembre tombe un dimanche et le 24 septembre tombe 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`

- Car lorsque start\_of\_week prend la valeur ’monday’, ces dates ne sont pas de la même semaine.

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

- Car lorsque start\_of\_week prend la valeur ’sunday’, ces dates sont de la même semaine.

## L’expression littérale de date (#)

Les exemples utilisent souvent le symbole de la livre (#) avec les expressions de date. Il s’agit d’une expression littérale de date, qui revient à utiliser des guillemets pour les chaînes de texte, et elle demande à Tableau si la valeur dans les symboles est une date.

Sans les expressions littérales de date, les dates peuvent être interprétées comme étant des types de données connexes. 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>’25&nbsp;mars&nbsp;1986’</td><td>Chaîne</td><td>’25&nbsp;mars&nbsp;1986’</td></tr><tr><td>#25/03/1986#</td><td>Date</td><td>#25/03/1986#</td></tr><tr><td>25&nbsp;mars&nbsp;1986</td><td>Virgule flottante</td><td>0,00006042</td></tr><tr><td>25&nbsp;mars&nbsp;1986</td><td>Entier</td><td>1&nbsp;958</td></tr><tr><td>25&nbsp;mars&nbsp;1986</td><td>-</td><td>non valide</td></tr></tbody></table>

![Volet Données avec plusieurs icônes de format de date mises en évidence.](/tableau/next/fr-ca/public/desktop/fr-ca/Img/datefunc_dateformats.png)

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

## Créer un calcul de date

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

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 qui affiche les données de commande par année et par trimestre.](/tableau/next/fr-ca/public/desktop/fr-ca/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 qui affiche l’année, le trimestre et le mois des dates de commande.](/tableau/next/fr-ca/public/desktop/fr-ca/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 quarter Date 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, par trimestre, par mois et par date du trimestre.](/tableau/next/fr-ca/public/desktop/fr-ca/Img/datefunctions1.png)