Chaînes de format de date et d’heure standard

Article
11/20/2024

Une chaîne de format de date et d’heure standard utilise un caractère unique comme spécificateur de format pour définir la représentation textuelle d’une valeur d’heure et de date. Toute chaîne de format de date et d’heure contenant plusieurs caractères, y compris un espace blanc, est interprétée comme une chaîne de format de date et d’heure personnalisée. Une chaîne de format standard ou personnalisée peut être utilisée pour définir la représentation textuelle qui résulte d’une opération de mise en forme.

Tableau de spécificateurs de format

Le tableau suivant décrit les spécificateurs de format de date et d’heure standard.

Spécificateur de format	Description	Exemples
"d"	Modèle de date courte. Plus d’informations : spécificateur de format de date courte (« d »).	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
« D »	Modèle de date longue. Plus d’informations : spécificateur de format de date longue (« D »).	2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Modèle de date/heure complet (heure courte). Informations supplémentaires : Spécificateur de format de date complet et d’heure courte ("f").	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Modèle de date/heure complet (heure longue). Informations supplémentaires : Spécificateur de format de date complet et d’heure longue ("F").	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Modèle de date/heure général (heure courte). Informations supplémentaires : Spécificateur de format de date général et d’heure courte ("g").	2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Modèle de date/heure général (heure longue). Informations supplémentaires : Spécificateur de format de date général et d’heure longue ("G").	2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Modèle de mois/jour. Informations supplémentaires : Spécificateur de format de mois ("M", "m).	2009-06-15T13:45:30 -> June 15 (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	Modèle de date/heure aller-retour. Informations supplémentaires : Spécificateur de format aller-retour ("O", "o" »).	2009-06-15T13:45:30 (local) --> 2009-06-15T13:45:30.0000000-07:000 2009-06-15T13:45:30 (Utc) --> 2009-06-15T13:45:30.0000000+00:000 2009-06-15T13:45:30 (non spécifié) --> 2009-06-15T13:45:30.0000000
"R", "r"	Modèle RFC1123. Informations supplémentaires : Spécificateur de format RFC1123 ("R", "r").	2009-06-15T13:45:30 -> Mon, 15 juin 2009 13:45:30 GMT
"s"	Modèle de date/heure pouvant être trié. Informations supplémentaires : Spécificateur de format pouvant être trié ("s").	2009-06-15T13:45:30 (local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (Utc) -> 2009-06-15T13:45:30
"t"	Modèle d’heure courte. Informations supplémentaires : Spécificateur de format d’heure courte ("t").	2009-06-15T13:45:30 -> 1:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Modèle d’heure longue. Informations supplémentaires : Spécificateur de format d’heure longue ("T").	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Modèle de date/heure universel pouvant être trié. Informations supplémentaires : Spécificateur de format universel pouvant être trié ("u").	2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"Y", "y"	Modèle d’année/mois. Informations supplémentaires : Spécificateur de format Année Mois ("Y").	2009-06-15T13:45:30 -> June 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
N'importe quel caractère	Spécificateur inconnu.	Lève une erreur d’expression au moment de l’exécution.

Fonctionnement des chaînes de format standard

Dans une opération de mise en forme, une chaîne de format standard constitue simplement un alias d'une chaîne de format personnalisée. L'utilisation d'un alias pour faire référence à une chaîne de format personnalisée présente l'avantage suivant : bien que l'alias reste invariant, la chaîne de format personnalisée peut varier. Ce point est important car les représentations sous forme de chaîne de valeurs de date et d'heure varient généralement selon la culture. Par exemple, la chaîne de format standard "d" indique qu'une valeur de date et d'heure sera affichée à l'aide d'un modèle de date courte. Pour la culture dite indifférente, ce modèle est "MM/dd/yyyy". Pour la culture fr-FR, il s'agit de "dd/MM/yyyy". Pour la culture ja-JP, il s'agit de "yyyy/MM/dd".

Si, dans une opération de mise en forme, une chaîne de format standard est mappée à une chaîne de format personnalisée d'une culture particulière, votre application peut définir la culture spécifique dont les chaînes de format personnalisées sont utilisées de l'une des manières suivantes :

Vous pouvez utiliser la culture par défaut (ou actuelle). L'exemple suivant affiche une date à l'aide du format de date courte de la culture actuelle. Dans ce cas, la culture actuelle est en-US.
```
let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d"])
        //Displays 3/15/2024
    }
in
    Source
```
Vous pouvez passer une culture utilisée pour mettre en forme la date en fonction des règles de cette culture spécifique. L'exemple suivant affiche une date à l'aide du format de date courte de la culture pt-BR.
```
let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"])
        //Displays 15/03/2024
   }
in
    Source
```

Dans certains cas, il est pratique d'utiliser la chaîne de format standard comme abréviation pour les chaînes de format personnalisées plus longues et indifférentes. Quatre chaînes de format standard appartiennent à cette catégorie : "O" (ou "o"), "R" (ou "r"), "s" et "u". Ces chaînes correspondent aux chaînes de format personnalisées définies par la culture dite indifférente. Elles produisent des représentations sous forme de chaîne de valeurs de date et d'heure destinées à être identiques dans toutes les cultures. Le tableau suivant fournit des informations sur ces quatre chaînes de format de date et d'heure standard.

Chaîne de format standard	Défini par	Chaîne de format personnalisée
"O" ou "o"	None	yyyy’-’MM’-’dd’T’HH’ :’mm’ :’ss’.’fffffffK
"R" ou "r"	Spécification IETF RFC 1123	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	ISO 8601	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	Triable, car il utilise des zéros non significatifs pour l’année, le mois, le jour, l’heure, la minute et la seconde	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Les chaînes de format standard peuvent également être utilisées dans les opérations d’analyse, ce qui nécessite qu’une chaîne d’entrée soit exactement conforme à un modèle particulier pour que l’opération d’analyse réussisse. De nombreuses chaînes de format standard sont mappées à plusieurs chaînes de format personnalisées. Par conséquent, une valeur de date et d’heure peut être représentée dans divers formats et l’opération d’analyse réussit toujours.

Les sections suivantes décrivent les spécificateurs de format standard pour les valeurs Date, DateTime, DateTimeZone et Heure.

Formats de date

Ce groupe comprend les formats suivants :

Spécificateur de format de date courte ("d")
Spécificateur de format de date longue ("D")

Spécificateur de format de date courte ("d")

Le spécificateur de format standard « d » représente un format de date personnalisé défini par une culture spécifique. Par exemple, le texte de format personnalisé retourné par la culture invariante est « MM/dd/aaaa ».

L’exemple suivant utilise le spécificateur de format « d » pour afficher une valeur de date.

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = ""]),
        // Displays 04/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-US"]),
        // Displays 4/10/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "en-NZ"]),
        // Displays 10/4/2024

        Date.ToText(#date(2024, 4, 10), [Format = "d", Culture = "de-DE"])
        // Displays 10.4.2024
    }
