Freigeben über

Standardformatzeichenfolgen für Datum und Uhrzeit

  • Artikel

Eine Standardmäßige Datums- und Uhrzeitformatzeichenfolge verwendet ein einzelnes Zeichen als Formatbezeichner, um die Textdarstellung eines Uhrzeit- und Datumswerts zu definieren. Jede Formatzeichenfolge für Datum und Uhrzeit, die mehr als ein Zeichen (einschließlich Leerzeichen) enthält, wird als benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit interpretiert. Eine Standard- oder benutzerdefinierte Formatzeichenfolge kann verwendet werden, um die Textdarstellung zu definieren, die aus einem Formatierungsvorgang resultiert.

Tabelle mit Formatbezeichern

In der folgenden Tabelle werden die Standardformatbezeichner für Datum und Uhrzeit beschrieben.

Formatbezeichner BESCHREIBUNG Beispiele
"d" Kurzes Datumsmuster.

Weitere Informationen: Der kurze Datumsformatbezeichner ("d").		 2009-06-15T13:45:30 -> 6/15/2009 (en-US)

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

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D" Langes Datumsmuster.

Weitere Informationen: Der Formatbezeichner für das lange Datum ("D").		 2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)

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

2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f" Vollständiges Datums-/Zeitmuster (kurze Zeit).

Weitere Informationen finden Sie unter: Der Formatbezeichner für vollständiges Datum und kurze Zeit („f“).		 2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F" Vollständiges Datums-/Zeitmuster (lange Zeit).

Weitere Informationen finden Sie unter: Der Formatbezeichner für vollständiges Datum und lange Zeit („F“).		 2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g" Allgemeines Datums-/Zeitmuster (kurze Zeit).

Weitere Informationen finden Sie unter: Der allgemeine Formatbezeichner für Datum und kurze Zeit („g“).		 2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G" Allgemeines Datums-/Zeitmuster (lange Zeit).

Weitere Informationen finden Sie unter: Der allgemeine Formatbezeichner für Datum und lange Zeit („G“).		 2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m" Monatstagmuster.

Weitere Informationen finden Sie unter: Der Formatbezeichner für den Monat („M“, „m“).		 2009-06-15T13:45:30 -> June 15 (en-US)

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

2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o" Datums-/Uhrzeitmuster für Roundtrip.

Weitere Informationen finden Sie unter: Der Formatbezeichner für Roundtrips („O“, „o“).		 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00

2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z

2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000
"R", "r" RFC1123-Muster.

Weitere Informationen finden Sie unter: Der RFC1123-Formatbezeichner („R“, „r“).		 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 13:45:30 GMT
"s" Sortierbares Datums-/Zeitmuster.

Weitere Informationen finden Sie unter: Der sortierbare Formatbezeichner („s“).		 2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t" Kurzes Zeitmuster.

Weitere Informationen finden Sie unter: Der Formatbezeichner für kurze Zeit („t“).		 2009-06-15T13:45:30 -> 1:45 PM (en-US)

2009-06-15T13:45:30 -> 13:45 (hr-HR)

2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T" Langes Zeitmuster.

Weitere Informationen finden Sie unter: Der Formatbezeichner für lange Zeit („T“).		 2009-06-15T13:45:30 -> 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 13:45:30 (hr-HR)

2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u" Universelles, sortierbares Datums-/Zeitmuster.

Weitere Informationen finden Sie unter: Der universelle sortierbare Formatbezeichner („u“).		 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"Y", "y" Jahr-Monat-Muster.

Weitere Informationen finden Sie unter: Der Formatbezeichner für Jahr-Monat („Y“).		 2009-06-15T13:45:30 -> June 2009 (en-US)

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

2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Jedes andere einzelne Zeichen Unbekannter Bezeichner. Löst einen Laufzeitausdrucksfehler aus.

Funktionsweise der Standardformatzeichenfolgen

Bei einem Formatierungsvorgang ist eine Standardformatzeichenfolge lediglich ein Alias für eine benutzerdefinierte Formatzeichenfolge. Die Verwendung eines Alias, der auf eine benutzerdefinierte Formatzeichenfolge verweist, hat den Vorteil, dass der Alias unveränderlich bleibt, während die benutzerdefinierte Formatzeichenfolge selbst variieren kann. Dies ist wichtig, da sich die Zeichenfolgenentsprechungen von Datums- und Uhrzeitwerten i. d. R. abhängig von der Kultur unterscheiden. So gibt beispielsweise die Standardformatzeichenfolge "d" an, dass der Datums- und Uhrzeitwert in einem kurzen Datumsmuster angezeigt wird. Für die invariante Kultur lautet dieses Muster "MM/dd/yyyy". Für die Kultur fr-FR lautet es "dd/MM/yyyy". Für die Kultur ja-JP lautet es "yyyy/MM/dd".

