Partager via


Chaînes de format de date et d’heure personnalisées

Une chaîne de format de date et d’heure définit la représentation textuelle d’une valeur Date, DateTime, DateTimeZone ou Heure qui résulte d’une opération de mise en forme. Elle peut également définir la représentation d'une valeur de date et d'heure qui est requise dans une opération d'analyse afin de convertir correctement la chaîne sous forme de date et d'heure. Une chaîne de format personnalisée se compose d'un ou de plusieurs spécificateurs de format de date et d'heure personnalisés. Toute chaîne qui n’est pas une chaîne de format de date et d’heure standard est interprétée comme une chaîne de format de date et d’heure personnalisée.

Dans les opérations de mise en forme, les chaînes de format de date et d’heure personnalisées peuvent être utilisées avec la ToText méthode d’une instance de date et d’heure et de fuseau horaire. L’exemple suivant illustre ses utilisations.

let
    Source = 
    {
        Text.From("Today is " & Date.ToText(#date(2011, 6, 10), [Format = "MMMM dd yyyy"]) & "."),
        Text.Format("The current date and time: #{0}", {DateTimeZone.ToText(
            #datetimezone(2011, 6, 10, 15, 24, 16, 0, 0), [Format = "MM/dd/yy H:mm:ss zzz"])}
        )
    }
in
    Source

// The example displays the following output:
//    Today is June 10, 2011.
//    The current date and time: 06/10/11 15:24:16 +00:00

Dans les opérations d’analyse, les chaînes de format de date et d’heure personnalisées peuvent être utilisées avec les fonctions Date, DateTime, Heure et DateTimeZone. Ces fonctions nécessitent qu’une chaîne d’entrée soit conforme exactement à un modèle particulier pour que l’opération d’analyse réussisse. L’exemple suivant illustre un appel à la fonction DateTime.FromText pour analyser une date qui doit inclure un mois, un jour et une année à deux chiffres.

let
    dateValues = { "30-12-2011", "12-30-2011", "30-12-11", "12-30-11"},
    pattern = "MM-dd-yy",
    convertedDates = List.Transform(dateValues, (dateValue) => 
        try Text.Format("Converted '#{0}' to #{1}.", {dateValue, DateTime.FromText(dateValue, [Format=pattern])}) 
        otherwise Text.Format("Unable to convert '#{0}' to a date and time.", {dateValue}))
in
    convertedDates

// The example displays the following output:
//    Unable to convert '30-12-2011' to a date and time.
//    Unable to convert '12-30-2011' to a date and time.
//    Unable to convert '30-12-11' to a date and time.
//    Converted '12-30-11' to 12/30/2011.

Le tableau suivant décrit les spécificateurs de format de date et d’heure personnalisé et affiche une chaîne de résultat produite par chaque spécificateur de format. Par défaut, les chaînes de résultat reflètent les conventions de mise en forme de la culture en-US. Si un spécificateur de format particulier produit une chaîne de résultat localisée, l'exemple indique également la culture à laquelle la chaîne de résultat s'applique. Pour plus d’informations sur l’utilisation de chaînes de format de date et d’heure personnalisées, accédez à la section Notes .

Spécificateur de format Description Exemples
"d" Jour du mois, de 1 à 31.

Informations supplémentaires : Spécificateur de format personnalisé "d".
2009-06-01T13:45:30 -> 1

2009-06-15T13:45:30 -> 15
"dd" Jour du mois, de 01 à 31.

Plus d’informations : spécificateur de format personnalisé « dd ».
2009-06-01T13:45:30 -> 01

2009-06-15T13:45:30 -> 15
"ddd" Nom abrégé du jour de la semaine.

Plus d’informations : spécificateur de format personnalisé « ddd ».
2009-06-15T13:45:30 -> Mon (en-US)

2009-06-15T13:45:30 -> Пн (ru-RU)

2009-06-15T13:45:30 -> lun. (fr-FR)
"dddd" Nom complet du jour de la semaine.

Plus d’informations : spécificateur de format personnalisé « dddd ».
2009-06-15T13:45:30 -> Monday (en-US)

2009-06-15T13:45:30 -> понедельник (ru-RU)

2009-06-15T13:45:30 -> lundi (fr-FR)
"f" Dixièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "f".
2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.05 -> 0
"ff" Centièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "ff".
2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> 00
"fff" Millisecondes dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "fff".
6/15/2009 13:45:30.617 -> 617

6/15/2009 13:45:30.0005 -> 000
"ffff" Dix millièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "ffff".
2009-06-15T13:45:30.6175000 -> 6175

2009-06-15T13:45:30.0000500 -> 0000
"fffff" Cent millièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "fffff".
2009-06-15T13:45:30.6175400 -> 61754

6/15/2009 13:45:30.000005 -> 00000
"ffffff" Millionièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "ffffff".
2009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> 000000
"fffffff" Dix millionièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "fffffff".
2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 0001150
"F" Si la valeur est différente de zéro, elle représente les dixièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "F".
2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.0500000 -> (pas de sortie)
"FF" Si la valeur est différente de zéro, elle représente les centièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "FF".
2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> (pas de sortie)
"FFF" Si la valeur est différente de zéro, elle représente les millisecondes dans une valeur de date et d'heure.

Plus d’informations : spécificateur de format personnalisé « FFF ».
2009-06-15T13:45:30.6170000 -> 617

2009-06-15T13:45:30.0005000 -> (pas de sortie)
"FFFF" Si la valeur est différente de zéro, elle représente les dix millièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "FFFF".
2009-06-15T13:45:30.5275000 -> 5275

2009-06-15T13:45:30.0000500 -> (pas de sortie)
"FFFFF" Si la valeur est différente de zéro, elle représente les cent millièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "FFFFF".
2009-06-15T13:45:30.6175400 -> 61754

2009-06-15T13:45:30.0000050 -> (pas de sortie)
"FFFFFF" Si la valeur est différente de zéro, elle représente les millionièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "FFFFFF".
2009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> (pas de sortie)
"FFFFFFF" Si la valeur est différente de zéro, elle représente les dix millionièmes de seconde dans une valeur de date et d'heure.

Informations supplémentaires : Spécificateur de format personnalisé "FFFFFFF".
2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 000115
"g", "gg" Période ou ère.

Plus d’informations : spécificateur de format personnalisé « g » ou « gg ».
2009-06-15T13:45:30.6170000 -> A.D.
"h" Heure, au format de 12 heures, de 1 à 12.

Informations supplémentaires : Spécificateur de format personnalisé "h".
2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 1
"hh" Heure, au format de 12 heures, de 01 à 12.

Informations supplémentaires : Spécificateur de format personnalisé "hh".
2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 01
"H" Heure, au format de 24 heures, de 0 à 23.

Plus d’informations : spécificateur de format personnalisé « H ».
2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 13
"HH" Heure, au format de 24 heures, de 00 à 23.

Plus d’informations : spécificateur de format personnalisé « HH ».
2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 13
"K" Informations de fuseau horaire.

Plus d’informations : spécificateur de format personnalisé « K ».
2009-06-15T13:45:30, Non spécifié ->

2009-06-15T13:45:30, Utc -> +00:00

2009-06-15T13:45:30, Local -> -07:00 (dépend des paramètres de l’ordinateur local ou cloud)
"m" Minute, de 0 à 59.

Informations supplémentaires : Spécificateur de format personnalisé "m".
2009-06-15T01:09:30 -> 9

2009-06-15T13:29:30 -> 29
"mm" Minute, de 00 à 59.

Informations supplémentaires : Spécificateur de format personnalisé "mm".
2009-06-15T01:09:30 -> 09

2009-06-15T01:45:30 -> 45
"M" Mois, de 1 à 12.

Plus d’informations : spécificateur de format personnalisé « M ».
2009-06-15T13:45:30 -> 6
"MM" Mois, de 01 à 12.

Plus d’informations : spécificateur de format personnalisé « MM ».
2009-06-15T13:45:30 -> 06
"MMM" Nom abrégé du mois.

Plus d’informations : spécificateur de format personnalisé « MMM ».
2009-06-15T13:45:30 -> Jun (en-US)

2009-06-15T13:45:30 -> juin (fr-FR)

2009-06-15T13:45:30 -> Jun (zu-ZA)
"MMMM" Nom complet du mois.

Plus d’informations : spécificateur de format personnalisé « MMMM ».
2009-06-15T13:45:30 -> June (en-US)

2009-06-15T13:45:30 -> juni (da-DK)

2009-06-15T13:45:30 -> Juni (zu-ZA)
"s" Seconde, de 0 à 59.

Informations supplémentaires : Spécificateur de format personnalisé "s".
2009-06-15T13:45:09 -> 9
"ss" Seconde, de 00 à 59.

Informations supplémentaires : Spécificateur de format personnalisé "ss".
2009-06-15T13:45:09 -> 09
"t" Premier caractère de l'indicateur AM/PM.

Plus d’informations : spécificateur de format personnalisé « t ».
2009-06-15T13:45:30 -> P (en-US)

2009-06-15T13:45:30 -> 午 (ja-JP)

2009-06-15T13:45:30 -> (fr-FR)
"tt" Indicateur AM/PM.

Plus d’informations : spécificateur de format personnalisé « tt ».
2009-06-15T13:45:30 -> PM (en-US)

2009-06-15T13:45:30 -> 午後 (ja-JP)

2009-06-15T13:45:30 -> (fr-FR)
"y" Année, de 0 à 99.

Plus d’informations : spécificateur de format personnalisé « y ».
0001-01-01T00:00:00 -> 1

0900-01-01T00:00:00 -> 0

1900-01-01T00:00:00 -> 0

2009-06-15T13:45:30 -> 9

2019-06-15T13:45:30 -> 19
"yy" Année, de 00 à 99.

Plus d’informations : spécificateur de format personnalisé « yy ».
0001-01-01T00:00:00 -> 01

0900-01-01T00:00:00 -> 00

1900-01-01T00:00:00 -> 00

2019-06-15T13:45:30 -> 19
"yyy" Année, avec au minimum trois chiffres.

Plus d’informations : spécificateur de format personnalisé « aaaa ».
0001-01-01T00:00:00 -> 001

0900-01-01T00:00:00 -> 900

1900-01-01T00:00:00 -> 1900

2009-06-15T13:45:30 -> 2009
"yyyy" Année, en tant que nombre à quatre chiffres.

Plus d’informations : spécificateur de format personnalisé « aaaa ».
0001-01-01T00:00:00 -> 0001

0900-01-01T00:00:00 -> 0900

1900-01-01T00:00:00 -> 1900

2009-06-15T13:45:30 -> 2009
"yyyyy" Année, en tant que nombre à cinq chiffres.

Plus d’informations : spécificateur de format personnalisé « aaaa ».
0001-01-01T00:00:00 -> 00001

2009-06-15T13:45:30 -> 02009
"z" Décalage horaire par rapport à l'heure UTC, sans zéro non significatif.

Plus d’informations : spécificateur de format personnalisé « z ».
2009-06-15T13:45:30-07:00 -> -7
"zz" Décalage horaire par rapport à l'heure UTC, avec un zéro non significatif pour une valeur à un seul chiffre.

Plus d’informations : spécificateur de format personnalisé « zz ».
2009-06-15T13:45:30-07:00 -> -07
"zzz" Décalage horaire par rapport à l'heure UTC, en heures et minutes.

Plus d’informations : spécificateur de format personnalisé « zzz ».
2009-06-15T13:45:30-07:00 -> -07:00
":" Séparateur horaire.

Plus d’informations : spécificateur de format personnalisé « : ».
2009-06-15T13:45:30 -> : (en-US)

2009-06-15T13:45:30 -> . (it-IT)

2009-06-15T13:45:30 -> : (ja-JP)
"/" Séparateur de date.

Plus d’informations : spécificateur de format personnalisé « / ».
2009-06-15T13:45:30 -> / (en-US)

2009-06-15T13:45:30 -> - (ar-DZ)

2009-06-15T13:45:30 -> . (tr-TR)
"chaîne"

'chaîne'
Délimiteur de chaîne littérale.

Plus d’informations : Littéraux de caractère.
2009-06-15T13:45:30 (« "arr :" » h :m t) -> arr : 1:45 P

2009-06-15T13:45:30 ('arr:' h:m t) -> arr: 1:45 P
% Définit le caractère suivant comme spécificateur de format personnalisé.

Plus d’informations : Utilisation de spécificateurs de format personnalisés uniques.
2009-06-15T13:45:30 (%h) -> 1
\, "", ' Séquences d’échappement.

Plus d’informations : littéraux de caractères et utilisation des séquences d’échappement.
2009-06-15T13:45:30 (h \h) -> 1 h

2009-06-15T13:45:30 (h « "h" ») -> 1 h

2009-06-15T13:45:30 (h 'h') -> 1 h
N'importe quel autre caractère Le caractère est copié inchangé dans la chaîne de résultat.

Plus d’informations : Littéraux de caractère.
2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

Les sections suivantes fournissent des informations supplémentaires sur chaque spécificateur de format de date et d'heure personnalisé. Sauf indication contraire, chaque spécificateur produit une représentation sous forme de chaîne identique, qu’elle soit utilisée avec une valeur Date, DateTime, DateTimeZone ou Heure.

Spécificateur de format "d" pour le jour

Spécificateur de format personnalisé "d"

Le spécificateur de format personnalisé « d » représente le jour du mois sous la forme d’un nombre compris entre 1 et 31. Un jour à un seul chiffre est mis en forme sans zéro non significatif.

Si le spécificateur de format « d » est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d’heure standard « d ». Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L'exemple suivant inclut le spécificateur de format personnalisé "d" dans plusieurs chaînes de format.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, M", Culture = ""]),
        // Displays 29, 8 

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "en-US"]),
        // Displays 29, August

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "es-MX"])
        // Displays 29, agosto
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "dd"