in
    Source

Retour au tableau

Spécificateur de format de date longue ("D")

Le spécificateur de format standard « D » représente un format de date personnalisé défini par une culture spécifique. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "dddd, dd MMMM yyyy".

L'exemple suivant utilise le spécificateur de format "D" pour afficher une valeur de date et d'heure.

let
    Source =
    {
        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = ""]),
        // Displays Wednesday, 10 April, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "pt-BR"]),
        // Displays quarta-feira, 10 de abril de 2024

        Date.ToText(#date(2024, 4, 10), [Format = "D", Culture = "es-MX"])
        // Displays miércoles, 10 de abril de 2024
    }
in
    Source

Retour au tableau

Formats de date et d’heure

Ce groupe comprend les formats suivants :

Spécificateur de format de date complet et d’heure courte ("f")
Spécificateur de format de date complet et d’heure longue ("F")
Spécificateur de format de date général et d’heure courte ("g")
Spécificateur de format de date général et d’heure longue ("G")
Spécificateur de format aller-retour ("O", "o")
Spécificateur de format RFC1123 ("R", "r")
Spécificateur de format pouvant être trié ("s")
Spécificateur de format universel pouvant être trié ("u")

Spécificateur de format de date complet et d’heure courte ("f")

Le spécificateur de format standard "f" représente une combinaison des modèles de date longue ("D") et d’heure courte ("t"), séparés par un espace.

