Freigeben über


Benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit

Eine Datums- und Uhrzeitformatzeichenfolge definiert die Textdarstellung eines Date-, DateTime-, DateTimeZone- oder Time-Werts , der aus einem Formatierungsvorgang resultiert. Sie kann auch die Darstellung eines Datums- und Uhrzeitwerts definieren, der in einem Analysevorgang erforderlich ist, um die Zeichenfolge erfolgreich in ein Datum und eine Uhrzeit zu konvertieren. Benutzerdefinierte Formatzeichenfolgen bestehen aus einem oder mehreren benutzerdefinierten Formatbezeichnern für Datum und Uhrzeit. Jede Zeichenfolge, die keine Standardmäßige Datums- und Uhrzeitformatzeichenfolge ist, wird als benutzerdefinierte Datums- und Uhrzeitformatzeichenfolge interpretiert.

Bei Formatierungsvorgängen können benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen mit der ToText Methode einer Datums- und Uhrzeit- und Zeitzoneninstanz verwendet werden. Im folgenden Beispiel wird die Verwendung veranschaulicht.

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

Bei Analysevorgängen können benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen mit den Funktionen Date, DateTime, Time und DateTimeZone verwendet werden. Diese Funktionen erfordern, dass eine Eingabezeichenfolge genau einem bestimmten Muster entspricht, damit der Analysevorgang erfolgreich ausgeführt werden kann. Im folgenden Beispiel wird ein Aufruf der DateTime.FromText-Funktion veranschaulicht, um ein Datum zu analysieren, das einen Monat, einen Tag und ein zweistelliges Jahr enthalten muss.

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.

Die folgende Tabelle beschreibt die benutzerdefinierten Formatbezeichner für Datum und Uhrzeit und zeigt eine Ergebniszeichenfolge an, die von den einzelnen Formatbezeichnern erstellt wird. Standardmäßig entsprechen Ergebniszeichenfolgen den Formatierungskonventionen der Kultur "en-US". Wenn ein bestimmter Formatbezeichner eine lokalisierte Ergebniszeichenfolge erzeugt, wird im Beispiel auch die Kultur angegeben, für die die Ergebniszeichenfolge gilt. Weitere Informationen zur Verwendung von benutzerdefinierten Datums- und Uhrzeitformatzeichenfolgen finden Sie im Abschnitt "Notizen ".

Formatbezeichner BESCHREIBUNG Beispiele
"d" Der Tag des Monats, von 1 bis 31.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „d“.
2009-06-01T13:45:30 -> 1

2009-06-15T13:45:30 -> 15
"dd" Der Tag des Monats, von 01 bis 31.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "dd".
2009-06-01T13:45:30 -> 01

2009-06-15T13:45:30 -> 15
"ddd" Der abgekürzte Name des Tags der Woche.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "ddd".
2009-06-15T13:45:30 -> Mo. (de-DE)

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

2009-06-15T13:45:30 -> lun. (fr-FR)
"dddd" Der vollständige Name des Wochentags.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "dddd".
2009-06-15T13:45:30 -> Montag (de-DE)

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

2009-06-15T13:45:30 -> lundi (fr-FR)
"f" Die Zehntelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „f“.
2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.05 -> 0
"ff" Die Hundertstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „ff“.
2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> 00
"fff" Die Millisekunden in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „fff“.
6/15/2009 13:45:30.617 -> 617

6/15/2009 13:45:30.0005 -> 000
"ffff" Die Zehntausendstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „ffff“.
2009-06-15T13:45:30.6175000 -> 6175

2009-06-15T13:45:30.0000500 -> 0000
"fffff" Die Hunderttausendstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „fffff“.
2009-06-15T13:45:30.6175400 -> 61754

6/15/2009 13:45:30.000005 -> 00000
"ffffff" Die Millionstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „ffffff“.
2009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> 000000
"fffffff" Die Zehnmillionstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „fffffff“.
2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 0001150
"F" Wenn ungleich 0 (null), die Zehntelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „F“.
2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.0500000 -> (keine Ausgabe)
"FF" Wenn ungleich 0 (null), die Hundertstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „FF“.
2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> (keine Ausgabe)
"FFF" Wenn ungleich 0 (null), die Millisekunden in einem Datums- und Uhrzeitwert.

Weitere Informationen: Der benutzerdefinierte FFF-Formatbezeichner.
2009-06-15T13:45:30.6170000 -> 617

2009-06-15T13:45:30.0005000 -> (keine Ausgabe)
"FFFF" Wenn ungleich 0 (null), die Zehntausendstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „FFFF“.
2009-06-15T13:45:30.5275000 -> 5275

2009-06-15T13:45:30.0000500 -> (keine Ausgabe)
"FFFFF" Wenn ungleich 0 (null), die Hunderttausendstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „FFFFF“.
2009-06-15T13:45:30.6175400 -> 61754

2009-06-15T13:45:30.0000050 -> (keine Ausgabe)
"FFFFFF" Wenn ungleich 0 (null), die Millionstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „FFFFFF“.
2009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> (keine Ausgabe)
"FFFFFFF" Wenn ungleich 0 (null), die Zehnmillionstelsekunde in einem Datums- und Uhrzeitwert.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „FFFFFFF“.
2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 000115
"g", "gg" Der Zeitraum.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "g" oder "gg".
2009-06-15T13:45:30.6170000 -> A.D.
"h" Die Stunde, von 1 bis 12 (12-Stunden-Format).

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „h“.
2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 1
"hh" Die Stunde, von 01 bis 12 (12-Stunden-Format).

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „hh“.
2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 01
"H" Die Stunde, von 0 bis 23 (24-Stunden-Format).

Weitere Informationen: Der benutzerdefinierte H-Formatbezeichner.
2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 13
"HH" Die Stunde, von 00 bis 23 (24-Stunden-Format).

Weitere Informationen: Der benutzerdefinierte HH-Formatbezeichner.
2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 13
"K" Zeitzoneninformationen.

Weitere Informationen: Der benutzerdefinierte K-Formatbezeichner.
2009-06-15T13:45:30, nicht angegeben ->

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

