Niestandardowe ciągi formatu daty i godziny

Ciąg formatu daty i godziny definiuje tekstową reprezentację wartości Date, DateTime, DateTimeZone lub Time, która wynika z operacji formatowania. Może także definiować reprezentację wartości daty i godziny, która jest wymagana w operacji analizowania składni w celu pomyślnego przekonwertowania ciągu na datę i godzinę. Ciąg formatu niestandardowego składa się z co najmniej jednego specyfikatora niestandardowego formatu daty i godziny. Każdy ciąg, który nie jest standardowym ciągiem formatu daty i godziny, jest interpretowany jako niestandardowy ciąg formatu daty i godziny.

W operacjach formatowania można używać niestandardowych ciągów formatu daty i godziny z ToText metodą wystąpienia daty i godziny i strefy czasowej. Poniższy przykład ilustruje jego zastosowania.

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

W operacjach analizowania można używać niestandardowych ciągów formatu daty i godziny z funkcjami Date, DateTime, Time i DateTimeZone. Te funkcje wymagają, aby ciąg wejściowy był zgodny dokładnie z określonym wzorcem, aby operacja analizy powiodła się. W poniższym przykładzie pokazano wywołanie funkcji DateTime.FromText w celu przeanalizowania daty, która musi zawierać miesiąc, dzień i dwucyfrowy 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.

W poniższej tabeli opisano specyfikatory niestandardowego formatu daty i godziny oraz przedstawiono ciąg wyników generowany przez każdy specyfikator formatu. Domyślnie ciągi wynikowe odzwierciedlają konwencje formatowania kultury en-US. Jeśli określony specyfikator formatu generuje zlokalizowany ciąg wynikowy, w przykładzie wymieniono też kulturę, której dotyczy ciąg wynikowy. Aby uzyskać więcej informacji na temat używania niestandardowych ciągów formatu daty i godziny, przejdź do sekcji Notatki .