La chaîne de résultat est affectée par les informations de mise en forme d’une culture spécifique.

L'exemple suivant utilise le spécificateur de format "f" pour afficher une valeur de date et d'heure.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "f", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30
    }
in
    Source

Retour au tableau

Spécificateur de format de date complet et d’heure longue ("F")

Le spécificateur de format standard « F » représente un format de date et d’heure personnalisé défini par une culture spécifique. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "dddd, dd MMMM yyyy HH:mm:ss".

La chaîne de résultat est affectée par les informations de mise en forme d’une culture spécifique.

L'exemple suivant utilise le spécificateur de format "F" pour afficher une valeur de date et d'heure.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = ""]),
        // Displays Wednesday, 10 April, 2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "en-US"]),
        // Displays Wednesday, April 10, 2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "F", Culture = "fr-FR"])
        // Displays mercredi 10 avril 2024 06:30:00
    }
in
    Source

Retour au tableau

Spécificateur de format de date général et d’heure courte ("g")

Le spécificateur de format standard "g" représente une combinaison des modèles de date courte ("d") et d’heure courte ("t"), séparés par un espace. Le texte résultant est affecté par les informations de mise en forme d’une culture spécifique.

La chaîne de résultat est affectée par les informations de mise en forme d’une culture spécifique.

L'exemple suivant utilise le spécificateur de format "g" pour afficher une valeur de date et d'heure.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = ""]),
        // Displays 04/10/2024 06:30

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "en-US"]),
        // Displays 4/10/2024 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "g", Culture = "fr-BE"])
        // Displays 10-04-24 06:30
    }
in
    Source

Retour au tableau

Spécificateur de format de date général et d’heure longue ("G")

Le spécificateur de format standard "G" représente une combinaison des modèles de date courte ("d") et d’heure longue ("T"), séparés par un espace. Le texte résultant est affecté par les informations de mise en forme d’une culture spécifique.

La chaîne de résultat est affectée par les informations de mise en forme d’une culture spécifique.

L'exemple suivant utilise le spécificateur de format "G" pour afficher une valeur de date et d'heure.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = ""]),
        // Displays 04/10/2024 06:30:00

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "en-US"]),
        // Displays 4/10/2024 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "G", Culture = "nl-BE"])
        // Displays 10/04/2024 6:30:00
    }
in
    Source

Retour au tableau

Spécificateur de format aller-retour ("O", "o")

Le spécificateur de format standard "O" ou "o" représente une chaîne de format de date et d’heure personnalisée à l’aide d’un modèle qui conserve les informations de fuseau horaire et génère une chaîne de résultat conforme à la norme ISO 8601. Pour les valeurs DateTimeZone , ce spécificateur de format est conçu pour conserver les valeurs de date, d’heure et de fuseau horaire dans le texte.

Le spécificateur de format standard « O » ou « o » correspond au spécificateur « aaaa '-'MM'-'dd’T’HH' :'mm' :'ss'. » chaîne de format personnalisé fffffffffxxx pour les valeurs DateTimeZone . Dans ce texte, les paires de guillemets simples qui délimitent des caractères individuels, tels que les traits d’union, les points-virgules et la lettre « T », indiquent que le caractère individuel est un littéral qui ne peut pas être modifié. Les apostrophes n’apparaissent pas dans la chaîne de sortie.