2009-06-15T13:45:30, Lokal -> -07:00 (abhängig von lokalen oder Cloudcomputereinstellungen)
"m" Die Minute, von 0 bis 59.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „m“.
2009-06-15T01:09:30 -> 9

2009-06-15T13:29:30 -> 29
"mm" Die Minute, von 00 bis 59.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „mm“.
2009-06-15T01:09:30 -> 09

2009-06-15T01:45:30 -> 45
"M" Der Monat, von 1 bis 12.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "M".
2009-06-15T13:45:30 -> 6
"MM" Der Monat, von 01 bis 12.

Weitere Informationen: Der benutzerdefinierte MM-Formatbezeichner.
2009-06-15T13:45:30 -> 06
"MMM" Der abgekürzte Name des Monats.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "MMM".
2009-06-15T13:45:30 -> Juni (de-DE)

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

2009-06-15T13:45:30 -> Jun (zu-ZA)
"MMMM" Der vollständige Name des Monats.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "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" Die Sekunde, von 0 bis 59.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „s“.
2009-06-15T13:45:09 -> 9
"ss" Die Sekunde, von 00 bis 59.

Weitere Informationen finden Sie unter: Der benutzerdefinierte Formatbezeichner „ss“.
2009-06-15T13:45:09 -> 09
"t" Das erste Zeichen des AM/PM-Kennzeichners.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "t".
2009-06-15T13:45:30 -> P (en-US)

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

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

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "tt".
2009-06-15T13:45:30 -> PM (en-US)

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

2009-06-15T13:45:30 -> (fr-FR)
"y" Das Jahr, von 0 bis 99.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "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" Das Jahr, von 00 bis 99.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "yyy".
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" Das Jahr, mit einem Minimum von drei Ziffern.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "yyyy".
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" Das Jahr als vierstellige Zahl.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "yyyy".
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" Das Jahr als fünfstellige Zahl.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "yyyyy".
0001-01-01T00:00:00 -> 00001

2009-06-15T13:45:30 -> 02009
"z" Offset von UTC in Stunden, ohne führende Nullen.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "z".
2009-06-15T13:45:30-07:00 -> -7
"zz" Offset von UTC in Stunden, mit einer führenden Null für einen einstelligen Wert.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "zz".
2009-06-15T13:45:30-07:00 -> -07
"zzz" Offset von UTC in Stunden und Minuten.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "zzz".
2009-06-15T13:45:30-07:00 -> -07:00
":" Das Zeittrennzeichen.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner ":".
2009-06-15T13:45:30 -> : (en-US)

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

2009-06-15T13:45:30 -> : (ja-JP)
"/" Das Datumstrennzeichen.

Weitere Informationen: Der benutzerdefinierte Formatbezeichner "/".
2009-06-15T13:45:30 -> / (en-US)

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

2009-06-15T13:45:30 -> . (tr-TR)
"Zeichenfolge"

'Zeichenfolge'
Trennzeichen für Literalzeichenfolge.

Weitere Informationen finden Sie unter: Zeichenliterale
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
% Definiert das nächste Zeichen als benutzerdefinierten Formatbezeichner.

Weitere Informationen: Verwenden einzelner benutzerdefinierter Formatbezeichner.
2009-06-15T13:45:30 (%h) -> 1
\, "", ' Die Escapesequenzen.

Weitere Informationen: Zeichenliterale und Verwendung der Escapesequenzen.
2009-06-15T13:45:30 (h \h) -> 1 h

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

2009-06-15T13:45:30 (h 'h') -> 1 h
Jedes andere Zeichen Das Zeichen wird unverändert in die Ergebniszeichenfolge kopiert.

Weitere Informationen finden Sie unter: Zeichenliterale
2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

In den folgenden Abschnitten finden Sie weitere Informationen zu den einzelnen benutzerdefinierten Formatbezeichnern für Datum- und Uhrzeit. Sofern nicht anders angegeben, erzeugt jeder Bezeichner unabhängig davon, ob er mit einem Date-, DateTime-, DateTime-, DateTimeZone- oder Time-Wert verwendet wird, eine identische Zeichenfolgendarstellung.

Formatspezifizierer „d“ für den Tag

Der benutzerdefinierte Formatbezeichner „d“

Der benutzerdefinierte Formatbezeichner „d“ stellt den Tag des Monats als Zahl von 1 bis 31 dar. Einstellige Tage werden ohne führende Null formatiert.

Wenn der Formatbezeichner „d“ allein verwendet wird, d.h. ohne andere benutzerdefinierte Formatbezeichner, wird er als d-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "d" in mehrere Formatzeichenfolgen ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „dd“

Die benutzerdefinierte Formatzeichenfolge „dd“ stellt den Tag des Monats als Zahl von 01 bis 31 dar. Einstellige Tage werden mit einer führenden Null formatiert.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "dd" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „ddd“

Der benutzerdefinierte Formatbezeichner "ddd" stellt den abgekürzten Namen des Tags der Woche dar. Der lokalisierte abgekürzte Name des Wochentags wird aus der aktuellen oder angegebenen Kultur abgerufen.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "ddd" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „dddd“

Der benutzerdefinierte Formatbezeichner "dddd" (plus einer beliebigen Anzahl zusätzlicher d-Bezeichner) stellt den vollständigen Namen des Tags der Woche dar. Der lokalisierte Name des Wochentags wird aus der aktuellen oder angegebenen Kultur abgerufen.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "dddd" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Klein geschriebener Bruchspezifizierer „f“ für Sekunden

Der benutzerdefinierte Formatbezeichner „f“

Der benutzerdefinierte Formatbezeichner "f" stellt die signifikanteste Ziffer des Sekundenbruchteils dar, d. h. die Zehntelsekunden in einem Datums- und Uhrzeitwert.

