Dela via

Anpassade formatsträngar för datum och tid

  • Artikel

En datum- och tidsformatsträng definierar textrepresentationen av ett datum-, DateTime-, DateTimeZone- eller tidsvärde som är resultatet av en formateringsåtgärd. Den kan också definiera representationen av ett datum- och tidsvärde som krävs i en parsningsåtgärd för att konvertera strängen till ett datum och en tid. En anpassad formatsträng består av en eller flera anpassade datum- och tidsformatsspecificerare. Alla strängar som inte är en standardformatsträng för datum och tid tolkas som en anpassad datum- och tidsformatsträng.

I formateringsåtgärder kan anpassade datum- och tidsformatsträngar användas med ToText metoden för en datum- och tids- och tidszonsinstans. I följande exempel visas hur det används.

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

I parsningsåtgärder kan anpassade datum- och tidsformatsträngar användas med funktionerna Date, DateTime, Time och DateTimeZone . Dessa funktioner kräver att en indatasträng överensstämmer exakt med ett visst mönster för att parsningsåtgärden ska lyckas. I följande exempel visas ett anrop till funktionen DateTime.FromText för att parsa ett datum som måste innehålla en månad, en dag och ett tvåsiffrigt år.

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.

I följande tabell beskrivs de anpassade datum- och tidsformatsspecificerarna och en resultatsträng som skapas av varje formatspecificerare. Som standard återspeglar resultatsträngarna formateringskonventionerna för en-US-kulturen. Om en viss formatspecificerare skapar en lokaliserad resultatsträng, noterar exemplet även den kultur som resultatsträngen gäller för. Mer information om hur du använder anpassade datum- och tidsformatsträngar finns i avsnittet Anteckningar .

Formatspecificerare beskrivning Exempel
"d" Dagen i månaden, från 1 till 31.

Mer information: Den anpassade formatspecificeraren "d".		 2009-06-01T13:45:30 -> 1

2009-06-15T13:45:30 -> 15
"dd" Dagen i månaden, från 01 till 31.

Mer information: Den anpassade formatspecificeraren "dd".		 2009-06-01T13:45:30 -> 01

2009-06-15T13:45:30 -> 15
"ddd" Det förkortade namnet på veckodagen.

Mer information: Den anpassade formatspecificeraren "ddd".		 2009-06-15T13:45:30 –> mån (en-US)

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

2009-06-15T13:45:30 -> lun. (fr-FR)
"ddddd" Det fullständiga namnet på veckodagen.

Mer information: Den anpassade formatspecificeraren "dddd".		 2009-06-15T13:45:30 -> måndag (en-US)

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

2009-06-15T13:45:30 -> lundi (fr-FR)
"f" Tiondelar av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "f".		 2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.05 -> 0
"ff" Hundradelar av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "ff".		 2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> 00
"fff" Millisekunderna i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "fff".		 2009-06-15 13:45:30.617 -> 617

2009-06-15 13:45:30.0005-000>
"ffffff" De tio tusendelarna av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "ffff".		 2009-06-15T13:45:30.6175000 -> 6175

2009-06-15T13:45:30.0000500 -> 0000
"fffff" Hundratusendelar av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "fffff".		 2009-06-15T13:45:30.6175400 -> 61754

2009-06-15 13:45:30.000005 -> 00000
"ffffffff" Miljondelar av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "ffffff".		 2009-06-15T13:45:30.6175420 –> 617542

2009-06-15T13:45:30.0000005 -> 000000
"fffffff" De tio miljonerdelarna av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "fffffff".		 2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 –> 0001150
"F" Om inte noll, tiondelar av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "F".		 2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.05000000 -> (inga utdata)
"FF" Om det inte är noll, hundradelar av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren för "FF".		 2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> (inga utdata)
"FFF" Om det inte är noll anges millisekunderna i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "FFF".		 2009-06-15T13:45:30.6170000 -> 617

2009-06-15T13:45:30.0005000 -> (inga utdata)
"FFFF" Om det inte är noll är det tio tusendelar av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "FFFF".		 2009-06-15T13:45:30.5275000 -> 5275

2009-06-15T13:45:30.0000500 -> (inga utdata)
"FFFFF" Om inte noll, hundra tusendelar av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "FFFFF".		 2009-06-15T13:45:30.6175400 -> 61754

2009-06-15T13:45:30.0000050 –> (inga utdata)
"FFFFFF" Om inte noll, miljondelar av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "FFFFFF".		 2009-06-15T13:45:30.6175420 –> 617542

2009-06-15T13:45:30.0000005 –> (inga utdata)
"FFFFFFF" Om det inte är noll, de tio miljoner av en sekund i ett datum- och tidsvärde.

Mer information: Den anpassade formatspecificeraren "FFFFFFF".		 2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 –> 000115
"g", "gg" Perioden eller eran.

Mer information: Den anpassade formatspecificeraren "g" eller "gg".		 2009-06-15T13:45:30.6170000 -> A.D.
"h" Timmen, med en 12-timmarsklocka från 1 till 12.

Mer information: Den anpassade formatspecificeraren "h".		 2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 1
"hh" Timmen, med en 12-timmarsklocka från 01 till 12.