Le spécificateur de format personnalisé « dd » représente le jour du mois sous la forme d’un nombre compris entre 01 et 31. Un jour à un seul chiffre est mis en forme avec un zéro non significatif.

L'exemple suivant inclut le spécificateur de format personnalisé "dd" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
        // Displays 02, 01 
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "ddd"

Le spécificateur de format personnalisé "ddd" représente le nom abrégé du jour de la semaine. Le nom abrégé localisé du jour de la semaine est récupéré à partir de la culture actuelle ou spécifiée.

L'exemple suivant inclut le spécificateur de format personnalisé "ddd" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
        // Displays Thu 29 Aug

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
        // Displays jeu. 29 août
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "dddd"

Le spécificateur de format personnalisé "dddd" (plus n'importe quel nombre de spécificateurs "d" supplémentaires) représente le nom complet du jour de la semaine. Le nom localisé du jour de la semaine est récupéré à partir de la culture actuelle ou spécifiée.

L'exemple suivant inclut le spécificateur de format personnalisé "dddd" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
        // Displays Thursday 29 August

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
        // Displays giovedì 29 agosto
    }
in
    Source

Retour au tableau

Spécificateur de fraction "f" minuscule pour les secondes

Spécificateur de format personnalisé "f"

Le spécificateur de format personnalisé "f" représente le chiffre le plus significatif de la fraction de seconde ; autrement dit, il représente les dixièmes de seconde dans une valeur de date et d'heure.