Wenn der Formatbezeichner „f“ allein verwendet wird, d.h. ohne andere Formatbezeichner, wird er als f-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Wenn Sie "f"-Formatbezeichner als Teil einer Formatzeichenfolge verwenden, die zum Analysieren der Anzahl der Bruchsekunden bereitgestellt wird, gibt die Anzahl der "f"-Formatbezeichner die Anzahl der wichtigsten Ziffern der Sekundenbruchzahl an, die vorhanden sein muss, um die Zeichenfolge erfolgreich zu analysieren.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "f" in mehrere benutzerdefinierte Formatzeichenfolgen ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „ff“

Der benutzerdefinierte Formatbezeichner "ff" stellt die zwei signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Hundertstelsekunden in einem Datums- und Uhrzeitwert.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "ff" in mehrere benutzerdefinierte Formatzeichenfolgen ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „fff“

Der benutzerdefinierte Formatbezeichner "fff" stellt die drei signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Millisekunden in einem Datums- und Uhrzeitwert.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "fff" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „ffff“

Der benutzerdefinierte Formatbezeichner "ffff" stellt die vier signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Zehntausendstelsekunden in einem Datums- und Uhrzeitwert.

Obwohl es möglich ist, die zehntausendstel einer zweiten Komponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Auf den Betriebssystemen Windows Server 2019 und Windows 11 beträgt die Auflösung der Uhr etwa 1 Millisekunden.

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „fffff“

Der benutzerdefinierte Formatbezeichner "fffff" stellt die fünf signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Hunderttausendstelsekunden in einem Datums- und Uhrzeitwert.

Obwohl es möglich ist, die hunderttausendstel einer zweiten Komponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Auf den Betriebssystemen Windows Server 2019 und Windows 11 beträgt die Auflösung der Uhr etwa 1 Millisekunden.

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „ffffff“

Der benutzerdefinierte Formatbezeichner "ffffff" stellt die sechs signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Millionstelsekunden in einem Datums- und Uhrzeitwert.

Obwohl es möglich ist, die Millionstel einer zweiten Komponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Auf den Betriebssystemen Windows Server 2019 und Windows 11 beträgt die Auflösung der Uhr etwa 1 Millisekunden.

Zurück zur Tabelle

Benutzerdefinierte Formatbezeichner „fffffff“

Der benutzerdefinierte Formatbezeichner "fffffff" stellt die sieben signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Zehnmillionstelsekunden in einem Datums- und Uhrzeitwert.

Obwohl es möglich ist, die zehn Millionenstel einer zweiten Komponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Auf den Betriebssystemen Windows Server 2019 und Windows 11 beträgt die Auflösung der Uhr etwa 1 Millisekunden.

Zurück zur Tabelle

Groß geschriebener Bruchspezifizierer „F“ für Sekunden

Der benutzerdefinierte Formatbezeichner „F“

Der benutzerdefinierte Formatbezeichner "F" stellt die signifikanteste Ziffer des Sekundenbruchteils dar, d. h. die Zehntelsekunden in einem Datums- und Uhrzeitwert. Nichts wird angezeigt, wenn die Ziffer 0 ist, und das Dezimalzeichen, das auf die Anzahl der Sekunden folgt, wird ebenfalls nicht angezeigt.

Wenn der Formatbezeichner „F“ allein verwendet wird, d.h. ohne andere Formatbezeichner, wird er als F-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Die Anzahl der beim Analysieren verwendeten F-Formatbezeichner gibt die maximale Anzahl der wichtigsten Ziffern des Sekundenbruchs an, der vorhanden sein kann, um die Zeichenfolge erfolgreich zu analysieren.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "F" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „FF“

Der benutzerdefinierte Formatbezeichner "FF" stellt die zwei signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Hundertstelsekunden in einem Datums- und Uhrzeitwert. Nachfolgende Nullen werden nicht angezeigt. Nichts wird angezeigt, wenn die beiden signifikanten Ziffern 0 sind, und in diesem Fall wird auch nicht das Dezimalzeichen angezeigt, das auf die Anzahl der Sekunden folgt.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "FF" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „FFF“

Der benutzerdefinierte Formatbezeichner "FFF" stellt die drei signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Millisekunden in einem Datums- und Uhrzeitwert. Nachfolgende Nullen werden nicht angezeigt. Nichts wird angezeigt, wenn die drei signifikanten Ziffern 0 sind, und in diesem Fall wird auch das Dezimalzeichen, das der Anzahl der Sekunden folgt, nicht angezeigt.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "FFF" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „FFFF“

Der benutzerdefinierte Formatbezeichner "FFFF" stellt die vier signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Zehntausendstelsekunden in einem Datums- und Uhrzeitwert. Nachfolgende Nullen werden nicht angezeigt. Nichts wird angezeigt, wenn die vier signifikanten Ziffern 0 sind, und in diesem Fall wird auch nicht das Dezimalzeichen angezeigt, das auf die Anzahl der Sekunden folgt.

Obwohl es möglich ist, die zehntausendstel einer zweiten Komponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Auf den Betriebssystemen Windows Server 2019 und Windows 11 beträgt die Auflösung der Uhr etwa 1 Millisekunden.

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „FFFFF“

Der benutzerdefinierte Formatbezeichner "FFFFF" stellt die fünf signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Hunderttausendstelsekunden in einem Datums- und Uhrzeitwert. Nachfolgende Nullen werden nicht angezeigt. Nichts wird angezeigt, wenn die fünf signifikanten Ziffern 0 sind, und in diesem Fall wird auch nicht das Dezimalzeichen angezeigt, das auf die Anzahl der Sekunden folgt.

Obwohl es möglich ist, die hunderttausendstel einer zweiten Komponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Auf den Betriebssystemen Windows Server 2019 und Windows 11 beträgt die Auflösung der Uhr etwa 1 Millisekunden.

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „FFFFFF“

Der benutzerdefinierte Formatbezeichner "FFFFFF" stellt die sechs signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Millionstelsekunden in einem Datums- und Uhrzeitwert. Nachfolgende Nullen werden nicht angezeigt. Nichts wird angezeigt, wenn die sechs signifikanten Ziffern 0 sind, und in diesem Fall wird auch nicht das Dezimalzeichen angezeigt, das auf die Anzahl der Sekunden folgt.