Mer information: Den anpassade formatspecificeraren "hh".		 2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 01
"H" Timmen, med en 24-timmarsklocka från 0 till 23.

Mer information: Den anpassade formatspecificeraren "H".		 2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 13
"HH" Timmen, med en 24-timmarsklocka från 00 till 23.

Mer information: Den anpassade formatspecificeraren "HH".		 2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 13
"K" Information om tidszon.

Mer information: Den anpassade formatspecificeraren "K".		 2009-06-15T13:45:30, ospecificerad ->

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

2009-06-15T13:45:30, Lokal –> -07:00 (beror på lokala inställningar eller inställningar för molndatorer)
"m" Minuten, från 0 till 59.

Mer information: Den anpassade formatspecificeraren "m".		 2009-06-15T01:09:30 -> 9

2009-06-15T13:29:30 -> 29
"mm" Minuten, från 00 till 59.

Mer information: Den anpassade formatspecificeraren "mm".		 2009-06-15T01:09:30 -> 09

2009-06-15T01:45:30 -> 45
"M" Månaden, från 1 till 12.

Mer information: Den anpassade formatspecificeraren "M".		 2009-06-15T13:45:30 -> 6
"MM" Månaden, från 01 till 12.

Mer information: Den anpassade formatspecificeraren "MM".		 2009-06-15T13:45:30 -> 06
"MMM" Månadens förkortade namn.

Mer information: Den anpassade formatspecificeraren "MMM".		 2009-06-15T13:45:30 -> Jun (en-US)

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

2009-06-15T13:45:30 -> Jun (zu-ZA)
"MMMM" Månadens fullständiga namn.

Mer information: Den anpassade formatspecificeraren "MMMM".		 2009-06-15T13:45:30 -> Juni (en-US)

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

2009-06-15T13:45:30 -> Juni (zu-ZA)
"s" Den andra, från 0 till 59.

Mer information: Den anpassade formatspecificeraren "s".		 2009-06-15T13:45:09 -> 9
"ss" Den andra, från 00 till 59.

Mer information: Den anpassade formatspecificeraren för "ss".		 2009-06-15T13:45:09 -> 09
"t" Det första tecknet i AM/PM-designatorn.

Mer information: Den anpassade formatspecificeraren "t".		 2009-06-15T13:45:30 -> P (en-US)

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

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

Mer information: Den anpassade formatspecificeraren "tt".		 2009-06-15T13:45:30 -> PM (en-US)

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

2009-06-15T13:45:30 -> (fr-FR)
"y" Året, från 0 till 99.

Mer information: Den anpassade formatspecificeraren "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
"yyy" Året, från 00 till 99.

Mer information: Den anpassade formatspecificeraren "y".		 0001-01-01T00:00:00 -> 01

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

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

2019-06-15T13:45:30 -> 19
"yyyy" Året med minst tre siffror.

Mer information: Den "åååå" anpassade formatspecificeraren.		 0001-01-01T00:00:00 -> 001

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

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

2009-06-15T13:45:30 -> 2009
"yyyyy" Året som ett fyrsiffrigt tal.

Mer information: Den anpassade formatspecificeraren "åååå".		 0001-01-01T00:00:00 -> 0001

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

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

2009-06-15T13:45:30 -> 2009
"yyyyyy" Året som ett femsiffrigt tal.

Mer information: Den anpassade formatspecificeraren "ååååå".		 0001-01-01T00:00:00 -> 00001

2009-06-15T13:45:30 -> 02009
"z" Timförskjutning från UTC, utan inledande nollor.

Mer information: Den anpassade formatspecificeraren "z".		 2009-06-15T13:45:30-07:00 -> -7
"zz" Timförskjutning från UTC, med inledande nolla för ett ensiffrigt värde.

Mer information: Den anpassade formatspecificeraren "zz".		 2009-06-15T13:45:30-07:00 -> -07
"zzz" Förskjutning av timmar och minuter från UTC.

Mer information: Den anpassade formatspecificeraren "zzz".		 2009-06-15T13:45:30-07:00 -> -07:00
":" Tidsavgränsaren.

Mer information: Den ":"anpassade formatspecificeraren.		 2009-06-15T13:45:30 -> : (en-US)

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

2009-06-15T13:45:30 -> : (ja-JP)
"/" Datumavgränsaren.

Mer information: Den anpassade formatspecificeraren "/".		 2009-06-15T13:45:30 -> / (en-US)

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

2009-06-15T13:45:30 -> . (tr-TR)
"sträng"

"sträng"		 Literal sträng avgränsare.

Mer information: Teckenliteraler.		 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
% Definierar följande tecken som en anpassad formatspecificerare.

Mer information: Använda enskilda anpassade formatspecificerare.		 2009-06-15T13:45:30 (%h) -> 1
\, "", ' Escape-sekvenserna.

Mer information: Teckenliteraler och Använda escape-sekvenserna.		 2009-06-15T13:45:30 (h \h) -> 1 h

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

2009-06-15T13:45:30 (h 'h') -> 1 h
Alla andra tecken Tecknet kopieras till resultatsträngen oförändrad.

