Vlastní řetězce formátu data a času

Článek
10/24/2024

Řetězec formátu data a času definuje textovou reprezentaci hodnoty Date, DateTime, DateTimeZone nebo Time , která je výsledkem operace formátování. Může také definovat reprezentaci hodnoty data a času nezbytnou v rámci operace analýzy a úspěšně tak řetězec převést na datum a čas. Řetězec vlastního formátu se skládá z jednoho nebo více vlastních specifikátorů formátu data a času. Jakýkoli řetězec, který není standardním řetězcem formátu data a času, se interpretuje jako vlastní řetězec formátu data a času.

V operacích formátování lze vlastní řetězce formátu data a času použít s ToText metodou data a času a instance časového pásma. Následující příklad ukazuje jeho použití.

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

V operacích analýzy lze vlastní řetězce formátu data a času použít s funkcemi Date, DateTime, Time a DateTimeZone . Tyto funkce vyžadují, aby vstupní řetězec přesně odpovídal určitému vzoru, aby operace analýzy byla úspěšná. Následující příklad znázorňuje volání funkce DateTime.FromText k analýze data, které musí obsahovat měsíc, den a dvouciferný rok.

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.

Následující tabulka popisuje specifikátory vlastního formátu data a času a zobrazuje výsledný řetězec vytvořený specifikátorem jednotlivých formátů. Ve výchozím nastavení odráží výsledný řetězec konvence formátování jazykové verze en-US. Pokud konkrétní specifikátor formátu vytváří lokalizovaný výsledný řetězec, je v příkladu rovněž uvedena jazyková verze, na kterou se výsledný řetězec vztahuje. Další informace o použití vlastních řetězců formátu data a času najdete v části Poznámky .

