Del via

Standardstrenge til dato- og klokkeslætsformat

  • Artikel

En standardstreng til dato- og klokkeslætsformat bruger et enkelt tegn som formatangivelse til at definere tekstrepræsentationen af en klokkeslæts- og datoværdi. Enhver dato- og klokkeslætsformatstreng, der indeholder mere end ét tegn, herunder blanktegn, fortolkes som en brugerdefineret dato- og klokkeslætsformatstreng. En standardstreng eller en brugerdefineret formatstreng kan bruges til at definere den tekstrepræsentation, der er resultatet af en formateringshandling.

Tabel med formatangivelser

I følgende tabel beskrives standardangivelserne for dato- og klokkeslætsformat.

Formatangivelse Beskrivelse Eksempler
"d" Kort datomønster.

Flere oplysninger: Den korte datoformatangivelse ("d").		 2009-06-15T13:45:30 -> 15/6/2009 (da-US)

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

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D" Langt datomønster.

Flere oplysninger: Den lange datoformatangivelse ("D").		 2009-06-15T13:45:30 -> mandag 15. juni 2009 (da-US)

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

2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f" Mønster for fuld dato/klokkeslæt (kort klokkeslæt).

Flere oplysninger: Den korte klokkeslætsangivelse ("f") for hele datoen.		 2009-06-15T13:45:30 -> mandag 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" Mønster for fuld dato/klokkeslæt (langt klokkeslæt).

Flere oplysninger: Den fulde dato med langt klokkeslætsformat ("F")-formatangivelse.		 2009-06-15T13:45:30 -> mandag 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" Generelt dato-/klokkeslætsmønster (kort klokkeslæt).

Flere oplysninger: Den generelle dato med kort klokkeslætsangivelse ("g").		 2009-06-15T13:45:30 -> 15-06-2009 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" Generelt dato-/klokkeslætsmønster (langt klokkeslæt).

Flere oplysninger: Den generelle dato med langt klokkeslætsformat ("G")-formatangivelse.		 2009-06-15T13:45:30 -> 15-06-2009 13:45:30 (en-US)

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

2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m" Mønster for måned/dag.

Flere oplysninger: Månedsangivelsen ("M", "m")		 2009-06-15T13:45:30 -> 15. juni (da-US)

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

2009-06-15T13:45:30-15> Juni (id-ID)
"O", "o" tur-/dato-/klokkeslætsmønster.

Flere oplysninger: Formatangivelsen for rundtur ("O", "o").		 2009-06-15T13:45:30 (lokal) -> 2009-06-15T13:45:30.00000000-07:00

2009-06-15T13:45:30 (Utc) -> 2009-06-15T13:45:30.00000000+00:00

2009-06-15T13:45:30 (uspecificeret) -> 2009-06-15T13:45:30.000000000
"R", "r" RFC1123 mønster.

Flere oplysninger: Formatangivelsen for RFC1123 ("R", "r").		 2009-06-15T13:45:30 -> Man, 15 juni 2009 13:45:30 GMT
"s" Dato-/klokkeslætsmønster, der kan sorteres.

Flere oplysninger: Sorteringsformatangivelsen ("s").		 2009-06-15T13:45:30 (lokal) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (Utc) -> 2009-06-15T13:45:30
"t" Kort tidsmønster.

Flere oplysninger: Den korte klokkeslætsformatangivelse ("t").		 2009-06-15T13:45:30-13> :45 (da-US)

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

2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T" Langt tidsmønster.

Flere oplysninger: Den lange tid ("T")-formatangivelse.		 2009-06-15T13:45:30-13> :45:30 (da-US)

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

2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u" Universelt sorteringsmønster for dato/klokkeslæt.

Flere oplysninger: Den universelle sorteringstabel ("u") formatangivelse.		 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"Y", "y" Mønster for måned for år.

Flere oplysninger: Formatangivelsen for årets måned ("Y").		 2009-06-15T13:45:30 -> juni 2009 (da-US)

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

2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Et hvilket som helst andet enkelt tegn Ukendt specifikation. Udløser en fejl i kørselsudtrykket.

Sådan fungerer standardformatstrenge