Spécificateur de format standard « O » ou « o » (et le spécificateur « aaaa'-'MM'-'T’HH' :'mm' :'ss'. le format personnalisé fffffffffxxx) tire parti des façons dont ISO 8601 représente les informations de fuseau horaire pour conserver les valeurs DateTimeZone :

Le composant fuseau horaire de DateTimeZone.ToLocal valeurs de date et d’heure est un décalage par rapport à UTC (par exemple, +01:00, -07:00).
Le composant fuseau horaire de DateTimeZone.ToUtc valeurs de date et d’heure utilise +00.00 pour représenter UTC.

Comme le spécificateur de format standard « O » ou « o » est conforme à une norme internationale, l’opération de mise en forme ou d’analyse qui recourt au spécificateur utilise toujours la culture dite indifférente et le calendrier grégorien.

L’exemple suivant utilise le spécificateur de format « o » pour afficher une série de valeurs DateTimeZone sur un système du fuseau horaire américain.

let
    date1 = #datetimezone(2024, 6, 15, 13, 45, 30, 0, 0),
    Source =
    {
        Text.Format("#{0} (Unspecified) --> #{1}", {date1, DateTimeZone.ToText(date1, [Format = "O"])}),
        Text.Format("#{0} (Utc) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToUtc(date1), [Format = "O"])}),
        Text.Format("#{0} (Local) --> #{1}", {date1, DateTimeZone.ToText(DateTimeZone.ToLocal(date1), [Format = "O"])})
    }
in
    Source

// The example displays the following output:
//    6/15/2024 1:45:30 PM +00:00 (Unspecified) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Utc) --> 2024-06-15T13:45:30.0000000+00:00
//    6/15/2024 1:45:30 PM +00:00 (Local) --> 2024-06-15T08:45:30.0000000-07:00

Remarque

La valeur retournée par DateTimeZone.ToLocal dépend de l’exécution de Power Query sur un ordinateur local ou en ligne. Par exemple, dans l’exemple ci-dessus sur un système du fuseau horaire américain pacifique, Power Query Desktop retourne -07:00 pour l’heure locale , car il lit l’heure définie sur votre ordinateur local. Toutefois, Power Query Online retourne +00:00 , car il lit l’heure définie sur les machines virtuelles cloud, qui sont définies sur UTC.

L’exemple suivant utilise le spécificateur de format « o » pour créer une chaîne mise en forme, puis restaure la valeur de date et d’heure d’origine en appelant une routine d’analyse de date et d’heure.

let
    // Round-trip a local time
    #"Origin Local Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0)
    ),
    #"Local Date Text" = DateTimeZone.ToText(
        #"Origin Local Date", [Format = "o"]
    ),
    #"New Local Date" = DateTimeZone.FromText(#"Local Date Text"),
    #"Local Round Trip" = Text.Format(
        "Round-tripped #{0} Local to #{1} Local.", 
        {
            DateTimeZone.ToText(#"Origin Local Date"), 
            DateTimeZone.ToText(#"New Local Date")
        }
    ),

    // Round-trip a UTC time
    #"Origin UTC Date" = DateTimeZone.ToUtc(
        #datetimezone(2024, 4, 12, 9, 30, 0, 0, 0)
    ),
    #"UTC Date Text" = DateTimeZone.ToText(
        #"Origin UTC Date", [Format = "o"]
    ),
    #"New UTC Date" = DateTimeZone.FromText(#"UTC Date Text"),
    #"UTC Round Trip" = Text.Format(
        "Round-tripped #{0} UTC to #{1} UTC.", 
        {
            DateTimeZone.ToText(#"Origin UTC Date"), 
            DateTimeZone.ToText(#"New UTC Date")
        }
    ),

    // Round-trip an 18 hour offset time
    #"Origin Offset Date" = DateTimeZone.ToLocal(
        #datetimezone(2024, 4, 10, 6, 30, 0, 0, 0) + #duration(0, 18, 0, 0)
    ),
    #"Offset Date Text" = DateTimeZone.ToText(
        #"Origin Offset Date", [Format = "o"]
    ),
    #"New Offset Date" = DateTimeZone.FromText(#"Offset Date Text"),
    #"Offset Round Trip" = Text.Format(
        "Round-tripped #{0} to #{1}.", 
        {
            DateTimeZone.ToText(#"Origin Offset Date"), 
            DateTimeZone.ToText(#"New Offset Date")
        }
    ),

    #"Round Trip Results" = 
        {#"Local Round Trip", #"UTC Round Trip", #"Offset Round Trip"}
in
    #"Round Trip Results"

// The example displays the following output in Power Query Desktop:
//    Round-tripped 4/9/2024 11:30:00 PM -07:00 Local to 4/9/2024 11:30:00 PM -07:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/10/2024 5:30:00 PM -07:00 to 4/10/2024 5:30:00 PM -07:00.

// The example displays the following output in Power Query Online:
//    Round-tripped 4/10/2024 6:30:00 AM +00:00 Local to 4/10/2024 6:30:00 AM +00:00 Local.
//    Round-tripped 4/12/2024 9:30:00 AM +00:00 UTC to 4/12/2024 9:30:00 AM +00:00 UTC.
//    Round-tripped 4/11/2024 12:30:00 AM +00:00 to 4/11/2024 12:30:00 AM +00:00.

Retour au tableau

Spécificateur de format RFC1123 ("R", "r")

Le spécificateur de format standard « R » ou « r » représente une chaîne de format de date et d’heure personnalisée qui n’est pas définie par une culture spécifique. Il est toujours le même, quelle que soit la culture utilisée ou le fournisseur de format fourni. La chaîne de format personnalisée est "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Lorsque ce spécificateur de format standard est utilisé, l'opération de mise en forme ou d'analyse utilise toujours la culture dite indifférente.

Bien que la norme RFC 1123 exprime une heure en tant que temps universel coordonné (UTC), l’opération de mise en forme ne modifie pas la valeur de la date et de l’heure mises en forme. Par conséquent, vous devez convertir la valeur DateTime en UTC en appelant la méthode de fonction DateTimeZone.ToUtc avant d’effectuer l’opération de mise en forme.

L’exemple suivant utilise le spécificateur de format « r » pour afficher une valeur d’heure et de date sur un système du fuseau horaire américain pacifique (sept heures derrière UTC).

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source = 
    {
        DateTimeZone.ToText(date1, [Format = "r"]),
        // Displays Wed, 10 Apr 2024 13:30:00 GMT

        DateTimeZone.ToText(dateOffset, [Format = "r"])
        // Displays Wed, 10 Apr 2024 13:30:00 GMT
    }
in
    Source

Retour au tableau

Spécificateur de format pouvant être trié ("s")

Le spécificateur de format standard « s » représente une chaîne de format de date et d’heure personnalisée qui reflète une norme définie (ISO 8601) et est en lecture seule. Par conséquent, il s'agit toujours du même, quels que soient la culture utilisée ou le fournisseur de format spécifié. La chaîne de format personnalisée est "yyyy'-'MM'-'dd'T'HH':'mm':'ss". L'objectif du spécificateur de format "s" est de produire des chaînes de résultats qui trient de façon cohérente par ordre croissant ou décroissant en fonction des valeurs de date et d'heure.

Lorsque ce spécificateur de format standard est utilisé, l'opération de mise en forme ou d'analyse utilise toujours la culture dite indifférente.

L’exemple suivant utilise le spécificateur de format « s » pour afficher une valeur de date et d’heure sur un système du fuseau horaire américain pacifique.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "s", Culture = "en-US"])
        // Displays 2024-04-10T06:30:00
    }