Specifikátor formátu	Popis	Příklady
"d"	Den v měsíci, od 1 do 31. Další informace: Specifikátor vlastního formátu "d".	2009-06-01T13:45:30 -> 1 2009-06-15T13:45:30 -> 15
"dd"	Den v měsíci, od 01 do 31. Další informace: Specifikátor vlastního formátu "dd".	2009-06-01T13:45:30 -> 01 2009-06-15T13:45:30 -> 15
"ddd"	Zkrácený název dne v týdnu. Další informace: Specifikátor vlastního formátu "ddd".	2009-06-15T13:45:30 -> Mon (en-US) 2009-06-15T13:45:30 -> Пн (ru-RU) 2009-06-15T13:45:30 -> lun. (fr-FR)
"dddd"	Úplný název dne v týdnu. Další informace: Specifikátor vlastního formátu "dddd".	2009-06-15T13:45:30 –> pondělí (en-US) 2009-06-15T13:45:30 -> понедельник (ru-RU) 2009-06-15T13:45:30 -> lundi (fr-FR)
"f"	Desetiny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "f".	2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.05 -> 0
"ff"	Setiny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "ff".	2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> 00
"fff"	Milisekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "fff".	6/15/2009 13:45:30.617 -> 617 6/15/2009 13:45:30.0005 -> 000
"ffff"	Desetitisíciny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "ffff".	2009-06-15T13:45:30.6175000 -> 61755 2009-06-15T13:45:30.0000500 -> 0000
"fffff"	Stotisíciny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "fffff".	2009-06-15T13:45:30.6175400 -> 61754 6/15/2009 13:45:30.000005 -> 000000
"ffffff"	Miliontiny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "ffffff".	2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> 00000000
"fffffff"	Desetimiliontiny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "fffffff".	2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 0001150
"F"	Pokud je hodnota nenulová, jedná se o desetiny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "F".	2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.0500000 -> (bez výstupu)
"FF"	Pokud je hodnota nenulová, jedná se o setiny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "FF".	2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> (bez výstupu)
"FFF"	Pokud je hodnota nenulová, jedná se o milisekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "FFF".	2009-06-15T13:45:30.6170000 -> 617 2009-06-15T13:45:30.0005000 -> (bez výstupu)
"FFFF"	Pokud je hodnota nenulová, jedná se o desetitisíciny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "FFFF".	2009-06-15T13:45:30.5275000 -> 52755 2009-06-15T13:45:30.0000500 -> (bez výstupu)
"FFFFF"	Pokud je hodnota nenulová, jedná se o stotisíciny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "FFFFF".	2009-06-15T13:45:30.6175400 -> 61754 2009-06-15T13:45:30.0000050 -> (bez výstupu)
"FFFFFF"	Pokud je hodnota nenulová, jedná se o miliontiny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "FFFFFF".	2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> (bez výstupu)
"FFFFFFF"	Pokud je hodnota nenulová, jedná se o desetimiliontiny sekundy v hodnotě data a času. Další informace: Specifikátor vlastního formátu "FFFFFFF".	2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 000115
"g", "gg"	Období nebo éra. Další informace: Specifikátor vlastního formátu "g" nebo "gg".	2009-06-15T13:45:30.6170000 -> A.D.
"h"	Hodiny ve 12hodinovém formátu, od 1 do 12. Další informace: Specifikátor vlastního formátu "h".	2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 1
"hh"	Hodiny ve 12hodinovém formátu, od 01 do 12. Další informace: Specifikátor vlastního formátu "hh".	2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 01
"H"	Hodiny ve 24hodinovém formátu, od 0 do 23. Další informace: Specifikátor vlastního formátu "H".	2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 13
"HH"	Hodiny ve 24hodinovém formátu, od 00 do 23. Další informace: Specifikátor vlastního formátu "HH".	2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 13
"K"	Informace o časovém pásmu. Další informace: Specifikátor vlastního formátu "K".	2009-06-15T13:45:30, Nezadané -> 2009-06-15T13:45:30, Utc -> +00:00 2009-06-15T13:45:30, místní –> -07:00 (závisí na nastavení místního nebo cloudového počítače)
"m"	Minuta, od 0 do 59. Další informace: Specifikátor vlastního formátu "m".	2009-06-15T01:09:30 -> 9 2009-06-15T13:29:30 -> 29
"mm"	Minuta, od 00 do 59. Další informace: Specifikátor vlastního formátu "mm".	2009-06-15T01:09:30 -> 09 2009-06-15T01:45:30 -> 45
"M"	Měsíc od 1 do 12. Další informace: Specifikátor vlastního formátu "M".	2009-06-15T13:45:30 -> 6
"MM"	Měsíc od 01 do 12. Další informace: Specifikátor vlastního formátu "MM".	2009-06-15T13:45:30 -> 06
"MMM"	Zkrácený název měsíce. Další informace: Specifikátor vlastního formátu "MMM".	2009-06-15T13:45:30 -> Červen (cs-US) 2009-06-15T13:45:30 -> juin (fr-FR) 2009-06-15T13:45:30 -> Červen (zu-ZA)
"MMMM"	Úplný název měsíce. Další informace: Specifikátor vlastního formátu "MMMM".	2009-06-15T13:45:30 –> červen (cs-CZ) 2009-06-15T13:45:30 -> juni (da-DK) 2009-06-15T13:45:30 -> Juni (zu-ZA)
"s"	Druhý, od 0 do 59. Další informace: Specifikátor vlastního formátu "s".	2009-06-15T13:45:09 -> 9
"ss"	Druhý, od 00 do 59. Další informace: Specifikátor vlastního formátu "ss".	2009-06-15T13:45:09 -> 09
"t"	První znak označení pro dopoledne/odpoledne. Další informace: Specifikátor vlastního formátu "t".	2009-06-15T13:45:30 -> P (en-US) 2009-06-15T13:45:30 -> 午 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR)
"tt"	Označení pro dopoledne/odpoledne. Další informace: Specifikátor vlastního formátu "tt".	2009-06-15T13:45:30 -> PM (en-US) 2009-06-15T13:45:30 -> 午後 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR)
"y"	Rok, od 0 do 99. Další informace: Specifikátor vlastního formátu "y".	0001-01-01T00:00:00 -> 1 0900-01-01T00:00:00 -> 0 1900-01-01T00:00:00 -> 0 2009-06-15T13:45:30 -> 9 2019-06-15T13:45:30 -> 19
"yy"	Rok, od 00 do 99. Další informace: Specifikátor vlastního formátu "yy".	0001-01-01T00:00:00 -> 01 0900-01-01T00:00:00 -> 00 1900-01-01T00:00:00 -> 00 2019-06-15T13:45:30 -> 19
"yyy"	Rok s nejméně třemi číslicemi. Další informace: Specifikátor vlastního formátu "yyy".	0001-01-01T00:00:00 -> 001 0900-01-01T00:00:00 -> 900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009
"yyyy"	Rok jako čtyřmístné číslo. Další informace: Specifikátor vlastního formátu "yyyy".	0001-01-01T00:00:00 -> 0001 0900-01-01T00:00:00 -> 0900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009
"yyyyy"	Rok jako pětimístné číslo. Další informace: Specifikátor vlastního formátu "yyyyy".	0001-01-01T00:00:00 -> 00001 2009-06-15T13:45:30 -> 02009
"z"	Posun hodin od času UTC, bez počátečních nul. Další informace: Specifikátor vlastního formátu "z".	2009-06-15T13:45:30-07:00 -> -7
"zz"	Posun hodin od času UTC, s počáteční nulou pro jednocifernou hodnotu. Další informace: Specifikátor vlastního formátu "zz".	2009-06-15T13:45:30-07:00 -> -07
"zzz"	Posun v hodinách a minutách od času UTC. Další informace: Specifikátor vlastního formátu "zzz".	2009-06-15T13:45:30-07:00 -> -07:00
":"	Oddělovač času. Další informace: Specifikátor vlastního formátu ":".	2009-06-15T13:45:30 -> : (en-US) 2009-06-15T13:45:30 -> . (it-IT) 2009-06-15T13:45:30 -> : (ja-JP)
"/"	Oddělovač data. Další informace: Specifikátor vlastního formátu "/".	2009-06-15T13:45:30 -> / (en-US) 2009-06-15T13:45:30 -> - (ar-DZ) 2009-06-15T13:45:30 -> . (tr-TR)
"string" Řetězec	Oddělovač řetězcového literálu. Další informace: Literály znaků.	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
%	Definuje následující znak jako specifikátor vlastního formátu. Další informace: Použití specifikátorů jednoho vlastního formátu	2009-06-15T13:45:30 (%h) -> 1
\, "", '	Řídicí sekvence. Další informace: Literály znaků a použití řídicích sekvencí	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
Jakýkoli jiný znak	Znak je zkopírován do výsledného řetězce beze změny. Další informace: Literály znaků.	2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

Následující oddíly poskytují další informace o jednotlivých specifikátorech vlastního formátu data a času. Pokud není uvedeno jinak, každý specifikátor vytvoří identickou řetězcovou reprezentaci bez ohledu na to, jestli se používá s hodnotou Date, DateTime, DateTimeZone nebo Time .

Specifikátor formátu "d" dne

Specifikátor vlastního formátu "d"

Specifikátor vlastního formátu "d" představuje den v měsíci jako číslo od 1 do 31. Jednociferné číslo dne je formátováno bez počáteční nuly.

Pokud se specifikátor formátu "d" používá bez jiných specifikátorů vlastního formátu, interpretuje se jako specifikátor standardního formátu data a času "d". Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "d" v několika řetězcích formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "dd"

Řetězec vlastního formátu "dd" představuje den v měsíci jako číslo od 01 do 31. Jednociferné číslo dne je formátováno s počáteční nulou.