Si le spécificateur de format « f » est utilisé sans autre spécificateur de format, il est interprété comme le spécificateur de format de date et d’heure standard « f ». Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

Lorsque vous utilisez des spécificateurs de format « f » dans le cadre d’une chaîne de format fournie pour analyser le nombre de fractions de secondes, le nombre de spécificateurs de format « f » indique le nombre de chiffres les plus significatifs de la fraction de secondes qui doit être présente pour analyser correctement la chaîne.

L'exemple suivant inclut le spécificateur de format personnalisé "f" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
        // Displays 07:27:15:0

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
        // Displays 07:27:15:
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "ff"

Le spécificateur de format personnalisé "ff" représente les deux chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les centièmes de seconde dans une valeur de date et d'heure.

L'exemple suivant inclut le spécificateur de format personnalisé "ff" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
        // Displays 07:27:15:01

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
        // Displays 07:27:15:01
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "fff"

Le spécificateur de format personnalisé "fff" représente les trois chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les millisecondes dans une valeur de date et d'heure.

L'exemple suivant inclut le spécificateur de format personnalisé "fff" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
        // Displays 07:27:15:018

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
        // Displays 07:27:15:018
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "ffff"

Le spécificateur de format personnalisé "ffff" représente les quatre chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les dix millièmes de seconde dans une valeur de date et d'heure.

Bien qu’il soit possible d’afficher les dix millièmes d’un deuxième composant d’une valeur de temps, cette valeur peut ne pas être significative. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. Sur les systèmes d’exploitation Windows Server 2019 et Windows 11, la résolution de l’horloge est d’environ 1 milliseconde.

Retour au tableau

Spécificateur de format personnalisé "fffff"

Le spécificateur de format personnalisé "fffff" représente les cinq chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les cent millièmes de seconde dans une valeur de date et d'heure.

Bien qu’il soit possible d’afficher les cent millièmes d’un deuxième composant d’une valeur de temps, cette valeur peut ne pas être significative. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. Sur les systèmes d’exploitation Windows Server 2019 et Windows 11, la résolution de l’horloge est d’environ 1 milliseconde.

Retour au tableau

Spécificateur de format personnalisé "ffffff"

Le spécificateur de format personnalisé "ffffff" représente les six chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les millionièmes de seconde dans une valeur de date et d'heure.

Bien qu’il soit possible d’afficher les millionièmes d’un deuxième composant d’une valeur de temps, cette valeur peut ne pas être significative. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. Sur les systèmes d’exploitation Windows Server 2019 et Windows 11, la résolution de l’horloge est d’environ 1 milliseconde.

Retour au tableau

Spécificateur de format personnalisé "fffffff"

Le spécificateur de format personnalisé "fffffff" représente les sept chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les dix millionièmes de seconde dans une valeur de date et d'heure.

Bien qu’il soit possible d’afficher les dix millionièmes d’un deuxième composant d’une valeur de temps, cette valeur peut ne pas être significative. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. Sur les systèmes d’exploitation Windows Server 2019 et Windows 11, la résolution de l’horloge est d’environ 1 milliseconde.

Retour au tableau

Spécificateur de fraction "F" majuscule pour les secondes

Spécificateur de format personnalisé "F"

Le spécificateur de format personnalisé "F" représente le chiffre le plus significatif de la fraction de seconde ; autrement dit, il représente les dixièmes de seconde dans une valeur de date et d'heure. Rien n’est affiché si le chiffre est un zéro et, dans ce cas, la virgule décimale qui suit le nombre de secondes n’est pas affichée non plus.

Si le spécificateur de format « F » est utilisé sans autre spécificateur de format, il est interprété comme le spécificateur de format de date et d’heure standard « F ». Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

Le nombre de spécificateurs de format « F » utilisés lors de l’analyse indique le nombre maximal de chiffres les plus significatifs de la fraction de secondes qui peut être présente pour analyser correctement la chaîne.

L'exemple suivant inclut le spécificateur de format personnalisé "F" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
        // Displays 07:27:15:0

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
        // Displays 07:27:15:
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "FF"

Le spécificateur de format personnalisé "FF" représente les deux chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les centièmes de seconde dans une valeur de date et d'heure. Les zéros de fin ne sont pas affichés. Rien n’est affiché si les deux chiffres significatifs sont un zéro, et dans ce cas, la virgule décimale qui suit le nombre de secondes n’est pas affichée non plus.

L'exemple suivant inclut le spécificateur de format personnalisé "FF" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
        // Displays 07:27:15:01

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
        // Displays 07:27:15:01
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "FFF"

Le spécificateur de format personnalisé "FFF" représente les trois chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les millisecondes dans une valeur de date et d'heure. Les zéros de fin ne sont pas affichés. Rien n’est affiché si les trois chiffres significatifs sont un zéro, et dans ce cas, la virgule décimale qui suit le nombre de secondes n’est pas affichée non plus.