Mer information: Teckenliteraler.		 2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

Följande avsnitt innehåller ytterligare information om varje anpassad datum- och tidsformatsspecificerare. Om inget annat anges skapar varje specificerare en identisk strängrepresentation oavsett om den används med ett datum-, DateTime-, DateTimeZone- eller tidsvärde.

Formatspecificerare för dag "d"

Den anpassade formatspecificeraren "d"

Den anpassade formatspecificeraren d representerar dagen i månaden som ett tal från 1 till 31. En ensiffrig dag formateras utan inledande nolla.

Om formatspecificeraren "d" används utan andra anpassade formatspecificerare tolkas det som standardformatsspecificeraren "d". Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatspecificeraren "d" i flera formatsträngar.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "dd"

Den anpassade dd-formatsträngen representerar dagen i månaden som ett tal från 01 till 31. En ensiffrig dag formateras med inledande nolla.

I följande exempel ingår den anpassade formatspecificeraren "dd" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "ddd"

Den anpassade formatspecificeraren "ddd" representerar det förkortade namnet på veckodagen. Det lokaliserade förkortade namnet på veckodagen hämtas från den aktuella eller angivna kulturen.

I följande exempel ingår den anpassade formatspecificeraren "ddd" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "dddd"

Den anpassade formatspecificeraren "dddd" (plus valfritt antal ytterligare "d"-specificerare) representerar det fullständiga namnet på veckodagen. Det lokaliserade namnet på veckodagen hämtas från den aktuella eller angivna kulturen.

I följande exempel ingår den anpassade formatspecificeraren "dddd" i en anpassad formatsträng.

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

Tillbaka till tabellen

Bråkspecificerare för gemena sekunder

Den anpassade formatspecificeraren "f"

Den anpassade formatspecificeraren "f" representerar den viktigaste siffran i sekundfraktionen. Det innebär att den representerar tiondelar av en sekund i ett datum- och tidsvärde.

Om formatspecificeraren "f" används utan andra formatspecificerare tolkas den som standardformatsspecificeraren "f". Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

När du använder "f"-formatspecificerare som en del av en formatsträng som tillhandahålls för att parsa antalet bråksekunder anger antalet "f"-formatspecificerare antalet signifikanta siffror i sekundfraktionen som måste finnas för att parsa strängen.

I följande exempel ingår den anpassade formatspecificeraren "f" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "ff"

Den anpassade formatspecificeraren "ff" representerar de två viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar hundradelarna av en sekund i ett datum- och tidsvärde.

i följande exempel ingår den anpassade formatspecificeraren "ff" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "fff"

Den anpassade formatspecificeraren "fff" representerar de tre viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar millisekunderna i ett datum- och tidsvärde.

I följande exempel ingår den anpassade formatspecificeraren "fff" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "ffff"

Den anpassade formatspecificeraren "ffff" representerar de fyra viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar de tio tusendelarna av en sekund i ett datum- och tidsvärde.

Även om det är möjligt att visa de tio tusendelarna av en andra komponent i ett tidsvärde kanske det värdet inte är meningsfullt. Precisionen för datum- och tidsvärden beror på systemklockans upplösning. På operativsystemen Windows Server 2019 och Windows 11 är klockans upplösning cirka 1 millisekunder.

Tillbaka till tabellen

Den anpassade formatspecificeraren "fffff"

Den anpassade formatspecificeraren "fffff" representerar de fem viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar hundra tusendelar av en sekund i ett datum- och tidsvärde.

Även om det är möjligt att visa hundra tusendelar av en andra komponent i ett tidsvärde kanske det värdet inte är meningsfullt. Precisionen för datum- och tidsvärden beror på systemklockans upplösning. På operativsystemen Windows Server 2019 och Windows 11 är klockans upplösning cirka 1 millisekunder.

Tillbaka till tabellen

Den anpassade formatspecificeraren "ffffff"

Den anpassade formatspecificeraren "ffffff" representerar de sex viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar miljondelarna av en sekund i ett datum- och tidsvärde.

Även om det är möjligt att visa miljondelarna av en andra komponent i ett tidsvärde kanske det värdet inte är meningsfullt. Precisionen för datum- och tidsvärden beror på systemklockans upplösning. På operativsystemen Windows Server 2019 och Windows 11 är klockans upplösning cirka 1 millisekunder.

Tillbaka till tabellen

Den anpassade formatspecificeraren "fffffff"

Den anpassade formatspecificeraren fffffff representerar de sju viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar de tio miljonerdelarna av en sekund i ett datum- och tidsvärde.

Även om det är möjligt att visa de tio miljonerdelarna av en andra komponent i ett tidsvärde kanske det värdet inte är meningsfullt. Precisionen för datum- och tidsvärden beror på systemklockans upplösning. På operativsystemen Windows Server 2019 och Windows 11 är klockans upplösning cirka 1 millisekunder.

Tillbaka till tabellen

Bråkspecificerare för versaler

Den anpassade formatspecificeraren "F"