Následující příklad obsahuje specifikátor vlastního formátu "dd" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "ddd"

Specifikátor vlastního formátu "ddd" představuje zkrácený název dne v týdnu. Lokalizovaný zkrácený název dne v týdnu se načte z aktuální nebo zadané jazykové verze.

Následující příklad obsahuje specifikátor vlastního formátu "ddd" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "dddd"

Specifikátor vlastního formátu "dddd" (a libovolný počet dalších specifikátorů "d") představuje úplný název dne v týdnu. Lokalizovaný název dne v týdnu se načte z aktuální nebo zadané jazykové verze.

Následující příklad obsahuje specifikátor vlastního formátu "dddd" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor zlomku "f" s malými písmeny

Specifikátor vlastního formátu "f"

Specifikátor vlastního formátu "f" představuje nejvýznamnější číslici zlomku sekund. Představuje tedy desetiny sekundy v hodnotě data a času.

Pokud se specifikátor formátu "f" používá bez jiných specifikátorů formátu, interpretuje se jako specifikátor standardního formátu data a času "f". Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Pokud použijete specifikátory formátu "f" jako součást řetězce formátu zadaného k analýze počtu desetinných sekund, určuje počet specifikátorů formátu "f" počet nejvýznamnějších číslic zlomku sekund, který musí být k úspěšnému parsování řetězce.

Následující příklad obsahuje specifikátor vlastního formátu "f" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "ff"

Specifikátor vlastního formátu "ff" představuje dvě nejvýznamnější číslice zlomku sekund. Představuje tedy setiny sekundy v hodnotě data a času.

Následující příklad obsahuje specifikátor vlastního formátu "ff" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "fff"

Specifikátor vlastního formátu "fff" představuje tři nejvýznamnější číslice zlomku sekund. Představuje tedy milisekundy v hodnotě data a času.

Následující příklad obsahuje specifikátor vlastního formátu "fff" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "ffff"

Specifikátor vlastního formátu "ffff" představuje čtyři nejvýznamnější číslice zlomku sekund. Představuje tedy desetitisíciny sekundy v hodnotě data a času.

I když je možné zobrazit desetitisíce druhé komponenty časové hodnoty, nemusí být tato hodnota smysluplná. Přesnost hodnot data a času závisí na rozlišení systémových hodin. V operačních systémech Windows Server 2019 a Windows 11 je rozlišení hodin přibližně 1 milisekund.

Zpět k tabulce

Specifikátor vlastního formátu "fffff"

Specifikátor vlastního formátu "fffff" představuje pět nejvýznamnějších číslic zlomku sekund. Představuje tedy stotisíciny sekundy v hodnotě data a času.

I když je možné zobrazit stotisítiny druhé komponenty časové hodnoty, nemusí být tato hodnota smysluplná. Přesnost hodnot data a času závisí na rozlišení systémových hodin. V operačních systémech Windows Server 2019 a Windows 11 je rozlišení hodin přibližně 1 milisekund.

Zpět k tabulce

Specifikátor vlastního formátu "ffffff"

Specifikátor vlastního formátu "ffffff" představuje šest nejvýznamnějších číslic zlomku sekund. Představuje tedy miliontiny sekundy v hodnotě data a času.

I když je možné zobrazit milionty druhé komponenty časové hodnoty, nemusí být tato hodnota smysluplná. Přesnost hodnot data a času závisí na rozlišení systémových hodin. V operačních systémech Windows Server 2019 a Windows 11 je rozlišení hodin přibližně 1 milisekund.

Zpět k tabulce

Specifikátor vlastního formátu "fffffff"

Specifikátor vlastního formátu "fffffff" představuje sedm nejvýznamnějších číslic zlomku sekund. Představuje tedy desetimiliontiny sekundy v hodnotě data a času.

I když je možné zobrazit deset milionů sekund druhé komponenty časové hodnoty, nemusí být tato hodnota smysluplná. Přesnost hodnot data a času závisí na rozlišení systémových hodin. V operačních systémech Windows Server 2019 a Windows 11 je rozlišení hodin přibližně 1 milisekund.

Zpět k tabulce

Specifikátor zlomku "F" s velkými písmeny

Specifikátor vlastního formátu "F"

Specifikátor vlastního formátu "F" představuje nejvýznamnější číslici zlomku sekund. Představuje tedy desetiny sekundy v hodnotě data a času. Pokud je číslice nula, nic se nezobrazí a desetinná čárka, která následuje za počtem sekund, se také nezobrazí.

Pokud se specifikátor formátu "F" používá bez jiných specifikátorů formátu, interpretuje se jako specifikátor standardního formátu data a času "F". Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Počet specifikátorů formátu "F" použitých při analýze označuje maximální počet nejvýznamnějších číslic zlomku sekund, které mohou být přítomné k úspěšnému parsování řetězce.

Následující příklad obsahuje specifikátor vlastního formátu "F" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "FF"

Specifikátor vlastního formátu "FF" představuje dvě nejvýznamnější číslice zlomku sekund. Představuje tedy setiny sekundy v hodnotě data a času. Koncové nuly se nezobrazují. Pokud jsou dvě významné číslice nula, nic se nezobrazí a v takovém případě se nezobrazí ani desetinná čárka, která následuje za počtem sekund.

Následující příklad obsahuje specifikátor vlastního formátu "FF" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "FFF"

Specifikátor vlastního formátu "FFF" představuje tři nejvýznamnější číslice zlomku sekund. Představuje tedy milisekundy v hodnotě data a času. Koncové nuly se nezobrazují. Pokud jsou tři významné číslice nula, nic se nezobrazí a v takovém případě se nezobrazí ani desetinná čárka, která následuje za počtem sekund.