Specyfikator formatu	opis	Przykłady
„d”	Dzień miesiąca, od 1 do 31. Więcej informacji: Specyfikator formatu niestandardowego "d".	2009-06-01T13:45:30 -> 1 2009-06-15T13:45:30 -> 15
„dd”	Dzień miesiąca, od 01 do 31. Więcej informacji: Specyfikator formatu niestandardowego "dd".	2009-06-01T13:45:30 -> 01 2009-06-15T13:45:30 -> 15
„ddd”	Skrócona nazwa dnia tygodnia. Więcej informacji: Specyfikator formatu niestandardowego "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”	Pełna nazwa dnia tygodnia. Więcej informacji: Specyfikator formatu niestandardowego "dddd".	2009-06-15T13:45:30 -> poniedziałek (en-US) 2009-06-15T13:45:30 -> понедельник (ru-RU) 2009-06-15T13:45:30 -> lundi (fr-FR)
„f”	Liczba dziesiątych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "f".	2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.05 -> 0
„ff”	Liczba setnych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "ff".	2009-06-15T13:45:30.61700000 -> 61 2009-06-15T13:45:30.0050000 -> 00
„fff”	Liczba milisekund w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "fff".	6/15/2009 13:45:30.617 -> 617 6/15/2009 13:45:30.0005 -> 000
„ffff”	Liczba dziesięciotysięcznych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "ffff".	2009-06-15T13:45:30.6175000 -> 61755 2009-06-15T13:45:30.0000500–> 0000
„fffff”	Liczba stutysięcznych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "fffff".	2009-06-15T13:45:30.6175400 -> 617544 6/15/2009 13:45:30.000005 -> 000000
„ffffff”	Liczba milionowych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "ffffff".	2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> 0000000
„fffffff”	Liczba dziesięciomilionowych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "fffffff".	2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 0001150
„F”	Jeśli wartość jest różna od zera, liczba dziesiątych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "F".	2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.0500000 -> (brak danych wyjściowych)
„FF”	Jeśli wartość jest różna od zera, liczba setnych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "FF".	2009-06-15T13:45:30.61700000 -> 61 2009-06-15T13:45:30.0050000 —> (brak danych wyjściowych)
„FFF”	Jeśli wartość jest różna od zera, liczba milisekund w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "FFF".	2009-06-15T13:45:30.61700000 -> 617 2009-06-15T13:45:30.0005000 -> (brak danych wyjściowych)
„FFFF”	Jeśli wartość jest różna od zera, liczba dziesięciotysięcznych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "FFFF".	2009-06-15T13:45:30.5275000 -> 52775 2009-06-15T13:45:30.0000500 —> (brak danych wyjściowych)
„FFFFF”	Jeśli wartość jest różna od zera, liczba stutysięcznych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "FFFFF".	2009-06-15T13:45:30.6175400 -> 617544 2009-06-15T13:45:30.0000050 —> (brak danych wyjściowych)
„FFFFFF”	Jeśli wartość jest różna od zera, liczba milionowych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "FFFFFF".	2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 —> (brak danych wyjściowych)
„FFFFFFF”	Jeśli wartość jest różna od zera, liczba dziesięciomilionowych części sekundy w wartości daty i godziny. Więcej informacji: Specyfikator formatu niestandardowego "FFFFFFF".	2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 000115
„g”, „gg”	Okres lub era. Więcej informacji: specyfikator formatu niestandardowego "g" lub "gg".	2009-06-15T13:45:30.6170000 -> A.D.
„h”	Godzina; używany jest zegar 12-godzinny (wartości od 1 do 12). Więcej informacji: Specyfikator formatu niestandardowego "h".	2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 1
„hh”	Godzina; używany jest zegar 12-godzinny (wartości od 01 do 12). Więcej informacji: Specyfikator formatu niestandardowego "hh".	2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 01
„H”	Godzina, używając zegara 24-godzinnego od 0 do 23. Więcej informacji: Specyfikator formatu niestandardowego "H".	2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 13
„HH”	Godzina; używany jest zegar 24-godzinny (wartości od 00 do 23). Więcej informacji: Specyfikator formatu niestandardowego "HH".	2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 13
„K”	Informacje o strefie czasowej. Więcej informacji: Specyfikator formatu niestandardowego "K".	2009-06-15T13:45:30, nieokreślony -> 2009-06-15T13:45:30, Utc -> +00:00 2009-06-15T13:45:30, Lokalny —> -07:00 (zależy od ustawień komputera lokalnego lub w chmurze)
„m”	Minuta, od 0 do 59. Więcej informacji: Specyfikator formatu niestandardowego "m".	2009-06-15T01:09:30 -> 9 2009-06-15T13:29:30 -> 29
„mm”	Minuta, od 00 do 59. Więcej informacji: Specyfikator formatu niestandardowego "mm".	2009-06-15T01:09:30 -> 09 2009-06-15T01:45:30 -> 45
„M”	Miesiąc, od 1 do 12. Więcej informacji: Specyfikator formatu niestandardowego "M".	2009-06-15T13:45:30 -> 6
„MM”	Miesiąc, od 01 do 12. Więcej informacji: Specyfikator formatu niestandardowego "MM".	2009-06-15T13:45:30 -> 06
„MMM”	Skrócona nazwa miesiąca. Więcej informacji: Specyfikator formatu niestandardowego "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”	Pełna nazwa miesiąca. Więcej informacji: Specyfikator formatu niestandardowego "MMMM".	2009-06-15T13:45:30 —> czerwiec (en-US) 2009-06-15T13:45:30 -> juni (da-DK) 2009-06-15T13:45:30 -> Juni (zu-ZA)
„s”	Drugi, od 0 do 59. Więcej informacji: Specyfikator formatu niestandardowego "s".	2009-06-15T13:45:09 -> 9
„ss”	Drugi, od 00 do 59. Więcej informacji: Specyfikator formatu niestandardowego "ss".	2009-06-15T13:45:09 -> 09
„t”	Pierwszy znak oznaczenia AM/PM. Więcej informacji: Specyfikator formatu niestandardowego "t".	2009-06-15T13:45:30 -> P (en-US) 2009-06-15T13:45:30 -> 午 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR)
„tt”	Oznaczenie AM/PM. Więcej informacji: Specyfikator formatu niestandardowego "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; wartości z zakresu od 0 do 99. Więcej informacji: Specyfikator formatu niestandardowego "y".	0001-01-01T00:00:00-1> 0900-01-01T00:00:00–> 00 1900-01-01T00:00:00 -> 00 2009-06-15T13:45:30 -> 9 2019-06-15T13:45:30 -> 19
„yy”	Rok; wartości z zakresu od 00 do 99. Więcej informacji: Specyfikator formatu niestandardowego "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; co najmniej trzy cyfry. Więcej informacji: Specyfikator formatu niestandardowego "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 liczba czterocyfrowa. Więcej informacji: Specyfikator formatu niestandardowego "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 liczba pięciocyfrowa. Więcej informacji: Specyfikator formatu niestandardowego "yyy".	0001-01-01T00:00:00–> 0001 2009-06-15T13:45:30 -> 02009
„z”	Przesunięcie godzinowe względem czasu UTC, bez zer wiodących. Więcej informacji: Specyfikator formatu niestandardowego "z".	2009-06-15T13:45:30-07:00 -> -7
„zz”	Przesunięcie godzinowe względem czasu UTC, z zerem wiodącym dla wartości jednocyfrowych. Więcej informacji: Specyfikator formatu niestandardowego "zz".	2009-06-15T13:45:30-07:00 -> -07
„zzz”	Godzinowe i minutowe przesunięcie względem czasu UTC. Więcej informacji: Specyfikator formatu niestandardowego "zzz".	2009-06-15T13:45:30-07:00 -> -07:00
":"	Separator godziny. Więcej informacji: Specyfikator formatu niestandardowego ":".	2009-06-15T13:45:30 -> : (en-US) 2009-06-15T13:45:30 -> . (it-IT) 2009-06-15T13:45:30 -> : (ja-JP)
"/"	Separator daty. Więcej informacji: Specyfikator formatu niestandardowego "/".	2009-06-15T13:45:30 -> / (en-US) 2009-06-15T13:45:30 - -> (ar-DZ) 2009-06-15T13:45:30 -> . (tr-TR)
"ciąg" "ciąg"	Ogranicznik ciągu literału. Więcej informacji: Literały znaków.	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
%	Definiuje następujący znak jako specyfikator formatu niestandardowego. Więcej informacji: Używanie specyfikatorów pojedynczego formatu niestandardowego.	2009-06-15T13:45:30 (%h) -> 1
\, "", '	Sekwencje ucieczki. Więcej informacji: Literały znaków i Używanie sekwencji ucieczki.	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
Jakikolwiek inny znak	Znak jest kopiowany do ciągu wynikowego bez zmian. Więcej informacji: Literały znaków.	2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A

W poniższych sekcjach przedstawiono dodatkowe informacje dotyczące poszczególnych specyfikatorów niestandardowego formatu daty i godziny. Jeśli nie określono inaczej, każdy specyfikator tworzy identyczną reprezentację ciągu niezależnie od tego, czy jest używany z wartością Date, DateTimeZone lub Time.

Specyfikator formatu "d" dnia

Specyfikator formatu niestandardowego "d"

Specyfikator formatu niestandardowego "d" reprezentuje dzień miesiąca jako liczbę z zakresu od 1 do 31. Dzień oznaczony jedną cyfrą jest formatowany bez zera wiodącego.

Jeśli specyfikator formatu "d" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako specyfikator formatu standardowego daty i godziny "d". Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie specyfikator formatu niestandardowego „d” jest używany w kilku ciągach formatu.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "dd"

Ciąg formatu niestandardowego "dd" reprezentuje dzień miesiąca jako liczbę z zakresu od 01 do 31. Dzień oznaczony jedną cyfrą jest formatowany z zerem wiodącym.

W poniższym przykładzie specyfikator formatu niestandardowego „dd” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "ddd"

Specyfikator formatu niestandardowego „ddd” przedstawia skróconą nazwę dnia tygodnia. Zlokalizowana skrócona nazwa dnia tygodnia jest pobierana z bieżącej lub określonej kultury.

W poniższym przykładzie specyfikator formatu niestandardowego „ddd” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "dddd"