Den anpassade formatspecificeraren "F" representerar den viktigaste siffran i sekundfraktionen. Det innebär att den representerar tiondelar av en sekund i ett datum- och tidsvärde. Ingenting visas om siffran är noll, och decimaltecknet som följer antalet sekunder visas inte heller.

Om formatspecificeraren "F" används utan andra formatspecificerare tolkas den som standardformatsspecificeraren "F". Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

Antalet "F"-formatsspecificerare som används vid parsning anger det maximala antalet signifikanta siffror i sekundfraktionen som kan finnas för att parsa strängen.

I följande exempel ingår den anpassade formatspecificeraren "F" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren för "FF"

Den anpassade formatspecificeraren "FF" representerar de två viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar hundradelarna av en sekund i ett datum- och tidsvärde. Avslutande nollor visas inte. Ingenting visas om de två signifikanta siffrorna är noll, och i så fall visas inte heller decimaltecknet som följer antalet sekunder.

I följande exempel ingår den anpassade formatspecificeraren "FF" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "FFF"

Den anpassade FFF-formatsspecificeraren representerar de tre viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar millisekunderna i ett datum- och tidsvärde. Avslutande nollor visas inte. Ingenting visas om de tre signifikanta siffrorna är noll, och i så fall visas inte heller decimaltecknet som följer antalet sekunder.

I följande exempel ingår den anpassade formatspecificeraren "FFF" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren för "FFFF"

Den anpassade formatspecificeraren "FFFF" representerar de fyra viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar de tio tusendelarna av en sekund i ett datum- och tidsvärde. Avslutande nollor visas inte. Ingenting visas om de fyra signifikanta siffrorna är noll, och i så fall visas inte heller decimaltecknet som följer antalet sekunder.

Även om det är möjligt att visa de tio tusendelarna av en andra komponent i ett tidsvärde kanske det värdet inte är meningsfullt. Precisionen för datum- och tidsvärden beror på systemklockans upplösning. På operativsystemen Windows Server 2019 och Windows 11 är klockans upplösning cirka 1 millisekunder.

Tillbaka till tabellen

Den anpassade formatspecificeraren "FFFFF"

Den anpassade FFFFF-formatsspecificeraren representerar de fem viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar hundra tusendelar av en sekund i ett datum- och tidsvärde. Avslutande nollor visas inte. Ingenting visas om de fem signifikanta siffrorna är noll, och i så fall visas inte heller decimaltecknet som följer antalet sekunder.

Även om det är möjligt att visa hundra tusendelar av en andra komponent i ett tidsvärde kanske det värdet inte är meningsfullt. Precisionen för datum- och tidsvärden beror på systemklockans upplösning. På operativsystemen Windows Server 2019 och Windows 11 är klockans upplösning cirka 1 millisekunder.

Tillbaka till tabellen

Den anpassade formatspecificeraren "FFFFFF"

Den anpassade formatspecificeraren "FFFFFF" representerar de sex viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar miljondelarna av en sekund i ett datum- och tidsvärde. Avslutande nollor visas inte. Ingenting visas om de sex signifikanta siffrorna är noll, och i så fall visas inte heller decimaltecknet som följer antalet sekunder.

Även om det är möjligt att visa miljondelarna av en andra komponent i ett tidsvärde kanske det värdet inte är meningsfullt. Precisionen för datum- och tidsvärden beror på systemklockans upplösning. På operativsystemen Windows Server 2019 och Windows 11 är klockans upplösning cirka 1 millisekunder.

Tillbaka till tabellen

Den anpassade formatspecificeraren "FFFFFFF"

Den anpassade formatspecificeraren "FFFFFFF" representerar de sju viktigaste siffrorna i sekundfraktionen. Det innebär att den representerar de tio miljonerdelarna av en sekund i ett datum- och tidsvärde. Avslutande nollor visas inte. Ingenting visas om de sju signifikanta siffrorna är noll, och i så fall visas inte heller decimaltecknet som följer antalet sekunder.

Även om det är möjligt att visa de tio miljonerdelarna av en andra komponent i ett tidsvärde kanske det värdet inte är meningsfullt. Precisionen för datum- och tidsvärden beror på systemklockans upplösning. På operativsystemen Windows Server 2019 och Windows 11 är klockans upplösning cirka 1 millisekunder.

Tillbaka till tabellen

Formatspecificerare för era "g"

Den anpassade formatspecificeraren "g" eller "gg"

De anpassade formatspecificerarna "g" eller "gg" (plus valfritt antal ytterligare "g"-specificerare) representerar perioden eller eran, till exempel A.D. Formateringsåtgärden ignorerar den här specificeraren om datumet som ska formateras inte har någon associerad period- eller erasträng.

Om "g"-formatspecificeraren används utan andra anpassade formatspecificerare tolkas den som standardformatsspecificeraren "g". Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatspecificeraren "g" i en anpassad formatsträng.

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

Tillbaka till tabellen

Formatspecificerare för gemener i timmen "h"

Den anpassade formatspecificeraren "h"