L'exemple suivant inclut le spécificateur de format personnalisé "FFF" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
        // Displays 07:27:15:018

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
        // Displays 07:27:15:018
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "FFFF"

Le spécificateur de format personnalisé "FFFF" représente les quatre chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les dix millièmes de seconde dans une valeur de date et d'heure. Les zéros de fin ne sont pas affichés. Rien n’est affiché si les quatre chiffres significatifs sont un zéro, et dans ce cas, la virgule décimale qui suit le nombre de secondes n’est pas affichée non plus.

Bien qu’il soit possible d’afficher les dix millièmes d’un deuxième composant d’une valeur de temps, cette valeur peut ne pas être significative. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. Sur les systèmes d’exploitation Windows Server 2019 et Windows 11, la résolution de l’horloge est d’environ 1 milliseconde.

Retour au tableau

Spécificateur de format personnalisé "FFFFF"

Le spécificateur de format personnalisé "FFFFF" représente les cinq chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les cent millièmes de seconde dans une valeur de date et d'heure. Les zéros de fin ne sont pas affichés. Rien n’est affiché si les cinq chiffres significatifs sont un zéro, et dans ce cas, la virgule décimale qui suit le nombre de secondes n’est pas affichée non plus.

Bien qu’il soit possible d’afficher les cent millièmes d’un deuxième composant d’une valeur de temps, cette valeur peut ne pas être significative. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. Sur les systèmes d’exploitation Windows Server 2019 et Windows 11, la résolution de l’horloge est d’environ 1 milliseconde.

Retour au tableau

Spécificateur de format personnalisé "FFFFFF"

Le spécificateur de format personnalisé "FFFFFF" représente les six chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les millionièmes de seconde dans une valeur de date et d'heure. Les zéros de fin ne sont pas affichés. Rien n’est affiché si les six chiffres significatifs sont un zéro, et dans ce cas, la virgule décimale qui suit le nombre de secondes n’est pas affichée non plus.

Bien qu’il soit possible d’afficher les millionièmes d’un deuxième composant d’une valeur de temps, cette valeur peut ne pas être significative. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. Sur les systèmes d’exploitation Windows Server 2019 et Windows 11, la résolution de l’horloge est d’environ 1 milliseconde.

Retour au tableau

Spécificateur de format personnalisé "FFFFFFF"

Le spécificateur de format personnalisé "FFFFFFF" représente les sept chiffres les plus significatifs de la fraction de seconde ; autrement dit, il représente les dix millionièmes de seconde dans une valeur de date et d'heure. Les zéros de fin ne sont pas affichés. Rien n’est affiché si les sept chiffres significatifs sont un zéro, et dans ce cas, la virgule décimale qui suit le nombre de secondes n’est pas affichée non plus.

Bien qu’il soit possible d’afficher les dix millionièmes d’un deuxième composant d’une valeur de temps, cette valeur peut ne pas être significative. La précision des valeurs de date et d'heure dépend de la résolution de l'horloge système. Sur les systèmes d’exploitation Windows Server 2019 et Windows 11, la résolution de l’horloge est d’environ 1 milliseconde.

Retour au tableau

Spécificateur de format "g" pour l’ère

Spécificateur de format personnalisé "g" ou "gg"

Les spécificateurs de format personnalisé "g" ou "gg" (plus n’importe quel nombre de spécificateurs "g" supplémentaires) représentent la période ou l’ère, par exemple A.D. L’opération de mise en forme ignore ce spécificateur si la date à mettre en forme n’a pas de chaîne de période ou d’ère associée.

Si le spécificateur de format « g » est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d’heure standard « g ». Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L'exemple suivant inclut le spécificateur de format personnalisé "g" dans une chaîne de format personnalisée.

let
    Source =
    {
        Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = ""]),
        // Displays 08/04/0070 A.D.

        Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = "fr-FR"])
        // Displays 08/04/0070 ap. J.-C.
    }
in
    Source

Retour au tableau

Spécificateur de format "h" minuscule pour l’heure

Spécificateur de format personnalisé "h"

Le spécificateur de format personnalisé « h » représente l’heure sous la forme d’un nombre compris entre 1 et 12 ; autrement dit, l’heure est exprimée au format 12 heures qui compte les heures entières à partir de minuit ou midi. Une heure après minuit se présente de la même manière que la même heure après midi. L’heure n’est pas arrondie et une heure à un chiffre est mise en forme sans zéro non significatif. Par exemple, si on considère l'heure 5:43 du matin ou de l'après-midi, ce spécificateur de format personnalisé affiche "5".

Si le spécificateur de format « h » est utilisé sans d’autres spécificateurs de format personnalisés, il est interprété comme un spécificateur de format de date et d’heure standard et lève une erreur d’expression. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L'exemple suivant inclut le spécificateur de format personnalisé "h" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "hh"

Le spécificateur de format personnalisé « hh » (couplé à un nombre quelconque de spécificateurs « h » supplémentaires) représente l’heure sous la forme d’un nombre compris entre 01 et 12 ; autrement dit, l’heure est exprimée au format 12 heures qui compte les heures entières à partir de minuit ou midi. Une heure après minuit se présente de la même manière que la même heure après midi. L’heure n’est pas arrondie et une heure à un chiffre est mise en forme avec un zéro non significatif. Par exemple, si on considère l'heure 5:43 du matin ou de l'après-midi, ce spécificateur de format affiche "05".

L'exemple suivant inclut le spécificateur de format personnalisé "hh" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

Retour au tableau

Spécificateur de format "H" majuscule pour l’heure

Spécificateur de format personnalisé "H"

Le spécificateur de format personnalisé « H » représente l’heure sous la forme d’un nombre compris entre 0 et 23 ; autrement dit, l’heure est exprimée au format 24 heures de base zéro qui compte les heures à partir de minuit. Une heure à un seul chiffre est mise en forme sans zéro non significatif.

Si le spécificateur de format « H » est utilisé sans d’autres spécificateurs de format personnalisés, il est interprété comme un spécificateur de format de date et d’heure standard et lève une erreur d’expression. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L'exemple suivant inclut le spécificateur de format personnalisé "H" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "H:mm:ss", Culture = ""])
        // Displays 6:09:01
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "HH"

Le spécificateur de format personnalisé « HH » (couplé à un nombre quelconque de spécificateurs « H » supplémentaires) représente l’heure sous la forme d’un nombre compris entre 00 et 23 ; autrement dit, l’heure est exprimée au format 24 heures de base zéro qui compte les heures à partir de minuit. Une heure à un seul chiffre est mise en forme avec un zéro non significatif.

L'exemple suivant inclut le spécificateur de format personnalisé "HH" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "HH:mm:ss", Culture = ""])
        // Displays 06:09:01
    }
in
    Source

Retour au tableau

Spécificateur de format "K" pour le fuseau horaire

Spécificateur de format personnalisé "K"