Wenn eine Standardformatzeichenfolge in einem Formatierungsvorgang der benutzerdefinierte Formatzeichenfolge einer bestimmten Kultur zugeordnet wird, kann die Anwendung eine bestimmte Kultur definieren, deren benutzerdefinierte Formatzeichenfolgen auf eine der folgenden Weisen verwendet werden:

  • Sie können die Standardkultur (die aktuelle Kultur) verwenden. Das folgende Beispiel zeigt ein Datum unter Verwendung des kurzen Datumsformat der aktuellen Kultur an. In diesem Fall ist die aktuelle Kultur en-US.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d"])
        //Displays 3/15/2024
    }
in
    Source

  • Sie können eine Kultur übergeben, die zum Formatieren des Datums gemäß den Regeln dieser bestimmten Kultur verwendet wird. Das folgenden Beispiel zeigt ein Datum unter Verwendung des kurzen Datumsformat der Kultur pt-BR an.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"])
        //Displays 15/03/2024
   }
in
    Source

In einigen Fällen dient die Standardformatzeichenfolge als praktische Abkürzung für eine längere benutzerdefinierte Formatzeichenfolge, die unveränderlich ist. Vier Standardformatzeichenfolgen fallen in diese Kategorie: „O“ (oder „o“), „R“ (oder „r“), „s“ und „u“. Diese Zeichenfolgen entsprechen benutzerdefinierten Formatzeichenfolgen, die durch die invariante Kultur definiert werden. Sie erzeugen Zeichenfolgenentsprechungen von Datums- und Uhrzeitwerten, die über Kulturen hinweg identisch sein sollen. In der folgenden Tabelle werden Informationen über dieses vier Standardformatzeichenfolgen für Datum und Uhrzeit bereitgestellt.

Standardformatzeichenfolge Definiert durch Benutzerdefinierte Formatzeichenfolge
"O" oder "o" Keine jjjj'-'MM'-'tt'T'HH':'mm':'ss'.'fffffffK
"R" oder "r" IETF RFC 1123-Spezifikation ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s" ISO 8601 yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u" Sortierbar, da sie führende Nullen für Jahr, Monat, Tag, Stunde, Minute und Sekunde verwendet yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standardformatzeichenfolgen können auch in Analysevorgängen verwendet werden, bei denen eine Eingabezeichenfolge erforderlich ist, um genau einem bestimmten Muster für den erfolgreichen Analysevorgang zu entsprechen. Viele Standardformatzeichenfolgen werden mehreren benutzerdefinierten Formatzeichenfolgen zugeordnet, sodass ein Datums- und Uhrzeitwert in einer Vielzahl von Formaten dargestellt werden kann und der Analysevorgang weiterhin erfolgreich ist.

In den folgenden Abschnitten werden die Standardformatbezeichner für Datums-, DateTime-, DateTimeZone- und Zeitwerte beschrieben.

Datumsformate

Diese Gruppe enthält die folgenden Formate:

Der Formatbezeichner „d“ für kurzes Datum

Der Standardformatbezeichner "d" stellt ein benutzerdefiniertes Datumsformat dar, das durch eine bestimmte Kultur definiert wird. Beispielsweise lautet der von der invarianten Kultur zurückgegebene benutzerdefinierte Formattext "MM/dd/yyyy".

Im folgenden Beispiel wird der Formatbezeichner "d" verwendet, um einen Datumswert anzuzeigen.

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

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

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

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

Zurück zur Tabelle

Der Formatbezeichner „D“ für langes Datum

Der Standardformatbezeichner "D" stellt ein benutzerdefiniertes Datumsformat dar, das durch eine bestimmte Kultur definiert wird. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "dddd, dd MMMM yyyy".

Im folgenden Beispiel wird der D-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

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

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

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

Zurück zur Tabelle

Formate für Datum und Uhrzeit

Diese Gruppe enthält die folgenden Formate:

Der Formatbezeichner „f“ für vollständiges Datum und kurze Zeit

Der Standardformatbezeichner "f" stellt eine Kombination aus dem Muster für langes Datum ("D") und dem Muster für kurze Zeit ("t") getrennt durch ein Leerzeichen dar.

Die Ergebniszeichenfolge wird von den Formatierungsinformationen einer bestimmten Kultur beeinflusst.

Im folgenden Beispiel wird der f-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

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

Zurück zur Tabelle

Der Formatbezeichner „F“ für vollständiges Datum und lange Zeit

Der Standardformatbezeichner "F" stellt ein benutzerdefiniertes Datums- und Uhrzeitformat dar, das durch eine bestimmte Kultur definiert wird. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "dddd, dd MMMM yyyy HH:mm:ss".