in
    Source

Retour au tableau

Spécificateur de format universel pouvant être trié ("u")

Le spécificateur de format standard « u » représente une chaîne de format de date et d’heure personnalisée qui est toujours la même, quelle que soit la culture utilisée ou le fournisseur de format fourni. La chaîne de format personnalisée est "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Le modèle reflète une norme définie, et la propriété est en lecture seule. Lorsque ce spécificateur de format standard est utilisé, l'opération de mise en forme ou d'analyse utilise toujours la culture dite indifférente.

Bien que la chaîne de résultat exprime une heure en tant que temps universel coordonné (UTC), aucune conversion de la valeur DateTimeZone d’origine n’est effectuée pendant l’opération de mise en forme. Par conséquent, vous devez convertir une valeur DateTimeZone en UTC en appelant la fonction DateTimeZone.ToUtc avant de la mettre en forme.

L'exemple suivant utilise le spécificateur de format « u » pour afficher une valeur de date et d'heure.

let
    date1 = #datetimezone(2024, 4, 10, 6, 30, 0, -7, 0),
    dateOffset = DateTimeZone.ToUtc(date1),
    Source =
    {
        DateTimeZone.ToText(dateOffset, [Format = "u"]),
        // Displays 2024-04-10 13:30:00Z
    }
in
    Source

Retour au tableau

Formats d’horodatage

Ce groupe comprend les formats suivants :

Spécificateur de format d’heure courte ("t")
Spécificateur de format d’heure longue ("T")

Spécificateur de format d’heure courte ("t")

Le spécificateur de format standard « t » représente une chaîne de format de date et d’heure personnalisée définie par la culture spécifiée. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "HH:mm".

La chaîne de résultat est affectée par les informations de mise en forme d’une culture spécifique.

