Standardformatsträngar för datum och tid

Artikel
10/24/2024

En standardformatsträng för datum och tid använder ett enda tecken som formatspecificerare för att definiera textrepresentationen av ett tids- och datumvärde. Alla datum- och tidsformatsträngar som innehåller mer än ett tecken, inklusive blanksteg, tolkas som en anpassad datum- och tidsformatsträng. En standard- eller anpassad formatsträng kan användas för att definiera textrepresentationen som är resultatet av en formateringsåtgärd.

Tabell med formatspecificerare

I följande tabell beskrivs standardformatsspecificerarna för datum och tid.

Formatspecificerare	beskrivning	Exempel
"d"	Kort datummönster. Mer information: Formatspecificeraren för kort datum ("d").	2009-06-15T13:45:30 -> 2009-06-15 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Långt datummönster. Mer information: Formatspecificeraren för långt datum ("D").	2009-06-15T13:45:30 -> måndag 15 juni 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Mönster för fullständigt datum/tid (kort tid). Mer information: Formatspecificeraren för fullständigt datum ("f").	2009-06-15T13:45:30 -> måndag 15 juni 2009 13:45 (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"	Fullständigt datum/tid-mönster (lång tid). Mer information: Formatspecificeraren för fullständigt datum ("F").	2009-06-15T13:45:30 -> måndag 15 juni 2009 13:45:30 (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"	Allmänt datum/tid-mönster (kort tid). Mer information: Formatspecificeraren för generell kort tid ("g").	2009-06-15T13:45:30 -> 2009-06-15 13:45 (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"	Allmänt datum/tid-mönster (lång tid). Mer information: Formatspecificeraren för allmänt datum ("G").	2009-06-15T13:45:30 -> 2009-06-15 13:45:30 (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"	Mönster för månad/dag. Mer information: Formatspecificeraren month ("M", "m").	2009-06-15T13:45:30 -> 15 juni (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 –> 15 Juni (id-ID)
"O", "o"	datum-/tidsmönster för tur och retur. Mer information: Formatspecificeraren rundresa ("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 mönster. Mer information: Formatspecificeraren RFC1123 ("R", "r").	2009-06-15T13:45:30 -> Mån, 15 jun 2009 13:45:30 GMT
"s"	Sorterbart datum/tid-mönster. Mer information: Den sorterbara formatspecificeraren ("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"	Kort tidsmönster. Mer information: Formatspecificeraren för kort tid ("t").	2009-06-15T13:45:30 -> 13:45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Mönster för lång tid. Mer information: Formatspecificeraren för lång tid ("T").	2009-06-15T13:45:30 -> 13:45:30 (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Universellt sorterbart datum/tid-mönster. Mer information: Den universella sorterbara formatspecificeraren ("u").	2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"Y", "y"	Mönster för årsmånad. Mer information: Formatspecificeraren årsmånad ("Y").	2009-06-15T13:45:30 -> juni 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 –> Juni 2009 (id-ID)
Alla andra enskilda tecken	Okänd specificerare.	Genererar ett körningsuttrycksfel.

Så här fungerar standardformatsträngar

I en formateringsåtgärd är en standardformatsträng helt enkelt ett alias för en anpassad formatsträng. Fördelen med att använda ett alias för att referera till en sträng i anpassat format är att även om aliaset fortfarande är invariant kan den anpassade formatsträngen variera. Detta är viktigt eftersom strängrepresentationerna av datum- och tidsvärden vanligtvis varierar beroende på kultur. Standardformatsträngen "d" anger till exempel att ett datum- och tidsvärde ska visas med ett kort datummönster. För den invarianta kulturen är det här mönstret "MM/dd/åååå". För fr-FR-kulturen är det "dd/MM/åååå". För ja-JP-kulturen är det "åååå/MM/dd".

Om en standardformatsträng i en formateringsåtgärd mappar till en viss kulturs anpassade formatsträng kan ditt program definiera den specifika kultur vars anpassade formatsträngar används på något av följande sätt:

Du kan använda standardkulturen (eller aktuell). I följande exempel visas ett datum med den aktuella kulturens korta datumformat. I det här fallet är den nuvarande kulturen en-US.
```
let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d"])
        //Displays 3/15/2024
    }
in
    Source
```
Du kan skicka en kultur som används för att formatera datumet enligt reglerna för den specifika kulturen. I följande exempel visas ett datum med det korta datumformatet för pt-BR-kulturen.
```
let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"])
        //Displays 15/03/2024
   }
in
    Source
```

I vissa fall fungerar standardformatsträngen som en praktisk förkortning för en längre anpassad formatsträng som är invariant. Fyra standardformatsträngar tillhör den här kategorin: "O" (eller "o"), "R" (eller "r"), "s" och "u". Dessa strängar motsvarar anpassade formatsträngar som definieras av den invarianta kulturen. De skapar strängrepresentationer av datum- och tidsvärden som är avsedda att vara identiska mellan kulturer. Följande tabell innehåller information om dessa fyra standardformatsträngar för datum och tid.

Standardformatsträng	Definierad av	Sträng för anpassat format
"O" eller "o"	Ingen	yyyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" eller "r"	IETF RFC 1123-specifikation	ddd, dd MMM ååååå HH':'mm':ss 'GMT'
"s"	ISO 8601	yyyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	Sorterbar eftersom den använder inledande nollor för år, månad, dag, timme, minut och sekund	yyyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standardformatsträngar kan också användas för parsningsåtgärder, vilket kräver att en indatasträng exakt överensstämmer med ett visst mönster för att parsningsåtgärden ska lyckas. Många standardformatsträngar mappas till flera anpassade formatsträngar, så ett datum- och tidsvärde kan representeras i olika format och parsningsåtgärden lyckas fortfarande.

I följande avsnitt beskrivs standardformatsspecificerarna för värdena Date, DateTime, DateTimeZone och Time .

Datumformat

Den här gruppen innehåller följande format:

Formatspecificeraren för kort datum ("d")
Formatspecificeraren för långt datum ("D")

Formatspecificeraren för kort datum ("d")

Standardformatsspecificeraren "d" representerar ett anpassat datumformat som definierats av en specifik kultur. Den anpassade formattexten som returneras av den invarianta kulturen är till exempel "MM/dd/åååå".

I följande exempel används formatspecificeraren "d" för att visa ett datumvärde.

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

Tillbaka till tabellen

Formatspecificeraren för långt datum ("D")

Standardformatsspecificeraren "D" representerar ett anpassat datumformat som definierats av en specifik kultur. Till exempel är den anpassade formatsträngen för den invarianta kulturen "dddd, dd MMMM åååå".

I följande exempel används formatspecificeraren "D" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Datum- och tidsformat

Den här gruppen innehåller följande format:

Formatspecificeraren för fullständigt datum ("f")
Formatspecificeraren för fullständigt datum ("F")
Formatspecificeraren för generell kort tid ("g")
Formatspecificeraren för allmän datumlång tid ("G")
Formatspecificeraren rundresa ("O", "o")
Formatspecificeraren RFC1123 ("R", "r")
Den sorterbara formatspecificeraren ("s")
Den universella sorterbara formatspecificeraren ("u")

Formatspecificeraren för fullständigt datum ("f")

Standardformatsspecificeraren "f" representerar en kombination av mönster för långt datum ("D") och kort tid ("t") avgränsade med ett blanksteg.

Resultatsträngen påverkas av formateringsinformationen för en viss kultur.

I följande exempel används formatspecificeraren "f" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Formatspecificeraren för fullständigt datum ("F")

Standardformatsspecificeraren "F" representerar ett anpassat datum- och tidsformat som definieras av en specifik kultur. Till exempel är den anpassade formatsträngen för den invarianta kulturen "dddd, dd MMMM åååå HH:mm:ss".

Resultatsträngen påverkas av formateringsinformationen för en viss kultur.

I följande exempel används formatspecificeraren "F" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Formatspecificeraren för generell kort tid ("g")

Standardformatsspecificeraren "g" representerar en kombination av de korta datummönstren ("d") och kort tid ("t") avgränsade med ett blanksteg. Den resulterande texten påverkas av formateringsinformationen för en viss kultur.

Resultatsträngen påverkas av formateringsinformationen för en viss kultur.

I följande exempel används formatspecificeraren "g" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Formatspecificeraren för allmän datumlång tid ("G")

Standardformatsspecificeraren "G" representerar en kombination av de korta datummönstren ("d") och lång tid ("T") avgränsade med ett blanksteg. Den resulterande texten påverkas av formateringsinformationen för en viss kultur.

Resultatsträngen påverkas av formateringsinformationen för en viss kultur.

I följande exempel används formatspecificeraren "G" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Formatspecificeraren rundresa ("O", "o")

Standardformatsspecificeraren "O" eller "o" representerar en anpassad datum- och tidsformatsträng med ett mönster som bevarar tidszonsinformation och genererar en resultatsträng som uppfyller ISO 8601. För DateTimeZone-värden är den här formatspecificeraren utformad för att bevara värden för datum, tid och tidszon i text.

Standardformatsspecificeraren "O" eller "o" motsvarar "åååå"-'MM'-'dd'T'HH':'mm':'ss'.' fffffffxxx" anpassad formatsträng för DateTimeZone-värden . I den här texten anger paren med enkla citattecken som avgränsar enskilda tecken, till exempel bindestreck, kolon och bokstaven "T", att det enskilda tecknet är en literal som inte kan ändras. Apostrofer visas inte i utdatasträngen.

Standardformatsspecificeraren "O" eller "o" (och "yyyyy'-'MM'-'dd'T'HH':'mm':'ss'.". fffffffxxx" anpassat format) utnyttjar de tre sätt som ISO 8601 representerar tidszonsinformation för att bevara DateTimeZone-värdena :

Tidszonskomponenten i DateTimeZone.ToLocal-datum - och tidsvärden är en förskjutning från UTC (till exempel +01:00, -07:00).
Tidszonskomponenten i DateTimeZone.ToUtc-datum - och tidsvärden använder +00,00 för att representera UTC.

Eftersom standardformatsspecificeraren "O" eller "o" överensstämmer med en internationell standard använder formaterings- eller parsningsåtgärden som använder specificeraren alltid den invarianta kulturen och den gregorianska kalendern.

I följande exempel används formatspecificeraren "o" för att visa en serie DateTimeZone-värden i ett system i us Pacific Time-zonen.

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

Kommentar

Värdet som returneras av DateTimeZone.ToLocal beror på om du kör Power Query på en lokal dator eller online. I exemplet ovan på ett system i tidszonen usa och Stillahavsområdet returnerar -07:00 Power Query Desktop för lokal tid eftersom det läser den tid som angetts på den lokala datorn. Power Query Online returneras +00:00 dock eftersom den läser den tid som angetts på de virtuella molndatorerna, som är inställda på UTC.

I följande exempel används formatspecificeraren "o" för att skapa en formaterad sträng och återställer sedan det ursprungliga datum- och tidsvärdet genom att anropa en datum- och tidsparsningsrutin.

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.

Tillbaka till tabellen

Formatspecificeraren RFC1123 ("R", "r")

Standardformatsspecificeraren "R" eller "r" representerar en anpassad datum- och tidsformatsträng som inte definieras av en specifik kultur. Det är alltid samma sak, oavsett vilken kultur som används eller vilken formatprovider som tillhandahålls. Den anpassade formatsträngen är "ddd, dd MMM yyyyy HH':'mm':'ss 'GMT'". När den här standardformatsspecificeraren används använder formaterings- eller parsningsåtgärden alltid den invarianta kulturen.

Även om RFC 1123-standarden uttrycker en tid som UTC (Coordinated Universal Time) ändrar formateringsåtgärden inte värdet för det datum och den tid som formateras. Därför måste du konvertera DateTime-värdet till UTC genom att anropa funktionsmetoden DateTimeZone.ToUtc innan du utför formateringsåtgärden.

I följande exempel används formatspecificeraren "r" för att visa ett tids- och datumvärde på ett system i tidszonen usa stillahavsområdet (sju timmar efter UTC).

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

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

Tillbaka till tabellen

Den sorterbara formatspecificeraren ("s")

Standardformatsspecificeraren "s" representerar en anpassad datum- och tidsformatsträng som återspeglar en definierad standard (ISO 8601) och är skrivskyddad. Därför är den alltid densamma, oavsett vilken kultur som används eller vilken formatprovider som tillhandahålls. Den anpassade formatsträngen är "åååå'-'MM'-'dd'T'HH':'mm':'ss". Syftet med formatspecificeraren "s" är att skapa resultatsträngar som sorteras konsekvent i stigande eller fallande ordning baserat på datum- och tidsvärden.

När den här standardformatsspecificeraren används använder formaterings- eller parsningsåtgärden alltid den invarianta kulturen.

I följande exempel används formatspecificeraren "s" för att visa ett datum- och tidsvärde på ett system i tidszonen usa och Stillahavsområdet.

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

Tillbaka till tabellen

Den universella sorterbara formatspecificeraren ("u")

Standardformatsspecificeraren "u" representerar en anpassad datum- och tidsformatsträng som alltid är densamma, oavsett vilken kultur som används eller vilken formatprovider som tillhandahålls. Den anpassade formatsträngen är "åååå'-'MM'-'dd HH':'mm':'ss'Z'". Mönstret återspeglar en definierad standard och egenskapen är skrivskyddad. När den här standardformatsspecificeraren används använder formaterings- eller parsningsåtgärden alltid den invarianta kulturen.

Även om resultatsträngen ska uttrycka en tid som Coordinated Universal Time (UTC), utförs ingen konvertering av det ursprungliga DateTimeZone-värdet under formateringsåtgärden. Därför måste du konvertera ett DateTimeZone-värde till UTC genom att anropa funktionen DateTimeZone.ToUtc innan du formaterar det.

I följande exempel används formatspecificeraren "u" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Tidsformat

Den här gruppen innehåller följande format:

Formatspecificeraren för kort tid ("t")
Formatspecificeraren för lång tid ("T")

Formatspecificeraren för kort tid ("t")

Standardformatsspecificeraren "t" representerar en anpassad datum- och tidsformatsträng som definieras av den angivna kulturen. Till exempel är den anpassade formatsträngen för den invarianta kulturen "HH:mm".

Resultatsträngen påverkas av formateringsinformationen för en viss kultur.

I följande exempel används formatspecificeraren "t" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Formatspecificeraren för lång tid ("T")

Standardformatsspecificeraren "T" representerar en anpassad datum- och tidsformatsträng som definieras av den specifika kulturen. Den anpassade formatsträngen för den invarianta kulturen är till exempel "HH:mm:ss".

I följande exempel används formatspecificeraren "T" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Deldatumformat

Den här gruppen innehåller följande format:

Formatspecificeraren för månad ("M", "m")
Formatspecificeraren årsmånad ("Y", "y")

Formatspecificeraren för månad ("M", "m")

Standardformatsspecificeraren "M" eller "m" representerar en anpassad datum- och tidsformatsträng som definieras av den specifika kulturen. Till exempel är den anpassade formatsträngen för den invarianta kulturen "MMMM dd".

I följande exempel används formatspecificeraren "m" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Formatspecificeraren årsmånad ("Y", "y")

Standardformatsspecificeraren "Y" eller "y" representerar en anpassad datumformatsträng som definieras av en specifik kultur. Till exempel är den anpassade formatsträngen för den invarianta kulturen "åååå MMMM".

I följande exempel används formatspecificeraren "y" för att visa ett datum- och tidsvärde.

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

Tillbaka till tabellen

Dela via

Standardformatsträngar för datum och tid

Tabell med formatspecificerare

Så här fungerar standardformatsträngar

Datumformat

Formatspecificeraren för kort datum ("d")

Formatspecificeraren för långt datum ("D")

Datum- och tidsformat

Formatspecificeraren för fullständigt datum ("f")

Formatspecificeraren för fullständigt datum ("F")

Formatspecificeraren för generell kort tid ("g")

Formatspecificeraren för allmän datumlång tid ("G")

Formatspecificeraren rundresa ("O", "o")

Formatspecificeraren RFC1123 ("R", "r")

Den sorterbara formatspecificeraren ("s")

Den universella sorterbara formatspecificeraren ("u")

Tidsformat

Formatspecificeraren för kort tid ("t")

Formatspecificeraren för lång tid ("T")

Deldatumformat

Formatspecificeraren för månad ("M", "m")

Formatspecificeraren årsmånad ("Y", "y")

Feedback

Ytterligare resurser

Dela via

Standardformatsträngar för datum och tid

Tabell med formatspecificerare

Så här fungerar standardformatsträngar

Datumformat

Formatspecificeraren för kort datum ("d")

Formatspecificeraren för långt datum ("D")

Datum- och tidsformat

Formatspecificeraren för fullständigt datum ("f")

Formatspecificeraren för fullständigt datum ("F")

Formatspecificeraren för generell kort tid ("g")

Formatspecificeraren för allmän datumlång tid ("G")

Formatspecificeraren rundresa ("O", "o")

Formatspecificeraren RFC1123 ("R", "r")

Den sorterbara formatspecificeraren ("s")

Den universella sorterbara formatspecificeraren ("u")

Tidsformat

Formatspecificeraren för kort tid ("t")

Formatspecificeraren för lång tid ("T")

Deldatumformat

Formatspecificeraren för månad ("M", "m")

Formatspecificeraren årsmånad ("Y", "y")

Relaterat innehåll

Feedback

Ytterligare resurser