Obwohl es möglich ist, die Millionstel einer zweiten Komponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Auf den Betriebssystemen Windows Server 2019 und Windows 11 beträgt die Auflösung der Uhr etwa 1 Millisekunden.

Zurück zur Tabelle

Benutzerdefinierte Formatbezeichner „FFFFFFF“

Der benutzerdefinierte Formatbezeichner "FFFFFFF" stellt die sieben signifikantesten Ziffern des Sekundenbruchteils dar, d. h. die Zehnmillionstelsekunden in einem Datums- und Uhrzeitwert. Nachfolgende Nullen werden nicht angezeigt. Nichts wird angezeigt, wenn die sieben signifikanten Ziffern 0 sind, und in diesem Fall wird auch nicht das Dezimalzeichen angezeigt, das auf die Anzahl der Sekunden folgt.

Obwohl es möglich ist, die zehn Millionenstel einer zweiten Komponente eines Zeitwerts anzuzeigen, ist dieser Wert möglicherweise nicht sinnvoll. Die Genauigkeit der Datums- und Uhrzeitwerte hängt von der Auflösung der Systemuhr ab. Auf den Betriebssystemen Windows Server 2019 und Windows 11 beträgt die Auflösung der Uhr etwa 1 Millisekunden.

Zurück zur Tabelle

Formatspezifizierer „g“ für die Ära

Der benutzerdefinierte Formatbezeichner „g“ oder „gg“

Die benutzerdefinierten Formatbezeichner „g“ oder „gg“ (plus eine beliebige Anzahl zusätzlicher „g“-Bezeichner) stellen den Zeitraum oder das Zeitalter dar, z. B. A.D. Der Formatierungsvorgang ignoriert diesen Bezeichner, wenn das zu formatierende Datum keine zugeordnete Zeichenfolge für einen Zeitraum oder ein Zeitalter aufweist.

Wenn der Formatbezeichner „g“ allein verwendet wird, d. h. ohne andere benutzerdefinierte Formatbezeichner, wird er als g-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "g" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Klein geschriebener Formatspezifizierer „h“ für Stunden

Der benutzerdefinierte Formatbezeichner „h“

Der benutzerdefinierte Formatbezeichner “h“ stellt die Stunde als Zahl von 1 bis 12 dar. Die Stunde wird dabei im 12-Stunden-Format dargestellt, bei dem die vollen Stunden ab Mitternacht oder 12 Uhr mittags gezählt werden. Eine Stunde nach Mitternacht lässt nicht von derselben Stunde nach 12 Uhr mittags unterscheiden. Die Stunde wird nicht gerundet, und eine einstellige Stunde wird ohne vorangestellte Null formatiert. Beispielsweise zeigt dieser benutzerdefinierte Formatbezeichner um 5:43 Uhr morgens oder nachmittags "5" an.

Wenn der "h"-Formatbezeichner ohne andere benutzerdefinierte Formatbezeichner verwendet wird, wird er als Standardbezeichner für Datums- und Uhrzeitformat interpretiert und löst einen Ausdrucksfehler aus. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "h" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „hh“

Der benutzerdefinierte Formatbezeichner „hh“ (plus eine beliebige Anzahl zusätzlicher h-Bezeichner) stellt die Stunde als Zahl von 01 bis 12 dar. Die Stunde wird dabei im 12-Stunden-Format dargestellt, bei dem die vollen Stunden ab Mitternacht oder 12 Uhr mittags gezählt werden. Eine Stunde nach Mitternacht lässt nicht von derselben Stunde nach 12 Uhr mittags unterscheiden. Die Stunde wird nicht gerundet, und eine einstellige Stunde wird mit einer führenden Null formatiert. Beispielsweise zeigt dieser Formatbezeichner um 5:43 Uhr morgens oder nachmittags "05" an.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "hh" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Groß geschriebener Formatspezifizierer „H“ für Stunden

Der benutzerdefinierte Formatbezeichner „H“

Der benutzerdefinierte Formatbezeichner „H“ stellt die Stunde als Zahl von 0 bis 23 dar. Die Stunde wird dabei im nullbasierten 24-Stunden-Format dargestellt, bei dem die Stunden ab Mitternacht gezählt werden. Einstellige Stunden werden ohne führende Null formatiert.

Wenn der "H"-Formatbezeichner ohne andere benutzerdefinierte Formatbezeichner verwendet wird, wird er als Standardbezeichner für Datums- und Uhrzeitformat interpretiert und löst einen Ausdrucksfehler aus. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "H" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „HH“

Der benutzerdefinierte Formatbezeichner „HH“ (plus eine beliebige Anzahl zusätzlicher H-Bezeichner) stellt die Stunde als Zahl von 00 bis 23 dar. Die Stunde wird dabei im nullbasierten 24-Stunden-Format dargestellt, bei dem die Stunden ab Mitternacht gezählt werden. Einstellige Stunden werden mit einer führenden Null formatiert.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "HH" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Formatspezifizierer „K“ für die Zeitzone

Der benutzerdefinierte Formatbezeichner „K“

Der benutzerdefinierte Formatbezeichner "K" stellt die Zeitzoneninformationen eines Datums- und Uhrzeitwerts dar. Wenn dieser Formatbezeichner mit DateTimeZone-Werten verwendet wird, wird die Ergebniszeichenfolge wie folgt definiert:

  • Für die lokale Zeitzone erzeugt dieser Bezeichner eine Ergebniszeichenfolge, die den lokalen Offset von koordinierter Weltzeit (UTC) enthält, z. B. "-07:00", wenn Ihre Abfrage in Power Query Desktop ausgeführt wird. Wenn Ihre Abfrage in Power Query Online ausgeführt wird, erzeugt die Ergebniszeichenfolge keinen Offset von UTC-Zeit, d. h. "+00:00".

  • Für eine UTC-Zeit erzeugt die Ergebniszeichenfolge keinen Offset von UTC-Zeit; d. h. "+00:00, um ein UTC-Datum darzustellen.

  • Für eine Zeit aus einer nicht angegebenen Zeitzone ist das Ergebnis leer.

