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

Článek
10/24/2024

Standardní řetězec formátu data a času používá jako specifikátor formátu jeden znak k definování textové reprezentace hodnoty času a data. Jakýkoli řetězec formátu data a času, který obsahuje více než jeden znak včetně prázdných znaků, se interpretuje jako vlastní řetězec formátu data a času. Standardní nebo vlastní formátovací řetězec lze použít k definování textové reprezentace, která je výsledkem operace formátování.

Tabulka specifikátorů formátu

Následující tabulka popisuje standardní specifikátory formátu data a času.

Specifikátor formátu	Popis	Příklady
"d"	Vzor krátkého formátu data. Další informace: Specifikátor formátu krátkého data ("d").	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Vzor dlouhého formátu data. Další informace: Specifikátor formátu dlouhého data ("D").	2009-06-15T13:45:30 –> pondělí 15. června 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Vzor úplného formátu data/času (krátkého formátu času). Další informace: Specifikátor formátu full date short time ("f")	2009-06-15T13:45:30 –> pondělí 15. června 2009 13:45 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Vzor úplného formátu data/času (dlouhého formátu času). Další informace: Specifikátor formátu full date long time ("F")	2009-06-15T13:45:30 –> pondělí 15. června 2009 13:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Vzor obecného formátu data/času (krátkého formátu času). Další informace: Specifikátor formátu obecný krátký čas data ("g").	2009-06-15T13:45:30 -> 15.6.2009 13:45 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Vzor obecného formátu data a času (dlouhého formátu času). Další informace: Specifikátor obecného formátu data dlouhého času ("G").	2009-06-15T13:45:30 -> 15.6.2009 13:45:30 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Vzor formátu měsíce/dne. Další informace: Specifikátor formátu měsíce ("M", "m")	2009-06-15T13:45:30 –> 15. června (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	vzor data a času odezvy. Další informace: Specifikátor formátu odezvy ("O", "o")	2009-06-15T13:45:30 (místní) --> 2009-06-15T13:45:30.000000-07:00 2009-06-15T13:45:30 (Utc) --> 2009-06-15T13:45:30.000000+00:00 2009-06-15T13:45:30 (nezadané) --> 2009-06-15T13:45:30.00000000
"R", "r"	Vzor RFC1123. Další informace: Specifikátor formátu RFC1123 ("R", "r")	2009-06-15T13:45:30 -> Po, 15. června 2009 13:45:30 GMT
"s"	Vzor seřaditelného formátu data/času. Další informace: Specifikátor formátu řazení ("s").	2009-06-15T13:45:30 (místní) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (Utc) -> 2009-06-15T13:45:30
"t"	Vzor krátkého formátu času. Další informace: Specifikátor formátu krátkého času ("t").	2009-06-15T13:45:30 -> 13:45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Vzor dlouhého formátu času. Další informace: Specifikátor formátu dlouhého času ("T").	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Vzor univerzálního seřaditelného formátu data/času. Další informace: Specifikátor univerzálního formátu řazení ("u").	2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"Y", "y"	Vzor formátu roku a měsíce. Další informace: Specifikátor formátu měsíce roku ("Y").	2009-06-15T13:45:30 –> červen 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (ID-ID)
Jakýkoli jiný samostatný znak	Neznámý specifikátor.	Vyvolá chybu výrazu za běhu.

Jak fungují standardní formátovací řetězce

V rámci operace formátování je řetězec standardního formátu pouze aliasem pro řetězec vlastního formátu. Výhodou používání aliasu pro odkaz na řetězec vlastního formátu je skutečnost, že ačkoli alias zůstane neutrální, řetězec vlastního formátu se může změnit. Toto je důležité, protože řetězcová reprezentace hodnot data a času se obvykle liší podle jazykové verze. Například řetězec standardního formátu "d" označuje, že hodnota data a času má být zobrazena pomocí vzoru krátkého formátu data. Pro neutrální jazykovou verzi je použit formát "MM/dd/yyyy". Pro jazykovou verzi fr-FR je to formát "dd/MM/yyyy". Pro jazykovou verzi ja-JP je to formát "yyyy/MM/dd".

Pokud je řetězec standardního formátu v rámci operace formátování namapován na řetězec vlastního formátu konkrétní jazykové verze, může vaše aplikace definovat konkrétní jazykovou verzi, jejíž řetězce vlastního formátu se používají jedním z těchto způsobů:

Můžete použít výchozí (nebo aktuální) jazykovou verzi. Následující příklad zobrazí datum pomocí krátkého formátu data aktuální jazykové verze. V tomto případě je aktuální jazyková verze nastavena na en-US.
```
let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d"])
        //Displays 3/15/2024
    }
in
    Source
```
Jazykovou verzi, která se používá k formátování data, můžete předat podle pravidel dané jazykové verze. Následující příklad zobrazí datum pomocí formátu krátkého data jazykové verze pt-BR.
```
let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"])
        //Displays 15/03/2024
   }
in
    Source
```

V některých případech slouží řetězec standardního formátu jako vhodná zkratka pro řetězec vlastního delšího formátu, který je neutrální. Do této kategorie patří čtyři řetězce standardního formátu: "O" (nebo "o"), "R" (nebo "r"), "s" a "u". Tyto řetězce odpovídají řetězcům vlastního formátu, které jsou definovány neutrální jazykovou verzí. Vytvářejí řetězcové reprezentace hodnot data a času, které mají být identické napříč jazykovými verzemi. Následující tabulka obsahuje informace o těchto čtyřech řetězcích standardního formátu data a času.

Řetězec standardního formátu	Definováno podle	Řetězec vlastního formátu
"O" nebo "o"	Nic	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" nebo "r"	Specifikace IETF RFC 1123	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	ISO 8601	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	Seřaditelné, protože používá úvodní nuly pro rok, měsíc, den, hodinu, minutu a sekundu.	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standardní formátovací řetězce lze použít také v operacích analýzy, které vyžadují, aby vstupní řetězec přesně odpovídal určitému vzoru, aby operace analýzy byla úspěšná. Mnoho standardních řetězců formátu se mapuje na více řetězců vlastního formátu, takže hodnota data a času může být reprezentována v různých formátech a operace analýzy je stále úspěšná.

Následující části popisují standardní specifikátory formátu pro hodnoty Date, DateTime, DateTimeZone a Time.

Formáty kalendářních dat

Tato skupina obsahuje následující formáty:

Specifikátor formátu krátkého data ("d")
Specifikátor formátu dlouhého data ("D")

Specifikátor formátu krátkého data ("d")

Specifikátor standardního formátu "d" představuje vlastní formát data definovaný konkrétní jazykovou verzí. Například text vlastního formátu vrácený neutrální jazykovou verzí je "MM/dd/rrrr".

Následující příklad používá specifikátor formátu "d" k zobrazení hodnoty data.

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

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

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

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

Zpět k tabulce

Specifikátor formátu dlouhého data ("D")

Specifikátor standardního formátu "D" představuje vlastní formát data definovaný konkrétní jazykovou verzí. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "dddd, dd MMMM yyyy".

Následující příklad používá specifikátor formátu "D" k zobrazení hodnoty data a času.

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

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

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

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

Zpět k tabulce

Formáty data a času

Tato skupina obsahuje následující formáty:

Specifikátor formátu full date short time ("f")
Specifikátor formátu full date long time ("F")
Specifikátor obecného formátu data short time ("g")
Specifikátor obecného formátu data long time ("G")
Specifikátor formátu odezvy ("O", "o")
Specifikátor formátu RFC1123 ("R", "r")
Specifikátor formátu řazení ("s")
Specifikátor univerzálního formátu řazení ("u")

Specifikátor formátu full date short time ("f")

Standardní specifikátor formátu "f" představuje kombinaci vzorů dlouhého formátu data "D" a krátkého formátu času "t", která je oddělena mezerou.

Výsledný řetězec je ovlivněn formátováním informací konkrétní jazykové verze.

Následující příklad používá specifikátor formátu "f" k zobrazení hodnoty data a času.

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

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

Zpět k tabulce

Specifikátor formátu full date long time ("F")

Specifikátor standardního formátu "F" představuje vlastní formát data a času definovaný konkrétní jazykovou verzí. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "dddd, dd MMMM yyyy HH:mm:ss".

Výsledný řetězec je ovlivněn formátováním informací konkrétní jazykové verze.

Následující příklad používá specifikátor formátu "F" k zobrazení hodnoty data a času.

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

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

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

Zpět k tabulce

Specifikátor obecného formátu data short time ("g")

Standardní specifikátor formátu "g" představuje kombinaci vzorů krátkého formátu data "d" a krátkého formátu času "t", která je oddělena mezerou. Výsledný text je ovlivněn formátováním informací konkrétní jazykové verze.

Výsledný řetězec je ovlivněn formátováním informací konkrétní jazykové verze.

Následující příklad používá specifikátor formátu "g" k zobrazení hodnoty data a času.

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

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

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

Zpět k tabulce

Specifikátor obecného formátu data long time ("G")

Standardní specifikátor formátu "G" představuje kombinaci vzorů krátkého formátu data "d" a dlouhého formátu času "T", která je oddělena mezerou. Výsledný text je ovlivněn formátováním informací konkrétní jazykové verze.

Výsledný řetězec je ovlivněn formátováním informací konkrétní jazykové verze.

Následující příklad používá specifikátor formátu "G" k zobrazení hodnoty data a času.

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

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

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

Zpět k tabulce

Specifikátor formátu odezvy ("O", "o")

Specifikátor standardního formátu "O" nebo "o" představuje vlastní řetězec formátu data a času pomocí vzoru, který zachovává informace o časovém pásmu a vygeneruje výsledný řetězec, který odpovídá normě ISO 8601. Pro hodnoty DateTimeZone je tento specifikátor formátu navržen tak, aby zachoval hodnoty data, času a časového pásma v textu.

Specifikátor standardního formátu "O" nebo "o" odpovídá "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffxxx" řetězec vlastního formátu pro hodnoty DateTimeZone . V tomto textu dvojice jednoduchých uvozovek, které oddělují jednotlivé znaky, jako jsou spojovníky, dvojtečky a písmeno "T", označují, že jednotlivý znak je literál, který nelze změnit. Apostrofy se ve výstupním řetězci nezobrazí.

Specifikátor standardního formátu "O" nebo "o" (a "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.") Vlastní formát fffxxx) využívá způsoby, kterými ISO 8601 představuje informace o časovém pásmu, aby se zachovaly hodnoty DateTimeZone:

Součást časového pásma DateTimeZone.ToLocal hodnot data a času je posun od času UTC (například +01:00, -07:00).
Komponenta časového pásma DateTimeZone.ToUtc hodnot data a času používá k reprezentaci UTC +00,00.

Vzhledem k tomu, že specifikátor standardního formátu "O" nebo "o" odpovídá mezinárodnímu standardu, operace formátování nebo analýzy, která používá specifikátor, vždy používá neutrální jazykovou verzi a gregoriánský kalendář.

Následující příklad používá specifikátor formátu "o" k zobrazení řady hodnot DateTimeZone v systému v americkém časovém pásmu.

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

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

Poznámka:

Hodnota vrácená DateTimeZone.ToLocal 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ří se Power Query Desktop vrátí -07:00 pro místní čas, 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.

Následující příklad používá specifikátor formátu "o" k vytvoření formátovaného řetězce a potom obnoví původní hodnotu data a času voláním rutiny analýzy data a času.

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

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

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

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

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

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

Zpět k tabulce

Specifikátor formátu RFC1123 ("R", "r")

Specifikátor standardního formátu "R" nebo "r" představuje vlastní řetězec formátu data a času, který není definován konkrétní jazykovou verzí. Je vždy stejný bez ohledu na použitou jazykovou verzi nebo poskytovatele formátu. Řetězec vlastního formátu je "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Při použití tohoto standardního specifikátoru formátu používá operace formátování nebo analýzy vždy neutrální jazykovou verzi.