Následující příklad obsahuje specifikátor vlastního formátu "FFF" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "FFFF"

Specifikátor vlastního formátu "FFFF" představuje čtyři nejvýznamnější číslice zlomku sekund. Představuje tedy desetitisíciny sekundy v hodnotě data a času. Koncové nuly se nezobrazují. Pokud jsou čtyři platné číslice nula, nic se nezobrazí a v takovém případě se nezobrazí ani desetinná čárka, která následuje za počtem sekund.

Zpět k tabulce

Specifikátor vlastního formátu "FFFFF"

Specifikátor vlastního formátu "FFFFF" představuje pět nejvýznamnějších číslic zlomku sekund. Představuje tedy stotisíciny sekundy v hodnotě data a času. Koncové nuly se nezobrazují. Pokud je pět platných číslic nula, nic se nezobrazí a v takovém případě se nezobrazí ani desetinná čárka, která následuje za počtem sekund.

Zpět k tabulce

Specifikátor vlastního formátu "FFFFFF"

Specifikátor vlastního formátu "FFFFFF" představuje šest nejvýznamnějších číslic zlomku sekund. Představuje tedy miliontiny sekundy v hodnotě data a času. Koncové nuly se nezobrazují. Pokud je šest platných číslic nula, nic se nezobrazí a v takovém případě se nezobrazí ani desetinná čárka, která následuje za počtem sekund.

Zpět k tabulce

Specifikátor vlastního formátu "FFFFFFF"

Specifikátor vlastního formátu "FFFFFFF" představuje sedm nejvýznamnějších číslic zlomku sekund. Představuje tedy desetimiliontiny sekundy v hodnotě data a času. Koncové nuly se nezobrazují. Pokud je sedm platných číslic nula, nic se nezobrazí a v takovém případě se nezobrazí ani desetinná čárka, která následuje za počtem sekund.

Zpět k tabulce

Specifikátor formátu Era "g"

Specifikátor vlastního formátu "g" nebo "gg"

Specifikátory vlastního formátu "g" nebo "gg" (plus libovolný počet dalších specifikátorů "g") představují období nebo období, například A.D. Operace formátování tento specifikátor ignoruje, pokud datum, které má být formátováno, nemá přidružený řetězec období nebo éry.

Pokud se specifikátor formátu "g" používá bez jiných specifikátorů vlastního formátu, interpretuje se jako specifikátor standardního formátu data a času "g". Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "g" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor formátu "h" s malými písmeny

Specifikátor vlastního formátu "h"

Specifikátor vlastního formátu "h" představuje hodinu jako číslo od 1 do 12; to znamená, že hodina je reprezentována 12hodinovými hodinami, které počítají celé hodiny od půlnoci nebo poledne. Konkrétní hodina po půlnoci je nerozeznatelná od stejné hodiny po poledni. Hodina se nezaokrouhlí a jednociferná hodina se naformátuje bez úvodní nuly. Například pro čas 5:43 dopoledne nebo odpoledne tento specifikátor vlastního formátu zobrazí hodnotu "5".

Pokud specifikátor formátu "h" použijete bez dalších specifikátorů vlastního formátu, interpretuje se jako standardní specifikátor formátu data a času a vyvolá chybu výrazu. Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "h" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "hh"

Specifikátor vlastního formátu "hh" (plus libovolný počet dalších specifikátorů "h") představuje hodinu jako číslo od 01 do 12; to znamená, že hodina je reprezentována 12hodinovými hodinami, které počítají celé hodiny od půlnoci nebo poledne. Konkrétní hodina po půlnoci je nerozeznatelná od stejné hodiny po poledni. Hodina se nezaokrouhlí a jednociferná hodina se naformátuje na úvodní nulu. Například pro čas 5:43 dopoledne nebo odpoledne tento specifikátor formátu zobrazí hodnotu "05".

Následující příklad obsahuje specifikátor vlastního formátu "hh" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor formátu "H" velká písmena

Specifikátor vlastního formátu "H"

Specifikátor vlastního formátu "H" představuje hodinu jako číslo od 0 do 23; to znamená, že hodina je reprezentována 24hodinovými hodinami založenými na nule, která počítá hodiny od půlnoci. Jednociferné číslo hodiny je formátováno bez počáteční nuly.

Pokud se specifikátor formátu "H" používá bez jiných specifikátorů vlastního formátu, interpretuje se jako standardní specifikátor formátu data a času a vyvolá chybu výrazu. Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "H" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "HH"

Specifikátor vlastního formátu "HH" (plus libovolný počet dalších specifikátorů "H") představuje hodinu jako číslo od 00 do 23; to znamená, že hodina je reprezentována 24hodinovými hodinami založenými na nule, která počítá hodiny od půlnoci. Jednociferné číslo hodiny je formátováno s počáteční nulou.

Následující příklad obsahuje specifikátor vlastního formátu "HH" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor formátu "K" časového pásma

Specifikátor vlastního formátu "K"

Specifikátor vlastního formátu "K" představuje informace o časovém pásmu hodnoty data a času. Pokud se tento specifikátor formátu používá s hodnotami DateTimeZone , je výsledný řetězec definován takto:

Pro místní časové pásmo tento specifikátor vytvoří výsledný řetězec obsahující místní posun od koordinovaného univerzálního času (UTC), například -07:00, pokud se váš dotaz spustí v Power Query Desktopu. Pokud se váš dotaz spustí v Power Query Online, výsledný řetězec nevygeneruje žádný posun od času UTC, tj. +00:00.
V případě času UTC nevygeneruje výsledný řetězec žádný posun od času UTC; to znamená, že "+00:00 představuje datum UTC.
Po dobu z neurčeného časového pásma je výsledek prázdný.