I en formateringshandling er en standardformatstreng blot et alias for en brugerdefineret formatstreng. Fordelen ved at bruge et alias til at referere til en brugerdefineret formatstreng er, at selvom aliasset forbliver invariantt, kan selve den brugerdefinerede formatstreng variere. Dette er vigtigt, fordi strengrepræsentationerne af dato- og klokkeslætsværdier typisk varierer efter kultur. Standardformatstrengen "d" angiver f.eks., at en dato- og klokkeslætsværdi skal vises ved hjælp af et kort datomønster. For den invariante kultur er dette mønster "MM/dd/åååå". For fr-FR-kulturen er det "dd/MM/åååå". For ja-JP-kulturen er det "yyyy/MM/dd".

Hvis en standardformatstreng i en formateringshandling knyttes til en bestemt kulturs brugerdefinerede formatstreng, kan dit program definere den specifikke kultur, hvis brugerdefinerede formatstrenge bruges på en af følgende måder:

  • Du kan bruge standardkulturen (eller den aktuelle). I følgende eksempel vises en dato ved hjælp af den aktuelle kulturs korte datoformat. I dette tilfælde er den aktuelle kultur en-US.

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

  • Du kan overføre en kultur, der bruges til at formatere datoen i henhold til reglerne for den pågældende kultur. I følgende eksempel vises en dato ved hjælp af det korte datoformat for pt-BR-kulturen.

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

I nogle tilfælde fungerer standardformatstrengen som en praktisk forkortelse for en længere brugerdefineret formatstreng, der er invariant. Fire standardformatstrenge falder i denne kategori: "O" (eller "o"), "R" (eller "r"), "s" og "u". Disse strenge svarer til brugerdefinerede formatstrenge, der er defineret af den invariante kultur. De producerer strengrepræsentationer af dato- og klokkeslætsværdier, der er beregnet til at være identiske på tværs af kulturer. Følgende tabel indeholder oplysninger om disse fire standardstrenge til dato- og klokkeslætsformat.

Standardformatstreng Defineret af Brugerdefineret formatstreng
"O" eller "o" Ingen yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" eller "r" IETF RFC 1123-specifikation ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s" ISO 8601 yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u" Kan sorteres, fordi der bruges foranstillede nuller for år, måned, dag, time, minut og sekund yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standardformatstrenge kan også bruges til fortolkningshandlinger, som kræver, at en inputstreng stemmer nøjagtigt overens med et bestemt mønster, for at fortolkningshandlingen kan lykkes. Mange standardformatstrenge knyttes til flere brugerdefinerede formatstrenge, så en dato- og klokkeslætsværdi kan repræsenteres i en række forskellige formater, og fortolkningshandlingen lykkes stadig.

I følgende afsnit beskrives standardformatangivelserne for værdier af typen Date, DateTime, DateTimeZone og Time .

Datoformater

Denne gruppe indeholder følgende formater:

Den korte datoformatangivelse ("d")

Standardformatangivelsen "d" repræsenterer et brugerdefineret datoformat, der er defineret af en bestemt kultur. Den brugerdefinerede formattekst, der returneres af den invariante kultur, er f.eks. "MM/dd/åååå".

I følgende eksempel bruges formatet "d" til at vise en datoværdi.

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

Tilbage til tabel

Den lange datoformat ("D")

Standardformatet "D" repræsenterer et brugerdefineret datoformat, der er defineret af en bestemt kultur. Den brugerdefinerede formatstreng for den invariante kultur er f.eks. "dddd, dd MMMM yyyy".

I følgende eksempel bruges "D"-formatangivelsen til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Dato- og klokkeslætsformater

Denne gruppe indeholder følgende formater:

Den korte klokkeslætsangivelse ("f") for hele datoen

Standardformatangivelsen "f" repræsenterer en kombination af det lange datoformat ("D") og det korte klokkeslætsformat ("t") adskilt af et mellemrum.

Resultatstrengen påvirkes af formateringsoplysningerne for en bestemt kultur.

I følgende eksempel bruges formatet "f" til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Den fulde dato med langt klokkeslætsformat ("F")