Přestože standard RFC 1123 vyjadřuje čas jako koordinovaný univerzální čas (UTC), operace formátování neupravuje hodnotu data a času, který se formátuje. Proto je nutné před provedením operace formátování převést hodnotu DateTime na UTC voláním metody funkce DateTimeZone.ToUtc.

Následující příklad používá specifikátor formátu "r" k zobrazení hodnoty času a data v systému v americkém časovém pásmu (sedm hodin za UTC).

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

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

Zpět k tabulce

Specifikátor formátu řazení ("s")

Specifikátor standardního formátu "s" představuje vlastní řetězec formátu data a času, který odráží definovaný standard (ISO 8601) a je jen pro čtení. Proto je vždy stejný bez ohledu na použitou jazykovou verzi nebo dodaného poskytovatele formátu. Řetězec vlastního formátu je "yyyy'-'MM'-'dd'T'HH':'mm':'ss". Účelem specifikátoru formátu "s" je vytvořit výsledné řetězce, které seřadí konzistentně vzestupně nebo sestupně podle hodnot data a času.

Při použití tohoto standardního specifikátoru formátu používá operace formátování nebo analýzy vždy neutrální jazykovou verzi.

Následující příklad používá specifikátor formátu "s" k zobrazení hodnoty data a času v systému v americkém časovém pásmu Tichomoří.

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

Zpět k tabulce