Le spécificateur de format personnalisé "K" représente les informations de fuseau horaire d'une valeur de date et d'heure. Lorsque ce spécificateur de format est utilisé avec des valeurs DateTimeZone , la chaîne de résultat est définie comme suit :

  • Pour le fuseau horaire local, ce spécificateur produit une chaîne de résultat contenant le décalage local du temps universel coordonné (UTC), par exemple « -07:00 », si votre requête s’exécute dans Power Query Desktop. Si votre requête s’exécute dans Power Query Online, la chaîne de résultat ne produit aucun décalage de l’heure UTC, autrement dit « +00:00 ».

  • Pour une heure UTC, la chaîne de résultat ne produit aucun décalage de l’heure UTC ; autrement dit, « +00:00 pour représenter une date UTC.

  • Pour une heure à partir d’un fuseau horaire non spécifié, le résultat est vide.

Si le spécificateur de format « K » est utilisé sans d’autres spécificateurs de format personnalisés, il est interprété comme un spécificateur de format de date et d’heure standard et lève une erreur d’expression. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L’exemple suivant affiche la chaîne qui résulte de l’utilisation du spécificateur de format personnalisé « K » avec différentes valeurs sur un système dans le fuseau horaire américain pacifique.

let
    Source =
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(),[Format="%K"]),
        // Displays -07:00 (Desktop) or +00:00 (Online)

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="%K"]),
        // Displays +00:00

        Text.Format("'#{0}'", {DateTime.ToText(DateTime.LocalNow(),[Format="%K"])})
        // Displays ''
    }
in
    Source

Remarque

La valeur retournée par DateTimeZone.LocalNow 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 , 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.

Retour au tableau

Spécificateur de format "m" pour les minutes

Spécificateur de format personnalisé "m"

Le spécificateur de format personnalisé « m » représente la minute sous la forme d’un nombre compris entre 0 et 59. La minute représente les minutes entières qui se sont écoulées depuis la dernière heure. Une minute à un seul chiffre est mise en forme sans zéro non significatif.

Si le spécificateur de format « m » est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d’heure standard « m ». Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L'exemple suivant inclut le spécificateur de format personnalisé "m" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "mm"

Le spécificateur de format personnalisé « mm » (couplé à un nombre quelconque de spécificateurs « m » supplémentaires) représente la minute sous la forme d’un nombre compris entre 00 et 59. La minute représente les minutes entières qui se sont écoulées depuis la dernière heure. Une minute à un seul chiffre est mise en forme avec un zéro non significatif.

L'exemple suivant inclut le spécificateur de format personnalisé "mm" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

Retour au tableau

Spécificateur de format "M" pour le mois

Spécificateur de format personnalisé "M"

Le spécificateur de format personnalisé « M » représente le mois sous la forme d’un nombre compris entre 1 et 12 (ou entre 1 et 13 pour les calendriers de 13 mois). Un mois à un seul chiffre est mis en forme sans zéro non significatif.

Si le spécificateur de format « M » est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d’heure standard « M ». Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L'exemple suivant inclut le spécificateur de format personnalisé "M" dans une chaîne de format personnalisée.

let
    Source =
    {
        Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "en-US"]),
        // Displays (8) Aug, August

        Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "nl-NL"]),
        // Displays (8) aug, augustus

        Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "lv-LV"])
        // Displays (8) aug., augusts
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "MM"

Le spécificateur de format personnalisé « MM » représente le mois sous la forme d’un nombre compris entre 01 et 12 (ou entre 01 et 13 pour les calendriers de 13 mois). Un mois à un seul chiffre est mis en forme avec un zéro non significatif.

L'exemple suivant inclut le spécificateur de format personnalisé "MM" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
        // Displays 02, 01
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "MMM"

Le spécificateur de format personnalisé "MMM" représente le nom abrégé du mois. Le nom abrégé localisé du mois est récupéré des noms de mois abrégés de la culture actuelle ou spécifiée. S’il existe un spécificateur de format personnalisé « d » ou « dd » dans la chaîne de format personnalisé, le nom du mois est récupéré à partir des noms de génie abrégés à la place.

L'exemple suivant inclut le spécificateur de format personnalisé "MMM" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
        // Displays Thu 29 Aug

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
        // Displays jeu. 29 août
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "MMMM"

Le spécificateur de format personnalisé "MMMM" représente le nom complet du mois. Le nom localisé du mois est récupéré à partir de la culture actuelle ou spécifiée. S’il existe un spécificateur de format personnalisé « d » ou « dd » dans la chaîne de format personnalisé, le nom du mois est récupéré à partir des noms de génie abrégés à la place.

L'exemple suivant inclut le spécificateur de format personnalisé "MMMM" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
        // Displays Thursday 29 August

        DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
        // Displays giovedì 29 agosto
    }
in
    Source

Retour au tableau

Spécificateur de format "s" pour les secondes

Spécificateur de format personnalisé "s"

Le spécificateur de format personnalisé « s » représente la seconde sous la forme d’un nombre compris entre 0 et 59. Le résultat représente les secondes entières qui se sont écoulées depuis la dernière minute. Une seconde à un seul chiffre est mise en forme sans zéro non significatif.

Si le spécificateur de format « s » est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d’heure standard « s ». Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L'exemple suivant inclut le spécificateur de format personnalisé "s" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "ss"

Le spécificateur de format personnalisé « ss » (couplé à un nombre quelconque de spécificateurs « s » supplémentaires) représente la seconde sous la forme d’un nombre compris entre 00 et 59. Le résultat représente les secondes entières qui se sont écoulées depuis la dernière minute. Une seconde à un seul chiffre est mise en forme avec un zéro non significatif.

L'exemple suivant inclut le spécificateur de format personnalisé "ss" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

Retour au tableau

Spécificateur de format "t" pour le système méridien

Spécificateur de format personnalisé "t"

Le spécificateur de format personnalisé "t" représente le premier caractère de l'indicateur AM/PM. L’indicateur localisé approprié est récupéré à partir de la culture actuelle ou spécifique. L'indicateur AM est utilisé pour toutes les heures comprises entre 0:00:00 (minuit) et 11:59:59.999. L'indicateur PM est utilisé pour toutes les heures comprises entre 12:00:00 (midi) et 23:59:59.999.

Si le spécificateur de format « t » est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d’heure standard « t ». Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L'exemple suivant inclut le spécificateur de format personnalisé "t" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 6:9:1 P

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
        // Displays 6:9:1 μ

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
        // Displays 9:18:1.5 A

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
        // Displays 9:18:1.5 π
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "tt"