Standardformatangivelsen "F" repræsenterer et brugerdefineret dato- og klokkeslætsformat, der er defineret af en bestemt kultur. Den brugerdefinerede formatstreng for den invariante kultur er f.eks. "dddd, dd MMMM yyyy HH:mm:ss".

Resultatstrengen påvirkes af formateringsoplysningerne for en bestemt kultur.

I følgende eksempel bruges "F"-formatangivelsen til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Den generelle dato med kort klokkeslætsformat ("g")

Standardformatet "g" repræsenterer en kombination af mønstrene for korte datoer ("d") og kort klokkeslæt ("t") adskilt af et mellemrum. Den resulterende tekst påvirkes af formateringsoplysningerne for en bestemt kultur.

Resultatstrengen påvirkes af formateringsoplysningerne for en bestemt kultur.

I følgende eksempel bruges formatet "g" til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Den generelle dato med langt klokkeslætsformat ("G")

Standardformatangivelsen "G" repræsenterer en kombination af det korte datoformat ("d") og det lange klokkeslætsformat ("T") adskilt af et mellemrum. Den resulterende tekst påvirkes af formateringsoplysningerne for en bestemt kultur.

Resultatstrengen påvirkes af formateringsoplysningerne for en bestemt kultur.

I følgende eksempel bruges "G"-formatangivelsen til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Returformatet ("O", "o")

Standardformatangivelsen "O" eller "o" repræsenterer en brugerdefineret dato- og klokkeslætsformatstreng ved hjælp af et mønster, der bevarer tidszoneoplysninger og udsender en resultatstreng, der overholder ISO 8601. For DateTimeZone-værdier er denne formatangivelse designet til at bevare dato-, klokkeslæts- og tidszoneværdier i tekst.

Standardformatet "O" eller "o" svarer til "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffxxx" brugerdefineret formatstreng for DateTimeZone-værdier . I denne tekst angiver par med enkelte anførselstegn, der afgrænser individuelle tegn, f.eks. bindestreger, kolon og bogstavet "T", at det enkelte tegn er en konstant, der ikke kan ændres. Apostroffer vises ikke i outputstrengen.

Standardformatet "O" eller "o" (og "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffxxx"-brugerdefineret format) udnytter de måder, ISO 8601 repræsenterer tidszoneoplysninger på, for at bevare de DateTimeZone- værdier:

  • Tidszonekomponenten for DateTimeZone.ToLocal dato- og klokkeslætsværdier er en forskydning fra UTC (f.eks. +01:00, -07:00).

  • Tidszonekomponenten for DateTimeZone.ToUtc dato- og klokkeslætsværdier bruger +00,00 til at repræsentere UTC.

Da standardformatet "O" eller "o" er i overensstemmelse med en international standard, bruger den formaterings- eller fortolkningshandling, der bruger specifikationen, altid den invariante kultur og den gregorianske kalender.

I følgende eksempel bruges formatet "o" til at vise en række DateTimeZone-værdier på et system i tidszonen i det amerikanske Pacific Time zone.

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

Bemærk

Den værdi, der returneres af DateTimeZone.ToLocal, afhænger af, om du kører Power Query på en lokal computer eller online. I eksemplet ovenfor på et system i den amerikanske Pacific Time zone returnerer -07:00 Power Query Desktop f.eks. lokal tid, fordi det læser den tid, der er angivet på din lokale computer. Power Query Online returnerer +00:00 dog, fordi den læser den tid, der er angivet på de virtuelle maskiner i cloudmiljøet, som er indstillet til UTC.

I følgende eksempel bruges formatet "o" til at oprette en formateret streng og gendanner derefter den oprindelige dato- og klokkeslætsværdi ved at kalde en dato- og klokkeslætsparsingrutine.

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.

Tilbage til tabel

Formatangivelsen for RFC1123 ("R", "r")

Standardformatangivelsen "R" eller "r" repræsenterer en brugerdefineret formatstreng for dato og klokkeslæt, der ikke er defineret af en bestemt kultur. Det er altid det samme, uanset hvilken kultur der bruges, eller hvilken formatudbyder der er angivet. Den brugerdefinerede formatstreng er "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Når denne standardformatangivelse bruges, bruger formaterings- eller fortolkningshandlingen altid den invariante kultur.