Die Ergebniszeichenfolge wird von den Formatierungsinformationen einer bestimmten Kultur beeinflusst.

Im folgenden Beispiel wird der F-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

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

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

Zurück zur Tabelle

Der Formatbezeichner „g“ für allgemeines Datum und kurze Zeit

Der Standardformatbezeichner "g" stellt eine Kombination aus dem Muster für kurzes Datum ("d") und dem Muster für kurze Zeit ("t") getrennt durch ein Leerzeichen dar. Der resultierende Text wird durch die Formatierungsinformationen einer bestimmten Kultur beeinflusst.

Die Ergebniszeichenfolge wird von den Formatierungsinformationen einer bestimmten Kultur beeinflusst.

Im folgenden Beispiel wird der g-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

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

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

Zurück zur Tabelle

Der Formatbezeichner „G“ für allgemeines Datum und lange Zeit

Der Standardformatbezeichner "G" stellt eine Kombination aus dem Muster für kurzes Datum ("d") und dem Muster für lange Zeit ("T") getrennt durch ein Leerzeichen dar. Der resultierende Text wird durch die Formatierungsinformationen einer bestimmten Kultur beeinflusst.

Die Ergebniszeichenfolge wird von den Formatierungsinformationen einer bestimmten Kultur beeinflusst.

Im folgenden Beispiel wird der G-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

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

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

Zurück zur Tabelle

Die Formatbezeichner „O“, „o“ für Roundtrips

Der Standardformatbezeichner "O" oder "o" stellt eine benutzerdefinierte Formatzeichenfolge für Datum und Uhrzeit unter Verwendung eines Musters dar, bei dem die Zeitzoneninformationen beibehalten werden, und gibt eine Ergebniszeichenfolge aus, die die Anforderungen von ISO 8601 erfüllt. Für DateTimeZone-Werte wurde dieser Formatbezeichner so konzipiert, dass Datums-, Uhrzeit- und Zeitzonenwerte im Text beibehalten werden.

Der Standardformatbezeichner "O" oder "o" entspricht dem Standardformatbezeichner "yyyy'-'MM'-'Dd'T'HH':'mm''ss'.' fffffffxxx" benutzerdefinierte Formatzeichenfolge für DateTimeZone-Werte . In diesem Text geben die Paare einzelner Anführungszeichen an, die einzelne Zeichen trennen, z. B. die Bindestriche, die Doppelpunkte und den Buchstaben "T", dass das einzelne Zeichen ein Literal ist, das nicht geändert werden kann. Die Apostrophe werden nicht in der Ausgabezeichenfolge angezeigt.

Der Standardformatbezeichner "O" oder "o" (und der "yyyy'MM'-'Dd'T'HH':'mm''ss'.' fffffffxxx" benutzerdefiniertes Format) nutzt die drei Möglichkeiten, wie ISO 8601 Zeitzoneninformationen darstellt, um die DateTimeZone-Werte beizubehalten:

Da der Standardformatbezeichner „O“ oder „o“ einem internationalen Standard entspricht, nutzt der Formatierungs- oder Analysevorgang, der den Bezeichner verwendet, stets die invariante Kultur und den gregorianischen Kalender.

Im folgenden Beispiel wird der "o"-Formatbezeichner verwendet, um eine Reihe von DateTimeZone-Werten auf einem System in der Us-Pazifischen Zeitzone anzuzeigen.

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

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

Hinweis

Der von DateTimeZone.ToLocal 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 in einem System in der Us-Pazifischen Zeitzone für die Ortszeit 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.

Im folgenden Beispiel wird der "o"-Formatbezeichner verwendet, um eine formatierte Zeichenfolge zu erstellen, und stellt dann den ursprünglichen Datums- und Uhrzeitwert wieder her, indem eine Datums- und Uhrzeitanalyseroutine aufgerufen wird.

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

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

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

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

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

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

Zurück zur Tabelle

Die RFC1123-Formatbezeichner „R“, „r“

Der Standardformatbezeichner "R" oder "r" stellt eine benutzerdefinierte Datums- und Uhrzeitformatzeichenfolge dar, die nicht durch eine bestimmte Kultur definiert ist. Es ist immer gleich, unabhängig von der verwendeten Kultur oder dem bereitgestellten Formatanbieter. Die benutzerdefinierte Formatzeichenfolge lautet "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Wenn dieser Standardformatbezeichner verwendet wird, wird bei der Formatierungs- oder Analysemethode immer die invariante Kultur verwendet.