Specifikátor univerzálního formátu řazení ("u")

Specifikátor standardního formátu "u" představuje vlastní řetězec formátu data a času, který je vždy stejný bez ohledu na použitou jazykovou verzi nebo zadaný zprostředkovatel formátu. Řetězec vlastního formátu je "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Tento vzor odpovídá definovanému standardu a příslušná vlastnost je určena jen pro čtení. Při použití tohoto standardního specifikátoru formátu používá operace formátování nebo analýzy vždy neutrální jazykovou verzi.

I když by měl výsledný řetězec vyjádřit čas jako koordinovaný univerzální čas (UTC), během operace formátování se neprovádí žádný převod původní hodnoty DateTimeZone . Proto je nutné před formátováním převést hodnotu DateTime Zone na UTC voláním funkce DateTimeZone.ToUtc.

Následující příklad používá specifikátor formátu "u" k zobrazení hodnoty data a času.

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

Zpět k tabulce

Formáty času

Tato skupina obsahuje následující formáty:

Specifikátor krátkého formátu ("t")
Specifikátor formátu dlouhého času ("T")

Specifikátor krátkého formátu ("t")

Specifikátor standardního formátu "t" představuje vlastní řetězec formátu data a času definovaný zadanou jazykovou verzí. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "HH:mm".

Výsledný řetězec je ovlivněn formátováním informací konkrétní jazykové verze.

Následující příklad používá specifikátor formátu "t" k zobrazení hodnoty data a času.

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

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

Zpět k tabulce

Specifikátor formátu dlouhého času ("T")

Specifikátor standardního formátu "T" představuje vlastní řetězec formátu data a času, který je definován konkrétní jazykovou verzí. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "HH:mm:ss".

Následující příklad používá specifikátor formátu "T" k zobrazení hodnoty data a času.

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

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

Zpět k tabulce

Částečné formáty kalendářních dat

Tato skupina obsahuje následující formáty:

Specifikátor formátu měsíce ("M", "m")
Specifikátor formátu roku ("Y", "y")

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

Specifikátor standardního formátu "M" nebo "m" představuje vlastní řetězec formátu data a času, který je definován konkrétní jazykovou verzí. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "MMMM dd".

Následující příklad používá specifikátor formátu "m" k zobrazení hodnoty data a času.

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

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

Zpět k tabulce

Specifikátor formátu roku ("Y", "y")

Specifikátor standardního formátu "Y" nebo "y" představuje vlastní řetězec formátu data, který je definován konkrétní jazykovou verzí. Například řetězec vlastního formátu pro neutrální jazykovou verzi je "yyyy MMMM".

Následující příklad používá specifikátor formátu "y" k zobrazení hodnoty data a času.

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

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

Zpět k tabulce

Sdílet prostřednictvím

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

Tabulka specifikátorů formátu

Jak fungují standardní formátovací řetězce

Formáty kalendářních dat

Specifikátor formátu krátkého data ("d")

Specifikátor formátu dlouhého data ("D")

Formáty data a času

Specifikátor formátu full date short time ("f")

Specifikátor formátu full date long time ("F")

Specifikátor obecného formátu data short time ("g")

Specifikátor obecného formátu data long time ("G")

Specifikátor formátu odezvy ("O", "o")

Specifikátor formátu RFC1123 ("R", "r")

Specifikátor formátu řazení ("s")

Specifikátor univerzálního formátu řazení ("u")

Formáty času

Specifikátor krátkého formátu ("t")

Specifikátor formátu dlouhého času ("T")

Částečné formáty kalendářních dat

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

Specifikátor formátu roku ("Y", "y")

Váš názor

Další materiály

Sdílet prostřednictvím

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

Tabulka specifikátorů formátu

Jak fungují standardní formátovací řetězce

Formáty kalendářních dat

Specifikátor formátu krátkého data ("d")

Specifikátor formátu dlouhého data ("D")

Formáty data a času

Specifikátor formátu full date short time ("f")

Specifikátor formátu full date long time ("F")

Specifikátor obecného formátu data short time ("g")

Specifikátor obecného formátu data long time ("G")

Specifikátor formátu odezvy ("O", "o")

Specifikátor formátu RFC1123 ("R", "r")

Specifikátor formátu řazení ("s")

Specifikátor univerzálního formátu řazení ("u")

Formáty času

Specifikátor krátkého formátu ("t")

Specifikátor formátu dlouhého času ("T")

Částečné formáty kalendářních dat

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

Specifikátor formátu roku ("Y", "y")

Související obsah

Váš názor

Další materiály