Wenn der "K"-Formatbezeichner ohne andere benutzerdefinierte Formatbezeichner verwendet wird, wird er als Standardbezeichner für Datums- und Uhrzeitformat interpretiert und löst einen Ausdrucksfehler aus. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Im folgenden Beispiel wird die Zeichenfolge angezeigt, die sich aus der Verwendung des benutzerdefinierten Formatbezeichners "K" mit verschiedenen Werten in einem System in der Us-Pazifischen Zeitzone ergibt.

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

Hinweis

Der von DateTimeZone.LocalNow zurückgegebene Wert hängt davon ab, ob Sie Power Query auf einem lokalen Computer oder online ausführen. Beispielsweise gibt Power Query Desktop -07:00 im obigen Beispiel eines Systems in der Us-Pazifischen Zeitzone zurück, da sie die auf Ihrem lokalen Computer festgelegte Zeit liest. Power Query Online gibt jedoch zurück +00:00 , weil sie die auf den virtuellen Cloudcomputern festgelegte Zeit liest, die auf UTC festgelegt sind.

Zurück zur Tabelle

Formatspezifizierer „m“ für Minuten

Der benutzerdefinierte Formatbezeichner „m“

Der benutzerdefinierte Formatbezeichner „m“ stellt die Minute als Zahl von 0 bis 59 dar. Die Minute stellt ganze Minuten dar, die seit der letzten Stunde vergangen sind. Einstellige Minuten werden ohne führende Null formatiert.

Wenn der Formatbezeichner „m“ allein verwendet wird, d.h. ohne andere benutzerdefinierte Formatbezeichner, wird er als m-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "m" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „mm“

Der benutzerdefinierte Formatbezeichner „mm“ (plus eine beliebige Anzahl zusätzlicher m-Bezeichner) stellt die Minute als Zahl von 00 bis 59 dar. Die Minute stellt ganze Minuten dar, die seit der letzten Stunde vergangen sind. Einstellige Minuten werden mit einer führenden Null formatiert.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "mm" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Formatspezifizierer „M“ für den Monat

Der benutzerdefinierte Formatbezeichner „M“

Der benutzerdefinierte Formatbezeichner „M“ stellt den Monat als Zahl von 1 bis 12 dar (oder von 1 bis 13 bei Kalendern mit 13 Monaten). Einstellige Monate werden ohne führende Null formatiert.

Wenn der Formatbezeichner „M“ allein verwendet wird, d.h. ohne andere benutzerdefinierte Formatbezeichner, wird er als M-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "M" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „MM“

Der benutzerdefinierte Formatbezeichner „MM“ stellt den Monat als Zahl von 01 bis 12 dar (oder von 01 bis 13 bei Kalendern mit 13 Monaten). Einstellige Monate werden mit einer führenden Null formatiert.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "MM" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „MMM“

Der benutzerdefinierte Formatbezeichner "MMM" stellt den abgekürzten Namen des Monats dar. Der lokalisierte abgekürzte Name des Monats wird aus den abgekürzten Monatsnamen der aktuellen oder angegebenen Kultur abgerufen. Wenn ein benutzerdefinierter Formatbezeichner "d" oder "dd" in der benutzerdefinierten Formatzeichenfolge vorhanden ist, wird der Monatsname stattdessen aus den abgekürzten Genitivennamen abgerufen.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "MMM" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „MMMM“

Der benutzerdefinierte Formatbezeichner "MMMM" stellt den vollständigen Namen des Monats dar. Der lokalisierte Name des Monats wird aus der aktuellen oder angegebenen Kultur abgerufen. Wenn ein benutzerdefinierter Formatbezeichner "d" oder "dd" in der benutzerdefinierten Formatzeichenfolge vorhanden ist, wird der Monatsname stattdessen aus den abgekürzten Genitivennamen abgerufen.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "MMMM" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Formatspezifizierer „s“ für Sekunden

Der benutzerdefinierte Formatbezeichner „s“

Der benutzerdefinierte Formatbezeichner „s“ stellt die Sekunde als Zahl von 0 bis 59 dar. Das Ergebnis stellt ganze Sekunden dar, die seit der letzten Minute vergangen sind. Einstellige Sekunden werden ohne führende Null formatiert.

Wenn der Formatbezeichner „s“ allein verwendet wird, d.h. ohne andere benutzerdefinierte Formatbezeichner, wird er als s-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "s" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „ss“

Der benutzerdefinierte Formatbezeichner „ss“ (plus eine beliebige Anzahl zusätzlicher s-Bezeichner) stellt die Sekunde als Zahl von 00 bis 59 dar. Das Ergebnis stellt ganze Sekunden dar, die seit der letzten Minute vergangen sind. Einstellige Sekunden werden mit einer führenden Null formatiert.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "ss" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Formatspezifizierer „t“ für Meridiem

Der benutzerdefinierte Formatbezeichner „t“

Der benutzerdefinierte Formatbezeichner "t" stellt das erste Zeichen des AM/PM-Kennzeichners dar. Der entsprechende lokalisierte Kennzeichner wird aus der aktuellen oder spezifischen Kultur abgerufen. Der AM-Kennzeichner wird für alle Zeitangaben von 0:00:00 (Mitternacht) bis 11:59:59.999 verwendet. Der PM-Kennzeichner wird für alle Zeitangaben von 12:00:00 (Mittag) bis 23:59:59.999 verwendet.

Wenn der Formatbezeichner „t“ allein verwendet wird, d.h. ohne andere benutzerdefinierte Formatbezeichner, wird er als t-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "t" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „tt“

Der benutzerdefinierte Formatbezeichner "tt" (plus einer beliebigen Anzahl zusätzlicher t-Bezeichner) stellt den vollständigen AM/PM-Kennzeichner dar. Der entsprechende lokalisierte Kennzeichner wird aus der aktuellen oder spezifischen Kultur abgerufen. Der AM-Kennzeichner wird für alle Zeitangaben von 0:00:00 (Mitternacht) bis 11:59:59.999 verwendet. Der PM-Kennzeichner wird für alle Zeitangaben von 12:00:00 (Mittag) bis 23:59:59.999 verwendet.