Pokud se specifikátor formátu "K" používá bez jiných specifikátorů vlastního formátu, interpretuje se jako standardní specifikátor formátu data a času a vyvolá chybu výrazu. Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad zobrazí řetězec, který je výsledkem použití specifikátoru vlastního formátu "K" s různými hodnotami v systému v americkém časovém pásmu Tichomoří.

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

Poznámka:

Hodnota vrácená DateTimeZone.LocalNow závisí na tom, jestli používáte Power Query na místním počítači nebo online. Například ve výše uvedeném příkladu v systému v americkém časovém pásmu Tichomoří Vrátí -07:00 Power Query Desktop, protože čte čas nastavený na místním počítači. Power Query Online ale vrátí +00:00 , protože čte čas nastavený na cloudových virtuálních počítačích, které jsou nastavené na UTC.

Zpět k tabulce

Specifikátor formátu minute "m"

Specifikátor vlastního formátu "m"

Specifikátor vlastního formátu "m" představuje minutu jako číslo od 0 do 59. Minuta představuje celé minuty, které uplynuly od poslední hodiny. Jednociferné číslo minuty je formátováno bez počáteční nuly.

Pokud specifikátor formátu "m" použijete bez jiných specifikátorů vlastního formátu, interpretuje se jako specifikátor standardního formátu data a času "m". Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "m" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "mm"

Specifikátor vlastního formátu "mm" (plus libovolný počet dalších specifikátorů "m") představuje minutu jako číslo od 00 do 59. Minuta představuje celé minuty, které uplynuly od poslední hodiny. Jednociferné číslo minut je formátováno s počáteční nulou.

Následující příklad obsahuje specifikátor vlastního formátu "mm" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor formátu "M" měsíce

Specifikátor vlastního formátu "M"

Specifikátor vlastního formátu "M" představuje měsíc jako číslo od 1 do 12 (nebo od 1 do 13 pro kalendáře, které mají 13 měsíců). Jednociferné číslo měsíce je formátováno bez počáteční nuly.

Pokud se specifikátor formátu "M" používá bez jiných specifikátorů vlastního formátu, interpretuje se jako specifikátor standardního formátu data a času "M". Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "M" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "MM"

Specifikátor vlastního formátu "MM" představuje měsíc jako číslo od 01 do 12 (nebo od 1 do 13 pro kalendáře, které mají 13 měsíců). Jednociferné číslo měsíce je formátováno s počáteční nulou.

Následující příklad obsahuje specifikátor vlastního formátu "MM" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "MMM"

Specifikátor vlastního formátu "MMM" představuje zkrácený název měsíce. Lokalizovaný zkrácený název měsíce se načte z zkrácených názvů měsíců aktuální nebo zadané jazykové verze. Pokud v řetězci vlastního formátu existuje specifikátor vlastního formátu "d" nebo "dd", název měsíce se načte z zkrácených názvů genitivů.

Následující příklad obsahuje specifikátor vlastního formátu "MMM" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "MMMM"

Specifikátor vlastního formátu "MMMM" představuje úplný název měsíce. Lokalizovaný název měsíce se načte z aktuální nebo zadané jazykové verze. Pokud v řetězci vlastního formátu existuje specifikátor vlastního formátu "d" nebo "dd", název měsíce se načte z zkrácených názvů genitivů.

Následující příklad obsahuje specifikátor vlastního formátu "MMMM" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor formátu sekund "s"

Specifikátor vlastního formátu "s"

Specifikátor vlastního formátu "s" představuje sekundy jako číslo od 0 do 59. Výsledek představuje celé sekundy, které uplynuly od poslední minuty. Jednociferné číslo sekundy je formátováno bez počáteční nuly.

Pokud se specifikátor formátu "s" používá bez jiných specifikátorů vlastního formátu, interpretuje se jako specifikátor standardního formátu data a času "s". Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "s" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "ss"

Specifikátor vlastního formátu "ss" (plus libovolný počet dalších specifikátorů "s") představuje sekundy jako číslo od 00 do 59. Výsledek představuje celé sekundy, které uplynuly od poslední minuty. Jednociferné číslo sekundy je formátováno s počáteční nulou.

Následující příklad obsahuje specifikátor vlastního formátu "ss" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor formátu Meridiem "t"

Specifikátor vlastního formátu "t"

Specifikátor vlastního formátu "t" představuje první znak označení dopoledne/odpoledne. Odpovídající lokalizovaný designátor se načte z aktuální nebo konkrétní jazykové verze. Označení dopoledne (AM) se používá pro všechny hodnoty času od 0:00:00 (půlnoc) do 11:59:59.999. Označení odpoledne (PM) se používá pro všechny hodnoty času od 12:00:00 (poledne) do 23:59:59.999.

Pokud specifikátor formátu "t" použijete bez jiných specifikátorů vlastního formátu, interpretuje se jako specifikátor standardního formátu data a času "t". Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "t" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor vlastního formátu "tt"

Specifikátor vlastního formátu "tt" (plus libovolný počet dalších specifikátorů "t") představuje celé označení dopoledne/odpoledne. Odpovídající lokalizovaný designátor se načte z aktuální nebo konkrétní jazykové verze. Označení dopoledne (AM) se používá pro všechny hodnoty času od 0:00:00 (půlnoc) do 11:59:59.999. Označení odpoledne (PM) se používá pro všechny hodnoty času od 12:00:00 (poledne) do 23:59:59.999.

Nezapomeňte použít specifikátor "tt" pro jazyky, pro které je nutné zachovat rozlišení mezi AM a PM. Pro ukázku je uvedena japonština, pro kterou se liší určení dopoledne a odpoledne (AM a PM) v druhém znaku namísto prvního znaku.

Následující příklad obsahuje specifikátor vlastního formátu "tt" v řetězci vlastního formátu.

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