Specyfikator formatu niestandardowego „dddd” (plus dowolna liczba dodatkowych specyfikatorów „d”) oznacza pełną nazwę dnia tygodnia. Zlokalizowana nazwa dnia tygodnia jest pobierana z bieżącej lub określonej kultury.

W poniższym przykładzie specyfikator formatu niestandardowego „dddd” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator ułamków "f" małych liter

Specyfikator formatu niestandardowego "f"

Specyfikator formatu niestandardowego „f” przedstawia najbardziej znaczącą cyfrę części sekund, czyli przedstawia liczbę dziesiątych części sekundy w wartości daty i godziny.

Jeśli specyfikator formatu "f" jest używany bez innych specyfikatorów formatu, jest interpretowany jako specyfikator standardowego formatu daty i godziny "f". Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W przypadku używania specyfikatorów formatu "f" w ramach ciągu formatu dostarczonego do analizowania liczby sekund ułamkowych liczba specyfikatorów formatu "f" wskazuje liczbę najbardziej znaczących cyfr ułamka sekund, które muszą być obecne, aby pomyślnie przeanalizować ciąg.

W poniższym przykładzie specyfikator formatu niestandardowego „f” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "ff"

Specyfikator formatu niestandardowego „ff” przedstawia dwie najbardziej znaczące cyfry części sekund, czyli przedstawia liczbę setnych części sekundy w wartości daty i godziny.

W poniższym przykładzie specyfikator formatu niestandardowego „fff” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "fff"

Specyfikator formatu niestandardowego „fff” przedstawia trzy najbardziej znaczące cyfry części sekund, czyli przedstawia liczbę milisekund w wartości daty i godziny.

W poniższym przykładzie specyfikator formatu niestandardowego „fff” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "ffff"

Specyfikator formatu niestandardowego „ffff” przedstawia cztery najbardziej znaczące cyfry części sekund, czyli przedstawia liczbę dziesięciotysięcznych części sekundy w wartości daty i godziny.

Chociaż można wyświetlić dziesiąte części drugiego składnika wartości czasu, ta wartość może nie być znacząca. Dokładność wartości daty i godziny zależy od rozdzielczości zegara systemu. W systemach operacyjnych Windows Server 2019 i Windows 11 rozdzielczość zegara wynosi około 1 milisekund.

Powrót do tabeli

Specyfikator formatu niestandardowego "fffff"

Specyfikator formatu niestandardowego „fffff” przedstawia pięć najbardziej znaczących cyfr części sekund, czyli przedstawia liczbę stutysięcznych części sekundy w wartości daty i godziny.

Chociaż istnieje możliwość wyświetlenia setnych tysięcy drugiego składnika wartości czasu, ta wartość może nie być znacząca. Dokładność wartości daty i godziny zależy od rozdzielczości zegara systemu. W systemach operacyjnych Windows Server 2019 i Windows 11 rozdzielczość zegara wynosi około 1 milisekund.

Powrót do tabeli

Specyfikator formatu niestandardowego "ffffff"

Specyfikator formatu niestandardowego „ffffff” przedstawia sześć najbardziej znaczących cyfr części sekund, czyli przedstawia liczbę milionowych części sekundy w wartości daty i godziny.

Chociaż można wyświetlić milionowe części drugiego składnika wartości czasu, ta wartość może nie być znacząca. Dokładność wartości daty i godziny zależy od rozdzielczości zegara systemu. W systemach operacyjnych Windows Server 2019 i Windows 11 rozdzielczość zegara wynosi około 1 milisekund.

Powrót do tabeli

Specyfikator formatu niestandardowego "fffffff"

Specyfikator formatu niestandardowego „fffffff” przedstawia siedem najbardziej znaczących cyfr części sekund, czyli przedstawia liczbę dziesięciomilionowych części sekundy w wartości daty i godziny.

Chociaż można wyświetlić dziesiąte miliony drugiego składnika wartości czasu, ta wartość może nie być znacząca. Dokładność wartości daty i godziny zależy od rozdzielczości zegara systemu. W systemach operacyjnych Windows Server 2019 i Windows 11 rozdzielczość zegara wynosi około 1 milisekund.

Powrót do tabeli

Specyfikator ułamka "F" w sekundach wielkich liter

Specyfikator formatu niestandardowego "F"

Specyfikator formatu niestandardowego „F” przedstawia najbardziej znaczącą cyfrę części sekund, czyli przedstawia liczbę dziesiątych części sekundy w wartości daty i godziny. Nic nie jest wyświetlane, jeśli cyfra ma wartość zero, a punkt dziesiętny, który następuje po liczbie sekund, również nie jest wyświetlany.

Jeśli specyfikator formatu "F" jest używany bez innych specyfikatorów formatu, jest interpretowany jako specyfikator standardowego formatu daty i godziny "F". Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

Liczba specyfikatorów formatu "F" używanych podczas analizowania wskazuje maksymalną liczbę najważniejszych cyfr ułamka sekund, które mogą być obecne, aby pomyślnie przeanalizować ciąg.

W poniższym przykładzie specyfikator formatu niestandardowego „F” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "FF"

Specyfikator formatu niestandardowego „FF” przedstawia dwie najbardziej znaczące cyfry części sekund, czyli przedstawia liczbę setnych części sekundy w wartości daty i godziny. Końcowe zera nie są wyświetlane. Nic nie jest wyświetlane, jeśli dwie znaczące cyfry są zerowe, a w takim przypadku dziesiętny punkt, który następuje po liczbie sekund, również nie jest wyświetlany.

W poniższym przykładzie specyfikator formatu niestandardowego „FF” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "FFF"

Specyfikator formatu niestandardowego „FFF” przedstawia trzy najbardziej znaczące cyfry części sekund, czyli przedstawia liczbę milisekund w wartości daty i godziny. Końcowe zera nie są wyświetlane. Nic nie jest wyświetlane, jeśli trzy cyfry znaczące są zero, a w takim przypadku dziesiętny punkt, który następuje po liczbie sekund, również nie jest wyświetlany.

W poniższym przykładzie specyfikator formatu niestandardowego „FFF” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "FFFF"