Achten Sie darauf, dass Sie den Bezeichner „tt“ für Sprachen verwenden, bei denen die Unterscheidung zwischen AM und PM beibehalten werden muss. Ein Beispiel hierfür ist die japanische Sprache, in der nicht das erste, sondern das zweite Zeichen des AM/PM-Bezeichners das Unterscheidungsmerkmal darstellt.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "tt" in eine benutzerdefinierte Formatzeichenfolge ein.

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

Zurück zur Tabelle

Formatspezifizierer „y“ für das Jahr

Der benutzerdefinierte Formatbezeichner „y“

Der benutzerdefinierte Formatbezeichner "y" stellt das Jahr als einstellige oder zweistellige Zahl dar. Falls das Jahr mehr als zwei Ziffern umfasst, werden im Ergebnis nur die beiden niedrigwertigen Ziffern angezeigt. Wenn die erste Ziffer eines zweistelligen Jahrs eine Null ist (z. B. 2008), wird die Zahl ohne führende Null formatiert.

Wenn der Formatbezeichner „y“ allein verwendet wird, d.h. ohne andere benutzerdefinierte Formatbezeichner, wird er als y-Standardformatbezeichner für Datum und Uhrzeit interpretiert. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "y" in eine benutzerdefinierte Formatzeichenfolge ein.

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

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „yy“

Der benutzerdefinierte Formatbezeichner "yy" stellt das Jahr als zweistellige Zahl dar. Falls das Jahr mehr als zwei Ziffern umfasst, werden im Ergebnis nur die beiden niedrigwertigen Ziffern angezeigt. Umfasst das Jahr weniger als zwei signifikante Ziffern, wird die Zahl mit führenden Nullen auf eine zweistellige Jahresangabe aufgefüllt.

In einem Analysevorgang wird ein zweistelliges Jahr, das mithilfe des benutzerdefinierten Formatbezeichners "yyy" analysiert wird, basierend auf dem aktuellen Kalender des Formatanbieters interpretiert. Im folgenden Beispiel wird die Zeichenfolgendarstellung eines Datums mit einer zweistelligen Jahresangabe anhand des standardmäßigen gregorianischen Kalenders der Kultur en-US analysiert, die in diesem Fall die aktuelle Kultur ist. Die für das vierstellige Datum zurückgegebenen Werte hängen vom vom Betriebssystem festgelegten Bereich von 100 Jahren ab.

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

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "yy" in eine benutzerdefinierte Formatzeichenfolge ein.

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

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „yyy“

Der benutzerdefinierte Formatbezeichner "yyy" stellt das Jahr mit mindestens drei Ziffern dar. Falls das Jahr mehr als drei signifikante Ziffern umfasst, werden diese in die Ergebniszeichenfolge aufgenommen. Umfasst das Jahr weniger als drei Ziffern, wird die Zahl mit führenden Nullen auf eine dreistellige Jahresangabe aufgefüllt.

Hinweis

Für den buddhistischen Kalender Thailands, der fünfstellige Jahresangaben enthalten kann, zeigt dieser Bezeichner alle signifikanten Ziffern an.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "yyy" in eine benutzerdefinierte Formatzeichenfolge ein.

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

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „yyyy“

Der benutzerdefinierte Formatbezeichner "yyyy" stellt das Jahr mit mindestens vier Ziffern dar. Falls das Jahr mehr als vier signifikante Ziffern umfasst, werden diese in die Ergebniszeichenfolge eingeschlossen. Umfasst das Jahr weniger als vier Ziffern, wird die Zahl mit führenden Nullen auf eine vierstellige Jahresangabe aufgefüllt.

Hinweis

Für den buddhistischen Kalender Thailands, der fünfstellige Jahresangaben enthalten kann, zeigt dieser Bezeichner mindestens vier Ziffern an.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "yyyy" in eine benutzerdefinierte Formatzeichenfolge ein.

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

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

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „yyyyy“

Der benutzerdefinierte Formatbezeichner "yyyyy" (plus einer beliebigen Anzahl zusätzlicher y-Bezeichner) stellt das Jahr mit mindestens fünf Ziffern dar. Falls das Jahr mehr als fünf signifikante Ziffern umfasst, werden diese in die Ergebniszeichenfolge eingeschlossen. Umfasst das Jahr weniger als fünf Ziffern, wird die Zahl mit führenden Nullen auf eine fünfstellige Jahresangabe aufgefüllt.

Falls zusätzliche y-Bezeichner vorhanden sind, wird die Zahl mit der erforderlichen Anzahl an führenden Nullen auf die Anzahl der y-Bezeichner aufgefüllt.

Das folgende Beispiel schließt den benutzerdefinierten Formatbezeichner "yyyyy" in eine benutzerdefinierte Formatzeichenfolge ein.

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

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

Zurück zur Tabelle

Formatspezifizierer „z“ für das Offset

Der benutzerdefinierte Formatbezeichner „z“

Mit DateTimeZone-Werten stellt der benutzerdefinierte Formatbezeichner "z" den signierten Offset der angegebenen Zeitzone aus koordinierter Weltzeit (UTC) dar, gemessen in Stunden. Der Offset wird immer mit einem vorangestellten Plus- oder Minuszeichen angezeigt. Ein Pluszeichen (+) gibt die Stunden vor UTC, ein Minuszeichen (-) die Stunden nach UTC an. Einstellige Offseteerte werden ohne eine führende Null formatiert.

Die folgende Tabelle zeigt, wie sich der Offsetwert abhängig von der DateTimeZone-Funktion ändert.

DateTimeZone-Wert Offsetwert
DateTimeZone.LocalNow Auf Power Query Desktop wird der signierte Offset der Zeitzone des lokalen Betriebssystems von UTC verwendet. Gibt in Power Query Online zurück +00.
DateTimeZone.UtcNow Gibt +0 zurück.