Zpět k tabulce

Specifikátor formátu "y" roku

Specifikátor vlastního formátu "y"

Specifikátor vlastního formátu "y" představuje rok jako jednociferné nebo dvouciferné číslo. Pokud rok obsahuje více než dvě číslice, zobrazí se ve výsledku pouze dvě číslice nižšího řádu. Pokud první číslice dvoumístného čísla roku začíná nulou (například 2008), je číslo formátováno bez počáteční nuly.

Pokud specifikátor formátu "y" použijete bez jiných specifikátorů vlastního formátu, interpretuje se jako specifikátor standardního formátu data a času "y". Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "y" v řetězci vlastního formátu.

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

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

Zpět k tabulce

Specifikátor vlastního formátu "yy"

Specifikátor vlastního formátu "yy" představuje rok jako dvouciferné číslo. Pokud rok obsahuje více než dvě číslice, zobrazí se ve výsledku pouze dvě číslice nižšího řádu. Pokud má dvoumístný rok méně než dvě platné číslice, je číslo doplněno počátečními nulami za účelem vytvoření dvouciferného čísla.

V operaci analýzy se na základě aktuálního kalendáře zprostředkovatele formátu interpretuje dvouciferný rok, který se analyzuje pomocí specifikátoru vlastního formátu yyy. Následující příklad analyzuje řetězcovou reprezentaci data s rokem vyjádřeným dvěma číslicemi pomocí výchozího gregoriánského kalendáře jazykové verze en_US, což v tomto případě představuje aktuální jazykovou verzi. Hodnoty vrácené pro čtyřciferné datum závisí na rozsahu 100 roků nastaveným operačním systémem.

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

Následující příklad obsahuje specifikátor vlastního formátu "yy" v řetězci vlastního formátu.

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

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

Zpět k tabulce

Specifikátor vlastního formátu "yyy"

Specifikátor vlastního formátu "yyy" představuje rok nejméně se třemi číslicemi. Pokud rok obsahuje více než tři platné číslice, budou obsaženy ve výsledném řetězci. Pokud má rok méně než tři číslice, je číslo doplněno počátečními nulami tak, aby bylo vytvořeno trojciferné číslo.

Poznámka:

Pro thajský buddhistický kalendář, který může mít pět číslic roku, zobrazí tento specifikátor formátu všechny platné číslice.

Následující příklad obsahuje specifikátor vlastního formátu "yyy" v řetězci vlastního formátu.

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

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

Zpět k tabulce

Specifikátor vlastního formátu "yyyy"

Specifikátor vlastního formátu "yyyy" představuje rok nejméně se čtyřmi číslicemi. Pokud rok obsahuje více než čtyři platné číslice, budou obsaženy ve výsledném řetězci. Pokud má rok méně než čtyři číslice, je číslo doplněno počátečními nulami tak, aby bylo vytvořeno čtyřciferné číslo.

Poznámka:

Pro thajský buddhistický kalendář, který může mít pět číslic roku, zobrazí tento specifikátor formátu minimálně čtyři číslice.

Následující příklad obsahuje specifikátor vlastního formátu "yyyy" v řetězci vlastního formátu.

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

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

Zpět k tabulce

Specifikátor vlastního formátu "yyyyy"

Specifikátor vlastního formátu "yyyyy" (plus libovolný počet dalších specifikátorů "y") představuje rok nejméně s pěti číslicemi. Pokud rok obsahuje více než pět platných číslic, budou obsaženy ve výsledném řetězci. Pokud má rok méně než pět číslic, je číslo doplněno počátečními nulami tak, aby bylo vytvořeno pěticiferné číslo.

Pokud existují další specifikátory "y", je číslo doplněno tolika počátečními nulami, kolik je třeba pro vytvoření čísla podle specifikátorů "y".

Následující příklad obsahuje specifikátor vlastního formátu "yyyyy" v řetězci vlastního formátu.

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

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

Zpět k tabulce

Specifikátor formátu posunu "z"

Specifikátor vlastního formátu "z"

U hodnot DateTimeZone specifikátor vlastního formátu "z" představuje podepsaný posun zadaného časového pásma od koordinovaného univerzálního času (UTC) měřeného v hodinách. Posun je vždy zobrazen s počátečním znaménkem. Znaménko plus (+) označuje hodiny před časem UTC a symbol mínus (-) označuje hodiny za časem UTC. Jednociferné odsazení je formátováno bez úvodní nuly.

Následující tabulka ukazuje, jak se hodnota posunu mění v závislosti na funkci DateTimeZone .

Hodnota DateTimeZone	Hodnota posunu
DateTimeZone.LocalNow	V Power Query Desktopu je podepsaný posun časového pásma místního operačního systému z UTC. V Power Query Online vrátí hodnotu `+00`.
DateTimeZone.UtcNow	Vrací objekt `+0`.

Pokud se specifikátor formátu "z" používá bez jiných specifikátorů vlastního formátu, interpretuje se jako standardní specifikátor formátu data a času a vyvolá chybu výrazu. Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Následující příklad obsahuje specifikátor vlastního formátu "z" v řetězci vlastního formátu v systému v americkém časovém pásmu Tichomoří.

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

Poznámka:

Hodnota vrácená DateTimeZone.LocalNow závisí na tom, jestli používáte Power Query na místním počítači nebo online. Například ve výše uvedeném příkladu v systému v americkém časovém pásmu Tichomoří Vrátí {0:-7} Power Query Desktop, protože čte čas nastavený na místním počítači. Power Query Online ale vrátí {0:+0} , protože čte čas nastavený na cloudových virtuálních počítačích, které jsou nastavené na UTC.

Zpět k tabulce

Specifikátor vlastního formátu "zz"

