Vlastné reťazce formátu dátumu a času
Reťazec formátu dátumu a času definuje textové vyjadrenie hodnoty Date, DateTime, DateTimeZone alebo Time , ktorá je výsledkom operácie formátovania. Môže tiež definovať vyjadrenie hodnoty dátumu a času, ktoré sa vyžaduje v operácii analýzy, aby sa reťazec úspešne konvertoval na dátum a čas. Vlastný reťazec formátu sa skladá z jedného alebo viacerých špecifikácií formátu dátumu a času. Akýkoľvek reťazec, ktorý nie je reťazcom štandardného formátu dátumu a času, sa interpretuje ako vlastný reťazec formátu dátumu a času.
Pri operáciách formátovania možno použiť vlastné reťazce formátu dátumu a času s ToText
metódou inštancie dátumu a času a časového pásma. Použitie tohto príkladu je znázornené v nasledujúcom príklade.
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
Pri analýze operácií možno vlastné reťazce formátu dátumu a času použiť s funkciami Date, DateTime, Time a DateTimeZone. Tieto funkcie vyžadujú, aby vstupný reťazec presne zodpovedal konkrétnemu vzoru pre úspešnú operáciu analýzy. Nasledujúci príklad znázorňuje volanie funkcie DateTime.FromText na analyzovanie dátumu, ktorý musí obsahovať mesiac, deň a dvojciferný 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.
Nasledujúca tabuľka popisuje špecifikátory vlastného formátu dátumu a času a zobrazuje výsledný reťazec vytvorený jednotlivými špecifikáciami formátu. Reťazce výsledkov predvolene odrážajú konvencie formátovania jazykovej verzie en-US. Ak konkrétny špecifikátor formátu vytvorí lokalizovaný výsledný reťazec, v príklade sa tiež zaznamená kultúra, na ktorú sa výsledný reťazec používa. Ďalšie informácie o používaní vlastných reťazcov formátu dátumu a času nájdete v časti Poznámky .
Špecifikátor formátu | Description | Príklady |
---|---|---|
d | Deň v mesiaci, od 1 do 31. Ďalšie informácie: Špecifikácia vlastného formátu d. |
2009-06-01T13:45:30 -> 1 2009-06-15T13:45:30 -> 15 |
"dd" | Deň v mesiaci, od 01 do 31. Ďalšie informácie: Špecifikácia vlastného formátu dd. |
2009-06-01T13:45:30 -> 01 2009-06-15T13:45:30 -> 15 |
"ddd" | Skrátený názov dňa v týždni. Ďalšie informácie: Špecifikácia vlastného formátu ddd. |
2009-06-15T13:45:30 -> Pon (en-US) 2009-06-15T13:45:30 -> Пн (ru-RU) 2009-06-15T13:45:30 -> lun. (fr-FR) |
"dddd" | Celý názov dňa v týždni. Ďalšie informácie: Špecifikácia vlastného formátu dddd. |
2009-06-15T13:45:30 -> pondelok (en-US) 2009-06-15T13:45:30 -> понььльник (ru-RU) 2009-06-15T13:45:30 -> lundi (fr-FR) |
"f" | Desatiny sekundy v hodnote dátumu a času. Ďalšie informácie: Špecifikácia vlastného formátu f. |
2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.05 -> 0 |
"ff" | Stovky sekundy v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu ff. |
2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> 00 |
"fff" | Milisekundy v hodnote dátumu a času. Ďalšie informácie: Špecifikácia vlastného formátu fff. |
15.6.2009 13:45:30.617 -> 617 15.6.2009 13:45:30.0005 -> 000 |
"ffff" | Desať tisícín sekundy v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu ffff. |
2009-06-15T13:45:30.6175000 -> 6175 2009-06-15T13:45:30.0000500 -> 0000 |
"fffff" | Sto tisícín sekundy v hodnote dátumu a času. Ďalšie informácie: Špecifikácia vlastného formátu fffff. |
2009-06-15T13:45:30.6175400 -> 61754 15.6.2009 13:45:30.00005 -> 00000 |
"ffffff" | Milióny sekúnd v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu ffffff. |
2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.000005 -> 000000 |
"fffffff" | Desať miliónov sekúnd v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu fffffff. |
2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 0001150 |
"F" | Ak nie je nula, vrátia sa desatiny sekundy v hodnote dátumu a času. Ďalšie informácie: Špecifikácia vlastného formátu F. |
2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.0500000 –> (bez výstupu) |
"FF" | Ak nie je nula, stovky sekúnd v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu FF. |
2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 –> (bez výstupu) |
"FFF" | Ak nie je nula, milisekundy v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu FFF. |
2009-06-15T13:45:30.6170000 -> 617 2009-06-15T13:45:30.0005000 –> (bez výstupu) |
"FFFF" | Ak nie je nula, desať tisícin sekundy v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu FFFF. |
2009-06-15T13:45:30.5275000 -> 5275 2009-06-15T13:45:30.0000500 –> (bez výstupu) |
"FFFFF" | Ak nie je nula, stovky tisícok sekundy v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu FFFFF. |
2009-06-15T13:45:30.6175400 -> 61754 2009-06-15T13:45:30.000050 -> (bez výstupu) |
"FFFFFF" | Ak nie je nula, vrátia sa milióny sekúnd v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu FFFFFF. |
2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.000005 –> (bez výstupu) |
"FFFFFFF" | Ak nie je nula, vrátia sa desatiny miliónov sekúnd v hodnote dátumu a času. Ďalšie informácie: Špecifikátor vlastného formátu FFFFFFF. |
2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 000115 |
"g", "gg" | Obdobie alebo doba. Ďalšie informácie: Špecifikácia vlastného formátu "g" alebo "gg". |
2009-06-15T13:45:30.6170000 -> A.D. |
"h" | Hodina, v 12-hodinovom formáte, od 1 do 12. Ďalšie informácie: Špecifikácia vlastného formátu "h". |
2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 1 |
"hh" | Hodina, v 12-hodinovom formáte, od 01 do 12. Ďalšie informácie: Špecifikácia vlastného formátu "hh". |
2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 01 |
"H" | Hodina v 24-hodinovom formáte od 0 do 23. Ďalšie informácie: Špecifikácia vlastného formátu "H". |
2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 13 |
"HH" | Hodina, v 24-hodinovom formáte, od 00 do 23. Ďalšie informácie: Špecifikátor vlastného formátu HH. |
2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 13 |
"K" | Informácie o časovom pásme. Ďalšie informácie: Špecifikátor vlastného formátu "K". |
2009-06-15T13:45:30, Neuvedené –> 2009-06-15T13:45:30, Utc -> +00:00 2009-06-15T13:45:30, Lokálne –> -07:00 (závisí od nastavení lokálneho alebo cloudového počítača) |
"m" | Minúta, od 0 do 59. Ďalšie informácie: Špecifikátor vlastného formátu "m". |
2009-06-15T01:09:30 -> 9 2009-06-15T13:29:30 -> 29 |
"mm" | Minúta, od 00 do 59. Ďalšie informácie: Špecifikácia vlastného formátu mm. |
2009-06-15T01:09:30 -> 09 2009-06-15T01:45:30 -> 45 |
"M" | Mesiac, od 1 do 12. Ďalšie informácie: Špecifikácia vlastného formátu M. |
2009-06-15T13:45:30 -> 6 |
MM | Mesiac, od 01 do 12. Ďalšie informácie: Špecifikátor vlastného formátu MM. |
2009-06-15T13:45:30 -> 06 |
MMM | Skrátený názov mesiaca. Ďalšie informácie: Špecifikátor vlastného formátu MMM. |
2009-06-15T13:45:30 -> jún (en-US) 2009-06-15T13:45:30 -> Juin (fr-FR) 2009-06-15T13:45:30 -> Jún (zu-ZA) |
"MMMM" | Celý názov mesiaca. Ďalšie informácie: Špecifikátor vlastného formátu MMMM. |
2009-06-15T13:45:30 -> jún (en-US) 2009-06-15T13:45:30 -> juni (da-DK) 2009-06-15T13:45:30 -> Juni (zu-ZA) |
"s" | Druhý, od 0 do 59. Ďalšie informácie: Špecifikátor vlastného formátu "s". |
2009-06-15T13:45:09 -> 9 |
"ss" | Druhý, od 00 do 59. Ďalšie informácie: Špecifikácia vlastného formátu "ss". |
2009-06-15T13:45:09 -> 09 |
t | Prvý znak navrhovania dop/odp. Ďalšie informácie: Špecifikácia vlastného formátu t. |
2009-06-15T13:45:30 -> P (en-US) 2009-06-15T13:45:30 -> 午 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR) |
tt | Navrhovanie dop/odp. Ďalšie informácie: Špecifikácia vlastného formátu tt. |
2009-06-15T13:45:30 -> PM (en-US) 2009-06-15T13:45:30 -> 午後 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR) |
"y" | Rok, od 0 do 99. Ďalšie informácie: Špecifikátor vlastného formátu y. |
0001-01-01T00:00:00 -> 1 0900-01-01T00:00:00 -> 0 1900-01-01T00:00:00 -> 0 2009-06-15T13:45:30 -> 9 2019-06-15T13:45:30 -> 19 |
"yy" | Rok, od 00 do 99. Ďalšie informácie: Špecifikátor vlastného formátu yy. |
0001-01-01T00:00:00 -> 01 0900-01-01T00:00:00 -> 00 1900-01-01T00:00:00 -> 00 2019-06-15T13:45:30 -> 19 |
"yyyy" | Rok s minimálne tromi číslicami. Ďalšie informácie: Špecifikátor vlastného formátu yyy. |
0001-01-01T00:00:00 -> 001 0900-01-01T00:00:00 -> 900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009 |
"yyyy" | Rok ako štvormiestne číslo. Ďalšie informácie: Špecifikátor vlastného formátu yyyy. |
0001-01-01T00:00:00 -> 0001 0900-01-01T00:00:00 -> 0900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009 |
"yyyyy" | Rok ako päťmiestne číslo. Ďalšie informácie: Špecifikácia vlastného formátu yyyyy. |
0001-01-01T00:00:00 -> 00001 2009-06-15T13:45:30 -> 02009 |
"z" | Posun hodín od UTC bez úvodných núl. Ďalšie informácie: Špecifikátor vlastného formátu "z". |
2009-06-15T13:45:30-07:00 -> -7 |
"zz" | Posun hodín od UTC s úvodnou nulou pre jednocifernú hodnotu. Ďalšie informácie: Špecifikácia vlastného formátu zz. |
2009-06-15T13:45:30-07:00 -> -07 |
"zzz" | Posun hodín a minút od UTC. Ďalšie informácie: Špecifikácia vlastného formátu zzz. |
2009-06-15T13:45:30-07:00 -> -07:00 |
":" | Oddeľovač časov. Ďalšie informácie: Špecifikácia vlastného formátu ":" |
2009-06-15T13:45:30 -> : (en-US) 2009-06-15T13:45:30 -> . (it-IT) 2009-06-15T13:45:30 -> : (ja-JP) |
"/" | Oddeľovač dátumov. Ďalšie informácie: Špecifikácia vlastného formátu "/". |
2009-06-15T13:45:30 -> / (en-US) 2009-06-15T13:45:30 -> (ar-DZ) 2009-06-15T13:45:30 -> . (tr-TR) |
"string" (reťazec) 'reťazec' |
Oddeľovač reťazcov literálu. Ďalšie informácie: Literály znakov. |
2009-06-15T13:45:30 (""arr:"" h:m t) -> arr: 1:45 P 2009-06-15T13:45:30 ('arr:' h:m t) -> arr: 13:45 P |
% | Definuje nasledujúci znak ako špecifikátor vlastného formátu. Ďalšie informácie: Používanie špecifikácií jedného vlastného formátu. |
2009-06-15T13:45:30 (%h) -> 1 |
\, "", ' | Koncové postupnosti. Ďalšie informácie: Literály znakov a Použitie únikových postupností. |
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 |
Ľubovoľný iný znak | Znak sa skopíruje do výsledného reťazca bez zmeny. Ďalšie informácie: Literály znakov. |
2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A |
Nasledujúce časti poskytujú ďalšie informácie o každom špecifikátoru formátu dátumu a času. Pokiaľ nie je uvedené inak, každý špecifikátor vytvorí identické vyjadrenie reťazca bez ohľadu na to, či sa používa s hodnotou dátumu, dátumu a času, dátumu, času a časového pásma.
Špecifikátor formátu Deň (d)
Špecifikácia vlastného formátu d
Špecifikácia vlastného formátu d predstavuje deň v mesiaci ako číslo od 1 do 31. Deň s jednou číslicou je naformátovaný bez úvodnej nuly.
Ak sa špecifikácia formátu d použije bez iných špecifikácií vlastného formátu, bude interpretovaná ako špecifikácia štandardného formátu dátumu a času. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu d v niekoľkých reťazcoch formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, M", Culture = ""]),
// Displays 29, 8
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "en-US"]),
// Displays 29, August
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "d, MMMM", Culture = "es-MX"])
// Displays 29, agosto
}
in
Source
Špecifikácia vlastného formátu dd
Vlastný reťazec formátu dd predstavuje deň v mesiaci ako číslo od 01 do 31. Deň s jednou číslicou je naformátovaný s úvodnou nulou.
Nasledujúci príklad obsahuje špecifikátor "dd" vlastného formátu vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
// Displays 02, 01
}
in
Source
Špecifikátor vlastného formátu ddd
Špecifikácia vlastného formátu ddd predstavuje skrátený názov dňa v týždni. Lokalizovaný skrátený názov dňa v týždni sa načíta z aktuálnej alebo zadanej jazykovej verzie.
Nasledujúci príklad obsahuje špecifikátor "ddd" vlastného formátu vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
// Displays Thu 29 Aug
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
// Displays jeu. 29 août
}
in
Source
Špecifikácia vlastného formátu dddd
Špecifikátor "dddd" vlastného formátu (plus ľubovoľný počet ďalších špecifikácií d) predstavuje celý názov dňa v týždni. Lokalizovaný názov dňa v týždni sa načíta z aktuálnej alebo zadanej jazykovej verzie.
Nasledujúci príklad obsahuje špecifikátor "dddd" vlastného formátu vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
// Displays Thursday 29 August
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
// Displays giovedì 29 agosto
}
in
Source
Špecifikácia zlomku "f" malými písmenami
Špecifikácia vlastného formátu f
Špecifikácia vlastného formátu f predstavuje najvýznamnejšiu číslicu zlomku sekúnd. to znamená, že predstavuje desatiny sekundy v hodnote dátumu a času.
Ak sa špecifikácia formátu f použije bez iných špecifikácií formátu, interpretuje sa ako špecifikácia štandardného formátu dátumu a času (f). Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Keď použijete špecifikátory formátu f ako súčasť reťazca formátu zadaného na analyzovanie počtu zlomkových sekúnd, počet špecifikácií formátu f označuje počet najvýznamnejších číslic zlomku sekúnd, ktorý musí byť prítomný na úspešnú analýzu reťazca.
Nasledujúci príklad obsahuje špecifikáciu vlastného formátu "f" vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
// Displays 07:27:15:0
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
// Displays 07:27:15:
}
in
Source
Špecifikátor vlastného formátu ff
Špecifikácia vlastného formátu ff predstavuje dve najvýznamnejšie číslice zlomku sekúnd. to znamená, že predstavuje stovky sekúnd v hodnote dátumu a času.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu ff vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
// Displays 07:27:15:01
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
// Displays 07:27:15:01
}
in
Source
Špecifikácia vlastného formátu fff
Špecifikácia vlastného formátu fff predstavuje tri najvýznamnejšie číslice zlomku sekúnd. to znamená, že predstavuje milisekundy v hodnote dátumu a času.
Nasledujúci príklad obsahuje špecifikáciu vlastného formátu fff vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
// Displays 07:27:15:018
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
// Displays 07:27:15:018
}
in
Source
Špecifikátor vlastného formátu ffff
Špecifikácia vlastného formátu ffff predstavuje štyri najvýznamnejšie číslice zlomku sekúnd. to znamená, že predstavuje desať tisícok sekundy v hodnote dátumu a času.
Napriek tomu, že je možné zobraziť desať tisícín sekundy komponentu hodnoty času, táto hodnota nemusí byť zmysluplná. Presnosť hodnôt dátumu a času závisí od rozlíšenia systémových hodín. V operačných systémoch Windows Server 2019 a Windows 11 má rozlíšenie hodín približne 1 milisekundy.
Špecifikátor vlastného formátu fffff
Špecifikácia vlastného formátu fffff predstavuje päť najvýznamnejších číslic zlomkov sekúnd. To znamená, že predstavuje sto tisícín sekundy v hodnote dátumu a času.
Napriek tomu, že je možné zobraziť sto tisícín sekundy komponentu časovej hodnoty, táto hodnota nemusí byť zmysluplná. Presnosť hodnôt dátumu a času závisí od rozlíšenia systémových hodín. V operačných systémoch Windows Server 2019 a Windows 11 má rozlíšenie hodín približne 1 milisekundy.
Špecifikátor vlastného formátu ffffff
Špecifikácia vlastného formátu ffffff predstavuje šesť najvýznamnejších číslic zlomkov sekúnd. to znamená, že predstavuje milióny sekúnd v hodnote dátumu a času.
Napriek tomu, že je možné zobraziť milióny sekúnd zložky časovej hodnoty, táto hodnota nemusí byť zmysluplná. Presnosť hodnôt dátumu a času závisí od rozlíšenia systémových hodín. V operačných systémoch Windows Server 2019 a Windows 11 má rozlíšenie hodín približne 1 milisekundy.
Špecifikátor vlastného formátu fffffff
Špecifikácia vlastného formátu fffffff predstavuje sedem najvýznamnejších číslic zlomkov sekúnd. to znamená, že predstavuje desať miliónov sekúnd v hodnote dátumu a času.
Napriek tomu, že je možné zobraziť desať miliónov sekúnd zložky časovej hodnoty, táto hodnota nemusí byť zmysluplná. Presnosť hodnôt dátumu a času závisí od rozlíšenia systémových hodín. V operačných systémoch Windows Server 2019 a Windows 11 má rozlíšenie hodín približne 1 milisekundy.
Špecifikácia zlomku "F" veľkých písmen
Špecifikácia vlastného formátu F
Špecifikácia vlastného formátu F predstavuje najvýznamnejšiu číslicu zlomku sekúnd. to znamená, že predstavuje desatiny sekundy v hodnote dátumu a času. Ak je číslica nula, nič sa nezobrazí a zobrazí sa aj desatinná bodka, ktorá nasleduje za počtom sekúnd.
Ak sa špecifikácia formátu F použije bez iných špecifikácií formátu, bude interpretovaná ako špecifikácia štandardného formátu dátumu a času (F). Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Počet špecifikácií formátu F použitých pri analýze udáva maximálny počet najvýznamnejších číslic zlomkov sekúnd, ktoré môžu byť prítomné na úspešnú analýzu reťazca.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu F vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:f", Culture = ""]),
// Displays 07:27:15:0
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:F", Culture = ""])
// Displays 07:27:15:
}
in
Source
Špecifikátor vlastného formátu FF
Špecifikácia vlastného formátu FF predstavuje dve najvýznamnejšie číslice zlomku sekúnd. to znamená, že predstavuje stovky sekúnd v hodnote dátumu a času. Koncové nuly sa nezobrazujú. Ak sú dve platné číslice nula, nič sa nezobrazí. V takom prípade sa nezobrazí ani desatinná bodka, ktorá nasleduje za počtom sekúnd.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu FF vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:ff", Culture = ""]),
// Displays 07:27:15:01
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FF", Culture = ""])
// Displays 07:27:15:01
}
in
Source
Špecifikátor vlastného formátu FFF
Špecifikácia vlastného formátu FFF predstavuje tri najvýznamnejšie číslice zlomku sekúnd. to znamená, že predstavuje milisekundy v hodnote dátumu a času. Koncové nuly sa nezobrazujú. Ak sú tri platné číslice nula, nič sa nezobrazí. V takom prípade sa nezobrazí ani desatinná bodka, ktorá nasleduje za počtom sekúnd.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu FFF vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:fff", Culture = ""]),
// Displays 07:27:15:018
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15.018), [Format = "hh:mm:ss:FFF", Culture = ""])
// Displays 07:27:15:018
}
in
Source
Špecifikátor vlastného formátu FFFF
Špecifikácia vlastného formátu FFFF predstavuje štyri najvýznamnejšie číslice zlomku sekúnd. to znamená, že predstavuje desať tisícok sekundy v hodnote dátumu a času. Koncové nuly sa nezobrazujú. Ak sú štyri platné číslice nula, nič sa nezobrazí. V takom prípade sa nezobrazí ani desatinná bodka, ktorá nasleduje za počtom sekúnd.
Napriek tomu, že je možné zobraziť desať tisícín sekundy komponentu hodnoty času, táto hodnota nemusí byť zmysluplná. Presnosť hodnôt dátumu a času závisí od rozlíšenia systémových hodín. V operačných systémoch Windows Server 2019 a Windows 11 má rozlíšenie hodín približne 1 milisekundy.
Špecifikátor vlastného formátu FFFFF
Špecifikácia vlastného formátu FFFFF predstavuje päť najvýznamnejších číslic zlomkov sekúnd. To znamená, že predstavuje sto tisícín sekundy v hodnote dátumu a času. Koncové nuly sa nezobrazujú. Ak je počet významných číslic nula, nič sa nezobrazí, a v takom prípade sa nezobrazí ani desatinná bodka, ktorá nasleduje za počtom sekúnd.
Napriek tomu, že je možné zobraziť sto tisícín sekundy komponentu časovej hodnoty, táto hodnota nemusí byť zmysluplná. Presnosť hodnôt dátumu a času závisí od rozlíšenia systémových hodín. V operačných systémoch Windows Server 2019 a Windows 11 má rozlíšenie hodín približne 1 milisekundy.
Špecifikátor vlastného formátu FFFFFF
Špecifikátor vlastného formátu FFFFFF predstavuje šesť najvýznamnejších číslic zlomkov sekúnd. to znamená, že predstavuje milióny sekúnd v hodnote dátumu a času. Koncové nuly sa nezobrazujú. Ak je počet významných číslic nula, nič sa nezobrazí, a v takom prípade sa nezobrazí ani desatinná bodka, ktorá nasleduje za počtom sekúnd.
Napriek tomu, že je možné zobraziť milióny sekúnd zložky časovej hodnoty, táto hodnota nemusí byť zmysluplná. Presnosť hodnôt dátumu a času závisí od rozlíšenia systémových hodín. V operačných systémoch Windows Server 2019 a Windows 11 má rozlíšenie hodín približne 1 milisekundy.
Špecifikátor vlastného formátu FFFFFFF
Špecifikácia vlastného formátu FFFFFFF predstavuje sedem najvýznamnejších číslic zlomkov sekúnd. to znamená, že predstavuje desať miliónov sekúnd v hodnote dátumu a času. Koncové nuly sa nezobrazujú. Ak je sedem významných číslic nula, nič sa nezobrazí, a v takom prípade sa nezobrazí ani desatinná bodka, ktorá nasleduje za počtom sekúnd.
Napriek tomu, že je možné zobraziť desať miliónov sekúnd zložky časovej hodnoty, táto hodnota nemusí byť zmysluplná. Presnosť hodnôt dátumu a času závisí od rozlíšenia systémových hodín. V operačných systémoch Windows Server 2019 a Windows 11 má rozlíšenie hodín približne 1 milisekundy.
Špecifikácia formátu Era "g"
Špecifikátor vlastného formátu "g" alebo "gg"
Špecifikátory vlastného formátu "g" alebo "gg" (plus ľubovoľný počet ďalších špecifikácií "g") predstavujú obdobie alebo éru, ako je napríklad A.D. Operácia formátovania ignoruje tento špecifikátor, ak dátum, ktorý sa má formátovať, nemá priradené obdobie alebo reťazec éry.
Ak sa špecifikácia formátu "g" použije bez iných špecifikácií vlastného formátu, interpretuje sa ako špecifikácia štandardného formátu dátumu a času (g). Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu "g" vo vlastnom reťazci formátu.
let
Source =
{
Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = ""]),
// Displays 08/04/0070 A.D.
Date.ToText(#date(70, 08, 04), [Format = "MM/dd/yyyy g", Culture = "fr-FR"])
// Displays 08/04/0070 ap. J.-C.
}
in
Source
Špecifikátor formátu "h" malým písmenom
Špecifikácia vlastného formátu "h"
Špecifikácia vlastného formátu "h" predstavuje hodinu ako číslo od 1 do 12. t. j. hodina je zastúpená 12-hodinovým časom, ktorý počíta celé hodiny od polnoci alebo poludnia. Konkrétna hodina po polnoci je nerozoznateľná od rovnakej hodiny po poludní. Hodina sa nezaokrúhľuje a jednociferná hodina je formátovaná bez úvodnej nuly. Napríklad s daným časom 5:43 ráno alebo popoludní, tento špecifikátor vlastného formátu zobrazí hodnotu 5.
Ak sa špecifikácia formátu "h" používa bez iných špecifikácií vlastného formátu, interpretuje sa ako špecifikácia štandardného formátu dátumu a času a vyvolá chybu výrazu. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikáciu vlastného formátu "h" vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
// Displays 6:9:1 P
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
// Displays 6:9:1 μ
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
// Displays 9:18:1.5 A
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
// Displays 9:18:1.5 π
}
in
Source
Špecifikátor vlastného formátu hh
Špecifikácia vlastného formátu hh (plus ľubovoľný počet ďalších špecifikácií "h") predstavuje hodinu ako číslo od 01 do 12; t. j. hodina je zastúpená 12-hodinovým časom, ktorý počíta celé hodiny od polnoci alebo poludnia. Konkrétna hodina po polnoci je nerozoznateľná od rovnakej hodiny po poludní. Hodina sa nezaokrúhľuje a jednociferná hodina je formátovaná s úvodnou nulou. Napríklad s ohľadom na čas 5:43 ráno alebo popoludní, tento špecifikátor formátu zobrazí hodnotu 05.
Nasledujúci príklad obsahuje špecifikátor "hh" vlastného formátu vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
// Displays 06:09:01 PM
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
// Displays 06:09:01 du.
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
// Displays 09:18:01.50 AM
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
// Displays 09:18:01.50 de.
}
in
Source
Špecifikátor formátu "H" vo veľkých písmenách
Špecifikácia vlastného formátu H
Špecifikácia vlastného formátu H predstavuje hodinu ako číslo od 0 do 23. to znamená, že hodina je zastúpená 24-hodinovým časom založeným na nule, ktorý počíta hodiny od polnoci. Jednociferná hodina je naformátovaná bez úvodnej nuly.
Ak sa špecifikácia formátu H použije bez iných špecifikácií vlastného formátu, interpretuje sa ako štandardný špecifikátor formátu dátumu a času a vyvolá chybu výrazu. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikáciu vlastného formátu H vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "H:mm:ss", Culture = ""])
// Displays 6:09:01
}
in
Source
Špecifikátor vlastného formátu HH
Špecifikátor vlastného formátu HH (plus ľubovoľný počet ďalších špecifikácií "H") predstavuje hodinu ako číslo od 00 do 23; to znamená, že hodina je zastúpená 24-hodinovým časom založeným na nule, ktorý počíta hodiny od polnoci. Jednociferná hodina je formátovaná s úvodnou nulou.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu HH vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "HH:mm:ss", Culture = ""])
// Displays 06:09:01
}
in
Source
Špecifikácia formátu časového pásma "K"
Špecifikátor vlastného formátu "K"
Špecifikácia vlastného formátu K predstavuje informácie o časovom pásme hodnoty dátumu a času. Keď sa tento špecifikátor formátu použije s hodnotami DateTimeZone , výsledný reťazec sa definuje ako:
Pre miestne časové pásmo vytvorí tento špecifikátor výsledný reťazec obsahujúci lokálny posun od koordinovaného svetového času (UTC), napríklad -07:00, ak sa dotaz spustí v aplikácii Power Query Desktop. Ak je dotaz spustený v Power Query Online, výsledný reťazec nemá žiadny posun od utc času, to znamená +00:00.
Pre čas UTC nemá výsledný reťazec žiadny posun od utc času; to znamená + 00:00, ktoré predstavuje dátum UTC.
Pre čas z neuvedeného časového pásma je výsledok prázdny.
Ak sa špecifikácia formátu "K" používa bez iných špecifikácií vlastného formátu, interpretuje sa ako špecifikácia štandardného formátu dátumu a času a vyvolá chybu výrazu. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad zobrazuje reťazec, ktorý je výsledkom použitia špecifikátoru vlastného formátu "K" s rôznymi hodnotami v systéme v americkom tichomorskom časovom pásme.
let
Source =
{
DateTimeZone.ToText(DateTimeZone.LocalNow(),[Format="%K"]),
// Displays -07:00 (Desktop) or +00:00 (Online)
DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="%K"]),
// Displays +00:00
Text.Format("'#{0}'", {DateTime.ToText(DateTime.LocalNow(),[Format="%K"])})
// Displays ''
}
in
Source
Poznámka
Hodnota vrátená DateTimeZone.LocalNow závisí od toho, či používate Power Query v lokálnom počítači alebo online. V ukážke vyššie v systéme v americkom tichomorskom časovom pásme sa napríklad vráti -07:00
aplikácia Power Query Desktop, pretože číta čas nastavený v lokálnom počítači. Power Query Online však vráti +00:00
, pretože číta čas nastavený na cloudových virtuálnych počítačoch, ktoré sú nastavené na UTC.
Špecifikácia formátu minúty (m)
Špecifikátor vlastného formátu "m"
Špecifikácia vlastného formátu m predstavuje minútu ako číslo od 0 do 59. Minúta predstavuje celé minúty, ktoré uplynuli od poslednej hodiny. Jednociferná minúta je naformátovaná bez úvodnej nuly.
Ak sa špecifikácia formátu m použije bez iných špecifikácií vlastného formátu, interpretuje sa ako špecifikácia štandardného formátu dátumu a času (m). Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu m vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
// Displays 6:9:1 P
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
// Displays 6:9:1 μ
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
// Displays 9:18:1.5 A
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
// Displays 9:18:1.5 π
}
in
Source
Špecifikátor vlastného formátu "mm"
Špecifikácia vlastného formátu "mm" (plus ľubovoľný počet ďalších špecifikácií "m") predstavuje minútu ako číslo od 00 do 59. Minúta predstavuje celé minúty, ktoré uplynuli od poslednej hodiny. Jednociferná minúta je formátovaná s úvodnou nulou.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu mm vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
// Displays 06:09:01 PM
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
// Displays 06:09:01 du.
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
// Displays 09:18:01.50 AM
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
// Displays 09:18:01.50 de.
}
in
Source
Špecifikátor formátu mesiac "M"
Špecifikácia vlastného formátu M
Špecifikácia vlastného formátu M predstavuje mesiac ako číslo od 1 do 12 (alebo od 1 do 13 pre kalendáre, ktoré majú 13 mesiacov). Mesiac s jednou číslicou je naformátovaný bez úvodnej nuly.
Ak sa špecifikácia formátu M použije bez iných špecifikácií vlastného formátu, interpretuje sa ako špecifikácia štandardného formátu dátumu a času M. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu M vo vlastnom reťazci formátu.
let
Source =
{
Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "en-US"]),
// Displays (8) Aug, August
Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "nl-NL"]),
// Displays (8) aug, augustus
Date.ToText(#date(2024, 8, 18), [Format = "(M) MMM, MMMM", Culture = "lv-LV"])
// Displays (8) aug., augusts
}
in
Source
Špecifikácia vlastného formátu MM
Špecifikácia vlastného formátu MM predstavuje mesiac ako číslo od 01 do 12 (alebo od 1 do 13 pre kalendáre, ktoré majú 13 mesiacov). Mesiac s jednou číslicou je naformátovaný s úvodnou nulou.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu MM vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
// Displays 02, 01
}
in
Source
Špecifikátor vlastného formátu MMM
Špecifikácia vlastného formátu MMM predstavuje skrátený názov mesiaca. Lokalizovaný skrátený názov mesiaca sa načíta zo skrátených názvov mesiacov aktuálnej alebo zadanej jazykovej verzie. Ak je vo vlastnom reťazci formátu špecifikátor vlastného formátu "d" alebo "dd", názov mesiaca sa načíta zo skrátených genitívnych názvov.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu MMM vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "en-US"]),
// Displays Thu 29 Aug
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "ddd d MMM", Culture = "fr-FR"])
// Displays jeu. 29 août
}
in
Source
Špecifikátor vlastného formátu MMMM
Špecifikácia vlastného formátu MMMM predstavuje úplný názov mesiaca. Lokalizovaný názov mesiaca sa načíta z aktuálnej alebo zadanej jazykovej verzie. Ak je vo vlastnom reťazci formátu špecifikátor vlastného formátu "d" alebo "dd", názov mesiaca sa načíta zo skrátených genitívnych názvov.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu MMMM vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "en-US"]),
// Displays Thursday 29 August
DateTime.ToText(#datetime(2024, 8, 29, 19, 27, 15), [Format = "dddd dd MMMM", Culture = "it-IT"])
// Displays giovedì 29 agosto
}
in
Source
Špecifikátor formátu seconds "s"
Špecifikácia vlastného formátu "s"
Špecifikácia vlastného formátu "s" predstavuje sekundy ako číslo od 0 do 59. Výsledok predstavuje celé sekundy, ktoré uplynuli od poslednej minúty. Jednociferná sekunda je naformátovaná bez úvodnej nuly.
Ak sa špecifikácia formátu "s" použije bez iných špecifikácií vlastného formátu, interpretuje sa ako špecifikácia štandardného formátu dátumu a času "s". Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu "s" vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
// Displays 6:9:1 P
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
// Displays 6:9:1 μ
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
// Displays 9:18:1.5 A
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
// Displays 9:18:1.5 π
}
in
Source
Špecifikácia vlastného formátu "ss"
Špecifikátor vlastný formát "ss" (plus ľubovoľný počet ďalších špecifikácií "s") predstavuje sekundy ako číslo od 00 do 59. Výsledok predstavuje celé sekundy, ktoré uplynuli od poslednej minúty. Jednociferná sekunda je formátovaná s úvodnou nulou.
Nasledujúci príklad obsahuje špecifikátor "ss" vlastného formátu vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
// Displays 06:09:01 PM
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
// Displays 06:09:01 du.
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
// Displays 09:18:01.50 AM
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
// Displays 09:18:01.50 de.
}
in
Source
Špecifikátor formátu Meridiem "t"
Špecifikácia vlastného formátu "t"
Špecifikácia vlastného formátu t predstavuje prvý znak navrhovania DOP/ODP. Vhodný lokalizovaný návrhovač sa načíta z aktuálnej alebo konkrétnej jazykovej verzie. Návrhovač AM sa používa pre všetky časy od 0:00:00 (polnoc) do 11:59:59.999. Návrhovač PM sa používa pre všetky časy od 12:00:00 (poludnie) do 23:59:59.999.
Ak sa špecifikácia formátu t použije bez iných špecifikácií vlastného formátu, bude interpretovaná ako špecifikácia štandardného formátu dátumu a času .t. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikáciu vlastného formátu t vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = ""]),
// Displays 6:9:1 P
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "h:m:s.F t", Culture = "el-GR"]),
// Displays 6:9:1 μ
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = ""]),
// Displays 9:18:1.5 A
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "h:m:s.F t", Culture = "el-GR"])
// Displays 9:18:1.5 π
}
in
Source
Špecifikácia vlastného formátu tt
Špecifikátor "tt" vlastného formátu (plus ľubovoľný počet ďalších špecifikácií "t") predstavuje celý návrhátor AM/PM. Vhodný lokalizovaný návrhovač sa načíta z aktuálnej alebo konkrétnej jazykovej verzie. Návrhovač AM sa používa pre všetky časy od 0:00:00 (polnoc) do 11:59:59.999. Návrhovač PM sa používa pre všetky časy od 12:00:00 (poludnie) do 23:59:59.999.
Uistite sa, že používate špecifikátor tt pre jazyky, pre ktoré je potrebné zachovať rozdiel medzi dop a odp. Príkladom je japončina, pre ktorú sa navrhovania AM a PM líšia v druhom znaku namiesto prvého znaku.
Nasledujúci príklad obsahuje špecifikátor "tt" vlastného formátu vo vlastnom reťazci formátu.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = ""]),
// Displays 06:09:01 PM
DateTime.ToText(#datetime(2024, 1, 1, 18, 9, 1), [Format = "hh:mm:ss tt", Culture = "hu-HU"]),
// Displays 06:09:01 du.
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = ""]),
// Displays 09:18:01.50 AM
DateTime.ToText(#datetime(2024, 1, 1, 9, 18, 1.500), [Format = "hh:mm:ss.ff tt", Culture = "hu-HU"])
// Displays 09:18:01.50 de.
}
in
Source
Špecifikácia formátu roka "y"
Špecifikácia vlastného formátu "y"
Špecifikácia vlastného formátu y predstavuje rok ako jednociferné alebo dvojmiestne číslo. Ak má rok viac ako dve číslice, vo výsledku sa zobrazia iba dve číslice s nízkou objednávkou. Ak prvá číslica roka s dvomi číslicami začína nulou (napríklad 2008), číslo sa naformátuje bez úvodnej nuly.
Ak sa špecifikácia formátu y použije bez iných špecifikácií vlastného formátu, interpretuje sa ako špecifikácia štandardného formátu dátumu a času y. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu "y" vo vlastnom reťazci formátu.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "%y"]),
// Displays 1
Date.ToText(#date(2024, 1, 1), [Format = "%y"])
// Displays 24
}
in
Source
Špecifikátor vlastného formátu "yy"
Špecifikácia vlastného formátu yy predstavuje rok ako dvojmiestne číslo. Ak má rok viac ako dve číslice, vo výsledku sa zobrazia iba dve číslice s nízkou objednávkou. Ak má dvojciferný rok menej ako dve platné číslice, číslo je vyplnené úvodnými nulami, aby sa vytvorili dve číslice.
Pri analýze sa dvojciferný rok, ktorý sa analyzuje pomocou špecifikátoru vlastného formátu yy, interpretuje na základe aktuálneho kalendára poskytovateľa formátu. Nasledujúci príklad analyzuje vyjadrenie reťazca dátumu, ktorý má dvojciferný rok, pomocou predvoleného gregoriánskeho kalendára jazykovej verzie en-US, ktorý je v tomto prípade aktuálnou jazykovou verziou. Hodnoty vrátené pre štvorciferný dátum závisia od rozsahu 100 rokov, ktorý nastaví operačný systém.
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
Nasledujúci príklad obsahuje špecifikátor "yy" vlastného formátu vo vlastnom reťazci formátu.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yy"]),
// Displays 01
Date.ToText(#date(2024, 1, 1), [Format = "yy"])
// Displays 24
}
in
Source
Špecifikátor vlastného formátu "yyy"
Špecifikátor vlastného formátu yyy predstavuje rok s minimálne tromi číslicami. Ak má rok viac ako tri platné číslice, sú zahrnuté vo výslednom reťazci. Ak má rok menej ako tri číslice, číslo je vyplnené úvodnými nulami, aby sa vytvorili tri číslice.
Poznámka
Pre thajský budhistický kalendár, ktorý môže mať päťciferné roky, zobrazuje tento špecifikátor formátu všetky platné číslice.
Nasledujúci príklad obsahuje špecifikátor "yyy" vlastného formátu vo vlastnom reťazci formátu.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yyy"]),
// Displays 001
Date.ToText(#date(2024, 1, 1), [Format = "yyy"])
// Displays 2024
}
in
Source
Špecifikátor vlastného formátu "yyyy"
Špecifikátor vlastného formátu yyyy predstavuje rok s minimálne štyrmi číslicami. Ak má rok viac ako štyri platné číslice, sú zahrnuté vo výslednom reťazci. Ak má rok menej ako štyri číslice, číslo je vyplnené úvodnými nulami, aby sa vytvorili štyri číslice.
Poznámka
Pre thajský budhistický kalendár, ktorý môže mať päťciferné roky, zobrazuje tento špecifikátor formátu minimálne štyri číslice.
Nasledujúci príklad obsahuje špecifikátor "yyyy" vlastný formát vo vlastnom reťazci formátu.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yyyy"]),
// Displays 0001
Date.ToText(#date(2024, 1, 1), [Format = "yyyy"])
// Displays 2024
}
in
Source
Špecifikátor vlastného formátu yyyyy
Špecifikátor vlastného formátu yyyy (plus ľubovoľný počet ďalších špecifikácií y) predstavuje rok s minimálne piatimi číslicami. Ak má rok viac ako päť významných číslic, sú zahrnuté vo výslednom reťazci. Ak má rok menej ako päť číslic, číslo je vyplnené úvodnými nulami, aby sa vytvorilo päť číslic.
Ak existujú ďalšie špecifikátory "y", číslo je vyplnené ľubovoľným počtom úvodných núl, ktorý je potrebný na vytvorenie počtu špecifikácií y.
Nasledujúci príklad obsahuje špecifikáciu vlastného formátu "yyyyy" vo vlastnom reťazci formátu.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yyyyy"]),
// Displays 00001
Date.ToText(#date(2024, 1, 1), [Format = "yyyyy"])
// Displays 02024
}
in
Source
Špecifikácia formátu Offset "z"
Špecifikácia vlastného formátu z
Pri hodnotách DateTimeZone predstavuje špecifikácia vlastného formátu "z" posun zadaného časového pásma od koordinovaného svetového času (UTC) meraného v hodinách. Posun sa vždy zobrazuje s úvodným znamienkom. Znamienko plus (+) označuje hodiny pred UTC a znamienko mínus (-) označuje hodiny za UTC. Posun jednej číslice je naformátovaný bez úvodnej nuly.
V nasledujúcej tabuľke je uvedené, ako sa hodnota posunu mení v závislosti od funkcie DateTimeZone .
Hodnota DateTimeZone | Hodnota posunu |
---|---|
DateTimeZone.LocalNow | V aplikácii Power Query Desktop je to posun časového pásma lokálneho operačného systému od UTC. V Power Query Online vráti hodnotu +00 . |
DateTimeZone.UtcNow | Vráti hodnotu +0 . |
Ak sa špecifikácia formátu z použije bez iných špecifikácií vlastného formátu, bude interpretovaná ako špecifikácia štandardného formátu dátumu a času a vyvolá chybu výrazu. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Nasledujúci príklad obsahuje špecifikátor vlastného formátu z vo vlastnom reťazci formátu v systéme v časovom pásme USA a Tichomoria.
let
Source =
{
DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:%z}"]),
// Displays {0:-7} on Power Query Desktop
// Displays {0:+0} on Power Query Online
DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:%z}"]),
// Displays {0:+0}
DateTimeZone.ToText(DateTimeZone.SwitchZone(
#datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6),
[Format = "{0:%z}"]
)
// Displays {0:+6}
}
in
Source
Poznámka
Hodnota vrátená DateTimeZone.LocalNow závisí od toho, či používate Power Query v lokálnom počítači alebo online. V ukážke vyššie v systéme v americkom tichomorskom časovom pásme sa napríklad vráti {0:-7}
aplikácia Power Query Desktop, pretože číta čas nastavený v lokálnom počítači. Power Query Online však vráti {0:+0}
, pretože číta čas nastavený na cloudových virtuálnych počítačoch, ktoré sú nastavené na UTC.
Špecifikátor vlastného formátu zz
S hodnotami DateTimeZone predstavuje špecifikátor "zz" vlastný formát posunu zadaného časového pásma od UTC meraného v hodinách. Posun sa vždy zobrazuje s úvodným znamienkom. Znamienko plus (+) označuje hodiny pred UTC a znamienko mínus (-) označuje hodiny za UTC. Posun jednej číslice je formátovaný s úvodnou nulou.
V nasledujúcej tabuľke je uvedené, ako sa hodnota posunu mení v závislosti od funkcie DateTimeZone .
Hodnota DateTimeZone | Hodnota posunu |
---|---|
DateTimeZone.LocalNow | V aplikácii Power Query Desktop je to posun časového pásma lokálneho operačného systému od UTC. V Power Query Online vráti hodnotu +00 . |
DateTimeZone.UtcNow | Vráti hodnotu +00 . |
Nasledujúci príklad obsahuje špecifikátor "zz" vlastného formátu vo vlastnom reťazci formátu v systéme v časovom pásme USA a Tichomoria.
let
Source =
{
DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zz}"]),
// Displays {0:-07} on Power Query Desktop
// Displays {0:+00} on Power Query Online
DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zz}"]),
// Displays {0:+00}
DateTimeZone.ToText(DateTimeZone.SwitchZone(
#datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6),
[Format = "{0:zz}"]
)
// Displays {0:+06}
}
in
Source
Poznámka
Hodnota vrátená DateTimeZone.LocalNow závisí od toho, či používate Power Query v lokálnom počítači alebo online. V ukážke vyššie v systéme v americkom tichomorskom časovom pásme sa napríklad vráti {0:-07}
aplikácia Power Query Desktop, pretože číta čas nastavený v lokálnom počítači. Power Query Online však vráti {0:+00}
, pretože číta čas nastavený na cloudových virtuálnych počítačoch, ktoré sú nastavené na UTC.
Špecifikátor vlastného formátu ZZZ
S hodnotami DateTimeZone predstavuje špecifikácia vlastného formátu "zzz" posun zadaného časového pásma od UTC meraný v hodinách a minútach. Posun sa vždy zobrazuje s úvodným znamienkom. Znamienko plus (+) označuje hodiny pred UTC a znamienko mínus (-) označuje hodiny za UTC. Posun jednej číslice je formátovaný s úvodnou nulou.
V nasledujúcej tabuľke je uvedené, ako sa hodnota posunu mení v závislosti od funkcie DateTimeZone .
Hodnota DateTimeZoneValue | Hodnota posunu |
---|---|
DateTimeZone.LocalNow | V aplikácii Power Query Desktop je to posun časového pásma lokálneho operačného systému od UTC. V Power Query Online vráti hodnotu +00 . |
DateTimeZone.UtcNow | Vráti hodnotu +00:00 . |
Nasledujúci príklad obsahuje špecifikátor "zzz" vlastného formátu vo vlastnom reťazci formátu v systéme v časovom pásme USA a Tichomoria.
let
Source =
{
DateTimeZone.ToText(DateTimeZone.LocalNow(), [Format="{0:zzz}"]),
// Displays {0:-07:00} on Power Query Desktop
// Displays {0:+00:00} on Power Query Online
DateTimeZone.ToText(DateTimeZone.UtcNow(),[Format="{0:zzz}"]),
// Displays {0:+00:00}
DateTimeZone.ToText(DateTimeZone.SwitchZone(
#datetimezone(2024, 8, 1, 0, 0, 0, 0, 0), 6),
[Format = "{0:zzz}"]
)
// Displays {0:+06:00}
}
in
Source
Poznámka
Hodnota vrátená DateTimeZone.LocalNow závisí od toho, či používate Power Query v lokálnom počítači alebo online. V ukážke vyššie v systéme v americkom tichomorskom časovom pásme sa napríklad vráti {0:-07:00}
aplikácia Power Query Desktop, pretože číta čas nastavený v lokálnom počítači. Power Query Online však vráti {0:+00:00}
, pretože číta čas nastavený na cloudových virtuálnych počítačoch, ktoré sú nastavené na UTC.
Špecifikátory oddeľovača dátumu a času
Špecifikácia ":" vlastný formát
Špecifikácia ":". Vlastný formát predstavuje oddeľovač času, ktorý sa používa na odlíšenie hodín, minút a sekúnd. Vhodný lokalizovaný oddeľovač času sa načíta z aktuálnej alebo zadanej jazykovej verzie.
Poznámka
Ak chcete zmeniť oddeľovač času pre konkrétny reťazec dátumu a času, zadajte znak oddeľovača v rámci oddeľovača doslovného reťazca. Napríklad vlastný reťazec hh_dd_ss
formátu vytvorí výsledný reťazec, v ktorom sa ako oddeľovač času vždy použije "_" (znak podčiarknutia).
Ak sa špecifikácia formátu ":" použije bez iných špecifikácií vlastného formátu, bude interpretovaná ako špecifikácia štandardného formátu dátumu a času a vyvolá chybu výrazu. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Špecifikácia vlastného formátu ()/
Špecifikácia vlastného formátu /predstavuje oddeľovač dátumov, ktorý sa používa na odlíšenie rokov, mesiacov a dní. Vhodný lokalizovaný oddeľovač dátumov sa načíta z aktuálnej alebo zadanej jazykovej verzie.
Poznámka
Ak chcete zmeniť oddeľovač dátumov pre konkrétny reťazec dátumu a času, zadajte znak oddeľovača v rámci oddeľovača doslovného reťazca. Napríklad vlastný reťazec mm/dd/yyyy
formátu vytvorí výsledný reťazec, v ktorom sa ako oddeľovač dátumov vždy použije "/".
Ak sa špecifikácia formátu "/" používa bez iných špecifikácií vlastného formátu, interpretuje sa ako štandardný špecifikátor formátu dátumu a času a vyvolá chybu výrazu. Ďalšie informácie o používaní špecifikátoru jedného formátu nájdete v časti Používanie špecifikácií jedného vlastného formátu ďalej v tomto článku.
Znakové literáli
Nasledujúce znaky vo vlastnom reťazci formátu dátumu a času sú vyhradené a vždy sa interpretujú ako formátovacie znaky alebo v prípade "
, '
, /
a \
ako špeciálne znaky.
F
H
K
M
d
f
g
h
m
s
t
y
z
%
:
/
"
'
\
Všetky ostatné znaky sa vždy interpretujú ako znakové literáky a v rámci operácie formátovania sa vo výslednom reťazci bez zmeny zahrnú. Pri analýze sa musia presne zhodovať so znakmi vo vstupnom reťazci; V porovnaní sa rozlišuje veľké a malé písmená.
Nasledujúci príklad obsahuje doslovné znaky PST (pre tichomorský štandardný čas) a PDT (pre tichomorský letný čas), ktoré predstavujú miestne časové pásmo v reťazci formátu. Všimnite si, že reťazec je súčasťou výsledného reťazca a že reťazec obsahujúci reťazec miestneho časového pásma tiež úspešne analyzuje.
let
#"Date Formats" = {"dd MMM yyyy hh:mm tt PST", "dd MMM yyyy hh:mm tt PDT"},
Source =
{
DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Formats"{1}]),
try DateTime.ToText(DateTime.FromText(
"25 Dec 2023 12:00 pm PST", [Format = #"Date Formats"{0}]))
otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm PST" & "'"
}
in
Source
// The example displays the following output text:
// 18 Aug 2024 04:50 PM PDT
// 12/25/2023 12:00:00 PM
Existujú dva spôsoby, ako naznačiť, že znaky sa majú interpretovať ako doslovné znaky, a nie ako rezervné znaky, takže môžu byť zahrnuté do výsledného reťazca alebo úspešne analyzované vo vstupnom reťazci:
Tým, že sa obíde každý vyhradený znak. Ďalšie informácie nájdete v časti Použitie únikových postupností.
Nasledujúci príklad obsahuje doslovné znaky pst (pre tichomorský štandardný čas), ktoré predstavujú miestne časové pásmo v reťazci formátu. Keďže "s" aj "t" sú vlastné reťazce formátu, je potrebné obom znakom uniknúť, aby sa interpretovali ako znakové literály.
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
Celý reťazcový literál uzavrite do apostrofov. Nasledujúci príklad je rovnaký ako ten predchádzajúci, s tým rozdielom, že časť "pst" je uzavretá v apostrofoch, ktoré označujú, že celý reťazec s oddeľovačmi sa má interpretovať ako znakové literáky.
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
Poznámky
Používanie špecifikácií jedného vlastného formátu
Vlastný reťazec formátu dátumu a času pozostáva z dvoch alebo viacerých znakov. Metódy formátovania dátumu a času interpretujú ľubovoľný reťazec s jedným znakom ako štandardný reťazec formátu dátumu a času. Ak nerozpoznajú znak ako platný špecifikátor formátu, dôjde k chybe výrazu. Napríklad reťazec formátu, ktorý pozostáva iba z špecifikátoru "h" sa interpretuje ako reťazec štandardného formátu dátumu a času. V tomto konkrétnom prípade sa však vyskytne výnimka, pretože neexistuje žiadna špecifikácia štandardného formátu dátumu a času "h".
Ak chcete použiť niektorú z špecifikácií vlastného formátu dátumu a času ako jediný špecifikátor v reťazci formátu (to znamená, ak chcete použiť špecifikáciu formátu "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", alebo "/" vlastný formát špecifikátora sám o sebe), zahrňte medzeru pred alebo za špecifikáciu, alebo zahrňte špecifikáciu formátu percenta ("%").
Napríklad výraz "%h
" sa interpretuje ako vlastný reťazec formátu dátumu a času, ktorý zobrazuje hodinu znázornenú aktuálnou hodnotou dátumu a času. Môžete tiež použiť reťazec formátu " h" alebo "h", hoci to zahŕňa medzeru vo výslednom reťazci spolu s hodinou. Nasledujúci príklad ilustruje tieto tri reťazce formátu.
let
date = #datetime(2024, 6, 15, 13, 45, 0),
Source =
{
Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "%h"])}),
Text.Format("'#{0}'", {DateTime.ToText(date, [Format = " h"])}),
Text.Format("'#{0}'", {DateTime.ToText(date, [Format = "h "])})
}
in
Source
// The example displays a list with the following output text,
// with <sp> representing a space:
// '1'
// ' 1'
// '1 '
Použitie koncového postupnosti
Znaky "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", alebo "/" v reťazci formátu sa interpretujú ako vlastné špecifikátory formátu, a nie ako doslovné znaky.
Ak chcete zabrániť interpretácii znaku ako špecifikátoru formátu, môžete:
- Predchádzajte jej opačnou lomkou.
- Obklopte ju jednou úvodzovkou.
- Obklopte ho dvomi dvojitými úvodzovkami.
Každý z týchto znakov funguje ako úniková postupnosť. Koncová postupnosť znamená, že nasledujúci znak alebo obkolesený znak je textový literál, ktorý by sa mal zahrnúť do výsledného reťazca bez zmeny.
Ak chcete do výsledného reťazca vložiť dvojitú úvodzovku, musíte sa jej vyhnúť s inou dvojitou úvodzovkou (""
).
Nasledujúci príklad používa rôzne koncové postupnosti, aby zabránil operácii formátovania interpretovať znaky "h" a "m" ako špecifikátory formátu.
let
date = #datetime(2024, 6, 15, 13, 45, 30.90),
format1 = "h \h m \m",
format2 = "h ""h"" m ""m""",
format3 = "h 'h' m 'm'",
Source =
{
Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format1, DateTime.ToText(date, format1)}),
Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format2, DateTime.ToText(date, format2)}),
Text.Format("#{0} (#{1}) -> #{2}", {DateTime.ToText(date), format3, DateTime.ToText(date, format3)})
}
in
Source
// The example displays the following output text:
// 6/15/2024 1:45:30 PM (h \h m \m) -> 1 h 45 m
// 6/15/2024 1:45:30 PM (h "h" m "m") -> 1 h 45 m
// 6/15/2024 1:45:30 PM (h 'h' m 'm') -> 1 h 45 m