Wenn der "z"-Formatbezeichner ohne andere benutzerdefinierte Formatbezeichner verwendet wird, wird er als Standardbezeichner für Datums- und Uhrzeitformat interpretiert und löst einen Ausdrucksfehler aus. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Das folgende Beispiel enthält den benutzerdefinierten Formatbezeichner "z" in einer benutzerdefinierten Formatzeichenfolge auf einem System in der US-Pazifischen Zeitzone.

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

Hinweis

Der von DateTimeZone.LocalNow zurückgegebene Wert hängt davon ab, ob Sie Power Query auf einem lokalen Computer oder online ausführen. Beispielsweise gibt Power Query Desktop {0:-7} im obigen Beispiel eines Systems in der Us-Pazifischen Zeitzone zurück, da sie die auf Ihrem lokalen Computer festgelegte Zeit liest. Power Query Online gibt jedoch zurück {0:+0} , weil sie die auf den virtuellen Cloudcomputern festgelegte Zeit liest, die auf UTC festgelegt sind.

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „zz“

Bei DateTimeZone-Werten stellt der benutzerdefinierte Formatbezeichner "zz" den signierten Offset der angegebenen Zeitzone aus UTC dar, gemessen in Stunden. Der Offset wird immer mit einem vorangestellten Plus- oder Minuszeichen angezeigt. Ein Pluszeichen (+) gibt die Stunden vor UTC, ein Minuszeichen (-) die Stunden nach UTC an. Einstellige Offsetwerte werden mit einer führenden Null formatiert.

Die folgende Tabelle zeigt, wie sich der Offsetwert abhängig von der DateTimeZone-Funktion ändert.

DateTimeZone-Wert Offsetwert
DateTimeZone.LocalNow Auf Power Query Desktop wird der signierte Offset der Zeitzone des lokalen Betriebssystems von UTC verwendet. Gibt in Power Query Online zurück +00.
DateTimeZone.UtcNow Gibt +00 zurück.

Das folgende Beispiel enthält den benutzerdefinierten Formatbezeichner "zz" in einer benutzerdefinierten Formatzeichenfolge auf einem System in der US-Pazifischen Zeitzone.

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

Hinweis

Der von DateTimeZone.LocalNow zurückgegebene Wert hängt davon ab, ob Sie Power Query auf einem lokalen Computer oder online ausführen. Beispielsweise gibt Power Query Desktop {0:-07} im obigen Beispiel eines Systems in der Us-Pazifischen Zeitzone zurück, da sie die auf Ihrem lokalen Computer festgelegte Zeit liest. Power Query Online gibt jedoch zurück {0:+00} , weil sie die auf den virtuellen Cloudcomputern festgelegte Zeit liest, die auf UTC festgelegt sind.

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „zzz“

Mit DateTimeZone-Werten stellt der benutzerdefinierte Formatbezeichner "zzz" den signierten Offset der angegebenen Zeitzone aus UTC dar, gemessen in Stunden und Minuten. Der Offset wird immer mit einem vorangestellten Plus- oder Minuszeichen angezeigt. Ein Pluszeichen (+) gibt die Stunden vor UTC, ein Minuszeichen (-) die Stunden nach UTC an. Einstellige Offset-Werte werden mit einer führenden Null formatiert.

Die folgende Tabelle zeigt, wie sich der Offsetwert abhängig von der DateTimeZone-Funktion ändert.

DateTimeZoneValue-Wert Offsetwert
DateTimeZone.LocalNow Auf Power Query Desktop wird der signierte Offset der Zeitzone des lokalen Betriebssystems von UTC verwendet. Gibt in Power Query Online zurück +00.
DateTimeZone.UtcNow Gibt +00:00 zurück.

Das folgende Beispiel enthält den benutzerdefinierten Formatbezeichner "zzz" in einer benutzerdefinierten Formatzeichenfolge auf einem System in der US-Pazifischen Zeitzone.

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

Hinweis

Der von DateTimeZone.LocalNow zurückgegebene Wert hängt davon ab, ob Sie Power Query auf einem lokalen Computer oder online ausführen. Beispielsweise gibt Power Query Desktop {0:-07:00} im obigen Beispiel eines Systems in der Us-Pazifischen Zeitzone zurück, da sie die auf Ihrem lokalen Computer festgelegte Zeit liest. Power Query Online gibt jedoch zurück {0:+00:00} , weil sie die auf den virtuellen Cloudcomputern festgelegte Zeit liest, die auf UTC festgelegt sind.

Zurück zur Tabelle

Trennzeichenspezifizierer für Datum und Uhrzeit

Der benutzerdefinierte Formatbezeichner „:“

Der benutzerdefinierte Formatbezeichner ":" stellt das Trennzeichen für Zeitangaben dar, mit dem zwischen Stunden und Minuten unterschieden werden kann. Das entsprechende lokalisierte Zeittrennzeichen wird aus der aktuellen oder angegebenen Kultur abgerufen.

Hinweis

Um das Trennzeichen für Zeitangaben für ein bestimmtes Datum und eine Uhrzeit-Zeichenfolge zu ändern, geben Sie das Trennzeichen in ein Zeichenfolgenliteral-Trennzeichen. Z. B. die benutzerdefinierte Formatzeichenfolge hh_dd_ss erzeugt eine Ergebniszeichenfolge, die in dem "_" (Unterstrich) immer als Trennzeichen verwendet wird.

Wenn der ":"-Formatbezeichner ohne andere benutzerdefinierte Formatbezeichner verwendet wird, wird er als Standardbezeichner für Datums- und Uhrzeitformat interpretiert und löst einen Ausdrucksfehler aus. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Zurück zur Tabelle

Der benutzerdefinierte Formatbezeichner „/“

Der benutzerdefinierte Formatbezeichner "/" stellt das Datumstrennzeichen dar, mit dem zwischen Jahren, Monaten und Tagen unterschieden wird. Das entsprechende lokalisierte Datumstrennzeichen wird aus der aktuellen oder angegebenen Kultur abgerufen.

Hinweis