Specyfikator formatu niestandardowego „FFFF” przedstawia cztery najbardziej znaczące cyfry części sekund, czyli przedstawia liczbę dziesięciotysięcznych części sekundy w wartości daty i godziny. Końcowe zera nie są wyświetlane. Nic nie jest wyświetlane, jeśli cztery cyfry znaczące są zerowe, a w takim przypadku dziesiętny punkt, który następuje po liczbie sekund, również nie jest wyświetlany.

Chociaż można wyświetlić dziesiąte części drugiego składnika wartości czasu, ta wartość może nie być znacząca. Dokładność wartości daty i godziny zależy od rozdzielczości zegara systemu. W systemach operacyjnych Windows Server 2019 i Windows 11 rozdzielczość zegara wynosi około 1 milisekund.

Powrót do tabeli

Specyfikator formatu niestandardowego "FFFFF"

Specyfikator formatu niestandardowego „FFFFF” przedstawia pięć najbardziej znaczących cyfr części sekund, czyli przedstawia liczbę stutysięcznych części sekundy w wartości daty i godziny. Końcowe zera nie są wyświetlane. Nic nie jest wyświetlane, jeśli pięć cyfr znaczących ma wartość zero, a w takim przypadku nie jest również wyświetlany punkt dziesiętny, który następuje po liczbie sekund.

Chociaż istnieje możliwość wyświetlenia setnych tysięcy drugiego składnika wartości czasu, ta wartość może nie być znacząca. Dokładność wartości daty i godziny zależy od rozdzielczości zegara systemu. W systemach operacyjnych Windows Server 2019 i Windows 11 rozdzielczość zegara wynosi około 1 milisekund.

Powrót do tabeli

Specyfikator formatu niestandardowego "FFFFFF"

Specyfikator formatu niestandardowego „FFFFFF” przedstawia sześć najbardziej znaczących cyfr części sekund, czyli przedstawia liczbę milionowych części sekundy w wartości daty i godziny. Końcowe zera nie są wyświetlane. Nic nie jest wyświetlane, jeśli sześć cyfr znaczących ma wartość zero, a w takim przypadku nie jest również wyświetlany punkt dziesiętny, który następuje po liczbie sekund.

Chociaż można wyświetlić milionowe części drugiego składnika wartości czasu, ta wartość może nie być znacząca. Dokładność wartości daty i godziny zależy od rozdzielczości zegara systemu. W systemach operacyjnych Windows Server 2019 i Windows 11 rozdzielczość zegara wynosi około 1 milisekund.

Powrót do tabeli

Specyfikator formatu niestandardowego "FFFFFFF"

Specyfikator formatu niestandardowego „FFFFFFF” przedstawia siedem najbardziej znaczących cyfr części sekund, czyli przedstawia liczbę dziesięciomilionowych części sekundy w wartości daty i godziny. Końcowe zera nie są wyświetlane. Nic nie jest wyświetlane, jeśli siedem cyfr znaczących ma wartość zero, a w takim przypadku nie jest również wyświetlany punkt dziesiętny, który następuje po liczbie sekund.

Chociaż można wyświetlić dziesiąte miliony drugiego składnika wartości czasu, ta wartość może nie być znacząca. Dokładność wartości daty i godziny zależy od rozdzielczości zegara systemu. W systemach operacyjnych Windows Server 2019 i Windows 11 rozdzielczość zegara wynosi około 1 milisekund.

Powrót do tabeli

Specyfikator formatu "g" ery

Specyfikator formatu niestandardowego "g" lub "gg"

Specyfikatory formatu niestandardowego "g" lub "gg" (plus dowolna liczba dodatkowych specyfikatorów "g") reprezentuje okres lub erę, na przykład A.D. Operacja formatowania ignoruje ten specyfikator, jeśli data do sformatowania nie ma skojarzonego okresu ani ciągu ery.

Jeśli specyfikator formatu "g" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako specyfikator standardowego formatu daty i godziny "g". Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie specyfikator formatu niestandardowego „g” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu "h" z małą literą

Specyfikator formatu niestandardowego "h"

Specyfikator formatu niestandardowego "h" reprezentuje godzinę jako liczbę z zakresu od 1 do 12; oznacza to, że godzina jest reprezentowana przez zegar 12-godzinny, który liczy całe godziny od północy lub południa. Określonej godziny po północy nie można odróżnić od tej samej godziny po południu. Godzina nie jest zaokrąglana, a godzina jednocyfrowa jest formatowana bez zera wiodącego. Na przykład w przypadku godziny 5:43 rano lub po południu użycie tego specyfikatora formatu niestandardowego spowoduje wyświetlenie wartości „5”.

Jeśli specyfikator formatu "h" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako standardowy specyfikator formatu daty i godziny i zgłasza błąd wyrażenia. Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie specyfikator formatu niestandardowego „h” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "hh"

Specyfikator formatu niestandardowego "hh" (plus dowolna liczba dodatkowych specyfikatorów "h") reprezentuje godzinę jako liczbę z zakresu od 01 do 12; oznacza to, że godzina jest reprezentowana przez zegar 12-godzinny, który liczy całe godziny od północy lub południa. Określonej godziny po północy nie można odróżnić od tej samej godziny po południu. Godzina nie jest zaokrąglana, a godzina jednocyfrowa jest formatowana z zerem wiodącym. Na przykład w przypadku godziny 5:43 rano lub po południu użycie tego specyfikatora formatu niestandardowego spowoduje wyświetlenie wartości „05”.

W poniższym przykładzie specyfikator formatu niestandardowego „hh” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu "H" z wielką literą

Specyfikator formatu niestandardowego "H"

Specyfikator formatu niestandardowego "H" reprezentuje godzinę jako liczbę z zakresu od 0 do 23; oznacza to, że godzina jest reprezentowana przez zegar 24-godzinny oparty na zero, który liczy godziny od północy. Godzina oznaczona jedną cyfrą jest formatowana bez zera wiodącego.

Jeśli specyfikator formatu "H" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako standardowy specyfikator formatu daty i godziny i zgłasza błąd wyrażenia. Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie specyfikator formatu niestandardowego „H” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "HH"