Den anpassade formatspecificeraren "h" representerar timmen som ett tal mellan 1 och 12. Det innebär att timmen representeras av en 12-timmarsklocka som räknar hela timmarna sedan midnatt eller 12:00. En viss timme efter midnatt kan inte skiljas från samma timme efter 12.00. Timmen avrundas inte och en ensiffrig timme formateras utan inledande nolla. Till exempel, med en tid på 5:43 på morgonen eller eftermiddagen, visar den här anpassade formatspecificeraren "5".

Om formatspecificeraren "h" används utan andra anpassade formatspecificerare tolkas den som en standardformatsspecificerare för datum och tid och utlöser ett uttrycksfel. Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatspecificeraren "h" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "hh"

Den anpassade formatspecificeraren "hh" (plus valfritt antal ytterligare "h"-specificerare) representerar timmen som ett tal från 01 till 12. Det innebär att timmen representeras av en 12-timmarsklocka som räknar hela timmarna sedan midnatt eller 12:00. En viss timme efter midnatt kan inte skiljas från samma timme efter 12.00. Timmen avrundas inte och en ensiffrig timme formateras med inledande nolla. Till exempel, med en tid på 5:43 på morgonen eller eftermiddagen, visar den här formatspecificeraren "05".

I följande exempel ingår den anpassade formatspecificeraren "hh" i en anpassad formatsträng.

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

Tillbaka till tabellen

Formatspecificerare för versaltimmen "H"

Den anpassade formatspecificeraren "H"

Den anpassade formatspecificeraren "H" representerar timmen som ett tal från 0 till 23. Det innebär att timmen representeras av en nollbaserad 24-timmarsklocka som räknar timmarna sedan midnatt. En ensiffrig timme formateras utan inledande nolla.

Om formatspecificeraren "H" används utan andra anpassade formatspecificerare tolkas den som en standardformatsspecificerare för datum och tid och utlöser ett uttrycksfel. Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatspecificeraren "H" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "HH"

Den anpassade formatspecificeraren "HH" (plus valfritt antal ytterligare "H"-specificerare) representerar timmen som ett tal från 00 till 23. Det innebär att timmen representeras av en nollbaserad 24-timmarsklocka som räknar timmarna sedan midnatt. En ensiffrig timme formateras med inledande nolla.

I följande exempel ingår den anpassade formatspecificeraren "HH" i en anpassad formatsträng.

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

Tillbaka till tabellen

Formatspecificerare för tidszon "K"

Den anpassade formatspecificeraren "K"

Den anpassade formatspecificeraren K representerar tidszonsinformationen för ett datum- och tidsvärde. När den här formatspecificeraren används med DateTimeZone-värden definieras resultatsträngen som:

  • För den lokala tidszonen genererar den här specificeraren en resultatsträng som innehåller den lokala förskjutningen från Coordinated Universal Time (UTC), till exempel "-07:00", om frågan körs i Power Query Desktop. Om frågan körs i Power Query Online genererar resultatsträngen ingen förskjutning från UTC-tid, dvs. "+00:00".

  • Under en UTC-tid genererar resultatsträngen ingen förskjutning från UTC-tid. d.v.s. "+00:00 för att representera ett UTC-datum.

  • Under en tid från en ospecificerad tidszon är resultatet tomt.

Om formatspecificeraren "K" används utan andra anpassade formatspecificerare tolkas den som en standardformatsspecificerare för datum och tid och utlöser ett uttrycksfel. Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel visas strängen som är resultatet av att använda den anpassade formatspecificeraren "K" med olika värden i ett system i tidszonen för Stillahavsområdet i USA.

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

Kommentar

Värdet som returneras av DateTimeZone.LocalNow beror på om du kör Power Query på en lokal dator eller online. I exemplet ovan på ett system i tidszonen usa stillahavsområdet returnerar -07:00 Power Query Desktop 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.

Tillbaka till tabellen

Minutformatsspecificerare för "m"

Den anpassade formatspecificeraren "m"

Den anpassade formatspecificeraren m representerar minuten som ett tal från 0 till 59. Minuten representerar hela minuter som har passerat sedan den senaste timmen. En ensiffrig minut formateras utan inledande nolla.

Om formatspecificeraren "m" används utan andra anpassade formatspecificerare tolkas det som standardformatsspecificeraren "m". Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatspecificeraren "m" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "mm"

Den anpassade formatspecificeraren "mm" (plus valfritt antal ytterligare "m"-specificerare) representerar minuten som ett tal från 00 till 59. Minuten representerar hela minuter som har passerat sedan den senaste timmen. En ensiffrig minut formateras med inledande nolla.

I följande exempel ingår den anpassade formatspecificeraren "mm" i en anpassad formatsträng.

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

Tillbaka till tabellen

Month "M"-formatspecificerare

Den anpassade formatspecificeraren "M"

Den anpassade formatspecificeraren "M" representerar månaden som ett tal från 1 till 12 (eller från 1 till 13 för kalendrar som har 13 månader). En ensiffrig månad formateras utan inledande nolla.

Om formatspecificeraren "M" används utan andra anpassade formatspecificerare tolkas det som standardformatsspecificeraren "M". Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatspecificeraren "M" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "MM"