Um das Datumstrennzeichen für ein bestimmtes Datum und eine Uhrzeit-Zeichenfolge zu ändern, geben Sie das Trennzeichen in einem Zeichenfolgenliteral-Trennzeichen an. Die benutzerdefinierte Formatzeichenfolge mm/dd/yyyy erzeugt beispielsweise eine Ergebniszeichenfolge, in der "/" immer als Datumstrennzeichen verwendet wird.

Wenn der "/"-Formatbezeichner ohne andere benutzerdefinierte Formatbezeichner verwendet wird, wird er als Standardbezeichner für Datums- und Uhrzeitformat interpretiert und löst einen Ausdrucksfehler aus. Weitere Informationen zur Verwendung eines einzelnen Formatbezeichners finden Sie weiter unten in diesem Artikel unter Verwendung von Benutzerdefinierten Formatbezeichnern .

Zurück zur Tabelle

Zeichenliterale

Die folgenden Zeichen in einer benutzerdefinierten Formatzeichenfolge für Datum und Uhrzeit sind reserviert und werden immer als Formatierungszeichen bzw. im Fall von ", ', / und \ als Sonderzeichen interpretiert.

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

Alle anderen Zeichen werden immer als Zeichenliterale interpretiert und bei einem Formatierungsvorgang unverändert in die Ergebniszeichenfolge übernommen. In einem Analysevorgang müssen die Zeichen exakt den Zeichen in der Eingabezeichenfolge entsprechen, beim Vergleich wird die Groß- und Kleinschreibung beachtet.

Das folgende Beispiel enthält die Literalzeichen „PST“ (für Pacific Standard Time) und „PDT“ (für Pacific Daylight Time), um die lokale Zeitzone in einer Formatzeichenfolge darzustellen. Beachten Sie, dass die Zeichenfolge in der Ergebniszeichenfolge enthalten ist und dass eine Zeichenfolge, die die Zeichenfolge der lokalen Zeitzone enthält, ebenfalls erfolgreich analysiert wird.

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

Es gibt zwei Möglichkeiten, um anzugeben, dass Zeichen nicht als reservierte Zeichen, sondern als Literalzeichen interpretiert werden sollen, damit sie in eine Ergebniszeichenfolge eingeschlossen oder in einer Eingabezeichenfolge erfolgreich analysiert werden können:

  • Versehen Sie jedes reservierte Zeichen mit einem Escapezeichen. Weitere Informationen finden Sie unter Verwenden der Escapesequenzen.

    Das folgende Beispiel enthält die Literalzeichen „pst“ (für Pacific Standard Time), um die lokale Zeitzone in einer Formatzeichenfolge darzustellen. Da „s“ und „t“ benutzerdefinierte Formatzeichenfolgen sind, müssen beide Zeichen mit Escapezeichen versehen werden, damit sie als Zeichenliterale interpretiert werden können.

    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
    
  • Durch Einschließen der gesamten Literalzeichenfolge in Apostrophe. Das folgende Beispiel ähnelt dem vorherigen, mit der Ausnahme, dass "pst" in Apostrophe eingeschlossen ist, um anzugeben, dass die gesamte durch Trennzeichen getrennte Zeichenfolge als Zeichenliterale interpretiert werden soll.

    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
    

Hinweise

Verwenden von einzelnen benutzerdefinierten Formatbezeichnern

Eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit besteht aus zwei oder mehr Zeichen. Formatierungsmethoden für Datum und Uhrzeit interpretieren einzelne Zeichenfolgen als Standardformatzeichenfolgen für Datum und Uhrzeit. Wenn sie das Zeichen nicht als gültigen Formatbezeichner erkennen, lösen sie einen Ausdrucksfehler aus. Wenn die Formatzeichenfolge beispielsweise nur aus dem h-Bezeichner besteht, wird sie als Standardformatzeichenfolge für Datum und Uhrzeit interpretiert. In diesem speziellen Fall wird jedoch eine Ausnahme ausgelöst, weil kein Standardformatbezeichner „h“ für Datum und Uhrzeit vorhanden ist.

Wenn Sie einen benutzerdefinierten Formatbezeichner für Datum und Uhrzeit als einzigen Bezeichner in einer Formatierungszeichenfolge verwenden möchten, d. h. wenn Sie den benutzerdefinierten Formatbezeichner "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" oder "/" ohne einen anderen Bezeichner verwenden möchten, müssen Sie ein Leerzeichen vor oder nach dem Bezeichner angeben, oder Sie stellen dem einzelnen benutzerdefinierten Bezeichner für Datum und Uhrzeit einen Prozentformatbezeichner (%) voran.

Beispielsweise wird „%h“ als benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit interpretiert, mit der die durch den aktuellen Datums- und Uhrzeitwert dargestellte Stunde angezeigt wird. Sie können auch die Formatzeichenfolge " h" oder "h " verwenden, obwohl dadurch ein Leerzeichen zusammen mit der Stunde in die Ergebniszeichenfolge eingeschlossen wird. Im folgenden Beispiel werden diese drei Formatzeichenfolgen veranschaulicht.

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 ' 

Verwenden der Escapesequenzen

Die Zeichen "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" oder "/" in einer Formatzeichenfolge werden als benutzerdefinierte Formatbezeichner und nicht als Literalzeichen interpretiert.

Um zu verhindern, dass ein Zeichen als Formatbezeichner interpretiert wird, können Sie:

  • Stellen Sie ihm einen umgekehrten Schrägstrich voran.
  • Umschließen Sie es mit einem einzelnen Anführungszeichen.
  • Umschließen Sie es mit zwei doppelten Anführungszeichen.

Jedes dieser Zeichen fungiert als Escapesequenz. Die Escapesequenz gibt an, dass das folgende Zeichen oder umgebene Zeichen ein Textliteral ist, das unverändert in die Ergebniszeichenfolge eingeschlossen werden soll.

Um ein doppeltes Anführungszeichen in eine Ergebniszeichenfolge einzuschließen, müssen Sie es mit einem anderen doppelten Anführungszeichen ("") escapeen.

Im folgenden Beispiel werden unterschiedliche Escapesequenzen verwendet, um zu verhindern, dass der Formatierungsvorgang die Zeichen "h" und "m" als Formatbezeichner interpretiert.

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