Egendefinerte dato- og klokkeslettformatstrenger
En dato- og klokkeslettformatstreng definerer tekstrepresentasjonen av en dato-, DateTime-, DateTimeZone- eller Klokkeslett-verdi som er et resultat av en formateringsoperasjon. Den kan også definere representasjonen av en dato- og klokkeslettverdi som kreves i en analyseoperasjon for å kunne konvertere strengen til en dato og et klokkeslett. En egendefinert formatstreng består av én eller flere egendefinerte dato- og klokkeslettformatantall. Alle strenger som ikke er en standard dato- og klokkeslettformatstreng tolkes som en egendefinert dato- og klokkeslettformatstreng.
I formateringsoperasjoner kan egendefinerte dato- og klokkeslettformatstrenger brukes med ToText metoden for en dato- og klokkeslett- og tidssoneforekomst. Følgende eksempel illustrerer bruken.
let
Source =
{
Text.From("Today is " & Date.ToText(#date(2011, 6, 10), [Format = "MMMM dd yyyy"]) & "."),
Text.Format("The current date and time: #{0}", {DateTimeZone.ToText(
#datetimezone(2011, 6, 10, 15, 24, 16, 0, 0), [Format = "MM/dd/yy H:mm:ss zzz"])}
)
}
in
Source
// The example displays the following output:
// Today is June 10, 2011.
// The current date and time: 06/10/11 15:24:16 +00:00
I analyseoperasjoner kan egendefinerte dato- og klokkeslettformatstrenger brukes med funksjonene Date, DateTime, Time og DateTimeZone . Disse funksjonene krever at en inndatastreng samsvarer nøyaktig med et bestemt mønster for at analyseoperasjonen skal lykkes. Følgende eksempel illustrerer et kall til DateTime.FromText-funksjonen for å analysere en dato som må inneholde en måned, en dag og et tosifret år.
let
dateValues = { "30-12-2011", "12-30-2011", "30-12-11", "12-30-11"},
pattern = "MM-dd-yy",
convertedDates = List.Transform(dateValues, (dateValue) =>
try Text.Format("Converted '#{0}' to #{1}.", {dateValue, DateTime.FromText(dateValue, [Format=pattern])})
otherwise Text.Format("Unable to convert '#{0}' to a date and time.", {dateValue}))
in
convertedDates
// The example displays the following output:
// Unable to convert '30-12-2011' to a date and time.
// Unable to convert '12-30-2011' to a date and time.
// Unable to convert '30-12-11' to a date and time.
// Converted '12-30-11' to 12/30/2011.
Tabellen nedenfor beskriver de egendefinerte dato- og klokkeslettformatangitte og viser en resultatstreng produsert av hver formatangitter. Resultatstrenger gjenspeiler som standard formateringskonvensjonene for en-US-kulturen. Hvis en bestemt formatangitter produserer en lokalisert resultatstreng, noterer eksemplet også kulturen som resultatstrengen gjelder for. Hvis du vil ha mer informasjon om hvordan du bruker egendefinerte dato- og klokkeslettformatstrenger, kan du gå til Notater-delen .
| Formatantall | Bekrivelse | Eksempler |
|---|---|---|
| "d" | Dagen i måneden, fra 1 til 31. Mer informasjon: Det egendefinerte formatantallet d. |
2009-06-01T13:45:30 -> 1 2009-06-15T13:45:30 til> 15 |
| "dd" | Dagen i måneden, fra 01 til 31. Mer informasjon: Den egendefinerte formatangitteren "dd". |
2009-06-01T13:45:30 -> 01 2009-06-15T13:45:30 til> 15 |
| "ddd" | Det forkortede navnet på ukedagen. Mer informasjon: Den egendefinerte formatangitteren "ddd". |
2009-06-15T13:45:30 -> man (en-US) 2009-06-15T13:45:30 -> Пн (ru-RU) 2009-06-15T13:45:30 -> lun. (fr-FR) |
| "dddd" | Hele navnet på dagen i uken. Mer informasjon: Den egendefinerte formatangitteren dddd. |
2009-06-15T13:45:30 -> Mandag (en-US) 2009-06-15T13:45:30 -> понедельник (ru-RU) 2009-06-15T13:45:30 -> lundi (fr-FR) |
| "f" | Tiendedeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren f. |
2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.05 -> 0 |
| "ff" | Hundredeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren ff. |
2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> 00 |
| "fff" | Millisekunder i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren fff. |
15.06.2009 kl. 13:45:30.617 -> 617 15.06.2009 kl. 13:45:30.0005 -> 000 |
| "ffff" | De ti tusendeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren "ffff". |
2009-06-15T13:45:30.6175000 -> 6175 2009-06-15T13:45:30.0000500 -> 0000 |
| "fffff" | Hundre tusendeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren fffff. |
2009-06-15T13:45:30.6175400 -> 61754 15.06.2009 kl. 13:45:30.000005 -> 00000 |
| "ffffff" | Milliondeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren ffffff. |
2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> 000000 |
| "fffffff" | De ti milliondeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren fffffff. |
2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 0001150 |
| "F" | Hvis ikke-null, må det tiende sekundet i en dato- og klokkeslettverdi. Mer informasjon: Det egendefinerte F-formatantallet. |
2009-06-15T13:45:30.6170000 -> 6 2009-06-15T13:45:30.0500000 -> (ingen utgang) |
| "FF" | Hvis ikke-null, hundredeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren FF. |
2009-06-15T13:45:30.6170000 -> 61 2009-06-15T13:45:30.0050000 -> (ingen utgang) |
| "FFF" | Hvis ikke-null, millisekunder i en dato- og klokkeslettverdi. Mer informasjon: Det egendefinerte FFF-formatantallet. |
2009-06-15T13:45:30.6170000 -> 617 2009-06-15T13:45:30.0005000 -> (ingen utgang) |
| "FFFF" | Hvis ikke-null, de ti tusendeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren FFFF. |
2009-06-15T13:45:30.5275000 -> 5275 2009-06-15T13:45:30.0000500 -> (ingen utgang) |
| "FFFFF" | Hvis ikke-null, hundre tusendeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Det egendefinerte FFFFF-formatantallet. |
2009-06-15T13:45:30.6175400 -> 61754 2009-06-15T13:45:30.0000050 -> (ingen utgang) |
| "FFFFFF" | Hvis ikke-null, milliondeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren FFFFFF. |
2009-06-15T13:45:30.6175420 -> 617542 2009-06-15T13:45:30.0000005 -> (ingen utgang) |
| "FFFFFFF" | Hvis ikke-null, de ti milliondeler av et sekund i en dato- og klokkeslettverdi. Mer informasjon: Den egendefinerte formatangitteren FFFFFFF. |
2009-06-15T13:45:30.6175425 -> 6175425 2009-06-15T13:45:30.0001150 -> 000115 |
| "g", "gg" | Perioden eller epoken. Mer informasjon: Den egendefinerte formatangitteren g eller gg. |
2009-06-15T13:45:30.6170000 -> A.D. |
| "h" | Timen, ved hjelp av en 12-timers klokke fra 1 til 12. Mer informasjon: Den egendefinerte formatangitteren "h". |
2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 -> 1 |
| "hh" | Timen, ved hjelp av en 12-timers klokke fra 01 til 12. Mer informasjon: Den egendefinerte formatangitteren "hh". |
2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 -> 01 |
| "H" | Timen, ved hjelp av en 24-timers klokke fra 0 til 23. Mer informasjon: Den egendefinerte formatangitteren H. |
2009-06-15T01:45:30 -> 1 2009-06-15T13:45:30 til> 13 |
| "HH" | Timen, ved hjelp av en 24-timers klokke fra 00 til 23. Mer informasjon: Den egendefinerte formatangitteren HH. |
2009-06-15T01:45:30 -> 01 2009-06-15T13:45:30 til> 13 |
| "K" | Informasjon om tidssone. Mer informasjon: Den egendefinerte formatangitteren K. |
2009-06-15T13:45:30, Uspesifisert -> 2009-06-15T13:45:30, Utc -> +00:00 2009-06-15T13:45:30, Lokal -> -07:00 (avhenger av lokale eller skybaserte datamaskininnstillinger) |
| "m" | Minuttet, fra 0 til 59. Mer informasjon: Den egendefinerte formatangitteren m. |
2009-06-15T01:09:30 -> 9 2009-06-15T13:29:30 til> 29 |
| "mm" | Minuttet, fra 00 til 59. Mer informasjon: Det egendefinerte formatantallet mm. |
2009-06-15T01:09:30 -> 09 2009-06-15T01:45:30 til> 45 |
| "M" | Måneden, fra 1 til 12. Mer informasjon: Det egendefinerte M-formatantallet. |
2009-06-15T13:45:30 -> 6 |
| "MM" | Måneden, fra 01 til 12. Mer informasjon: Det egendefinerte formatantallet MM. |
2009-06-15T13:45:30 -> 06 |
| "MMM" | Det forkortede navnet på måneden. Mer informasjon: Det egendefinerte MMM-formatantallet. |
2009-06-15T13:45:30 -> Juni (en-US) 2009-06-15T13:45:30 -> juin (fr-FR) 2009-06-15T13:45:30 -> Juni (zu-ZA) |
| "MMMM" | Hele navnet på måneden. Mer informasjon: Det egendefinerte MMMM-formatantallet. |
2009-06-15T13:45:30 til> juni (en-US) 2009-06-15T13:45:30 -> juni (da-DK) 2009-06-15T13:45:30 -> Juni (zu-ZA) |
| "s" | Den andre, fra 0 til 59. Mer informasjon: Det egendefinerte formatantallet «s». |
2009-06-15T13:45:09 til> 9 |
| "ss" | Den andre, fra 00 til 59. Mer informasjon: Det egendefinerte formatantallet ss. |
2009-06-15T13:45:09 til> 09 |
| "t" | Det første tegnet i AM/PM-utformingstegnet. Mer informasjon: Den egendefinerte formatangitteren t. |
2009-06-15T13:45:30 -> P (en-US) 2009-06-15T13:45:30 -> 午 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR) |
| "tt" | AM/PM-utformingstegnet. Mer informasjon: Den egendefinerte formatangitteren tt. |
2009-06-15T13:45:30 -> PM (en-US) 2009-06-15T13:45:30 -> 午後 (ja-JP) 2009-06-15T13:45:30 -> (fr-FR) |
| "y" | Året, fra 0 til 99. Mer informasjon: Den egendefinerte formatangitteren 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 |
| "ååå" | Året, fra 00 til 99. Mer informasjon: Den egendefinerte formatangitteren "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 |
| "åååå" | Året, med minimum tre sifre. Mer informasjon: Det egendefinerte formatantallet «åååå». |
0001-01-01T00:00:00 -> 001 0900-01-01T00:00:00 -> 900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009 |
| "åååå" | Året som et firesifret tall. Mer informasjon: Det egendefinerte formatantallet «åå». |
0001-01-01T00:00:00 -> 0001 0900-01-01T00:00:00 -> 0900 1900-01-01T00:00:00 -> 1900 2009-06-15T13:45:30 -> 2009 |
| "ååååå" | Året som et femsifret tall. Mer informasjon: Den egendefinerte formatangitteren "yyyyy". |
0001-01-01T00:00:00 -> 00001 2009-06-15T13:45:30 -> 02009 |
| "z" | Timer forskjøvet fra UTC, uten innledende nuller. Mer informasjon: Den egendefinerte formatangitteren z. |
2009-06-15T13:45:30-07:00 -> -7 |
| "zz" | Timer forskyvning fra UTC, med en innledende null for en enkeltsifret verdi. Mer informasjon: Den egendefinerte formatangitteren "zz". |
2009-06-15T13:45:30-07:00 -> -07 |
| "zzz" | Timer og minutter forskyvning fra UTC. Mer informasjon: Den egendefinerte formatangitteren zzz. |
2009-06-15T13:45:30-07:00 -> -07:00 |
| ":" | Tidsskilletegnet. Mer informasjon: Den ":" egendefinerte formatantallet. |
2009-06-15T13:45:30 -> : (en-US) 2009-06-15T13:45:30 -> . (it-IT) 2009-06-15T13:45:30 -> : (ja-JP) |
| "/" | Datoskilletegnet. Mer informasjon: Det egendefinerte formatantallet /. |
2009-06-15T13:45:30 -> / (en-US) 2009-06-15T13:45:30 -> - (ar-DZ) 2009-06-15T13:45:30 -> . (tr-TR) |
| "streng" «streng» |
Litteral strengskilletegn. Mer informasjon: Tegnlitteraler. |
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 |
| % | Definerer følgende tegn som en egendefinert formatangitter. Mer informasjon: Bruke enkle egendefinerte formatantall. |
2009-06-15T13:45:30 (%h) -> 1 |
| \, "", ' | Rømningssekvensene. Mer informasjon: Tegnlitteraler og Bruk av escape-sekvensene. |
2009-06-15T13:45:30 (h \h) -> 1 t 2009-06-15T13:45:30 (t ""h"") -> 1 t 2009-06-15T13:45:30 (t 'h') -> 1 t |
| Alle andre tegn | Tegnet kopieres til resultatstrengen uendret. Mer informasjon: Tegnlitteraler. |
2009-06-15T01:45:30 (arr hh:mm t) -> arr 01:45 A |
Avsnittene nedenfor gir mer informasjon om hver egendefinerte dato- og klokkeslettformatangitter. Med mindre annet er angitt, produserer hver angivelse en identisk strengrepresentasjon uavhengig av om den brukes med en dato-, DateTime-, DateTimeZone- eller Klokkeslett-verdi .
Formatantall for dag "d"
Den egendefinerte formatangitteren "d"
Det egendefinerte formatantallet "d" representerer dagen i måneden som et tall fra 1 til 31. En enkeltsifret dag formateres uten innledende null.
Hvis "d"-formatantallet brukes uten andre egendefinerte formatangittere, tolkes det som "d" standard dato- og klokkeslettformatantall. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Eksemplet nedenfor inneholder det egendefinerte formatantallet d i flere formatstrenger.
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
Den egendefinerte formatantallet "dd"
Den egendefinerte formatstrengen "dd" representerer dagen i måneden som et tall fra 01 til 31. En enkeltsifret dag er formatert med en innledende null.
Eksemplet nedenfor inneholder det egendefinerte formatet "dd" i en egendefinert formatstreng.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
// Displays 02, 01
}
in
Source
Det egendefinerte formatantallet "ddd"
Det egendefinerte formatantallet "ddd" representerer det forkortede navnet på dagen i uken. Det lokaliserte forkortede navnet på dagen i uken hentes fra gjeldende eller angitte kultur.
Eksemplet nedenfor inneholder det egendefinerte formatantallet ddd i en egendefinert formatstreng.
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
Det egendefinerte formatantallet "dddd"
Den egendefinerte formatangitteren "dddd" (pluss et hvilket som helst antall ekstra "d"-anliggender) representerer hele navnet på ukedagen. Det lokaliserte navnet på ukedagen hentes fra gjeldende eller angitte kultur.
Eksemplet nedenfor inneholder det egendefinerte formatantallet "dddd" i en egendefinert formatstreng.
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
Liten sekund "f" brøkantall
Den egendefinerte formatangitteren f
Den egendefinerte formatangitteren "f" representerer det viktigste sifferet i sekundfraksjonen. det vil eksempel: Det representerer tiendedelen av et sekund i en dato- og klokkeslettverdi.
Hvis "f"-formatantallet brukes uten andre formatangitte, tolkes det som standard dato- og klokkeslettformatantallet for "f". Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Når du bruker "f"-formatantall som en del av en formatstreng som er angitt for å analysere antall brøksekunder, angir antallet "f"-formatangittere antallet signifikante sifre i sekundfraksjonen som må være til stede for å kunne analysere strengen.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren f i en egendefinert formatstreng.
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
Den egendefinerte formatangitteren "ff"
Det egendefinerte formatantallet "ff" representerer de to viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere hundredeler av et sekund i en dato- og klokkeslettverdi.
følgende eksempel inkluderer den egendefinerte formatangitteren "ff" i en egendefinert formatstreng.
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
Den egendefinerte formatangitteren fff
Den egendefinerte formatantallet "fff" representerer de tre viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere millisekunder i en dato- og klokkeslettverdi.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren fff i en egendefinert formatstreng.
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
Det egendefinerte formatantallet "ffff"
Det egendefinerte formatantallet "ffff" representerer de fire viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere de ti tusendeler av et sekund i en dato- og klokkeslettverdi.
Selv om det er mulig å vise de ti tusendeler av en annen komponent i en tidsverdi, kan det hende at verdien ikke gir mening. Presisjonen av dato- og klokkeslettverdier avhenger av oppløsningen på systemklokken. På operativsystemene Windows Server 2019 og Windows 11 er klokkeoppløsningen omtrent 1 millisekunder.
Den egendefinerte formatangitteren fffff
Det egendefinerte formatantallet "fffff" representerer de fem viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere hundre tusendeler av et sekund i en dato- og klokkeslettverdi.
Selv om det er mulig å vise hundre tusendeler av en annen komponent i en tidsverdi, kan det hende at denne verdien ikke gir mening. Presisjonen av dato- og klokkeslettverdier avhenger av oppløsningen på systemklokken. På operativsystemene Windows Server 2019 og Windows 11 er klokkeoppløsningen omtrent 1 millisekunder.
Det egendefinerte formatantallet "ffffff"
Det egendefinerte formatantallet "ffffff" representerer de seks viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere milliondeler av et sekund i en dato- og klokkeslettverdi.
Selv om det er mulig å vise milliondeler av en annen komponent i en tidsverdi, kan det hende at verdien ikke gir mening. Presisjonen av dato- og klokkeslettverdier avhenger av oppløsningen på systemklokken. På operativsystemene Windows Server 2019 og Windows 11 er klokkeoppløsningen omtrent 1 millisekunder.
Den egendefinerte formatangitteren fffffff
Det egendefinerte formatantallet "fffffff" representerer de sju viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere de ti milliondeler av et sekund i en dato- og klokkeslettverdi.
Selv om det er mulig å vise de ti milliondeler av en annen komponent i en tidsverdi, kan det hende at denne verdien ikke gir mening. Presisjonen av dato- og klokkeslettverdier avhenger av oppløsningen på systemklokken. På operativsystemene Windows Server 2019 og Windows 11 er klokkeoppløsningen omtrent 1 millisekunder.
Brøkantall med store bokstaver i sekunder
Den egendefinerte formatangitteren F
Den egendefinerte formatangitteren F representerer det viktigste sifferet i sekundfraksjonen. det vil eksempel: Det representerer tiendedelen av et sekund i en dato- og klokkeslettverdi. Ingenting vises hvis sifferet er null, og desimaltegnet som følger antall sekunder, vises heller ikke.
Hvis "F"-formatantallet brukes uten andre formatangitte, tolkes det som standard dato- og klokkeslettformatantallet F. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Antallet "F"-formatangittere som brukes ved analyse, angir maksimalt antall de mest signifikante sifrene i sekundfraksjonen som kan presenteres for å analysere strengen.
Eksemplet nedenfor inneholder det egendefinerte F-formatantallet i en egendefinert formatstreng.
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
Den egendefinerte formatangitteren FF
Den egendefinerte formatangitteren FF representerer de to viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere hundredeler av et sekund i en dato- og klokkeslettverdi. Etterfølgende nuller vises ikke. Ingenting vises hvis de to signifikante sifrene er null, og i så fall vises heller ikke desimaltegnet som følger antall sekunder.
Det følgende eksemplet inneholder den egendefinerte formatangitteren FF i en egendefinert formatstreng.
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
Det egendefinerte FFF-formatantallet
Det egendefinerte FFF-formatantallet representerer de tre viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere millisekunder i en dato- og klokkeslettverdi. Etterfølgende nuller vises ikke. Ingenting vises hvis de tre signifikante sifrene er null, og i så fall vises heller ikke desimaltegnet som følger antall sekunder.
Eksemplet nedenfor inneholder det egendefinerte FFF-formatantallet i en egendefinert formatstreng.
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
Det egendefinerte formatantallet FFFF
Det egendefinerte formatantallet FFFF representerer de fire viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere de ti tusendeler av et sekund i en dato- og klokkeslettverdi. Etterfølgende nuller vises ikke. Ingenting vises hvis de fire signifikante sifrene er null, og i så fall vises heller ikke desimaltegnet som følger antall sekunder.
Selv om det er mulig å vise de ti tusendeler av en annen komponent i en tidsverdi, kan det hende at verdien ikke gir mening. Presisjonen av dato- og klokkeslettverdier avhenger av oppløsningen på systemklokken. På operativsystemene Windows Server 2019 og Windows 11 er klokkeoppløsningen omtrent 1 millisekunder.
Det egendefinerte FFFFF-formatantallet
Den egendefinerte formatangitteren FFFFF representerer de fem viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere hundre tusendeler av et sekund i en dato- og klokkeslettverdi. Etterfølgende nuller vises ikke. Ingenting vises hvis de fem signifikante sifrene er null, og i så fall vises heller ikke desimaltegnet som følger antall sekunder.
Selv om det er mulig å vise hundre tusendeler av en annen komponent i en tidsverdi, kan det hende at denne verdien ikke gir mening. Presisjonen av dato- og klokkeslettverdier avhenger av oppløsningen på systemklokken. På operativsystemene Windows Server 2019 og Windows 11 er klokkeoppløsningen omtrent 1 millisekunder.
Det egendefinerte formatantallet FFFFFF
Det egendefinerte formatantallet FFFFFF representerer de seks viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere milliondeler av et sekund i en dato- og klokkeslettverdi. Etterfølgende nuller vises ikke. Ingenting vises hvis de seks signifikante sifrene er null, og i så fall vises heller ikke desimaltegnet som følger antall sekunder.
Selv om det er mulig å vise milliondeler av en annen komponent i en tidsverdi, kan det hende at verdien ikke gir mening. Presisjonen av dato- og klokkeslettverdier avhenger av oppløsningen på systemklokken. På operativsystemene Windows Server 2019 og Windows 11 er klokkeoppløsningen omtrent 1 millisekunder.
Den egendefinerte formatangitteren FFFFFFF
Den egendefinerte formatangitteren FFFFFFF representerer de sju viktigste sifrene i sekundfraksjonen. det vil eksempelvis representere de ti milliondeler av et sekund i en dato- og klokkeslettverdi. Etterfølgende nuller vises ikke. Ingenting vises hvis de sju signifikante sifrene er null, og i så fall vises heller ikke desimaltegnet som følger antall sekunder.
Selv om det er mulig å vise de ti milliondeler av en annen komponent i en tidsverdi, kan det hende at denne verdien ikke gir mening. Presisjonen av dato- og klokkeslettverdier avhenger av oppløsningen på systemklokken. På operativsystemene Windows Server 2019 og Windows 11 er klokkeoppløsningen omtrent 1 millisekunder.
Era "g" format specifier
Det egendefinerte formatantallet «g» eller «gg»
De egendefinerte formatangitte "g" eller "gg"-formatangitterne (pluss et hvilket som helst antall ekstra "g"-anliggender) representerer perioden eller epoken, for eksempel A.D. Formateringsoperasjonen ignorerer denne anangiren hvis datoen som skal formateres, ikke har en tilknyttet periode- eller ærastreng.
Hvis "g"-formatantallet brukes uten andre egendefinerte formatangittere, tolkes det som standard dato- og klokkeslettformatantallet for "g". Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren g i en egendefinert formatstreng.
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
Formatantall for små bokstaver "h"
Den egendefinerte formatangitteren "h"
Den egendefinerte formatangitteren "h" representerer timen som et tall fra 1 til 12. det vil eksempel: timen representeres av en 12-timers klokke som teller hele timer siden midnatt eller midt på dagen. En bestemt time etter midnatt kan ikke skilles fra samme time etter klokken 12.00. Timen avrundes ikke, og en time med ett siffer formateres uten innledende null. Hvis du for eksempel har et klokkeslett på 5:43 om morgenen eller ettermiddagen, viser denne egendefinerte formatangitteren «5».
Hvis "h"-formatantallet brukes uten andre egendefinerte formatangittere, tolkes det som en standard dato- og klokkeslettformatangitter og gir en uttrykksfeil. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren «h» i en egendefinert formatstreng.
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
Den egendefinerte formatangitteren "hh"
Den egendefinerte formatangitteren "hh" (pluss et hvilket som helst antall ekstra "h"-anangire) representerer timen som et tall fra 01 til 12; det vil eksempel: timen representeres av en 12-timers klokke som teller hele timer siden midnatt eller midt på dagen. En bestemt time etter midnatt kan ikke skilles fra samme time etter klokken 12.00. Timen avrundes ikke, og en time med ett siffer formateres med en innledende null. Hvis du for eksempel har et klokkeslett på 5:43 om morgenen eller ettermiddagen, viser denne formatangitteren 05.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren «hh» i en egendefinert formatstreng.
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
Formatantallet «H» med store bokstaver
Den egendefinerte formatangitteren H
Det egendefinerte formatet "H" representerer timen som et tall fra 0 til 23. det vil eksempel: timen representeres av en nullbasert 24-timers klokke som teller timene siden midnatt. En time med ett siffer formateres uten innledende null.
Hvis "H"-formatantallet brukes uten andre egendefinerte formatangittere, tolkes det som en standard dato- og klokkeslettformatangitter og gir en uttrykksfeil. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Det følgende eksemplet inneholder den egendefinerte formatangitteren H i en egendefinert formatstreng.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "H:mm:ss", Culture = ""])
// Displays 6:09:01
}
in
Source
Den egendefinerte formatangitteren HH
Det egendefinerte formatet "HH" (pluss et hvilket som helst antall ekstra "H"-anangire) representerer timen som et tall fra 00 til 23; det vil eksempel: timen representeres av en nullbasert 24-timers klokke som teller timene siden midnatt. En time med ett siffer formateres med en innledende null.
Eksemplet nedenfor inneholder det egendefinerte formatet HH i en egendefinert formatstreng.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 1, 6, 9, 1), [Format = "HH:mm:ss", Culture = ""])
// Displays 06:09:01
}
in
Source
Tidssone "K" formatantall
Den egendefinerte formatangitteren K
Den egendefinerte formatangitteren K representerer tidssoneinformasjonen for en dato- og klokkeslettverdi. Når denne formatangitteren brukes med DateTimeZone-verdier , defineres resultatstrengen som:
For den lokale tidssonen produserer denne anskriveren en resultatstreng som inneholder den lokale forskyvningen fra Coordinated Universal Time (UTC), for eksempel «-07:00», hvis spørringen kjører i Power Query Desktop. Hvis spørringen kjører i Power Query Online, produserer resultatstrengen ingen forskyvning fra UTC-tid, det vil eksempelvis +00:00.
Resultatstrengen produserer ingen forskyvning fra UTC-tid for en UTC-tid. that is, "+00:00 to represent a UTC date.
Resultatet er tomt for en tid fra en uspesifisert tidssone.
Hvis "K"-formatantallet brukes uten andre egendefinerte formatangittere, tolkes det som en standard dato- og klokkeslettformatangitter og gir en uttrykksfeil. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Følgende eksempel viser strengen som resulterer i å bruke det egendefinerte formatet K med forskjellige verdier på et system i den amerikanske stillehavstidssonen.
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
Merk
Verdien som returneres av DateTimeZone.LocalNow avhenger av om du kjører Power Query på en lokal maskin eller på nettet. Power Query Desktop returnerer -07:00 for eksempel i eksemplet ovenfor på et system i den amerikanske stillehavstidssonen, fordi det leser tiden som er angitt på den lokale maskinen. Power Query Online returnerer +00:00 imidlertid fordi den leser tiden som er angitt på de virtuelle skymaskinene, som er satt til UTC.
Formatantall for minuttformat
Den egendefinerte formatangitteren "m"
Den egendefinerte formatangitteren "m" representerer minuttet som et tall fra 0 til 59. Minuttet representerer hele minutter som har gått siden den siste timen. Et minutt med ett siffer formateres uten innledende null.
Hvis «m»-formatantallet brukes uten andre egendefinerte formatangittere, tolkes det som «m»-standard dato- og klokkeslettformatantall. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Følgende eksempel inneholder den egendefinerte formatangitteren m i en egendefinert formatstreng.
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
Det egendefinerte formatantallet mm
Det egendefinerte formatantallet mm (pluss et hvilket som helst antall ekstra "m"-spesifiserere) representerer minuttet som et tall fra 00 til 59. Minuttet representerer hele minutter som har gått siden den siste timen. Et minutt med ett siffer formateres med en innledende null.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren mm i en egendefinert formatstreng.
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
Formatantall for måned "M"
Den egendefinerte formatangitteren M
Det egendefinerte formatet M representerer måneden som et tall fra 1 til 12 (eller fra 1 til 13 for kalendere som har 13 måneder). En måned med ett siffer formateres uten innledende null.
Hvis formatantallet M brukes uten andre egendefinerte formatangittere, tolkes det som standard dato- og klokkeslettformatangitt for M. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Eksemplet nedenfor inneholder det egendefinerte M-formatantallet i en egendefinert formatstreng.
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
Det egendefinerte formatantallet MM
Det egendefinerte formatantallet MM representerer måneden som et tall fra 01 til 12 (eller fra 1 til 13 for kalendere som har 13 måneder). En måned med ett siffer formateres med innledende null.
Eksemplet nedenfor inneholder det egendefinerte formatet MM i en egendefinert formatstreng.
let
Source =
{
DateTime.ToText(#datetime(2024, 1, 2, 6, 30, 15), [Format = "dd, MM", Culture = ""])
// Displays 02, 01
}
in
Source
Det egendefinerte MMM-formatantallet
Det egendefinerte MMM-formatantallet representerer månedens forkortede navn. Det lokaliserte forkortede navnet på måneden hentes fra de forkortede månedsnavnene for gjeldende eller angitt kultur. Hvis det finnes en egendefinert formatangitt d- eller dd-formatangitt i den egendefinerte formatstrengen, hentes månedsnavnet fra de forkortede genitive navnene i stedet.
Eksemplet nedenfor inneholder det egendefinerte MMM-formatantallet i en egendefinert formatstreng.
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
Det egendefinerte formatantallet MMMM
Det egendefinerte formatantallet MMMM representerer det fullstendige navnet på måneden. Det lokaliserte navnet på måneden hentes fra gjeldende eller angitt kultur. Hvis det finnes en egendefinert formatangitt d- eller dd-formatangitt i den egendefinerte formatstrengen, hentes månedsnavnet fra de forkortede genitive navnene i stedet.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren MMMM i en egendefinert formatstreng.
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
Sekunder "s" formatantall
Det egendefinerte formatantallet «s»
Det egendefinerte formatantallet «s» representerer sekundene som et tall fra 0 til 59. Resultatet representerer hele sekunder som har gått siden siste minutt. Et sekund med ett siffer formateres uten innledende null.
Hvis formatantallet «s» brukes uten andre egendefinerte formatangittere, tolkes det som standard dato- og klokkeslettformatantallet for «s». Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren «s» i en egendefinert formatstreng.
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
Det egendefinerte formatantallet "ss"
Det egendefinerte formatantallet "ss" (pluss et hvilket som helst antall ekstra "s"-anangire) representerer sekundene som et tall fra 00 til 59. Resultatet representerer hele sekunder som har gått siden siste minutt. Et sekund med ett siffer formateres med innledende null.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren «ss» i en egendefinert formatstreng.
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
Meridiem "t" format specifier
Den egendefinerte formatangitteren t
Det egendefinerte formatantallet t representerer det første tegnet i AM/PM-utformingstegnet. Riktig lokalisert utforming hentes fra gjeldende eller spesifikk kultur. AM-utforming brukes for alle tider fra 00:00:00 (midnatt) til 11:59:59.999. Pm-utforming brukes for alle tider fra 12:00:00 (middag) til 23:59:59.999.
Hvis formatangitteren t brukes uten andre egendefinerte formatangittere, tolkes det som «t»-standard dato- og klokkeslettformatantall. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Eksemplet nedenfor inneholder den egendefinerte formatangitteren t i en egendefinert formatstreng.
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
Den egendefinerte formatangitteren tt
Den egendefinerte formatangitteren tt (pluss et hvilket som helst antall ekstra T-anskrivere) representerer hele AM/PM-utformingen. Riktig lokalisert utforming hentes fra gjeldende eller spesifikk kultur. AM-utforming brukes for alle tider fra 00:00:00 (midnatt) til 11:59:59.999. Pm-utforming brukes for alle tider fra 12:00:00 (middag) til 23:59:59.999.
Pass på å bruke tt-anførstegnet for språk som det er nødvendig for å opprettholde skillet mellom AM og PM. Et eksempel er japansk, der AM- og PM-antegnene er forskjellige i det andre tegnet i stedet for det første tegnet.
Det følgende eksemplet inneholder den egendefinerte formatangitteren tt i en egendefinert formatstreng.
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
Formatantall for år "y"
Det egendefinerte formatantallet "y"
Den egendefinerte formatantallet "y" representerer året som et ettsifret eller tosifret tall. Hvis året har mer enn to sifre, vises bare de to sifrene med lav rekkefølge i resultatet. Hvis det første sifferet i et tosifret år begynner med null (for eksempel 2008), formateres tallet uten innledende null.
Hvis formatantallet «y» brukes uten andre egendefinerte formatangittere, tolkes det som standard dato- og klokkeslettformatantallet for y. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Eksemplet nedenfor inneholder det egendefinerte formatantallet y i en egendefinert formatstreng.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "%y"]),
// Displays 1
Date.ToText(#date(2024, 1, 1), [Format = "%y"])
// Displays 24
}
in
Source
Det egendefinerte formatantallet "yy"
Det egendefinerte formatantallet "yy" representerer året som et tosifret tall. Hvis året har mer enn to sifre, vises bare de to sifrene med lav rekkefølge i resultatet. Hvis det tosifrede året har færre enn to signifikante sifre, blir tallet polstret med innledende nuller for å produsere to sifre.
I en analyseoperasjon tolkes et tosifret år som analyseres ved hjelp av den egendefinerte formatangitteren yy, basert på formatleverandørens gjeldende kalender. Eksemplet nedenfor analyserer strengrepresentasjonen av en dato som har et tosifret årstall ved hjelp av standard gregoriansk kalender for en-US-kulturen, som i dette tilfellet er gjeldende kultur. Verdiene som returneres for den firesifrede datoen, avhenger av 100 års rekkevidde angitt av operativsystemet.
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
Eksemplet nedenfor inneholder den egendefinerte formatangitteren "yy" i en egendefinert formatstreng.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yy"]),
// Displays 01
Date.ToText(#date(2024, 1, 1), [Format = "yy"])
// Displays 24
}
in
Source
Den egendefinerte formatangitteren «åå»
Det egendefinerte formatantallet «å» representerer året med minst tre sifre. Hvis året har mer enn tre signifikante sifre, inkluderes de i resultatstrengen. Hvis året har færre enn tre sifre, er tallet polstret med innledende nuller for å produsere tre sifre.
Merk
For den thailandske buddhistiske kalenderen, som kan ha femsifrede årstall, viser denne formatangitteren alle signifikante sifre.
Eksemplet nedenfor inneholder det egendefinerte formatantallet «å» i en egendefinert formatstreng.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yyy"]),
// Displays 001
Date.ToText(#date(2024, 1, 1), [Format = "yyy"])
// Displays 2024
}
in
Source
Den egendefinerte formatangitteren "åååå"
Det egendefinerte formatantallet «åååå» representerer året med minst fire sifre. Hvis året har mer enn fire signifikante sifre, inkluderes de i resultatstrengen. Hvis året har færre enn fire sifre, er tallet polstret med innledende nuller for å produsere fire sifre.
Merk
For den thailandske buddhistiske kalenderen, som kan ha femsifrede årstall, viser denne formatangitteren minimum fire sifre.
Eksemplet nedenfor inneholder det egendefinerte formatantallet "åå" i en egendefinert formatstreng.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yyyy"]),
// Displays 0001
Date.ToText(#date(2024, 1, 1), [Format = "yyyy"])
// Displays 2024
}
in
Source
Den egendefinerte formatangitteren "ååååå"
Den egendefinerte formatangitteren «ååå» (pluss et hvilket som helst antall ekstra «y»-anangire) representerer året med minst fem sifre. Hvis året har mer enn fem signifikante sifre, inkluderes de i resultatstrengen. Hvis året har færre enn fem sifre, er tallet polstret med innledende nuller for å produsere fem sifre.
Hvis det finnes flere "y"-anliggender, blir tallet polstret med så mange innledende nuller som nødvendig for å produsere antall "y"-anliggender.
Eksemplet nedenfor inneholder det egendefinerte formatantallet «å» i en egendefinert formatstreng.
let
Source =
{
Date.ToText(#date(1, 12, 1), [Format = "yyyyy"]),
// Displays 00001
Date.ToText(#date(2024, 1, 1), [Format = "yyyyy"])
// Displays 02024
}
in
Source
Forskyvning av «z»-formatantall
Den egendefinerte formatangitteren z
Med DateTimeZone-verdier representerer den egendefinerte formatangitteren z den signerte forskyvningen av den angitte tidssonen fra Coordinated Universal Time (UTC), målt i timer. Forskyvningen vises alltid med et innledende tegn. Et plusstegn (+) angir timer foran UTC, og et minustegn (-) angir timer bak UTC. En enkeltsifret forskyvning formateres uten innledende null.
Tabellen nedenfor viser hvordan forskyvningsverdien endres avhengig av DateTimeZone-funksjonen .
| DateTimeZone-verdi | Forskyvningsverdi |
|---|---|
| DateTimeZone.LocalNow | På Power Query Desktop, den signerte forskyvningen av det lokale operativsystemets tidssone fra UTC. Returnerer på Power Query Online +00. |
| DateTimeZone.UtcNow | Returnerer +0. |
Hvis «z»-formatantallet brukes uten andre egendefinerte formatangittere, tolkes det som en standard dato- og klokkeslettformatangitter og gir en uttrykksfeil. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Det følgende eksemplet inneholder den egendefinerte formatangitteren z i en egendefinert formatstreng på et system i tidssonen usa. Stillehavskysten.
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
Merk
Verdien som returneres av DateTimeZone.LocalNow avhenger av om du kjører Power Query på en lokal maskin eller på nettet. Power Query Desktop returnerer {0:-7} for eksempel i eksemplet ovenfor på et system i den amerikanske stillehavstidssonen, fordi det leser tiden som er angitt på den lokale maskinen. Power Query Online returnerer {0:+0} imidlertid fordi den leser tiden som er angitt på de virtuelle skymaskinene, som er satt til UTC.
Den egendefinerte formatangitteren "zz"
Med DateTimeZone-verdier representerer den egendefinerte formatangitteren «zz» den signerte forskyvningen av den angitte tidssonen fra UTC, målt i timer. Forskyvningen vises alltid med et innledende tegn. Et plusstegn (+) angir timer foran UTC, og et minustegn (-) angir timer bak UTC. En enkeltsifret forskyvning formateres med en innledende null.
Tabellen nedenfor viser hvordan forskyvningsverdien endres avhengig av DateTimeZone-funksjonen .
| DateTimeZone-verdi | Forskyvningsverdi |
|---|---|
| DateTimeZone.LocalNow | På Power Query Desktop, den signerte forskyvningen av det lokale operativsystemets tidssone fra UTC. Returnerer på Power Query Online +00. |
| DateTimeZone.UtcNow | Returnerer +00. |
Eksemplet nedenfor inneholder den egendefinerte formatangitteren «zz» i en egendefinert formatstreng på et system i den amerikanske stillehavstidssonen.
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
Merk
Verdien som returneres av DateTimeZone.LocalNow avhenger av om du kjører Power Query på en lokal maskin eller på nettet. Power Query Desktop returnerer {0:-07} for eksempel i eksemplet ovenfor på et system i den amerikanske stillehavstidssonen, fordi det leser tiden som er angitt på den lokale maskinen. Power Query Online returnerer {0:+00} imidlertid fordi den leser tiden som er angitt på de virtuelle skymaskinene, som er satt til UTC.
Den egendefinerte formatantallet «zzz»
Med DateTimeZone-verdier representerer den egendefinerte formatangitteren zzz den signerte forskyvningen av den angitte tidssonen fra UTC, målt i timer og minutter. Forskyvningen vises alltid med et innledende tegn. Et plusstegn (+) angir timer foran UTC, og et minustegn (-) angir timer bak UTC. En enkeltsifret forskyvning formateres med en innledende null.
Tabellen nedenfor viser hvordan forskyvningsverdien endres avhengig av DateTimeZone-funksjonen .
| DateTimeZoneValue-verdi | Forskyvningsverdi |
|---|---|
| DateTimeZone.LocalNow | På Power Query Desktop, den signerte forskyvningen av det lokale operativsystemets tidssone fra UTC. Returnerer på Power Query Online +00. |
| DateTimeZone.UtcNow | Returnerer +00:00. |
Eksemplet nedenfor inneholder den egendefinerte formatangitteren zzz i en egendefinert formatstreng på et system i den amerikanske stillehavstidssonen.
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
Merk
Verdien som returneres av DateTimeZone.LocalNow avhenger av om du kjører Power Query på en lokal maskin eller på nettet. Power Query Desktop returnerer {0:-07:00} for eksempel i eksemplet ovenfor på et system i den amerikanske stillehavstidssonen, fordi det leser tiden som er angitt på den lokale maskinen. Power Query Online returnerer {0:+00:00} imidlertid fordi den leser tiden som er angitt på de virtuelle skymaskinene, som er satt til UTC.
Dato- og klokkeslettskilleantall
Den egendefinerte formatangitteren
Den egendefinerte formatangitteren representerer tidsskilletegnet, som brukes til å skille mellom timer, minutter og sekunder. Det aktuelle lokaliserte tidsskilletegnet hentes fra gjeldende eller angitt kultur.
Merk
Hvis du vil endre tidsskilletegnet for en bestemt dato- og klokkeslettstreng, angir du skilletegnet i et litteral strengskilletegn. Den egendefinerte formatstrengen hh_dd_ss produserer for eksempel en resultatstreng der «_» (et understrekingstegn) alltid brukes som tidsskilletegn.
Hvis den angitte ":" formatantallet brukes uten andre egendefinerte formatangittere, tolkes det som en standard dato- og klokkeslettformatangitter og gir en uttrykksfeil. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Den egendefinerte formatangitteren "/"
Det egendefinerte formatantallet "/" representerer datoskilletegnet, som brukes til å skille mellom år, måneder og dager. Det aktuelle lokaliserte datoskilletegnet hentes fra gjeldende eller angitt kultur.
Merk
Hvis du vil endre datoskilletegnet for en bestemt dato- og klokkeslettstreng, angir du skilletegnet i et litteral strengskilletegn. Den egendefinerte formatstrengen mm/dd/yyyy produserer for eksempel en resultatstreng der /alltid brukes som datoskilletegn.
Hvis formatantallet /brukes uten andre egendefinerte formatangittere, tolkes det som en standard dato- og klokkeslettformatangitter og gir en uttrykksfeil. Hvis du vil ha mer informasjon om hvordan du bruker en enkelt formatangitter, kan du gå til Bruk av egendefinerte formatantall senere i denne artikkelen.
Tegnlitteraler
Følgende tegn i en egendefinert formatstreng for dato og klokkeslett er reservert og tolkes alltid som formateringstegn eller, når det gjelder ", ', /og \, som spesialtegn.
FHKMdfghmstyz%:/"'\
Alle andre tegn tolkes alltid som tegnlitteraler, og inkluderes i resultatstrengen uendret i en formateringsoperasjon. I en analyseoperasjon må de samsvare nøyaktig med tegnene i inndatastrengen. sammenligningen skiller mellom store og små bokstaver.
Eksemplet nedenfor inneholder litteraltegnene PST (for Stillehavskysten (normaltid) og PDT (for Stillehavskysten (sommertid) for å representere den lokale tidssonen i en formatstreng. Vær oppmerksom på at strengen er inkludert i resultatstrengen, og at en streng som inneholder den lokale tidssonestrengen, også analyseres.
let
#"Date Formats" = {"dd MMM yyyy hh:mm tt PST", "dd MMM yyyy hh:mm tt PDT"},
Source =
{
DateTime.ToText(#datetime(2024, 8, 18, 16, 50, 0), [Format = #"Date Formats"{1}]),
try DateTime.ToText(DateTime.FromText(
"25 Dec 2023 12:00 pm PST", [Format = #"Date Formats"{0}]))
otherwise "Unable to parse '" & "25 Dec 2023 12:00 pm PST" & "'"
}
in
Source
// The example displays the following output text:
// 18 Aug 2024 04:50 PM PDT
// 12/25/2023 12:00:00 PM
Det finnes to måter å angi at tegn skal tolkes som litterale tegn og ikke som reservetegn, slik at de kan inkluderes i en resultatstreng eller analyseres i en inndatastreng:
Ved å fjerne hvert reserverte tegn. Hvis du vil ha mer informasjon, kan du gå til Bruk escape-sekvensene.
Eksemplet nedenfor inneholder litteraltegnene PST (for Stillehavskysten (normaltid) for å representere den lokale tidssonen i en formatstreng. Fordi både «s» og «t» er egendefinerte formatstrenger, må begge tegnene være ugyldige for å kunne tolkes som tegnlitteraler.
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 PMVed å omslutte hele den bokstavelige strengen i apostrofer. Følgende eksempel er som det forrige, bortsett fra at PST er omsluttet av apostrofer for å indikere at hele strengen med skilletegn skal tolkes som tegnlitteraler.
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
Notater
Bruke enkle egendefinerte formatangittere
En egendefinert dato- og klokkeslettformatstreng består av to eller flere tegn. Formateringsmetoder for dato og klokkeslett tolker alle enkelttegnstrenger som en standard dato- og klokkeslettformatstreng. Hvis de ikke gjenkjenner tegnet som en gyldig formatangivelse, får de en uttrykksfeil. En formatstreng som for eksempel bare består av den angitte «h» tolkes som en standard dato- og klokkeslettformatstreng. I dette tilfellet oppstår det imidlertid et unntak fordi det ikke finnes noen standard dato- og klokkeslettformatangitt.
Hvis du vil bruke en av de egendefinerte dato- og klokkeslettformatangitte som den eneste anviseren i en formatstreng (det vil eksempel: for å bruke "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":", or "/" custom format specifier by itself), include a space before or after the specifier, or include a percent ("%") format specifier before the single custom date and time specifier.
«%h» tolkes for eksempel som en egendefinert dato- og klokkeslettformatstreng som viser timen som representeres av gjeldende dato- og klokkeslettverdi. Du kan også bruke formatstrengen "h" eller "h", selv om dette inkluderer et mellomrom i resultatstrengen sammen med timen. Følgende eksempel illustrerer disse tre formatstrengene.
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 '
Bruke escape-sekvensene
Tegnene "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":"eller "/" i en formatstreng tolkes som egendefinerte formatantall i stedet for som litterale tegn.
Hvis du vil hindre at et tegn tolkes som en formatangitter, kan du:
- Gå foran den med en omvendt skråstrek.
- Omgi det med ett enkelt anførselstegn.
- Omgi den med to doble anførselstegn.
Hvert av disse tegnene fungerer som en escape-sekvens. Escape-sekvensen betyr at følgende tegn eller omgitt tegn er en tekstlitteral som skal inkluderes i resultatstrengen uendret.
Hvis du vil inkludere et dobbelt anførselstegn i en resultatstreng, må du fjerne det med et annet dobbelt anførselstegn ("").
Følgende eksempel bruker forskjellige escape-sekvenser for å hindre formateringsoperasjonen fra å tolke "h" og "m" tegn som formatantall.
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