Den anpassade formatspecificeraren "MM" representerar månaden som ett tal från 01 till 12 (eller från 1 till 13 för kalendrar som har 13 månader). En ensiffrig månad formateras med inledande nolla.

I följande exempel ingår den anpassade formatspecificeraren "MM" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "MMM"

Den anpassade formatspecificeraren "MMM" representerar månadens förkortade namn. Det lokaliserade förkortade namnet på månaden hämtas från de förkortade månadsnamnen för den aktuella eller angivna kulturen. Om det finns en anpassad formatspecificerare för "d" eller "dd" i den anpassade formatsträngen hämtas månadsnamnet från de förkortade genitive namnen i stället.

I följande exempel ingår den anpassade formatspecificeraren "MMM" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "MMMM"

Den anpassade formatspecificeraren "MMMM" representerar månadens fullständiga namn. Månadens lokaliserade namn hämtas från den aktuella eller angivna kulturen. Om det finns en anpassad formatspecificerare för "d" eller "dd" i den anpassade formatsträngen hämtas månadsnamnet från de förkortade genitive namnen i stället.

I följande exempel ingår den anpassade formatspecificeraren "MMMM" i en anpassad formatsträng.

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

Tillbaka till tabellen

Sekundformatsspecificerare

Den anpassade formatspecificeraren "s"

Den anpassade formatspecificeraren "s" representerar sekunderna som ett tal från 0 till 59. Resultatet representerar hela sekunder som har passerat sedan den senaste minuten. En ensiffrig sekund formateras utan inledande nolla.

Om formatspecificeraren "s" används utan andra anpassade formatspecificerare tolkas det som standardformatsspecificeraren för "s". Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatspecificeraren "s" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "ss"

Den anpassade formatspecificeraren för "ss" (plus valfritt antal ytterligare "s"-specificerare) representerar sekunderna som ett tal från 00 till 59. Resultatet representerar hela sekunder som har passerat sedan den senaste minuten. En ensiffrig sekund formateras med inledande nolla.

I följande exempel ingår den anpassade formatspecificeraren "ss" i en anpassad formatsträng.

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

Tillbaka till tabellen

Formatspecificerare för Meridiem "t"

Den anpassade formatspecificeraren "t"

Den anpassade formatspecificeraren "t" representerar det första tecknet i AM/PM-designatorn. Lämplig lokaliserad designator hämtas från den aktuella eller specifika kulturen. AM-designatorn används för alla tider från 0:00:00 (midnatt) till 11:59:59.999. PM-designatorn används för alla tider från 12:00:00 (12:00) till 23:59:59.999.

Om formatspecificeraren "t" används utan andra anpassade formatspecificerare tolkas det som standardformatsspecificeraren "t". Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatspecificeraren "t" i en anpassad formatsträng.

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "tt"

Den anpassade formatspecificeraren "tt" (plus valfritt antal ytterligare "t"-specificerare) representerar hela AM/PM-designatorn. Lämplig lokaliserad designator hämtas från den aktuella eller specifika kulturen. AM-designatorn används för alla tider från 0:00:00 (midnatt) till 11:59:59.999. PM-designatorn används för alla tider från 12:00:00 (12:00) till 23:59:59.999.

Se till att använda "tt"-specificeraren för språk för vilka det är nödvändigt att upprätthålla skillnaden mellan AM och PM. Ett exempel är japanska, där AM- och PM-designern skiljer sig åt i det andra tecknet i stället för det första tecknet.

I följande exempel ingår den anpassade formatspecificeraren "tt" i en anpassad formatsträng.

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

Tillbaka till tabellen

Formatspecificerare för år "y"

Den anpassade formatspecificeraren "y"

Den anpassade formatspecificeraren "y" representerar året som ett ensiffrigt eller tvåsiffrigt tal. Om året har fler än två siffror visas endast de två lågordningssiffrorna i resultatet. Om den första siffran för ett tvåsiffrigt år börjar med en nolla (till exempel 2008) formateras talet utan inledande nolla.

Om formatspecificeraren "y" används utan andra anpassade formatspecificerare tolkas det som standardformatsspecificeraren "y". Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatspecificeraren "y" i en anpassad formatsträng.

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

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "yyy"

Den anpassade formatspecificeraren "yy" representerar året som ett tvåsiffrigt tal. Om året har fler än två siffror visas endast de två lågordningssiffrorna i resultatet. Om det tvåsiffriga året har färre än två signifikanta siffror, är talet vadderat med inledande nollor för att producera två siffror.

I en parsningsåtgärd tolkas ett tvåsiffrigt år som parsas med den anpassade formatspecificeraren "yy" baserat på formatproviderns aktuella kalender. I följande exempel parsas strängrepresentationen av ett datum som har ett tvåsiffrigt år med hjälp av den gregorianska standardkalendern för en-US-kulturen, som i det här fallet är den aktuella kulturen. De värden som returneras för det fyrsiffriga datumet beror på operativsystemets 100-årsintervall.

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

I följande exempel ingår den anpassade formatspecificeraren "yy" i en anpassad formatsträng.

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

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "ååå"