Specyfikator formatu niestandardowego "HH" (plus dowolna liczba dodatkowych specyfikatorów "H") reprezentuje godzinę jako liczbę z zakresu od 00 do 23; oznacza to, że godzina jest reprezentowana przez zegar 24-godzinny oparty na zero, który liczy godziny od północy. Godzina oznaczona jedną cyfrą jest formatowana z zerem wiodącym.

W poniższym przykładzie specyfikator formatu niestandardowego „HH” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu strefy czasowej "K"

Specyfikator formatu niestandardowego "K"

Specyfikator formatu niestandardowego „K” przedstawia informacje o strefie czasowej z wartości daty i godziny. Gdy ten specyfikator formatu jest używany z wartościami DateTimeZone , ciąg wynikowy jest definiowany jako:

• W przypadku lokalnej strefy czasowej ten specyfikator generuje ciąg wynikowy zawierający przesunięcie lokalne z uniwersalnego czasu koordynowanego (UTC), na przykład "-07:00", jeśli zapytanie jest uruchamiane w programie Power Query Desktop. Jeśli zapytanie jest uruchamiane w usłudze Power Query Online, ciąg wynikowy nie generuje przesunięcia od czasu UTC, czyli "+00:00".

• Przez czas UTC ciąg wynikowy nie generuje przesunięcia od czasu UTC; oznacza to, "+00:00 do reprezentowania daty UTC.

• W przypadku czasu z nieokreślonej strefy czasowej wynik jest pusty.

Jeśli specyfikator formatu "K" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako standardowy specyfikator formatu daty i godziny i zgłasza błąd wyrażenia. Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie przedstawiono ciąg, który wynika z używania specyfikatora formatu niestandardowego "K" z różnymi wartościami w systemie w strefie czasowej Pacyficznego Stanów Zjednoczonych.

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

Uwaga

Wartość zwrócona przez DateTimeZone.LocalNow zależy od tego, czy używasz dodatku Power Query na komputerze lokalnym, czy w trybie online. Na przykład w powyższym przykładzie w systemie w strefie czasowej Pacyfik USA program Power Query Desktop zwraca -07:00 , ponieważ odczytuje czas ustawiony na komputerze lokalnym. Jednak usługa Power Query Online zwraca +00:00 , ponieważ odczytuje czas ustawiony na maszynach wirtualnych w chmurze, które są ustawione na utc.

Powrót do tabeli

Specyfikator formatu minuty "m"

Specyfikator formatu niestandardowego "m"

Specyfikator formatu niestandardowego "m" reprezentuje minutę jako liczbę z zakresu od 0 do 59. Wynik to liczba pełnych minut, które upłynęły od ostatniej godziny. Minuta oznaczona jedną cyfrą jest formatowana bez zera wiodącego.

Jeśli specyfikator formatu "m" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako specyfikator formatu standardowego daty i godziny "m". Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie specyfikator formatu niestandardowego „m” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "mm"

Specyfikator formatu niestandardowego "mm" (plus dowolna liczba dodatkowych specyfikatorów "m") reprezentuje minutę jako liczbę z zakresu od 00 do 59. Wynik to liczba pełnych minut, które upłynęły od ostatniej godziny. Minuta oznaczona jedną cyfrą jest formatowana z zerem wiodącym.

W poniższym przykładzie specyfikator formatu niestandardowego „mm” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu "M" miesiąca

Specyfikator formatu niestandardowego "M"

Specyfikator formatu niestandardowego "M" reprezentuje miesiąc jako liczbę z zakresu od 1 do 12 (lub od 1 do 13 dla kalendarzy, które mają 13 miesięcy). Miesiąc oznaczony jedną cyfrą jest formatowany bez zera wiodącego.

Jeśli specyfikator formatu "M" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako specyfikator formatu daty i godziny standardowej "M". Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie specyfikator formatu niestandardowego „M” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "MM"

Specyfikator formatu niestandardowego "MM" reprezentuje miesiąc jako liczbę z zakresu od 01 do 12 (lub od 1 do 13 dla kalendarzy, które mają 13 miesięcy). Miesiąc oznaczony jedną cyfrą jest formatowany z zerem wiodącym.

W poniższym przykładzie specyfikator formatu niestandardowego „MM” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "MMM"

Specyfikator formatu niestandardowego „MMM” przedstawia skróconą nazwę miesiąca. Zlokalizowana skrócona nazwa miesiąca jest pobierana ze skróconych nazw miesięcy bieżącej lub określonej kultury. Jeśli w ciągu formatu niestandardowego istnieje specyfikator formatu niestandardowego "d" lub "dd", nazwa miesiąca zostanie pobrana z skróconych nazw genitive.

W poniższym przykładzie specyfikator formatu niestandardowego „MMM” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "MMMM"

Specyfikator formatu niestandardowego „MMMM” przedstawia pełną nazwę miesiąca. Zlokalizowana nazwa miesiąca jest pobierana z bieżącej lub określonej kultury. Jeśli w ciągu formatu niestandardowego istnieje specyfikator formatu niestandardowego "d" lub "dd", nazwa miesiąca zostanie pobrana z skróconych nazw genitive.

W poniższym przykładzie specyfikator formatu niestandardowego „MMMM” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu "s" w sekundach

Specyfikator formatu niestandardowego "s"

Specyfikator formatu niestandardowego "s" reprezentuje sekundy jako liczbę z zakresu od 0 do 59. Wynik przedstawia pełne sekundy, które upłynęły od ostatniej minuty. Sekunda oznaczona jedną cyfrą jest formatowana bez zera wiodącego.

Jeśli specyfikator formatu "s" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako specyfikator formatu standardowego daty i godziny "s". Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie specyfikator formatu niestandardowego „s” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "ss"

Specyfikator formatu niestandardowego "ss" (plus dowolna liczba dodatkowych specyfikatorów "s") reprezentuje sekundy jako liczbę z zakresu od 00 do 59. Wynik przedstawia pełne sekundy, które upłynęły od ostatniej minuty. Sekunda oznaczona jedną cyfrą jest formatowana z zerem wiodącym.

W poniższym przykładzie specyfikator formatu niestandardowego „ss” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu Meridiem "t"