Le spécificateur de format personnalisé "tt" (plus n'importe quel nombre de spécificateurs "t" supplémentaires) représente l'intégralité de l'indicateur AM/PM. L’indicateur localisé approprié est récupéré à partir de la culture actuelle ou spécifique. L'indicateur AM est utilisé pour toutes les heures comprises entre 0:00:00 (minuit) et 11:59:59.999. L'indicateur PM est utilisé pour toutes les heures comprises entre 12:00:00 (midi) et 23:59:59.999.

Veillez à utiliser le spécificateur « tt » dans les langues pour lesquelles il est nécessaire de maintenir la distinction entre le matin (AM) et l’après-midi (PM). Un exemple est illustré par la langue japonaise, pour laquelle les indicateurs AM/PM se distinguent dans le deuxième caractère au lieu du premier.

L'exemple suivant inclut le spécificateur de format personnalisé "tt" dans une chaîne de format personnalisée.

let
    Source =
    {
        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
        // Displays 06:09:01 PM

        DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
        // Displays 06:09:01 du.

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
        // Displays 09:18:01.50 AM

        DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
        // Displays 09:18:01.50 de.
    }
in
    Source

Retour au tableau

Spécificateur de format "y" pour l’année

Spécificateur de format personnalisé "y"

Le spécificateur de format personnalisé "y" représente l'année sous la forme d'un nombre à un chiffre ou à deux chiffres. Si l'année comporte plus de deux chiffres, seuls les deux chiffres de poids faible apparaissent dans le résultat. Si le premier chiffre d'une année sur deux chiffres commence par un zéro (par exemple, 2008), le nombre est mis en forme sans zéro non significatif.

Si le spécificateur de format « y » est utilisé sans autre spécificateur de format personnalisé, il est interprété comme le spécificateur de format de date et d’heure standard « y ». Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L'exemple suivant inclut le spécificateur de format personnalisé "y" dans une chaîne de format personnalisée.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "%y"]),
        // Displays 1

        Date.ToText(#date(2024, 1, 1), [Format = "%y"])
        // Displays 24
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "yy"

Le spécificateur de format personnalisé "yy" représente l'année sous la forme d'un nombre à deux chiffres. Si l'année comporte plus de deux chiffres, seuls les deux chiffres de poids faible apparaissent dans le résultat. Si l'année à deux chiffres comporte moins de deux chiffres significatifs, le nombre est complété avec des zéros non significatifs pour qu'il possède deux chiffres.

Dans une opération d’analyse, une année à deux chiffres analysée à l’aide du spécificateur de format personnalisé « yy » est interprétée en fonction du calendrier actuel du fournisseur de format. L'exemple suivant analyse la représentation sous forme de chaîne d'une date ayant une année à deux chiffres, en utilisant le calendrier grégorien par défaut de la culture en-US, laquelle représente la culture actuelle. Les valeurs retournées pour la date à quatre chiffres dépendent de la plage de 100 ans définie par le système d’exploitation.

let
    // Define the date format and value
    fmt = "dd-MMM-yy",

    // Convert year 49 to a 4-digit year
    firstDate = Text.Format("#{0}", { Date.FromText("24-Jan-49", [Format = fmt]) }),

    // Convert year 50 to a 4-digit year
    finalDate = Text.Format("#{0}", { Date.FromText("24-Jan-50", [Format = fmt]) }),
    Heading = "Default Two Digit Year Range: 1950 - 2049",
    result = {Heading, firstDate, finalDate}
in
    result

// The example displays the following output:
//       Default Two Digit Year Range: 1950 - 2049
//       1/24/2049
//       1/24/1950

L'exemple suivant inclut le spécificateur de format personnalisé "yy" dans une chaîne de format personnalisé.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yy"]),
        // Displays 01

        Date.ToText(#date(2024, 1, 1), [Format = "yy"])
        // Displays 24
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "yyy"

Le spécificateur de format personnalisé "yyy" représente l'année avec un minimum de trois chiffres. Si l'année comporte plus de trois chiffres significatifs, ils sont inclus dans la chaîne résultante. Si l'année comporte moins de trois chiffres, le nombre est rempli avec des zéros non significatifs pour produire trois chiffres.

Remarque

Pour le calendrier bouddhiste thaïlandais, qui peut comporter des années à cinq chiffres, ce spécificateur de format affiche tous les chiffres significatifs.

L'exemple suivant inclut le spécificateur de format personnalisé "yyy" dans une chaîne de format personnalisée.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyy"]),
        // Displays 001

        Date.ToText(#date(2024, 1, 1), [Format = "yyy"])
        // Displays 2024
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "yyyy"

Le spécificateur de format personnalisé "yyyy" représente l'année avec un minimum de quatre chiffres. Si l'année comporte plus de quatre chiffres significatifs, ils sont inclus dans la chaîne résultante. Si l'année comporte moins de quatre chiffres, le nombre est rempli à l'aide de zéros non significatifs pour produire quatre chiffres.

Remarque

Pour le calendrier bouddhiste thaïlandais, qui peut comporter des années à cinq chiffres, ce spécificateur de format affiche au minimum quatre chiffres.

L'exemple suivant inclut le spécificateur de format personnalisé "yyyy" dans une chaîne de format personnalisée.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyyy"]),
        // Displays 0001

        Date.ToText(#date(2024, 1, 1), [Format = "yyyy"])
        // Displays 2024
    }
in
    Source

Retour au tableau

Spécificateur de format personnalisé "yyyyy"

Le spécificateur de format personnalisé "yyyyy" (plus tout nombre de spécificateurs "y" supplémentaires) représente l'année avec au minimum cinq chiffres. Si l'année comporte plus de cinq chiffres significatifs, ils sont inclus dans la chaîne résultante. Si l'année comporte moins de cinq chiffres, le nombre est rempli avec des zéros non significatifs pour produire cinq chiffres.

S'il existe des spécificateurs "y" supplémentaires, le nombre est rempli avec autant de zéros non significatifs que nécessaire pour produire le nombre de spécificateurs "y".

L'exemple suivant inclut le spécificateur de format personnalisé "yyyyy" dans une chaîne de format personnalisée.

let
    Source =
    {
        Date.ToText(#date(1, 12, 1), [Format = "yyyyy"]),
        // Displays 00001

        Date.ToText(#date(2024, 1, 1), [Format = "yyyyy"])
        // Displays 02024
    }
in
    Source

Retour au tableau

Spécificateur de format "z" pour le décalage

Spécificateur de format personnalisé "z"

Avec les valeurs DateTimeZone , le spécificateur de format personnalisé « z » représente le décalage signé du fuseau horaire spécifié par rapport au temps universel coordonné (UTC), mesuré en heures. L'offset est toujours affiché avec un signe de début. Un signe plus (+) indique les heures avant l'heure UTC, et un signe moins (-) indique les heures après l'heure UTC. Un décalage à un seul chiffre est mis en forme sans zéro non significatif.

Le tableau suivant montre comment la valeur de décalage change en fonction de la fonction DateTimeZone .

Valeur DateTimeZone Valeur de décalage
DateTimeZone.LocalNow Sur Power Query Desktop, décalage signé du fuseau horaire du système d’exploitation local à partir de l’heure UTC. Sur Power Query Online, retourne +00.
DateTimeZone.UtcNow Retourne +0.

Si le spécificateur de format « z » est utilisé sans d’autres spécificateurs de format personnalisés, il est interprété comme un spécificateur de format de date et d’heure standard et lève une erreur d’expression. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

L’exemple suivant inclut le spécificateur de format personnalisé « z » dans une chaîne de format personnalisée sur un système du fuseau horaire américain pacifique.

let
    Source = 
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:%z}"]),
        // Displays {0:-7} on Power Query Desktop
        // Displays {0:+0} on Power Query Online

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:%z}"]),
        // Displays {0:+0}

        DateTimeZone.ToText(DateTimeZone.SwitchZone(
            #datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6), 
            [Format = "{0:%z}"]
        )
        // Displays {0:+6}
    }
in
    Source

Remarque

La valeur retournée par DateTimeZone.LocalNow 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 {0:-7} , car il lit l’heure définie sur votre ordinateur local. Toutefois, Power Query Online retourne {0:+0} , car il lit l’heure définie sur les machines virtuelles cloud, qui sont définies sur UTC.

Retour au tableau

Spécificateur de format personnalisé "zz"

Avec les valeurs DateTimeZone , le spécificateur de format personnalisé « zz » représente le décalage signé du fuseau horaire spécifié à partir de l’heure UTC, mesuré en heures. L'offset est toujours affiché avec un signe de début. Un signe plus (+) indique les heures avant l'heure UTC, et un signe moins (-) indique les heures après l'heure UTC. Un décalage à un seul chiffre est mis en forme avec un zéro non significatif.

Le tableau suivant montre comment la valeur de décalage change en fonction de la fonction DateTimeZone .

Valeur DateTimeZone Valeur de décalage
DateTimeZone.LocalNow Sur Power Query Desktop, décalage signé du fuseau horaire du système d’exploitation local à partir de l’heure UTC. Sur Power Query Online, retourne +00.
DateTimeZone.UtcNow Retourne +00.

L’exemple suivant inclut le spécificateur de format personnalisé « zz » dans une chaîne de format personnalisée sur un système du fuseau horaire américain pacifique.

let
    Source = 
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zz}"]),
        // Displays {0:-07} on Power Query Desktop
        // Displays {0:+00} on Power Query Online

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zz}"]),
        // Displays {0:+00}

        DateTimeZone.ToText(DateTimeZone.SwitchZone(
            #datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6), 
            [Format = "{0:zz}"]
        )
        // Displays {0:+06}
    }
in
    Source

Remarque

La valeur retournée par DateTimeZone.LocalNow 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 {0:-07} , car il lit l’heure définie sur votre ordinateur local. Toutefois, Power Query Online retourne {0:+00} , car il lit l’heure définie sur les machines virtuelles cloud, qui sont définies sur UTC.

Retour au tableau

Spécificateur de format personnalisé "zzz"

Avec les valeurs DateTimeZone , le spécificateur de format personnalisé « zzz » représente le décalage signé du fuseau horaire spécifié à partir de l’heure UTC, mesuré en heures et en minutes. L'offset est toujours affiché avec un signe de début. Un signe plus (+) indique les heures avant l'heure UTC, et un signe moins (-) indique les heures après l'heure UTC. Un offset à un seul chiffre est mis en forme avec un zéro non significatif.

Le tableau suivant montre comment la valeur de décalage change en fonction de la fonction DateTimeZone .

Valeur DateTimeZoneValue Valeur de décalage
DateTimeZone.LocalNow Sur Power Query Desktop, décalage signé du fuseau horaire du système d’exploitation local à partir de l’heure UTC. Sur Power Query Online, retourne +00.
DateTimeZone.UtcNow Retourne +00:00.

L’exemple suivant inclut le spécificateur de format personnalisé « zzz » dans une chaîne de format personnalisée sur un système du fuseau horaire américain pacifique.

let
    Source = 
    {
        DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zzz}"]),
        // Displays {0:-07:00} on Power Query Desktop
        // Displays {0:+00:00} on Power Query Online

        DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zzz}"]),
        // Displays {0:+00:00}

        DateTimeZone.ToText(DateTimeZone.SwitchZone(
            #datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6), 
            [Format = "{0:zzz}"]
        )
        // Displays {0:+06:00}
    }
in
    Source

Remarque

La valeur retournée par DateTimeZone.LocalNow 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 {0:-07:00} , car il lit l’heure définie sur votre ordinateur local. Toutefois, Power Query Online retourne {0:+00:00} , car il lit l’heure définie sur les machines virtuelles cloud, qui sont définies sur UTC.

Retour au tableau

Spécificateurs des séparateurs de date et d’heure

Spécificateur de format personnalisé ":"

Le spécificateur de format personnalisé ":" représente le séparateur d'heure, lequel est utilisé pour différencier les heures, les minutes et les secondes. Le séparateur de temps localisé approprié est récupéré à partir de la culture actuelle ou spécifiée.

Remarque

Pour modifier le séparateur horaire d'une chaîne de date et heure, spécifiez le caractère de séparation dans un délimiteur de chaîne littérale. Par exemple, la chaîne de format personnalisée hh_dd_ss produit une chaîne de résultat dans laquelle "_ " (trait de soulignement) est toujours utilisé comme séparateur horaire.

Si le spécificateur de format « : » est utilisé sans d’autres spécificateurs de format personnalisés, il est interprété comme un spécificateur de format de date et d’heure standard et lève une erreur d’expression. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

Retour au tableau

Spécificateur de format personnalisé "/"

Le spécificateur de format personnalisé "/" représente le séparateur de date, lequel est utilisé pour différencier les années, les mois et les jours. Le séparateur de date localisé approprié est récupéré à partir de la culture actuelle ou spécifiée.

Remarque

Pour modifier le séparateur de date d'une chaîne de date et heure, spécifiez le caractère de séparation dans un délimiteur de chaîne littérale. Par exemple, la chaîne de format personnalisée mm/dd/yyyy produit une chaîne de résultat dans laquelle "/" est toujours utilisé comme séparateur de date.

Si le spécificateur de format « / » est utilisé sans d’autres spécificateurs de format personnalisés, il est interprété comme un spécificateur de format de date et d’heure standard et lève une erreur d’expression. Pour plus d’informations sur l’utilisation d’un spécificateur de format unique, accédez à Utiliser des spécificateurs de format personnalisé uniques plus loin dans cet article.

Retour au tableau

Littéraux de caractère

Les caractères suivants dans une chaîne de format de date et d’heure standard ou personnalisé sont réservés ; ils sont toujours interprétés comme des caractères de mise en forme ou, dans le cas des caractères ", ', / et \, comme des caractères spéciaux.

  • F
  • H
  • K
  • M
  • d
  • f
  • g
  • h
  • m
  • s
  • t
  • y
  • z
  • %
  • :
  • /
  • "
  • '
  • \

Tous les autres caractères sont toujours interprétés comme des caractères littéraux et, dans une opération de mise en forme, sont inclus inchangés dans la chaîne de résultat. Dans une opération d’analyse, ils doivent correspondre exactement aux caractères présents dans la chaîne d’entrée. La comparaison respecte la casse.

L’exemple suivant inclut les caractères littéraux « PST » (pour Pacific Standard Time, heure normale du Pacifique) et « PDT » (pour Pacific Daylight Time, heure d’été du Pacifique) pour représenter le fuseau horaire local dans une chaîne de format. Notez que la chaîne est incluse dans la chaîne de résultat, et qu’une chaîne qui inclut la chaîne du fuseau horaire local est également analysée avec succès.

let
    #"Date Formats" = {"dd MMM yyyy hh:mm tt PST", "dd MMM yyyy hh:mm tt PDT"},
    Source = 
    {
        DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Formats"{1}]),
        try DateTime.ToText(DateTime.FromText(
            "25 Dec 2023 12:00 pm PST", [Format = #"Date Formats"{0}])) 
            otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm PST" & "'"
    }
in
    Source

// The example displays the following output text:
//       18 Aug 2024 04:50 PM PDT
//       12/25/2023 12:00:00 PM

Il existe deux façons d’indiquer que les caractères doivent être interprétés comme des caractères littéraux, et non comme des caractères réservés, pour qu’ils puissent être inclus dans une chaîne de résultat ou analysés correctement dans une chaîne d’entrée :

  • En plaçant chaque caractère réservé dans une séquence d’échappement. Pour plus d’informations, accédez à l’utilisation des séquences d’échappement.

    L’exemple suivant inclut les caractères littéraux « pst » (pour Pacific Standard Time, heure normale du Pacifique) pour représenter le fuseau horaire local dans une chaîne de format. Étant donné que « s » et « t » sont des chaînes de format personnalisées, les deux caractères doivent être placés dans des séquences d’échappement pour être interprétés comme des littéraux de caractères.

    let
          #"Date Format" = "dd MMM yyyy hh:mm tt p's''t'",
          Source = 
          {
              DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Format"]),
              try DateTime.ToText(DateTime.FromText(
                  "25 Dec 2023 12:00 pm pst", [Format = #"Date Format"]))
                  otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm pst" & "'"
          }
    in
          Source
    
    // The example displays the following output text:
    //       18 Aug 2024 04:50 PM pst
    //       12/25/2016 12:00:00 PM
    
  • En plaçant la chaîne littérale entière en apostrophes. L’exemple suivant est semblable à celui précédent, sauf que « pst » est placé entre apostrophes pour indiquer que la chaîne délimitée entière doit être interprétée comme des littéraux de caractères.

    let
          #"Date Format" = "dd MMM yyyy hh:mm tt 'pst'",
          Source = 
          {
              DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Format"]),
              try DateTime.ToText(DateTime.FromText(
                  "25 Dec 2023 12:00 pm pst", [Format = #"Date Format"]))
                  otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm pst" & "'"
          }
    in
          Source
    
    // The example displays the following output text:
    //       18 Aug 2024 04:50 PM pst
    //       12/25/2016 12:00:00 PM
    

Notes

Utilisation de spécificateurs de format personnalisés uniques

Une chaîne de format de date et d'heure personnalisée se compose d'au moins deux caractères. Les méthodes de mise en forme de la date et de l'heure interprètent toute chaîne à un caractère comme une chaîne de format de date et d'heure standard. S’ils ne reconnaissent pas le caractère comme spécificateur de format valide, ils lèvent une erreur d’expression. Par exemple, une chaîne de format qui se compose uniquement du spécificateur "h" est interprétée comme une chaîne de format de date et d'heure standard. Toutefois, dans ce cas particulier, une exception est levée, car il n’existe aucun spécificateur de format de date et d’heure standard "h".

Pour utiliser tout spécificateur de format de date et d'heure personnalisé comme seul spécificateur dans une chaîne de format (autrement dit, utiliser le spécificateur de format personnalisé "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" ou "/" tout seul), incluez un espace avant ou après le spécificateur, ou incluez un spécificateur de format pourcentage ("%") avant le spécificateur de date et d'heure personnalisé unique.

Par exemple, "%h" est interprété comme chaîne de format de date et d’heure personnalisée qui affiche l’heure représentée par la valeur de date et d’heure actuelle. Vous pouvez également utiliser la chaîne de format "h" ou "h", bien que cela inclue un espace avec l'heure dans la chaîne de résultat. L'exemple suivant illustre ces trois chaînes de format.

let
    date = #datetime(2024, 6, 15, 13, 45, 0),
    Source =
    {
        Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "%h"])}),
        Text.Format("'#{0}'", {DateTime.ToText(date, [Format = " h"])}),
        Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "h "])})
    }
in
    Source

// The example displays a list with the following output text, 
//   with <sp> representing a space:
//       '1'
//       ' 1'
//       '1 ' 

Utilisation des séquences d’échappement

Les caractères "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" ou "/" dans une chaîne de format sont interprétés comme des spécificateurs de format personnalisés plutôt que comme des caractères littéraux.

Pour empêcher l’interprétation d’un caractère comme spécificateur de format, vous pouvez :

  • Précèdez-le avec une barre oblique inverse.
  • Entourez-le d’une citation unique.
  • Entourez-le de deux guillemets doubles.

Chacun de ces caractères agit comme une séquence d’échappement. La séquence d’échappement signifie que le caractère suivant ou le caractère entouré est un littéral de texte qui doit être inclus dans la chaîne de résultat inchangée.

Pour inclure un guillemet double dans une chaîne de résultat, vous devez l’échapper avec une autre guillemet double ("").

L’exemple suivant utilise différentes séquences d’échappement pour empêcher l’opération de mise en forme d’interpréter les caractères « h » et « m » comme spécificateurs de format.

let
    date = #datetime(2024, 6, 15, 13, 45, 30.90),
    format1 = "h \h m \m",
    format2 = "h ""h"" m ""m""",
    format3 = "h 'h' m 'm'",
    Source = 
    {
        Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format1, DateTime.ToText(date, format1)}),
        Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format2, DateTime.ToText(date, format2)}),
        Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format3, DateTime.ToText(date, format3)})
    }
in
    Source

// The example displays the following output text:
//       6/15/2024 1:45:30 PM (h \h m \m) -> 1 h 45 m
//       6/15/2024 1:45:30 PM (h "h" m "m") -> 1 h 45 m
//       6/15/2024 1:45:30 PM (h 'h' m 'm') -> 1 h 45 m