L'exemple suivant utilise le spécificateur de format "t" pour afficher une valeur de date et d'heure.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = ""]),
        // Displays 06:30
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "en-US"]),
        // Displays 6:30 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "t", Culture = "es-ES"])
        // Displays 6:30
    }
in
    Source

Retour au tableau

Spécificateur de format d’heure longue ("T")

Le spécificateur de format standard « T » représente une chaîne de format de date et d’heure personnalisée définie par la culture spécifique. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "HH:mm:ss".

L'exemple suivant utilise le spécificateur de format "T" pour afficher une valeur de date et d'heure.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = ""]),
        // Displays 06:30:00
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "en-US"]),
        // Displays 6:30:00 AM

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "T", Culture = "es-ES"])
        // Displays 6:30:00
    }
in
    Source

Retour au tableau

Formats de date partielle

Ce groupe comprend les formats suivants :

Spécificateur de format de mois ("M", "m")
Spécificateur de format année-mois ("Y")

Spécificateur de format de mois ("M", "m")

Le spécificateur de format standard « M » ou « m » représente une chaîne de format de date et d’heure personnalisée définie par la culture spécifique. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "MMMM dd".

L'exemple suivant utilise le spécificateur de format "m" pour afficher une valeur de date et d'heure.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = ""]),
        // Displays April 10
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "en-US"]),
        // Displays April 10

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "m", Culture = "ms-MY"])
        // Displays 10 April
    }
in
    Source

Retour au tableau

Spécificateur de format Année Mois ("Y", "y")

Le spécificateur de format standard « Y » ou « y » représente une chaîne de format de date personnalisée définie par une culture spécifique. Par exemple, la chaîne de format personnalisée pour la culture dite indifférente est "yyyy MMMM".

L'exemple suivant utilise le spécificateur de format "y" pour afficher une valeur de date et d'heure.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = ""]),
        // Displays 2024 April
        
        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "Y", Culture = "en-US"]),
        // Displays April 2024

        DateTime.ToText(#datetime(2024, 4, 10, 6, 30, 0), [Format = "y", Culture = "af-ZA"])
        // Displays April 2024
    }
in
    Source

Retour au tableau

Partager via

Chaînes de format de date et d’heure standard

Tableau de spécificateurs de format

Fonctionnement des chaînes de format standard

Formats de date

Spécificateur de format de date courte ("d")

Spécificateur de format de date longue ("D")

Formats de date et d’heure

Spécificateur de format de date complet et d’heure courte ("f")

Spécificateur de format de date complet et d’heure longue ("F")

Spécificateur de format de date général et d’heure courte ("g")

Spécificateur de format de date général et d’heure longue ("G")

Spécificateur de format aller-retour ("O", "o")

Spécificateur de format RFC1123 ("R", "r")

Spécificateur de format pouvant être trié ("s")

Spécificateur de format universel pouvant être trié ("u")

Formats d’horodatage

Spécificateur de format d’heure courte ("t")

Spécificateur de format d’heure longue ("T")

Formats de date partielle

Spécificateur de format de mois ("M", "m")

Spécificateur de format Année Mois ("Y", "y")

Commentaires

Ressources supplémentaires

Partager via

Chaînes de format de date et d’heure standard

Tableau de spécificateurs de format

Fonctionnement des chaînes de format standard

Formats de date

Spécificateur de format de date courte ("d")

Spécificateur de format de date longue ("D")

Formats de date et d’heure

Spécificateur de format de date complet et d’heure courte ("f")

Spécificateur de format de date complet et d’heure longue ("F")

Spécificateur de format de date général et d’heure courte ("g")

Spécificateur de format de date général et d’heure longue ("G")

Spécificateur de format aller-retour ("O", "o")

Spécificateur de format RFC1123 ("R", "r")

Spécificateur de format pouvant être trié ("s")

Spécificateur de format universel pouvant être trié ("u")

Formats d’horodatage

Spécificateur de format d’heure courte ("t")

Spécificateur de format d’heure longue ("T")

Formats de date partielle

Spécificateur de format de mois ("M", "m")

Spécificateur de format Année Mois ("Y", "y")

Contenu connexe

Commentaires

Ressources supplémentaires