Specyfikator formatu niestandardowego "t"

Specyfikator formatu niestandardowego „t” przedstawia pierwszy znak oznaczenia AM/PM. Odpowiedni zlokalizowany designator jest pobierany z bieżącej lub określonej kultury. Oznaczenie AM jest stosowanie do wszystkich godzin z zakresu od 0:00:00 (północ) do 11:59:59.999. Oznaczenie PM jest stosowane do wszystkich godzin z zakresu od 12:00:00 (południe) do 23:59:59.999.

Jeśli specyfikator formatu "t" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako specyfikator formatu standardowego daty i godziny "t". Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie specyfikator formatu niestandardowego „t” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu niestandardowego "tt"

Specyfikator formatu niestandardowego „tt” (plus dowolna liczba dodatkowych specyfikatorów „t”) przedstawia całe oznaczenie AM/PM. Odpowiedni zlokalizowany designator jest pobierany z bieżącej lub określonej kultury. Oznaczenie AM jest stosowanie do wszystkich godzin z zakresu od 0:00:00 (północ) do 11:59:59.999. Oznaczenie PM jest stosowane do wszystkich godzin z zakresu od 12:00:00 (południe) do 23:59:59.999.

Pamiętaj, aby użyć specyfikatora "tt" dla języków, dla których konieczne jest zachowanie rozróżnienia między am i PM. Przykładem jest język japoński, dla którego oznaczenia AM i PM różnią się w drugim znaku, a nie w pierwszym znaku.

W poniższym przykładzie specyfikator formatu niestandardowego „tt” jest używany w ciągu formatu niestandardowego.

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

Powrót do tabeli

Specyfikator formatu "y" roku

Specyfikator formatu niestandardowego "y"

Specyfikator formatu niestandardowego „y” przedstawia rok jako jedno- lub dwucyfrową liczbę. Jeśli rok ma więcej niż dwie cyfry, w wyniku pojawią się tylko dwie ostatnie cyfry. Jeżeli pierwsza cyfra roku dwucyfrowego rozpoczyna się od zera (na przykład, 2008), liczba jest formatowana bez zera wiodącego.

Jeśli specyfikator formatu "y" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako specyfikator standardowego formatu daty i godziny "y". Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

W poniższym przykładzie specyfikator formatu niestandardowego „y” jest używany w ciągu formatu niestandardowego.

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

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

Powrót do tabeli

Specyfikator formatu niestandardowego "yyy"

Specyfikator formatu niestandardowego „yy” przedstawia rok jako liczbę dwucyfrową. Jeśli rok ma więcej niż dwie cyfry, w wyniku pojawią się tylko dwie ostatnie cyfry. Jeśli rok dwucyfrowy ma mniej niż dwie cyfry znaczące, liczba jest dopełniana wiodącymi zerami w celu utworzenia dwóch cyfr.

W operacji analizowania dwucyfrowy rok, który jest analizowany przy użyciu specyfikatora formatu niestandardowego "y" jest interpretowany na podstawie bieżącego kalendarza dostawcy formatu. W poniższym przykładzie jest analizowany ciąg przedstawiając datę, która ma domyślnie dwucyfrowy rok według domyślnego kalendarza gregoriańskiego w kulturze en-US, która w tym przypadku jest bieżącą kulturą. Wartości zwracane dla daty czterocyfrowej zależą od zakresu 100 lat ustawionego przez system operacyjny.

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

W poniższym przykładzie specyfikator formatu niestandardowego „yy” jest używany w ciągu formatu niestandardowego.

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

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

Powrót do tabeli

Specyfikator formatu niestandardowego "yyy"

Specyfikator formatu niestandardowego „yyy” przedstawia rok za pomocą co najmniej trzech cyfr. Jeśli rok ma więcej niż trzy cyfry znaczące, są one uwzględnione w ciągu wynikowym. Jeśli rok ma mniej niż trzy cyfry, liczba jest dopełniana wiodącymi zerami w celu utworzenia trzech cyfr.

Uwaga

W przypadku tajskiego kalendarza buddyjskiego, w którym rok może być liczbą pięciocyfrową, ten specyfikator formatu powoduje wyświetlenie wszystkich cyfr znaczących.

W poniższym przykładzie specyfikator formatu niestandardowego „yyy” jest używany w ciągu formatu niestandardowego.

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

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

Powrót do tabeli

Specyfikator formatu niestandardowego "yyyy"

Specyfikator formatu niestandardowego „yyyy” przedstawia rok za pomocą co najmniej czterech cyfr. Jeśli rok ma więcej niż cztery cyfry znaczące, są one uwzględnione w ciągu wynikowym. Jeśli rok ma mniej niż cztery cyfry, liczba jest dopełniana wiodącymi zerami w celu utworzenia czterech cyfr.

Uwaga

W przypadku tajskiego kalendarza buddyjskiego, w którym rok może być liczbą pięciocyfrową, ten specyfikator formatu powoduje wyświetlenie co najmniej czterech cyfr.

W poniższym przykładzie specyfikator formatu niestandardowego „yyyy” jest używany w ciągu formatu niestandardowego.

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

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

Powrót do tabeli

Specyfikator formatu niestandardowego "yyy"

Specyfikator formatu niestandardowego „yyyyy” (plus dowolna liczba dodatkowych specyfikatorów „y”) przedstawia rok za pomocą co najmniej pięciu cyfr. Jeśli rok ma więcej niż pięć cyfr znaczących, są one uwzględnione w ciągu wynikowym. Jeśli rok ma mniej niż pięć cyfr, liczba jest dopełniana zerami wiodącymi w celu utworzenia pięciu cyfr.

Jeśli istnieją dodatkowe specyfikatory „y”, liczba jest dopełniana tak wieloma zerami wiodącymi, jak jest to konieczne, aby utworzyć liczbę specyfikatorów „y”.

W poniższym przykładzie specyfikator formatu niestandardowego „yyyyy” jest używany w ciągu formatu niestandardowego.

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

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

Powrót do tabeli

Specyfikator formatu przesunięcia "z"

Specyfikator formatu niestandardowego "z"