Den anpassade formatspecificeraren "ååå" representerar året med minst tre siffror. Om året har fler än tre signifikanta siffror inkluderas de i resultatsträngen. Om året har färre än tre siffror, är talet vadderat med inledande nollor för att producera tre siffror.

Kommentar

För den thailändska buddistiska kalendern, som kan ha femsiffriga år, visar den här formatspecificeraren alla betydande siffror.

I följande exempel ingår den anpassade formatspecificeraren "ååå" i en anpassad formatsträng.

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

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "åååå"

Den anpassade formatspecificeraren "åååå" representerar året med minst fyra siffror. Om året har fler än fyra signifikanta siffror inkluderas de i resultatsträngen. Om året har färre än fyra siffror, är talet vadderat med inledande nollor för att producera fyra siffror.

Kommentar

För den thailändska buddistiska kalendern, som kan ha femsiffriga år, visar den här formatspecificeraren minst fyra siffror.

I följande exempel ingår den anpassade formatspecificeraren "åååå" i en anpassad formatsträng.

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

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "ååååå"

Den anpassade formatspecificeraren "åå" (plus valfritt antal ytterligare "y"-specificerare) representerar året med minst fem siffror. Om året har fler än fem signifikanta siffror inkluderas de i resultatsträngen. Om året har färre än fem siffror är talet vadderat med inledande nollor för att producera fem siffror.

Om det finns ytterligare "y"-specificerare, vadderas talet med så många inledande nollor som behövs för att generera antalet "y"-specificerare.

I följande exempel ingår den anpassade formatspecificeraren "åååå" i en anpassad formatsträng.

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

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

Tillbaka till tabellen

Offset "z"-formatspecificerare

Den anpassade formatspecificeraren "z"

Med DateTimeZone-värden representerar den anpassade formatspecificeraren "z" den signerade förskjutningen för den angivna tidszonen från Coordinated Universal Time (UTC), mätt i timmar. Förskjutningen visas alltid med ett inledande tecken. Ett plustecken (+) anger timmar före UTC och ett minustecken (-) anger timmar bakom UTC. En ensiffrig förskjutning formateras utan inledande nolla.

Följande tabell visar hur förskjutningsvärdet ändras beroende på funktionen DateTimeZone .

DateTimeZone-värde Förskjutningsvärde
DateTimeZone.LocalNow På Power Query Desktop är den signerade förskjutningen av det lokala operativsystemets tidszon från UTC. I Power Query Online returnerar .+00
DateTimeZone.UtcNow Returnerar +0.

Om formatspecificeraren "z" används utan andra anpassade formatspecificerare tolkas den som en standardformatsspecificerare för datum och tid och utlöser ett uttrycksfel. Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

I följande exempel ingår den anpassade formatsspecificeraren "z" i en anpassad formatsträng i ett system i tidszonen US Pacific.

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

Kommentar

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "zz"

Med DateTimeZone-värden representerar den anpassade formatspecificeraren "zz" den signerade förskjutningen för den angivna tidszonen från UTC, mätt i timmar. Förskjutningen visas alltid med ett inledande tecken. Ett plustecken (+) anger timmar före UTC och ett minustecken (-) anger timmar bakom UTC. En ensiffrig förskjutning formateras med inledande nolla.

Följande tabell visar hur förskjutningsvärdet ändras beroende på funktionen DateTimeZone .

DateTimeZone-värde Förskjutningsvärde
DateTimeZone.LocalNow På Power Query Desktop är den signerade förskjutningen av det lokala operativsystemets tidszon från UTC. I Power Query Online returnerar .+00
DateTimeZone.UtcNow Returnerar +00.

I följande exempel ingår den anpassade formatspecificeraren "zz" i en anpassad formatsträng i ett system i tidszonen USA stillahavsområdet.

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

Kommentar

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

Tillbaka till tabellen

Den anpassade formatspecificeraren "zzz"

Med DateTimeZone-värden representerar den anpassade formatspecificeraren "zzz" den signerade förskjutningen av den angivna tidszonen från UTC, mätt i timmar och minuter. Förskjutningen visas alltid med ett inledande tecken. Ett plustecken (+) anger timmar före UTC och ett minustecken (-) anger timmar bakom UTC. En ensiffrig förskjutning formateras med inledande nolla.

Följande tabell visar hur förskjutningsvärdet ändras beroende på funktionen DateTimeZone .

DateTimeZoneValue-värde Förskjutningsvärde
DateTimeZone.LocalNow På Power Query Desktop är den signerade förskjutningen av det lokala operativsystemets tidszon från UTC. I Power Query Online returnerar .+00
DateTimeZone.UtcNow Returnerar +00:00.

I följande exempel ingår den anpassade formatsspecificeraren "zzz" i en anpassad formatsträng i ett system i tidszonen usa stillahavsområdet.

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

Kommentar

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

Tillbaka till tabellen

Datum- och tidsavgränsare

Den ":"anpassade formatspecificeraren

Den ":" anpassade formatspecificeraren representerar tidsavgränsaren, som används för att särskilja timmar, minuter och sekunder. Lämplig lokaliserad tidsavgränsare hämtas från den aktuella eller angivna kulturen.