Selvom RFC 1123-standarden udtrykker et klokkeslæt som UTC (Coordinated Universal Time), ændrer formateringshandlingen ikke værdien af den dato og det klokkeslæt, der formateres. Du skal derfor konvertere værdien DateTime til UTC ved at kalde funktionen DateTimeZone.ToUtc, før du udfører formateringshandlingen.

I følgende eksempel bruges formatet "r" til at vise en klokkeslæts- og datoværdi på et system i den amerikanske Pacific Time-zone (syv timer 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

Tilbage til tabel

Sorteringsformatet ("s")

Standardformatangivelsen "s" repræsenterer en brugerdefineret streng til dato- og klokkeslætsformat, der afspejler en defineret standard (ISO 8601), og som er skrivebeskyttet. Derfor er det altid det samme, uanset hvilken kultur der bruges, eller hvilken formatudbyder der er angivet. Den brugerdefinerede formatstreng er "yyyy'-'MM'-'dd'T'HH':'mm':'ss". Formålet med formatangivelsen "s" er at oprette resultatstrenge, der sorterer konsekvent i stigende eller faldende rækkefølge baseret på dato- og klokkeslætsværdier.

Når denne standardformatangivelse bruges, bruger formaterings- eller fortolkningshandlingen altid den invariante kultur.

I følgende eksempel bruges formatet "s" til at vise en dato- og klokkeslætsværdi på et system i tidszonen for Det Amerikanske Stillehavstidspunkt.

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

Tilbage til tabel

Den universelle sorteringsfunktion ("u")

Standardformatangivelsen "u" repræsenterer en brugerdefineret streng til dato- og klokkeslætsformat, der altid er den samme, uanset hvilken kultur der bruges, eller hvilken formatprovider der er angivet. Den brugerdefinerede formatstreng er "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Mønsteret afspejler en defineret standard, og egenskaben er skrivebeskyttet. Når denne standardformatangivelse bruges, bruger formaterings- eller fortolkningshandlingen altid den invariante kultur.

Selvom resultatstrengen skal udtrykke et klokkeslæt som UTC (Coordinated Universal Time), udføres der ingen konvertering af den oprindelige DateTimeZone-værdi under formateringshandlingen. Derfor skal du konvertere en DateTimeZone- værdi til UTC ved at kalde funktionen DateTimeZone.ToUtc, før du formaterer den.

I følgende eksempel bruges formatet "u" til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Klokkeslætsformater

Denne gruppe indeholder følgende formater:

Kort klokkeslætsformat ("t")

Standardformatangivelsen "t" repræsenterer en brugerdefineret dato- og klokkeslætsformatstreng, der er defineret af den angivne kultur. Den brugerdefinerede formatstreng for den invariante kultur er f.eks. "HH:mm".

Resultatstrengen påvirkes af formateringsoplysningerne for en bestemt kultur.

I følgende eksempel bruges formatet "t" til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Den lange tid ("T")-formatangivelse

Standardformatangivelsen "T" repræsenterer en brugerdefineret streng til dato- og klokkeslætsformat, der er defineret af den specifikke kultur. Den brugerdefinerede formatstreng for den invariante kultur er f.eks. "HH:mm:ss".

I følgende eksempel bruges "T"-formatangivelsen til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Delvise datoformater

Denne gruppe indeholder følgende formater:

Månedsformatet ("M", "m")

Standardformatangivelsen "M" eller "m" repræsenterer en brugerdefineret formatstreng for dato og klokkeslæt, der er defineret af den specifikke kultur. Den brugerdefinerede formatstreng for den invariante kultur er f.eks. "MMMM dd".

I følgende eksempel bruges formatet "m" til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Årstalsangivelsen ("Y", "y")

Standardformatangivelsen "Y" eller "y" repræsenterer en brugerdefineret datoformatstreng, der er defineret af en bestemt kultur. Den brugerdefinerede formatstreng for den invariante kultur er f.eks. "yyyy MMMM".

I følgende eksempel bruges formatet "y" til at vise en dato- og klokkeslætsværdi.

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

Tilbage til tabel

Relateret indhold