W przypadku wartości DateTimeZone specyfikator formatu niestandardowego "z" reprezentuje podpisane przesunięcie określonej strefy czasowej z uniwersalnego czasu koordynowanego (UTC), mierzone w godzinach. Przesuni‪ęcie jest zawsze wyświetlane ze znakiem wiodącym. Znak plus (+) wskazuje godziny wyprzedzające czas UTC, a znak minus (-) wskazuje godziny pozostające w tyle za czasem UTC. Przesunięcie jednocyfrowe jest formatowane bez zera wiodącego.

W poniższej tabeli pokazano, jak zmienia się wartość przesunięcia w zależności od funkcji DateTimeZone .

Wartość dateTimeZone	Wartość przesunięcia
DateTimeZone.LocalNow	W programie Power Query Desktop podpisane przesunięcie strefy czasowej lokalnego systemu operacyjnego z czasu UTC. W usłudze Power Query Online zwraca wartość +00.
DateTimeZone.UtcNow	Zwraca wartość +0.

Jeśli specyfikator formatu "z" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako standardowy specyfikator formatu daty i godziny i zgłasza błąd wyrażenia. Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

Poniższy przykład zawiera specyfikator formatu niestandardowego "z" w ciągu formatu niestandardowego w systemie w strefie czasowej Pacyficznego Stanów Zjednoczonych.

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

Uwaga

Wartość zwrócona przez DateTimeZone.LocalNow zależy od tego, czy używasz dodatku Power Query na komputerze lokalnym, czy w trybie online. Na przykład w powyższym przykładzie w systemie w strefie czasowej Pacyfik USA program Power Query Desktop zwraca {0:-7} , ponieważ odczytuje czas ustawiony na komputerze lokalnym. Jednak usługa Power Query Online zwraca {0:+0} , ponieważ odczytuje czas ustawiony na maszynach wirtualnych w chmurze, które są ustawione na utc.

Powrót do tabeli

Specyfikator formatu niestandardowego "zz"

W przypadku wartości DateTimeZone specyfikator formatu niestandardowego "zz" reprezentuje podpisane przesunięcie określonej strefy czasowej z czasu UTC mierzone w godzinach. Przesuni‪ęcie jest zawsze wyświetlane ze znakiem wiodącym. Znak plus (+) wskazuje godziny wyprzedzające czas UTC, a znak minus (-) wskazuje godziny pozostające w tyle za czasem UTC. Przesunięcie jednocyfrowe jest sformatowane z zerem wiodącym.

W poniższej tabeli pokazano, jak zmienia się wartość przesunięcia w zależności od funkcji DateTimeZone .

Wartość dateTimeZone	Wartość przesunięcia
DateTimeZone.LocalNow	W programie Power Query Desktop podpisane przesunięcie strefy czasowej lokalnego systemu operacyjnego z czasu UTC. W usłudze Power Query Online zwraca wartość +00.
DateTimeZone.UtcNow	Zwraca wartość +00.

Poniższy przykład zawiera specyfikator formatu niestandardowego "zz" w ciągu formatu niestandardowego w systemie w strefie czasowej Pacyfik USA.

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

Uwaga

Wartość zwrócona przez DateTimeZone.LocalNow zależy od tego, czy używasz dodatku Power Query na komputerze lokalnym, czy w trybie online. Na przykład w powyższym przykładzie w systemie w strefie czasowej Pacyfik USA program Power Query Desktop zwraca {0:-07} , ponieważ odczytuje czas ustawiony na komputerze lokalnym. Jednak usługa Power Query Online zwraca {0:+00} , ponieważ odczytuje czas ustawiony na maszynach wirtualnych w chmurze, które są ustawione na utc.

Powrót do tabeli

Specyfikator formatu niestandardowego "zzz"

W przypadku wartości DateTimeZone specyfikator formatu niestandardowego "zzz" reprezentuje podpisane przesunięcie określonej strefy czasowej z utc, mierzone w godzinach i minutach. Przesuni‪ęcie jest zawsze wyświetlane ze znakiem wiodącym. Znak plus (+) wskazuje godziny wyprzedzające czas UTC, a znak minus (-) wskazuje godziny pozostające w tyle za czasem UTC. Przesunięcie oznaczone jedną cyfrą jest formatowane z zerem wiodącym.

W poniższej tabeli pokazano, jak zmienia się wartość przesunięcia w zależności od funkcji DateTimeZone .

Wartość DateTimeZoneValue	Wartość przesunięcia
DateTimeZone.LocalNow	W programie Power Query Desktop podpisane przesunięcie strefy czasowej lokalnego systemu operacyjnego z czasu UTC. W usłudze Power Query Online zwraca wartość +00.
DateTimeZone.UtcNow	Zwraca wartość +00:00.

Poniższy przykład zawiera specyfikator formatu niestandardowego "zzz" w ciągu formatu niestandardowego w systemie w strefie czasowej Pacyfik USA.

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

Uwaga

Wartość zwrócona przez DateTimeZone.LocalNow zależy od tego, czy używasz dodatku Power Query na komputerze lokalnym, czy w trybie online. Na przykład w powyższym przykładzie w systemie w strefie czasowej Pacyfik USA program Power Query Desktop zwraca {0:-07:00} , ponieważ odczytuje czas ustawiony na komputerze lokalnym. Jednak usługa Power Query Online zwraca {0:+00:00} , ponieważ odczytuje czas ustawiony na maszynach wirtualnych w chmurze, które są ustawione na utc.

Powrót do tabeli

Specyfikatory separatora daty i godziny

Specyfikator formatu niestandardowego ":"

Specyfikator formatu niestandardowego „:” przedstawia separator godzin, który jest używany do odróżnienia godzin, minut i sekund. Odpowiedni zlokalizowany separator czasu jest pobierany z bieżącej lub określonej kultury.

Uwaga

Aby zmienić separator czasu dla określonego ciągu daty i godziny, określ znak separatora w ograniczniku ciągu literału. Na przykład ciąg hh_dd_ss formatu niestandardowego generuje ciąg wynikowy, w którym znak "_" (podkreślenie) jest zawsze używany jako separator czasu.