Obwohl der RFC 1123-Standard eine Uhrzeit als koordinierte Weltzeit (UTC) ausdrückt, ändert der Formatierungsvorgang nicht den Wert des Datums und der Uhrzeit, das formatiert wird. Daher müssen Sie den DateTime-Wert in UTC konvertieren, indem Sie die DateTimeZone.ToUtc-Funktionsmethode aufrufen, bevor Sie den Formatierungsvorgang ausführen.

Im folgenden Beispiel wird der Formatbezeichner "r" verwendet, um einen Zeit- und Datumswert in einem System in der US-Pazifischen Zeitzone (sieben Stunden hinter UTC) anzuzeigen.

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

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

Zurück zur Tabelle

Der Bezeichner „s“ für sortierbares Format

Der Standardformatbezeichner "s" stellt eine benutzerdefinierte Datums- und Uhrzeitformatzeichenfolge dar, die einen definierten Standard (ISO 8601) widerspiegelt und schreibgeschützt ist. Es ist daher unabhängig von der verwendeten Kultur oder dem bereitgestellten Formatanbieter immer identisch. Die benutzerdefinierte Formatzeichenfolge lautet "yyyy'-'MM'-'dd'T'HH':'mm':'ss". Der Formatbezeichner "s" dient dazu, Ergebniszeichenfolgen zu generieren, die konsistent in aufsteigender oder absteigender Reihenfolge auf der Grundlage von Datums-und Uhrzeitwerten sortieren.

Wenn dieser Standardformatbezeichner verwendet wird, wird bei der Formatierungs- oder Analysemethode immer die invariante Kultur verwendet.

Im folgenden Beispiel wird der Formatbezeichner "s" verwendet, um einen Datums- und Uhrzeitwert in einem System in der US-Pazifischen Zeitzone anzuzeigen.

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

Zurück zur Tabelle

Der Bezeichner „u“ für universelles sortierbares Format

Der Standardformatbezeichner "u" stellt eine benutzerdefinierte Datums- und Uhrzeitformatzeichenfolge dar, die unabhängig von der verwendeten Kultur oder dem angegebenen Formatanbieter immer gleich ist. Die benutzerdefinierte Formatzeichenfolge lautet "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Bei dem Muster handelt es sich um einen definierten Standard. Die Eigenschaft ist schreibgeschützt. Wenn dieser Standardformatbezeichner verwendet wird, wird bei der Formatierungs- oder Analysemethode immer die invariante Kultur verwendet.

Obwohl die Ergebniszeichenfolge eine Uhrzeit als koordinierte Weltzeit (UTC) ausdrücken soll, wird während des Formatierungsvorgangs keine Konvertierung des ursprünglichen DateTimeZone-Werts ausgeführt. Daher müssen Sie einen DateTimeZone-Wert in UTC konvertieren, indem Sie die DateTimeZone.ToUtc-Funktion aufrufen, bevor Sie ihn formatieren.

Im folgenden Beispiel wird der u-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

Zurück zur Tabelle

Uhrzeitformate

Diese Gruppe enthält die folgenden Formate:

Der Formatbezeichner „t“ für kurze Zeit

Der Standardformatbezeichner "t" stellt eine benutzerdefinierte Datums- und Uhrzeitformatzeichenfolge dar, die von der angegebenen Kultur definiert wird. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "HH:mm".

Die Ergebniszeichenfolge wird von den Formatierungsinformationen einer bestimmten Kultur beeinflusst.

Im folgenden Beispiel wird der t-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

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

Zurück zur Tabelle

Der Formatbezeichner „T“ für lange Zeit

Der Standardformatbezeichner "T" stellt eine benutzerdefinierte Datums- und Uhrzeitformatzeichenfolge dar, die von der spezifischen Kultur definiert wird. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "HH:mm:ss".

Im folgenden Beispiel wird der T-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

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

Zurück zur Tabelle

Partielle Datumsformate

Diese Gruppe enthält die folgenden Formate:

Die Formatbezeichner „M“, „m“ für Monat

Der Standardformatbezeichner "M" oder "m" stellt eine benutzerdefinierte Datums- und Uhrzeitformatzeichenfolge dar, die von der spezifischen Kultur definiert wird. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "MMMM dd".

Im folgenden Beispiel wird der m-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

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

Zurück zur Tabelle

Die Formatbezeichner „Y“, „y“ für Jahr-Monat

Der Standardformatbezeichner "Y" oder "y" stellt eine benutzerdefinierte Datumsformatzeichenfolge dar, die durch eine bestimmte Kultur definiert wird. Die benutzerdefinierte Formatzeichenfolge für die invariante Kultur lautet beispielsweise "yyyy MMMM".

Im folgenden Beispiel wird der y-Formatbezeichner verwendet, um einen Datums- und Zeitwert anzuzeigen.

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

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

Zurück zur Tabelle

Zugehöriger Inhalt