S hodnotami DateTimeZone specifikátor vlastního formátu "zz" představuje podepsaný posun zadaného časového pásma z UTC měřeného v hodinách. Posun je vždy zobrazen s počátečním znaménkem. Znaménko plus (+) označuje hodiny před časem UTC a symbol mínus (-) označuje hodiny za časem UTC. Jednociferný posun je formátován počáteční nulou.

Následující tabulka ukazuje, jak se hodnota posunu mění v závislosti na funkci DateTimeZone .

Hodnota DateTimeZone	Hodnota posunu
DateTimeZone.LocalNow	V Power Query Desktopu je podepsaný posun časového pásma místního operačního systému z UTC. V Power Query Online vrátí hodnotu `+00`.
DateTimeZone.UtcNow	Vrací objekt `+00`.

Následující příklad obsahuje specifikátor vlastního formátu "zz" v řetězci vlastního formátu v systému v americkém časovém pásmu Tichomoří.

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

Poznámka:

Hodnota vrácená DateTimeZone.LocalNow závisí na tom, jestli používáte Power Query na místním počítači nebo online. Například ve výše uvedeném příkladu v systému v americkém časovém pásmu Tichomoří Vrátí {0:-07} Power Query Desktop, protože čte čas nastavený na místním počítači. Power Query Online ale vrátí {0:+00} , protože čte čas nastavený na cloudových virtuálních počítačích, které jsou nastavené na UTC.

Zpět k tabulce

Specifikátor vlastního formátu "zzz"

U hodnot DateTimeZone specifikátor vlastního formátu "zzz" představuje podepsaný posun zadaného časového pásma z UTC měřený v hodinách a minutách. Posun je vždy zobrazen s počátečním znaménkem. Znaménko plus (+) označuje hodiny před časem UTC a symbol mínus (-) označuje hodiny za časem UTC. Jednociferné číslo posunu je formátováno s počáteční nulou.

Následující tabulka ukazuje, jak se hodnota posunu mění v závislosti na funkci DateTimeZone .

Hodnota DateTimeZoneValue	Hodnota posunu
DateTimeZone.LocalNow	V Power Query Desktopu je podepsaný posun časového pásma místního operačního systému z UTC. V Power Query Online vrátí hodnotu `+00`.
DateTimeZone.UtcNow	Vrací objekt `+00:00`.

Následující příklad obsahuje specifikátor vlastního formátu "zzz" v řetězci vlastního formátu v systému v americkém časovém pásmu Tichomoří.

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

Poznámka:

Hodnota vrácená DateTimeZone.LocalNow závisí na tom, jestli používáte Power Query na místním počítači nebo online. Například ve výše uvedeném příkladu v systému v americkém časovém pásmu Tichomoří Vrátí {0:-07:00} Power Query Desktop, protože čte čas nastavený na místním počítači. Power Query Online ale vrátí {0:+00:00} , protože čte čas nastavený na cloudových virtuálních počítačích, které jsou nastavené na UTC.

Zpět k tabulce

Specifikátory oddělovače data a času

Specifikátor vlastního formátu ":"

Specifikátor vlastního formátu ":" představuje oddělovač času, který se používá k rozlišení hodin, minut a sekund. Odpovídající lokalizovaný oddělovač času se načte z aktuální nebo zadané jazykové verze.

Poznámka:

Pokud chcete změnit oddělovač času pro určitý řetězec data a času, zadejte znak oddělovače v řetězci literálu. Například řetězec hh_dd_ss vlastního formátu vytvoří výsledný řetězec, ve kterém se jako oddělovač času vždy používá "_" (podtržítko).

Pokud se specifikátor formátu ":" používá bez jiných specifikátorů vlastního formátu, interpretuje se jako standardní specifikátor formátu data a času a vyvolá chybu výrazu. Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Zpět k tabulce

Specifikátor vlastního formátu "/"

Specifikátor vlastního formátu "/" představuje oddělovač dat, který se používá k rozlišení roků, měsíců a dnů. Odpovídající lokalizovaný oddělovač kalendářních dat se načte z aktuální nebo zadané jazykové verze.

Poznámka:

Pokud chcete změnit oddělovač kalendářních dat pro určitý řetězec data a času, zadejte znak oddělovače v řetězci literálu. Například řetězec mm/dd/yyyy vlastního formátu vytvoří výsledný řetězec, ve kterém se jako oddělovač kalendářních dat vždy použije znak /.

Pokud se specifikátor formátu "/" používá bez jiných specifikátorů vlastního formátu, interpretuje se jako standardní specifikátor formátu data a času a vyvolá chybu výrazu. Další informace o použití specifikátoru jednoho formátu najdete v části Použití specifikátorů jednoduchého vlastního formátu dále v tomto článku.

Zpět k tabulce

Literály znaků

Následující znaky ve vlastním řetězci formátu data a času jsou vyhrazeny a vždy jsou interpretovány jako formátovací znaky, nebo v případě ", , '/a \, jako speciální znaky.

Všechny ostatní znaky jsou vždy interpretovány jako literály znaků a ve operaci formátování jsou zahrnuty do výsledného řetězce beze změny. V operaci analýzy musí přesně odpovídat znakům ve vstupním řetězci; porovnání se rozlišují malá a velká písmena.

Následující příklad obsahuje literální znaky PST (pro Tichomoří standardní čas) a PDT (pro Tichomoří letní čas), které představují místní časové pásmo v řetězci formátu. Všimněte si, že řetězec je součástí výsledného řetězce a že řetězec, který obsahuje řetězec místního časového pásma, se také úspěšně parsuje.

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

Existují dva způsoby, jak označit, že se znaky mají interpretovat jako literální znaky, nikoli jako rezervované znaky, aby je bylo možné zahrnout do výsledného řetězce nebo úspěšně analyzovat ve vstupním řetězci:

Po zapouzdření každého rezervovaného znaku. Další informace najdete v části Použití řídicích sekvencí.

Následující příklad obsahuje literály "pst" (pro Tichomoří standardní čas), které představují místní časové pásmo v řetězci formátu. Vzhledem k tomu, že "s" i "t" jsou řetězce vlastního formátu, musí být oba znaky interpretovány jako literály znaků.

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

Uzavřením celého literálového řetězce do apostrofů. Následující příklad je podobný předchozímu, s tím rozdílem, že "pst" je uzavřen v apostrofech, aby bylo možné označit, že celý řetězec s oddělovači by měl být interpretován jako literály znaků.

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

Notes

Použití specifikátorů s jedním vlastním formátem

Řetězec vlastního formátu data a času se skládá ze dvou nebo několika znaků. Metody formátování data a času interpretují jakýkoli řetězec s jediným znakem jako řetězec standardního formátu data a času. Pokud znak nerozpozná jako platný specifikátor formátu, vyvolá chybu výrazu. Například řetězec formátu, který se skládá pouze ze specifikátoru "h", je interpretován jako řetězec standardního formátu data a času. V tomto konkrétním případě je však vyvolán výjimka, protože neexistuje specifikátor standardního formátu data a času "h".

Chcete-li použít kterýkoli ze specifikátorů vlastního formátu data a času jako jediný specifikátor v řetězci formátu (to znamená, že chcete použít samotné specifikátory formátu "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" nebo "/"), vložte před nebo za specifikátor mezeru, nebo vložte před jednoduchý specifikátor vlastního formátu specifikátor formátu procento %.

Například "%h" se interpretuje jako vlastní řetězec formátu data a času, který zobrazuje hodinu reprezentovanou aktuální hodnotou data a času. Můžete také použít řetězec formátu " h" nebo "h ", ačkoli tato hodnota vloží ve výsledném řetězci vedle hodin mezeru. Následující příklad znázorňuje tyto tři řetězce formátu.

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 '

Použití řídicích sekvencí

Znaky "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", nebo "/" v řetězci formátu jsou interpretovány jako specifikátory vlastního formátu, nikoli jako literální znaky.

Pokud chcete zabránit interpretaci znaku jako specifikátoru formátu, můžete:

Před ním zadejte zpětné lomítko.
Obklopte ho jednou uvozovkou.
Obklopte ho dvěma dvojitými uvozovkami.

Každý z těchto znaků funguje jako řídicí sekvence. Řídicí sekvence označuje, že následující znak nebo ohraničený znak je textový literál, který by měl být zahrnut do výsledného řetězce beze změny.

Pokud chcete do výsledného řetězce zahrnout dvojitou uvozovku, musíte utéct jinou dvojitou uvozovkou ("").

Následující příklad používá různé řídicí sekvence, aby zabránila operaci formátování interpretovat znaky "h" a "m" jako specifikátory formátu.

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

Sdílet prostřednictvím

Vlastní řetězce formátu data a času

Specifikátor formátu "d" dne

Specifikátor vlastního formátu "d"

Specifikátor vlastního formátu "dd"

Specifikátor vlastního formátu "ddd"

Specifikátor vlastního formátu "dddd"

Specifikátor zlomku "f" s malými písmeny

Specifikátor vlastního formátu "f"

Specifikátor vlastního formátu "ff"

Specifikátor vlastního formátu "fff"

Specifikátor vlastního formátu "ffff"

Specifikátor vlastního formátu "fffff"

Specifikátor vlastního formátu "ffffff"

Specifikátor vlastního formátu "fffffff"

Specifikátor zlomku "F" s velkými písmeny

Specifikátor vlastního formátu "F"

Specifikátor vlastního formátu "FF"

Specifikátor vlastního formátu "FFF"

Specifikátor vlastního formátu "FFFF"

Specifikátor vlastního formátu "FFFFF"

Specifikátor vlastního formátu "FFFFFF"

Specifikátor vlastního formátu "FFFFFFF"

Specifikátor formátu Era "g"

Specifikátor vlastního formátu "g" nebo "gg"

Specifikátor formátu "h" s malými písmeny

Specifikátor vlastního formátu "h"

Specifikátor vlastního formátu "hh"

Specifikátor formátu "H" velká písmena

Specifikátor vlastního formátu "H"

Specifikátor vlastního formátu "HH"

Specifikátor formátu "K" časového pásma

Specifikátor vlastního formátu "K"

Specifikátor formátu minute "m"

Specifikátor vlastního formátu "m"

Specifikátor vlastního formátu "mm"

Specifikátor formátu "M" měsíce

Specifikátor vlastního formátu "M"

Specifikátor vlastního formátu "MM"

Specifikátor vlastního formátu "MMM"

Specifikátor vlastního formátu "MMMM"

Specifikátor formátu sekund "s"

Specifikátor vlastního formátu "s"

Specifikátor vlastního formátu "ss"

Specifikátor formátu Meridiem "t"

Specifikátor vlastního formátu "t"

Specifikátor vlastního formátu "tt"

Specifikátor formátu "y" roku

Specifikátor vlastního formátu "y"

Specifikátor vlastního formátu "yy"

Specifikátor vlastního formátu "yyy"

Specifikátor vlastního formátu "yyyy"

Specifikátor vlastního formátu "yyyyy"

Specifikátor formátu posunu "z"

Specifikátor vlastního formátu "z"

Specifikátor vlastního formátu "zz"

Specifikátor vlastního formátu "zzz"

Specifikátory oddělovače data a času

Specifikátor vlastního formátu ":"

Specifikátor vlastního formátu "/"

Literály znaků

Notes

Použití specifikátorů s jedním vlastním formátem

Použití řídicích sekvencí

Související obsah

Váš názor

Další materiály