Jeśli specyfikator formatu ":" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako standardowy specyfikator formatu daty i godziny i zgłasza błąd wyrażenia. Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

Powrót do tabeli

Specyfikator formatu niestandardowego "/"

Specyfikator formatu niestandardowego „/” oznacza separator daty, który jest używany do odróżnienia lat, miesięcy i dni. Odpowiedni zlokalizowany separator dat jest pobierany z bieżącej lub określonej kultury.

Uwaga

Aby zmienić separator daty dla określonego ciągu daty i godziny, określ znak separatora w ograniczniku ciągu literału. Na przykład ciąg formatu niestandardowego generuje ciąg mm/dd/yyyy wynikowy, w którym "/" jest zawsze używany jako separator daty.

Jeśli specyfikator formatu "/" jest używany bez innych specyfikatorów formatu niestandardowego, jest interpretowany jako standardowy specyfikator formatu daty i godziny i zgłasza błąd wyrażenia. Aby uzyskać więcej informacji na temat korzystania z specyfikatora pojedynczego formatu, przejdź do tematu Używanie specyfikatorów formatu pojedynczego niestandardowego w dalszej części tego artykułu.

Powrót do tabeli

Literały znaków

Następujące znaki w niestandardowym ciągu formatu daty i godziny są zastrzeżone i są zawsze interpretowane jako znaki formatowania lub w przypadku "znaków specjalnych , '/i \.

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

Wszystkie inne znaki są zawsze interpretowane jako literały znaków, a w operacji formatowania są uwzględniane w ciągu wynikowym bez zmian. W operacji analizowania muszą dokładnie odpowiadać znakom w ciągu wejściowym; w porównaniu uwzględniana jest wielkość liter.

W poniższym przykładzie uwzględniono znaki literału "PST" (dla czasu pacyficznego) i "PDT" (dla pacyficznego czasu letniego) reprezentujące lokalną strefę czasową w ciągu formatu. Należy pamiętać, że ciąg jest uwzględniony w ciągu wynikowym i że ciąg, który zawiera lokalny ciąg strefy czasowej, również analizuje się pomyślnie.

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

Istnieją dwa sposoby wskazywania, że znaki mają być interpretowane jako znaki literału, a nie jako znaki rezerwowe, aby można je było uwzględnić w ciągu wynikowym lub pomyślnie przeanalizować w ciągu wejściowym:

• Przez ucieczkę od każdego zastrzeżonego znaku. Aby uzyskać więcej informacji, przejdź do tematu Używanie sekwencji ucieczki.

  Poniższy przykład zawiera znaki literału "pst" (czas standardowy pacyficznego) do reprezentowania lokalnej strefy czasowej w ciągu formatu. Ponieważ ciągi formatu "s" i "t" są ciągami formatu niestandardowego, oba znaki muszą być interpretowane jako literały znaków.

  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
  

• Otaczając cały ciąg literału w apostrofy. Poniższy przykład jest podobny do poprzedniego, z tą różnicą, że ciąg "pst" jest ujęty w apostrofy, aby wskazać, że cały rozdzielany ciąg powinien być interpretowany jako literały znaków.

  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
  

Uwagi

Używanie specyfikatorów pojedynczego formatu niestandardowego

Ciąg niestandardowego formatu daty i godziny składa się z co najmniej dwóch znaków. Metody formatowania daty i godziny interpretują każdy jednoznakowy ciąg jako ciąg standardowego formatu daty i godziny. Jeśli nie rozpoznają znaku jako prawidłowego specyfikatora formatu, zgłaszają błąd wyrażenia. Na przykład ciąg formatu, który składa się tylko ze specyfikatora „h”, jest interpretowany jako ciąg standardowego formatu daty i godziny. Jednak w tym konkretnym przypadku zgłaszany jest wyjątek, ponieważ nie ma specyfikatora formatu daty i godziny "h".

Aby użyć jakiegokolwiek specyfikatora niestandardowego formatu daty i godziny jako jedynego specyfikatora w ciągu formatu (tj. użyć samego specyfikatora formatu niestandardowego „d”, „f”, „F”, „g”, „h”, „H”, „K”, „m”, „M”, „s”, „t”, „y”, „z”, „:”, lub „/”), należy przed lub za specyfikatorem umieścić spację albo umieścić specyfikator formatu procent („%”) przed pojedynczym specyfikatorem niestandardowego formatu daty i godziny.

Na przykład "%h" jest interpretowany jako niestandardowy ciąg formatu daty i godziny, który wyświetla godzinę reprezentowaną przez bieżącą wartość daty i godziny. Można także użyć ciągu formatu „ h” lub „h ”, mimo że zawierają w ciągu wynikowym i spację, i godzinę. W poniższym przykładzie pokazano te trzy ciągi formatu.

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 ' 

Używanie sekwencji ucieczki

Znaki „D”, „f”, „F”, „G”, „g”, „H”, „K”, „m”, „M”, „s”, „t”, „y”, „z”, „:”, lub „/” w ciągu formatu są interpretowane jako specyfikatory formatu niestandardowego, a nie jako znaki literału.

Aby zapobiec interpretowaniu znaku jako specyfikatora formatu, możesz:

• Poprzedzić go ukośnikiem odwrotnym.
• Otaczaj go pojedynczym cudzysłowem.
• Otaczaj go dwoma podwójnymi cudzysłowymi.

Każdy z tych znaków działa jako sekwencja ucieczki. Sekwencja ucieczki oznacza, że następujący znak lub znak otoczony jest literałem tekstowym, który powinien zostać uwzględniony w ciągu wynikowym bez zmian.

Aby uwzględnić podwójny cudzysłów w ciągu wynikowym, należy go ująć za pomocą innego podwójnego cudzysłowu ("").

W poniższym przykładzie użyto różnych sekwencji ucieczki, aby zapobiec interpretowaniu znaków "h" i "m" jako specyfikatorów formatu.

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

Powiązana zawartość

• Wpływ kultury na formatowanie tekstu
• Konwersja typu Date, Time, DateTime i DateTimeZone
• Funkcje daty
• Funkcje DateTime
• Funkcje DateTimeZone
• Funkcje czasu
• Standardowe ciągi formatu daty i godziny