Kommentar

Om du vill ändra tidsavgränsaren för en viss datum- och tidssträng anger du avgränsarens tecken i en literalsträngavgränsare. Den anpassade formatsträngen hh_dd_ss skapar till exempel en resultatsträng där "_" (ett understreck) alltid används som tidsavgränsare.

Om formatspecificeraren ":"används utan andra anpassade formatspecificerare tolkas den som en standardformatsspecificerare för datum och tid och utlöser ett uttrycksfel. Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

Tillbaka till tabellen

Den anpassade formatspecificeraren "/"

Den anpassade formatspecificeraren "/" representerar datumavgränsaren, som används för att särskilja år, månader och dagar. Lämplig lokaliserad datumavgränsare hämtas från den aktuella eller angivna kulturen.

Kommentar

Om du vill ändra datumavgränsaren för en viss datum- och tidssträng anger du avgränsarens tecken i en literalsträngavgränsare. Den anpassade formatsträngen mm/dd/yyyy genererar till exempel en resultatsträng där "/" alltid används som datumavgränsare.

Om formatspecificeraren "/" används utan andra anpassade formatspecificerare tolkas den som en standard date and time-formatspecificerare och utlöser ett uttrycksfel. Mer information om hur du använder en enskild formatspecificerare finns i Använda enskilda anpassade formatspecificerare senare i den här artikeln.

Tillbaka till tabellen

Teckenliteraler

Följande tecken i en anpassad datum- och tidsformatsträng är reserverade och tolkas alltid som formateringstecken "eller, när det gäller , ', /och \, som specialtecken.

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

Alla andra tecken tolkas alltid som teckenliteraler och ingår i resultatsträngen oförändrad i en formateringsåtgärd. I en parsningsåtgärd måste de matcha tecknen i indatasträngen exakt. jämförelsen är skiftlägeskänslig.

I följande exempel ingår de literala tecknen "PST" (för Pacific Standard Time) och "PDT" (för Pacific Daylight Time) för att representera den lokala tidszonen i en formatsträng. Observera att strängen ingår i resultatsträngen och att en sträng som innehåller den lokala tidszonssträngen också parsar korrekt.

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

Det finns två sätt att indikera att tecken ska tolkas som literaltecken och inte som reserverade tecken, så att de kan inkluderas i en resultatsträng eller parsas i en indatasträng:

  • Genom att ta bort varje reserverat tecken. Mer information finns i Använda escape-sekvenserna.

    I följande exempel ingår de literala tecknen "pst" (för Pacific Standard-tid) för att representera den lokala tidszonen i en formatsträng. Eftersom både "s" och "t" är anpassade formatsträngar måste båda tecknen inte tolkas som teckenliteraler.

    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

  • Genom att omsluta hela literalsträngen i apostrofer. Följande exempel liknar det föregående, förutom att "pst" omges av apostrofer för att indikera att hela den avgränsade strängen ska tolkas som teckenliteraler.

    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

Kommentar

Använda enstaka anpassade formatspecificerare

En anpassad datum- och tidsformatsträng består av två eller flera tecken. Formateringsmetoder för datum och tid tolkar valfri sträng med ett tecken som en standardsträng för datum- och tidsformat. Om de inte känner igen tecknet som en giltig formatspecificerare utlöser de ett uttrycksfel. Till exempel tolkas en formatsträng som endast består av specificeraren "h" som en standardsträng för datum- och tidsformat. I det här fallet utlöses dock ett undantag eftersom det inte finns någon "h" standardformatsspecificerare för datum och tid.

Om du vill använda någon av de anpassade datum- och tidsformatsspecificerarna som den enda specificeraren i en formatsträng (det vill om du vill använda formatspecificeraren "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", eller "/" egen formatspecificerare), inkludera ett blanksteg före eller efter specificeraren, eller inkludera en procentformatsspecificerare (%).

Till exempel tolkas "%h" som en anpassad datum- och tidsformatsträng som visar den timme som representeras av det aktuella datum- och tidsvärdet. Du kan också använda formatsträngen " h" eller "h ", även om detta innehåller ett blanksteg i resultatsträngen tillsammans med timmen. I följande exempel visas dessa tre formatsträngar.

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 '

Använda escape-sekvenserna

Tecknen "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", eller "/" i en formatsträng tolkas som anpassade formatspecificerare snarare än som literaltecken.

Om du vill förhindra att ett tecken tolkas som en formatspecificerare kan du:

  • Föregå med ett omvänt snedstreck.
  • Omge den med ett enda citattecken.
  • Omge den med två dubbla citattecken.

Vart och ett av dessa tecken fungerar som en escape-sekvens. Escape-sekvensen betyder att följande tecken eller omgivna tecken är en textliteral som ska inkluderas i resultatsträngen oförändrad.

Om du vill inkludera ett dubbelt citattecken i en resultatsträng måste du undvika det med ett annat dubbelt citattecken ("").

I följande exempel används olika escape-sekvenser för att förhindra att formateringsåtgärden tolkar tecknen "h" och "m" som formatspecificerare.

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

Relaterat innehåll