Delen via


Tekenreeksen met aangepaste datum- en tijdnotatie

Een tekenreeks voor datum- en tijdnotatie definieert de tekstweergave van een datum-, datum/tijd-, datetimezone- of tijdwaarde die het resultaat is van een opmaakbewerking. Het kan ook de weergave definiëren van een datum- en tijdwaarde die vereist is in een parseringsbewerking om de tekenreeks te converteren naar een datum en tijd. Een tekenreeks voor aangepaste notatie bestaat uit een of meer aangepaste datum- en tijdnotatieaanduidingen. Een tekenreeks die geen standaardtekenreeks voor datum- en tijdnotatie is, wordt geïnterpreteerd als een aangepaste tekenreeks voor datum- en tijdnotatie.

Bij opmaakbewerkingen kunnen aangepaste tekenreeksen voor datum- en tijdnotatie worden gebruikt met de ToText methode van een datum- en tijd- en tijdzone-exemplaar. Het volgende voorbeeld illustreert het gebruik ervan.

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

In parseringsbewerkingen kunnen aangepaste tekenreeksen voor datum- en tijdnotatie worden gebruikt met de functies DateTime, Time en DateTimeZone. Voor deze functies is vereist dat een invoertekenreeks exact voldoet aan een bepaald patroon om de parseringsbewerking te laten slagen. In het volgende voorbeeld ziet u een aanroep van de functie DateTime.FromText om een datum te parseren die een maand, een dag en een jaar van twee cijfers moet bevatten.

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.

In de volgende tabel worden de aangepaste datum- en tijdnotatieaanduidingen beschreven en wordt een resultaattekenreeks weergegeven die door elke notatieaanduiding wordt geproduceerd. Standaard weerspiegelen resultaattekenreeksen de opmaakconventies van de en-US-cultuur. Als een bepaalde notatieaanduiding een gelokaliseerde resultaattekenreeks produceert, noteert het voorbeeld ook de cultuur waarop de resultaattekenreeks van toepassing is. Ga naar de sectie Notities voor meer informatie over het gebruik van aangepaste tekenreeksen voor datum- en tijdnotatie.

Opmaakaanduiding Beschrijving Voorbeelden
"d" De dag van de maand, van 1 tot 31.

Meer informatie: de aangepaste notatieaanduiding d.
2009-06-01T13:45:30 -> 1

2009-06-15T13:45:30 -> 15
"dd" De dag van de maand, van 01 tot 31.

Meer informatie: De aangepaste notatieaanduiding 'dd'.
2009-06-01T13:45:30 -> 01

2009-06-15T13:45:30 -> 15
"ddd" De verkorte naam van de dag van de week.

Meer informatie: De aangepaste notatieaanduiding ddd.
2009-06-15T13:45:30 -> Mon (en-US)

2009-06-15T13:45:30 -> Пн (ru-RU)

2009-06-15T13:45:30 -> lun. (fr-FR)
"dddd" De volledige naam van de dag van de week.

Meer informatie: De aangepaste notatieaanduiding dddd.
2009-06-15T13:45:30 -> Maandag (en-US)

2009-06-15T13:45:30 -> понедельник (ru-RU)

2009-06-15T13:45:30 -> lundi (fr-FR)
"f" De tienden van een seconde in een datum- en tijdwaarde.

Meer informatie: de aangepaste notatieaanduiding 'f'.
2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.05 -> 0
"ff" De honderdste van een seconde in een datum- en tijdwaarde.

Meer informatie: De aangepaste notatieaanduiding 'ff'.
2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> 00
"fff" De milliseconden in een datum- en tijdwaarde.

Meer informatie: De aangepaste notatieaanduiding 'fff'.
15-6-2009 13:45:30.617 -> 617

15-6-2009 13:45:30.0005 -> 000
"ffff" De tienduizendste van een seconde in een datum- en tijdwaarde.

Meer informatie: De aangepaste notatieaanduiding 'ffff'.
2009-06-15T13:45:30.6175000 -> 6175

2009-06-15T13:45:30.0000500 -> 00000
"fffff" De honderdduizendste van een seconde in een datum- en tijdwaarde.

Meer informatie: De aangepaste notatieaanduiding fffff.
2009-06-15T13:45:30.6175400 -> 617544

15-6-2009 13:45:30.000005 -> 000000
"ffffff" De miljoenste van een seconde in een datum- en tijdwaarde.

Meer informatie: De aangepaste notatieaanduiding ffffff.
2009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> 0000000
"fffffff" De tien miljoenste van een seconde in een datum- en tijdwaarde.

Meer informatie: de aangepaste notatieaanduiding fffffff.
2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 0001150
"F" Als niet-nul, de tienden van een seconde in een datum- en tijdwaarde.

Meer informatie: de aangepaste notatieaanduiding F.
2009-06-15T13:45:30.6170000 -> 6

2009-06-15T13:45:30.0500000 -> (geen uitvoer)
"FF" Als het niet-nul is, worden de honderdsten van een seconde in een datum- en tijdwaarde weergegeven.

Meer informatie: De aangepaste indelingsaanduiding FF.
2009-06-15T13:45:30.6170000 -> 61

2009-06-15T13:45:30.0050000 -> (geen uitvoer)
"FFF" Als de waarde niet nul is, worden de milliseconden in een datum- en tijdwaarde weergegeven.

Meer informatie: de aangepaste indelingsaanduiding FFF.
2009-06-15T13:45:30.6170000 -> 617

2009-06-15T13:45:30.0005000 -> (geen uitvoer)
"FFFF" Als er geen nul is, worden de tien duizendde van een seconde in een datum- en tijdwaarde weergegeven.

Meer informatie: De aangepaste indelingsaanduiding FFFF.
2009-06-15T13:45:30.5275000 -> 52755

2009-06-15T13:45:30.0000500 -> (geen uitvoer)
"FFFFF" Als het getal niet nul is, worden de honderdduizendste van een seconde in een datum- en tijdwaarde weergegeven.

Meer informatie: De aangepaste indelingsaanduiding FFFFF.
2009-06-15T13:45:30.6175400 -> 617544

2009-06-15T13:45:30.0000050 -> (geen uitvoer)
"FFFFFF" Als de waarde niet nul is, worden de miljoenden van een seconde in een datum- en tijdwaarde weergegeven.

Meer informatie: de aangepaste indelingsaanduiding FFFFFF.
2009-06-15T13:45:30.6175420 -> 617542

2009-06-15T13:45:30.0000005 -> (geen uitvoer)
"FFFFFFF" Als de waarde niet nul is, worden de tien miljoenden van een seconde in een datum- en tijdwaarde weergegeven.

Meer informatie: de aangepaste notatieaanduiding FFFFFFF.
2009-06-15T13:45:30.6175425 -> 6175425

2009-06-15T13:45:30.0001150 -> 000115
"g", "gg" De periode of het tijdperk.

Meer informatie: de aangepaste notatieaanduiding 'g' of 'gg'.
2009-06-15T13:45:30.6170000 -> A.D.
"h" Het uur, met behulp van een 12-uurs klok van 1 tot 12.

Meer informatie: de aangepaste notatieaanduiding 'h'.
2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 1
"uu" Het uur, met behulp van een 12-uurs klok van 01 tot 12.

Meer informatie: De aangepaste notatieaanduiding 'uu'.
2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 01
"H" Het uur, met behulp van een 24-uurs klok van 0 tot 23.

Meer informatie: De aangepaste notatieaanduiding 'H'.
2009-06-15T01:45:30 -> 1

2009-06-15T13:45:30 -> 13
"UU" Het uur, met behulp van een 24-uurs klok van 00 tot 23.

Meer informatie: De aangepaste notatieaanduiding HH.
2009-06-15T01:45:30 -> 01

2009-06-15T13:45:30 -> 13
"K" Tijdzone-informatie.

Meer informatie: De aangepaste notatieaanduiding K.
2009-06-15T13:45:30, Niet opgegeven ->

2009-06-15T13:45:30, Utc -> +00:00

2009-06-15T13:45:30, Lokaal -> -07:00 (afhankelijk van de lokale of cloudcomputerinstellingen)
"m" De minuut, van 0 tot 59.

Meer informatie: De aangepaste notatieaanduiding 'm'.
2009-06-15T01:09:30 -> 9

2009-06-15T13:29:30 -> 29
"mm" De minuut, van 00 tot 59.

Meer informatie: De aangepaste notatieaanduiding mm.
2009-06-15T01:09:30 -> 09

2009-06-15T01:45:30 -> 45
"M" De maand, van 1 tot 12.

Meer informatie: De aangepaste notatieaanduiding 'M'.
2009-06-15T13:45:30 -> 6
"MM" De maand, van 01 tot 12.

Meer informatie: De aangepaste notatieaanduiding MM.
2009-06-15T13:45:30 -> 06
"MMM" De verkorte naam van de maand.

Meer informatie: De aangepaste notatieaanduiding MMM.
2009-06-15T13:45:30 -> Jun (en-US)

2009-06-15T13:45:30 -> juin (fr-FR)

2009-06-15T13:45:30 -> Jun (zu-ZA)
"MMMM" De volledige naam van de maand.

Meer informatie: De aangepaste notatieaanduiding MMMM.
2009-06-15T13:45:30 -> juni (en-US)

2009-06-15T13:45:30 -> juni (da-DK)

2009-06-15T13:45:30 -> Juni (zu-ZA)
"s" De tweede, van 0 tot 59.

Meer informatie: de aangepaste notatieaanduiding 's'.
2009-06-15T13:45:09 -> 9
"ss" De tweede, van 00 tot 59.

Meer informatie: De aangepaste notatieaanduiding 'ss'.
2009-06-15T13:45:09 -> 09
"t" Het eerste teken van de AM/PM-ontwerpaar.

Meer informatie: De aangepaste notatieaanduiding 't'.
2009-06-15T13:45:30 -> P (en-US)

2009-06-15T13:45:30 -> 午 (ja-JP)

2009-06-15T13:45:30 -> (fr-FR)
"tt" De AM/PM-ontwerpaar.

Meer informatie: De aangepaste notatieaanduiding 'tt'.
2009-06-15T13:45:30 -> PM (en-US)

2009-06-15T13:45:30 -> 午後 (ja-JP)

2009-06-15T13:45:30 -> (fr-FR)
"y" Het jaar, van 0 tot 99.

Meer informatie: De aangepaste notatieaanduiding 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" Het jaar, van 00 tot 99.

Meer informatie: De aangepaste notatieaanduiding 'yyy'.
0001-01-01T00:00:00 -> 01

0900-01-01T00:00:00 -> 00

1900-01-01T00:00:00 -> 00

2019-06-15T13:45:30 -> 19
"yyy" Het jaar, met minimaal drie cijfers.

Meer informatie: De aangepaste notatieaanduiding jjjj.
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" Het jaar als een getal van vier cijfers.

Meer informatie: De aangepaste notatieaanduiding '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" Het jaar als een getal van vijf cijfers.

Meer informatie: De aangepaste notatieaanduiding 'yyyyy'.
0001-01-01T00:00:00 -> 00001

2009-06-15T13:45:30 -> 02009
"z" Uren offset van UTC, zonder voorloopnullen.

Meer informatie: De aangepaste notatieaanduiding 'z'.
2009-06-15T13:45:30-07:00 -> -7
"zz" Uren offset van UTC, met een voorloopnul voor een waarde met één cijfer.

Meer informatie: De aangepaste notatieaanduiding 'zz'.
2009-06-15T13:45:30-07:00 -> -07
"zzz" Uren en minuten offset van UTC.

Meer informatie: De aangepaste indelingsaanduiding 'zzz'.
2009-06-15T13:45:30-07:00 -> -07:00
":" Het tijdscheidingsteken.

Meer informatie: De aangepaste notatieaanduiding :.
2009-06-15T13:45:30 -> : (en-US)

2009-06-15T13:45:30 -> . (it-IT)

2009-06-15T13:45:30 -> : (ja-JP)
"/" Het datumscheidingsteken.

Meer informatie: de aanduiding voor aangepaste notatie '/'.
2009-06-15T13:45:30 -> / (en-US)

2009-06-15T13:45:30 -> - (ar-DZ)

2009-06-15T13:45:30 -> . (tr-TR)
"tekenreeks"

'tekenreeks'
Letterlijk tekenreeksscheidingsteken.

Meer informatie: letterlijke tekens.
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
% Hiermee definieert u het volgende teken als een aangepaste notatieaanduiding.

Meer informatie: Enkele aangepaste notatieaanduidingen gebruiken.
2009-06-15T13:45:30 (%h) -> 1
\, "", ' De escapereeksen.

Meer informatie: letterlijke tekens en het gebruik van de escapereeksen.
2009-06-15T13:45:30 (h \h) -> 1 u

2009-06-15T13:45:30 (h ""h"") -> 1 u

2009-06-15T13:45:30 (h 'h') -> 1 u
Elk ander teken Het teken wordt ongewijzigd gekopieerd naar de resultaattekenreeks.

Meer informatie: letterlijke tekens.
2009-06-15T01:45:30 (arr uu:mm t) -> arr 01:45 A

De volgende secties bevatten aanvullende informatie over elke aangepaste datum- en tijdnotatieaanduiding. Tenzij anders vermeld, produceert elke aanduiding een identieke tekenreeksweergave, ongeacht of deze wordt gebruikt met een datum-, datum/tijd- of datum/tijdwaarde.

Indelingsaanduiding dag d

De aangepaste notatieaanduiding 'd'

De aangepaste notatieaanduiding d vertegenwoordigt de dag van de maand als een getal tussen 1 en 31. Een dag met één cijfer wordt opgemaakt zonder voorloopnul.

Als de notatieaanduiding 'd' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als de standaardnotatieaanduiding d. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'd' in verschillende notatietekenreeksen.

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

Terug naar tabel

De aangepaste notatieaanduiding 'dd'

De aangepaste notatietekenreeks dd vertegenwoordigt de dag van de maand als een getal tussen 01 en 31. Een dag met één cijfer wordt opgemaakt met een voorloopnul.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'dd' in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding ddd

De aangepaste notatieaanduiding ddd vertegenwoordigt de verkorte naam van de dag van de week. De gelokaliseerde verkorte naam van de dag van de week wordt opgehaald uit de huidige of opgegeven cultuur.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding ddd in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding dddd

De aangepaste notatieaanduiding 'dddd' (plus een willekeurig aantal extra 'd'-aanduidingen) vertegenwoordigt de volledige naam van de dag van de week. De gelokaliseerde naam van de dag van de week wordt opgehaald uit de huidige of opgegeven cultuur.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding dddd in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

Kleine letters seconden "f" breukaanduiding

De aangepaste notatieaanduiding 'f'

De aangepaste notatieaanduiding f vertegenwoordigt het belangrijkste cijfer van de secondenfractie; Dat wil gezegd: het vertegenwoordigt de tienden van een seconde in een datum- en tijdwaarde.

Als de notatieaanduiding 'f' wordt gebruikt zonder andere notatieaanduidingen, wordt deze geïnterpreteerd als de standaardnotatieaanduiding 'f' voor datum- en tijdnotatie. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Wanneer u de notatieaanduidingen 'f' gebruikt als onderdeel van een notatietekenreeks die is opgegeven om het aantal fractionele seconden te parseren, geeft het aantal notatieaanduidingen 'f' het aantal belangrijkste cijfers van de secondenfractie aan dat aanwezig moet zijn om de tekenreeks te parseren.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'f' in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding 'ff'

De aangepaste notatieaanduiding 'ff' vertegenwoordigt de twee belangrijkste cijfers van de secondenfractie; dat wil gezegd, het vertegenwoordigt de honderdste van een seconde in een datum- en tijdwaarde.

het volgende voorbeeld bevat de aangepaste notatieaanduiding 'ff' in een tekenreeks met een aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding 'fff'

De aangepaste notatieaanduiding fff vertegenwoordigt de drie belangrijkste cijfers van de secondenfractie; Dat wil gezegd, het vertegenwoordigt de milliseconden in een datum- en tijdwaarde.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'fff' in een tekenreeks met een aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding ffff

De aangepaste notatieaanduiding 'ffff' vertegenwoordigt de vier belangrijkste cijfers van de secondenfractie; Dat wil gezegd, het vertegenwoordigt de tienduizendste van een seconde in een datum- en tijdwaarde.

Hoewel het mogelijk is om de tienduizendste van een tweede component van een tijdwaarde weer te geven, is die waarde mogelijk niet zinvol. De precisie van datum- en tijdwaarden is afhankelijk van de resolutie van de systeemklok. Op de besturingssystemen Windows Server 2019 en Windows 11 is de resolutie van de klok ongeveer 1 milliseconden.

Terug naar tabel

De aangepaste notatieaanduiding fffff

De aangepaste notatieaanduiding fffff vertegenwoordigt de vijf belangrijkste cijfers van de secondenfractie; Dat wil gezegd: het vertegenwoordigt de honderd duizendde van een seconde in een datum- en tijdwaarde.

Hoewel het mogelijk is om de honderdduizendste van een tweede component van een tijdwaarde weer te geven, is die waarde mogelijk niet zinvol. De precisie van datum- en tijdwaarden is afhankelijk van de resolutie van de systeemklok. Op de besturingssystemen Windows Server 2019 en Windows 11 is de resolutie van de klok ongeveer 1 milliseconden.

Terug naar tabel

De aangepaste notatieaanduiding ffffff

De aangepaste notatieaanduiding ffffff vertegenwoordigt de zes belangrijkste cijfers van de fractie seconden; Dat wil gezegd: het vertegenwoordigt de miljoenste van een seconde in een datum- en tijdwaarde.

Hoewel het mogelijk is om de miljoenste van een tweede component van een tijdwaarde weer te geven, is die waarde mogelijk niet zinvol. De precisie van datum- en tijdwaarden is afhankelijk van de resolutie van de systeemklok. Op de besturingssystemen Windows Server 2019 en Windows 11 is de resolutie van de klok ongeveer 1 milliseconden.

Terug naar tabel

De aangepaste notatieaanduiding fffffff

De aangepaste notatieaanduiding fffffff vertegenwoordigt de zeven belangrijkste cijfers van de secondenfractie; Dat wil gezegd: het vertegenwoordigt de tien miljoenste van een seconde in een datum- en tijdwaarde.

Hoewel het mogelijk is om de tien miljoenste van een tweede component van een tijdwaarde weer te geven, is die waarde mogelijk niet zinvol. De precisie van datum- en tijdwaarden is afhankelijk van de resolutie van de systeemklok. Op de besturingssystemen Windows Server 2019 en Windows 11 is de resolutie van de klok ongeveer 1 milliseconden.

Terug naar tabel

Hoofdletterseconden "F" breukaanduiding

De aangepaste notatieaanduiding F

De aangepaste notatieaanduiding F vertegenwoordigt het belangrijkste cijfer van de secondenfractie; Dat wil gezegd: het vertegenwoordigt de tienden van een seconde in een datum- en tijdwaarde. Er wordt niets weergegeven als het cijfer nul is en het decimaalteken dat volgt op het aantal seconden, wordt ook niet weergegeven.

Als de notatieaanduiding 'F' wordt gebruikt zonder andere notatieaanduidingen, wordt deze geïnterpreteerd als de standaardnotatie 'F' voor datum- en tijdnotatie. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het aantal notatieaanduidingen 'F' dat wordt gebruikt bij het parseren, geeft het maximum aantal significante cijfers van de secondenfractie aan dat kan worden weergegeven om de tekenreeks te parseren.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'F' in een tekenreeks met aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding FF

De aangepaste notatieaanduiding FF vertegenwoordigt de twee belangrijkste cijfers van de secondenfractie; dat wil gezegd, het vertegenwoordigt de honderdste van een seconde in een datum- en tijdwaarde. Volgnullen worden niet weergegeven. Er wordt niets weergegeven als de twee significante cijfers nul zijn en in dat geval wordt het decimaalteken dat volgt op het aantal seconden ook niet weergegeven.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding FF in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding FFF

De aangepaste notatieaanduiding FFF vertegenwoordigt de drie belangrijkste cijfers van de secondenfractie; Dat wil gezegd, het vertegenwoordigt de milliseconden in een datum- en tijdwaarde. Volgnullen worden niet weergegeven. Er wordt niets weergegeven als de drie significante cijfers nul zijn en in dat geval wordt het decimaalteken dat volgt op het aantal seconden ook niet weergegeven.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding FFF in een tekenreeks met aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding FFFF

De aangepaste notatieaanduiding FFFF vertegenwoordigt de vier belangrijkste cijfers van de secondenfractie; Dat wil gezegd, het vertegenwoordigt de tienduizendste van een seconde in een datum- en tijdwaarde. Volgnullen worden niet weergegeven. Er wordt niets weergegeven als de vier significante cijfers nul zijn en in dat geval wordt het decimaalteken dat volgt op het aantal seconden ook niet weergegeven.

Hoewel het mogelijk is om de tienduizendste van een tweede component van een tijdwaarde weer te geven, is die waarde mogelijk niet zinvol. De precisie van datum- en tijdwaarden is afhankelijk van de resolutie van de systeemklok. Op de besturingssystemen Windows Server 2019 en Windows 11 is de resolutie van de klok ongeveer 1 milliseconden.

Terug naar tabel

De aangepaste notatieaanduiding FFFFF

De aangepaste notatieaanduiding FFFFF vertegenwoordigt de vijf belangrijkste cijfers van de fractie seconden; Dat wil gezegd: het vertegenwoordigt de honderd duizendde van een seconde in een datum- en tijdwaarde. Volgnullen worden niet weergegeven. Er wordt niets weergegeven als de vijf significante cijfers nul zijn en in dat geval wordt het decimaalteken dat volgt op het aantal seconden ook niet weergegeven.

Hoewel het mogelijk is om de honderdduizendste van een tweede component van een tijdwaarde weer te geven, is die waarde mogelijk niet zinvol. De precisie van datum- en tijdwaarden is afhankelijk van de resolutie van de systeemklok. Op de besturingssystemen Windows Server 2019 en Windows 11 is de resolutie van de klok ongeveer 1 milliseconden.

Terug naar tabel

De aangepaste notatieaanduiding FFFFFF

De aangepaste notatieaanduiding FFFFFF vertegenwoordigt de zes belangrijkste cijfers van de fractie seconden; Dat wil gezegd: het vertegenwoordigt de miljoenste van een seconde in een datum- en tijdwaarde. Volgnullen worden niet weergegeven. Er wordt niets weergegeven als de zes significante cijfers nul zijn en in dat geval wordt het decimaalteken dat volgt op het aantal seconden ook niet weergegeven.

Hoewel het mogelijk is om de miljoenste van een tweede component van een tijdwaarde weer te geven, is die waarde mogelijk niet zinvol. De precisie van datum- en tijdwaarden is afhankelijk van de resolutie van de systeemklok. Op de besturingssystemen Windows Server 2019 en Windows 11 is de resolutie van de klok ongeveer 1 milliseconden.

Terug naar tabel

De aangepaste notatieaanduiding FFFFFFF

De aangepaste notatieaanduiding FFFFFFF vertegenwoordigt de zeven belangrijkste cijfers van de fractie seconden; Dat wil gezegd: het vertegenwoordigt de tien miljoenste van een seconde in een datum- en tijdwaarde. Volgnullen worden niet weergegeven. Er wordt niets weergegeven als de zeven significante cijfers nul zijn en in dat geval wordt het decimaalteken dat volgt op het aantal seconden ook niet weergegeven.

Hoewel het mogelijk is om de tien miljoenste van een tweede component van een tijdwaarde weer te geven, is die waarde mogelijk niet zinvol. De precisie van datum- en tijdwaarden is afhankelijk van de resolutie van de systeemklok. Op de besturingssystemen Windows Server 2019 en Windows 11 is de resolutie van de klok ongeveer 1 milliseconden.

Terug naar tabel

Era "g" format specifier

De aangepaste notatieaanduiding 'g' of 'gg'

De aangepaste notatieaanduidingen 'g' of 'gg' (plus een willekeurig aantal extra 'g'-aanduidingen) vertegenwoordigt de periode of het tijdperk, zoals A.D. Met de opmaakbewerking wordt deze aanduiding genegeerd als de datum die moet worden opgemaakt geen gekoppelde periode- of eratekenreeks heeft.

Als de notatieaanduiding 'g' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als de standaardnotatieaanduiding 'g' voor datum- en tijdnotatie. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding g in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

Notatieaanduiding voor kleine letters "h"

De aangepaste notatieaanduiding 'h'

De aangepaste notatieaanduiding 'h' vertegenwoordigt het uur als een getal tussen 1 en 12; Dat wil gezegd, het uur wordt vertegenwoordigd door een 12-uurs klok die de hele uren telt sinds middernacht of middag. Een bepaald uur na middernacht is niet te onderscheiden van hetzelfde uur na middag. Het uur wordt niet afgerond en een uur met één cijfer wordt opgemaakt zonder voorloopnul. Als u bijvoorbeeld een tijd van 5:43 's ochtends of 's middags hebt, wordt in deze aangepaste notatieaanduiding '5' weergegeven.

Als de notatieaanduiding 'h' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaardaanduiding voor datum- en tijdnotatie en wordt er een expressiefout gegenereerd. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'h' in een tekenreeks met een aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding 'uu'

De aangepaste notatieaanduiding 'uu' (plus een willekeurig aantal extra 'h'-aanduidingen) vertegenwoordigt het uur als een getal van 01 tot 12; Dat wil gezegd, het uur wordt vertegenwoordigd door een 12-uurs klok die de hele uren telt sinds middernacht of middag. Een bepaald uur na middernacht is niet te onderscheiden van hetzelfde uur na middag. Het uur wordt niet afgerond en een uur met één cijfer wordt opgemaakt met een voorloopnul. Als u bijvoorbeeld een tijd van 5:43 's ochtends of 's middags hebt, geeft deze notatieaanduiding '05' weer.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'uu' in een tekenreeks met aangepaste notatie.

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

Terug naar tabel

Aanduiding voor hoofdletteruur 'H'-indeling

De aangepaste notatieaanduiding H

De aangepaste notatieaanduiding H vertegenwoordigt het uur als een getal tussen 0 en 23; Dat wil gezegd, het uur wordt vertegenwoordigd door een op nul gebaseerde 24-uurs klok die de uren sinds middernacht telt. Een uur met één cijfer wordt opgemaakt zonder voorloopnul.

Als de notatieaanduiding 'H' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaardaanduiding voor datum- en tijdnotatie en wordt er een expressiefout gegenereerd. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'H' in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding HH

De aangepaste notatieaanduiding 'UU' (plus een willekeurig aantal extra H-aanduidingen) vertegenwoordigt het uur als een getal van 00 tot 23; Dat wil gezegd, het uur wordt vertegenwoordigd door een op nul gebaseerde 24-uurs klok die de uren sinds middernacht telt. Een uur met één cijfer wordt opgemaakt met een voorloopnul.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding HH in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

Aanduiding voor indeling van tijdzone K

De aangepaste notatieaanduiding K

De aangepaste notatieaanduiding K vertegenwoordigt de tijdzone-informatie van een datum- en tijdwaarde. Wanneer deze notatieaanduiding wordt gebruikt met DateTimeZone-waarden , wordt de resultaattekenreeks gedefinieerd als:

  • Voor de lokale tijdzone produceert deze aanduiding een resultaattekenreeks met de lokale offset van Coordinated Universal Time (UTC), bijvoorbeeld '-07:00', als uw query wordt uitgevoerd in Power Query Desktop. Als uw query wordt uitgevoerd in Power Query Online, produceert de resultaattekenreeks geen verschuiving van UTC-tijd, dat wil bijvoorbeeld '+00:00'.

  • Voor een UTC-tijd produceert de resultaattekenreeks geen verschuiving van UTC-tijd; Dat wil gezegd: '+00:00 om een UTC-datum weer te geven.

  • Voor een tijd uit een niet-opgegeven tijdzone is het resultaat leeg.

Als de notatieaanduiding K wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaardaanduiding voor datum- en tijdnotatie en wordt er een expressiefout gegenereerd. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

In het volgende voorbeeld wordt de tekenreeks weergegeven die het resultaat is van het gebruik van de aangepaste notatie 'K' met verschillende waarden op een systeem in de Tijdzone van de Verenigde Oceaan.

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

Notitie

De waarde die door DateTimeZone.LocalNow wordt geretourneerd, is afhankelijk van of u Power Query uitvoert op een lokale computer of online. In het bovenstaande voorbeeld op een systeem in de Tijdzone Pacific in de VS retourneert -07:00 Power Query Desktop bijvoorbeeld omdat deze de tijd leest die is ingesteld op uw lokale computer. Power Query Online retourneert +00:00 echter omdat deze de tijd leest die is ingesteld op de virtuele machines in de cloud, die zijn ingesteld op UTC.

Terug naar tabel

Notatieaanduiding voor minuut 'm'

De aangepaste notatieaanduiding 'm'

De aangepaste notatieaanduiding 'm' vertegenwoordigt de minuut als een getal tussen 0 en 59. De minuut vertegenwoordigt hele minuten die sinds het afgelopen uur zijn verstreken. Een minuut met één cijfer wordt opgemaakt zonder voorloopnul.

Als de notatieaanduiding 'm' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als de standaardnotatieaanduiding 'm' voor datum- en tijdnotatie. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'm' in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding mm

De aangepaste notatieaanduiding 'mm' (plus een willekeurig aantal extra 'm'-aanduidingen) vertegenwoordigt de minuut als een getal van 00 tot 59. De minuut vertegenwoordigt hele minuten die sinds het afgelopen uur zijn verstreken. Een minuut met één cijfer wordt opgemaakt met een voorloopnul.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'mm' in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

Aanduiding voor maandnotatie M

De aangepaste notatieaanduiding 'M'

De aangepaste notatieaanduiding M vertegenwoordigt de maand als een getal tussen 1 en 12 (of van 1 tot 13 voor kalenders met 13 maanden). Een maand met één cijfer wordt opgemaakt zonder voorloopnul.

Als de notatieaanduiding 'M' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als de standaardaanduiding voor datum- en tijdnotatie van M. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'M' in een tekenreeks met een aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding MM

De aangepaste notatieaanduiding MM vertegenwoordigt de maand als een getal van 01 tot 12 (of van 1 tot 13 voor kalenders met 13 maanden). Een maand met één cijfer wordt opgemaakt met een voorloopnul.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding MM in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding MMM

De aangepaste notatieaanduiding MMM vertegenwoordigt de verkorte naam van de maand. De gelokaliseerde verkorte naam van de maand wordt opgehaald uit de verkorte maandnamen van de huidige of opgegeven cultuur. Als er een aangepaste notatieaanduiding 'd' of 'dd' is in de tekenreeks voor aangepaste notatie, wordt de maandnaam opgehaald uit de verkorte genitieve namen.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding MMM in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding MMMM

De aangepaste notatieaanduiding MMMM vertegenwoordigt de volledige naam van de maand. De gelokaliseerde naam van de maand wordt opgehaald uit de huidige of opgegeven cultuur. Als er een aangepaste notatieaanduiding 'd' of 'dd' is in de tekenreeks voor aangepaste notatie, wordt de maandnaam opgehaald uit de verkorte genitieve namen.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding MMMM in een tekenreeks met aangepaste notatie.

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

Terug naar tabel

Notatieaanduiding seconden

De aangepaste notatieaanduiding 's'

De aangepaste notatieaanduiding 's' vertegenwoordigt de seconden als een getal tussen 0 en 59. Het resultaat vertegenwoordigt hele seconden die zijn verstreken sinds de laatste minuut. Een seconde met één cijfer wordt opgemaakt zonder voorloopnul.

Als de notatieaanduiding 's' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als de standaardnotatieaanduiding voor datum en tijd. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 's' in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding 'ss'

De aangepaste notatieaanduiding 'ss' (plus een willekeurig aantal extra 's'-aanduidingen) vertegenwoordigt de seconden als een getal van 00 tot 59. Het resultaat vertegenwoordigt hele seconden die zijn verstreken sinds de laatste minuut. Een seconde met één cijfer wordt opgemaakt met een voorloopnul.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'ss' in een tekenreeks met een aangepaste notatie.

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

Terug naar tabel

Indelingsaanduiding van Hetem "t"

De aangepaste notatieaanduiding 't'

De aangepaste notatieaanduiding 't' vertegenwoordigt het eerste teken van de AM/PM-ontwerpfunctie. De juiste gelokaliseerde ontwerpmachine wordt opgehaald uit de huidige of specifieke cultuur. De AM-ontwerpfunctie wordt gebruikt voor alle tijden van 0:00:00 (middernacht) tot 11:59:59.999. De PM-ontwerpfunctie wordt gebruikt voor alle tijden van 12:00:00 (middag) tot 23:59:59.999.

Als de notatieaanduiding 't' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als de standaardnotatieaanduiding 't' voor datum- en tijdnotatie. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 't' in een tekenreeks met aangepaste notatie.

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

Terug naar tabel

De aangepaste notatieaanduiding 'tt'

De aangepaste notatieaanduiding 'tt' (plus een willekeurig aantal extra 't'-aanduidingen) vertegenwoordigt de hele AM/PM-ontwerpfunctie. De juiste gelokaliseerde ontwerpmachine wordt opgehaald uit de huidige of specifieke cultuur. De AM-ontwerpfunctie wordt gebruikt voor alle tijden van 0:00:00 (middernacht) tot 11:59:59.999. De PM-ontwerpfunctie wordt gebruikt voor alle tijden van 12:00:00 (middag) tot 23:59:59.999.

Zorg ervoor dat u de aanduiding 'tt' gebruikt voor talen waarvoor het nodig is om het onderscheid tussen AM en PM te behouden. Een voorbeeld is Japans, waarvoor de AM- en PM-ontwerpators verschillen in het tweede teken in plaats van het eerste teken.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'tt' in een tekenreeks voor aangepaste notatie.

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

Terug naar tabel

Jaarnotatieaanduiding y

De aangepaste notatieaanduiding y

De aangepaste notatieaanduiding y vertegenwoordigt het jaar als een cijfer met één cijfer of twee cijfers. Als het jaar meer dan twee cijfers heeft, worden alleen de twee cijfers met lage volgorde weergegeven in het resultaat. Als het eerste cijfer van een jaar van twee cijfers begint met een nul (bijvoorbeeld 2008), wordt het getal opgemaakt zonder voorloopnul.

Als de y-notatieaanduiding wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als de standaardaanduiding voor datum- en tijdnotatie 'y'. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding y in een tekenreeks voor aangepaste notatie.

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

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

Terug naar tabel

De aangepaste notatieaanduiding yyy

De aangepaste notatieaanduiding yyy vertegenwoordigt het jaar als een getal van twee cijfers. Als het jaar meer dan twee cijfers heeft, worden alleen de twee cijfers met lage volgorde weergegeven in het resultaat. Als het tweecijferige jaar minder dan twee significante cijfers heeft, wordt het getal opgevuld met voorloopnullen om twee cijfers te produceren.

In een parseringsbewerking wordt een jaar van twee cijfers geparseerd met behulp van de aangepaste notatieaanduiding yyy op basis van de huidige kalender van de notatieprovider. In het volgende voorbeeld wordt de tekenreeksweergave van een datum geparseerd die een jaar van twee cijfers heeft met behulp van de standaard Gregoriaanse kalender van de en-US-cultuur, die in dit geval de huidige cultuur is. De waarden die worden geretourneerd voor de datum met vier cijfers, zijn afhankelijk van het bereik van 100 jaar dat is ingesteld door het besturingssysteem.

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

Het volgende voorbeeld bevat de aangepaste notatieaanduiding yyy in een tekenreeks voor aangepaste notatie.

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

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

Terug naar tabel

De aangepaste notatieaanduiding 'yyy'

De aangepaste notatieaanduiding yyy vertegenwoordigt het jaar met minimaal drie cijfers. Als het jaar meer dan drie significante cijfers heeft, worden deze opgenomen in de resultaattekenreeks. Als het jaar minder dan drie cijfers heeft, wordt het getal opgevuld met voorloopnullen om drie cijfers te produceren.

Notitie

Voor de Thaise boeddhistische kalender, die vijfcijferige jaren kan hebben, geeft deze notatieaanduiding alle significante cijfers weer.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding jjjj in een tekenreeks met een aangepaste notatie.

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

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

Terug naar tabel

De aangepaste notatieaanduiding 'yyyy'

De aangepaste notatieaanduiding jjjj vertegenwoordigt het jaar met minimaal vier cijfers. Als het jaar meer dan vier significante cijfers heeft, worden deze opgenomen in de resultaattekenreeks. Als het jaar minder dan vier cijfers heeft, wordt het getal opgevuld met voorloopnullen om vier cijfers te produceren.

Notitie

Voor de Thaise boeddhistische kalender, die vijfcijferige jaren kan hebben, geeft deze notatieaanduiding een minimum van vier cijfers weer.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding jjjj in een tekenreeks voor aangepaste notatie.

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

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

Terug naar tabel

De aangepaste notatieaanduiding yyyyy

De aangepaste notatieaanduiding jjjj (plus een willekeurig aantal extra yy-aanduidingen) vertegenwoordigt het jaar met minimaal vijf cijfers. Als het jaar meer dan vijf significante cijfers heeft, worden deze opgenomen in de resultaattekenreeks. Als het jaar minder dan vijf cijfers heeft, wordt het getal opgevuld met voorloopnullen om vijf cijfers te produceren.

Als er extra y-aanduidingen zijn, wordt het getal opgevuld met zo veel voorloopnullen als nodig is om het aantal y-aanduidingen te produceren.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'yyyyy' in een tekenreeks voor aangepaste notatie.

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

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

Terug naar tabel

Verschuiving "z" opmaakaanduiding

De aangepaste notatieaanduiding 'z'

Met DateTimeZone-waarden vertegenwoordigt de aangepaste notatieaanduiding 'z' de ondertekende offset van de opgegeven tijdzone van Coordinated Universal Time (UTC), gemeten in uren. De verschuiving wordt altijd weergegeven met een voorloopteken. Een plusteken (+) geeft uren voor UTC aan en een minteken (-) geeft uren achter UTC aan. Een offset met één cijfer wordt opgemaakt zonder voorloopnul.

In de volgende tabel ziet u hoe de offsetwaarde verandert, afhankelijk van de functie DateTimeZone .

DateTimeZone-waarde Verschuivingswaarde
DateTimeZone.LocalNow In Power Query Desktop is de ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. Retourneert +00op Power Query Online.
DateTimeZone.UtcNow Retourneert +0.

Als de notatieaanduiding 'z' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaardaanduiding voor datum- en tijdnotatie en wordt er een expressiefout gegenereerd. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'z' in een tekenreeks voor aangepaste notatie op een systeem in de Tijdzone van de Verenigde Oceaan.

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

Notitie

De waarde die door DateTimeZone.LocalNow wordt geretourneerd, is afhankelijk van of u Power Query uitvoert op een lokale computer of online. In het bovenstaande voorbeeld op een systeem in de Tijdzone Pacific in de VS retourneert {0:-7} Power Query Desktop bijvoorbeeld omdat deze de tijd leest die is ingesteld op uw lokale computer. Power Query Online retourneert {0:+0} echter omdat deze de tijd leest die is ingesteld op de virtuele machines in de cloud, die zijn ingesteld op UTC.

Terug naar tabel

De aangepaste notatieaanduiding 'zz'

Met DateTimeZone-waarden vertegenwoordigt de aangepaste notatieaanduiding 'zz' de ondertekende offset van de opgegeven tijdzone van UTC, gemeten in uren. De verschuiving wordt altijd weergegeven met een voorloopteken. Een plusteken (+) geeft uren voor UTC aan en een minteken (-) geeft uren achter UTC aan. Een offset met één cijfer wordt opgemaakt met een voorloopnul.

In de volgende tabel ziet u hoe de offsetwaarde verandert, afhankelijk van de functie DateTimeZone .

DateTimeZone-waarde Verschuivingswaarde
DateTimeZone.LocalNow In Power Query Desktop is de ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. Retourneert +00op Power Query Online.
DateTimeZone.UtcNow Retourneert +00.

Het volgende voorbeeld bevat de aanduiding voor aangepaste notatie 'zz' in een tekenreeks voor aangepaste notatie op een systeem in de Tijdzone van de Verenigde Oceaan.

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

Notitie

De waarde die door DateTimeZone.LocalNow wordt geretourneerd, is afhankelijk van of u Power Query uitvoert op een lokale computer of online. In het bovenstaande voorbeeld op een systeem in de Tijdzone Pacific in de VS retourneert {0:-07} Power Query Desktop bijvoorbeeld omdat deze de tijd leest die is ingesteld op uw lokale computer. Power Query Online retourneert {0:+00} echter omdat deze de tijd leest die is ingesteld op de virtuele machines in de cloud, die zijn ingesteld op UTC.

Terug naar tabel

De aangepaste notatieaanduiding 'zzz'

Met DateTimeZone-waarden vertegenwoordigt de aangepaste notatieaanduiding 'zzz' de ondertekende offset van de opgegeven tijdzone van UTC, gemeten in uren en minuten. De verschuiving wordt altijd weergegeven met een voorloopteken. Een plusteken (+) geeft uren voor UTC aan en een minteken (-) geeft uren achter UTC aan. Een offset met één cijfer wordt opgemaakt met een voorloopnul.

In de volgende tabel ziet u hoe de offsetwaarde verandert, afhankelijk van de functie DateTimeZone .

DateTimeZoneValue-waarde Verschuivingswaarde
DateTimeZone.LocalNow In Power Query Desktop is de ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. Retourneert +00op Power Query Online.
DateTimeZone.UtcNow Retourneert +00:00.

Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'zzz' in een tekenreeks voor aangepaste notatie op een systeem in de Tijdzone van de Verenigde Oceaan.

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

Notitie

De waarde die door DateTimeZone.LocalNow wordt geretourneerd, is afhankelijk van of u Power Query uitvoert op een lokale computer of online. In het bovenstaande voorbeeld op een systeem in de Tijdzone Pacific in de VS retourneert {0:-07:00} Power Query Desktop bijvoorbeeld omdat deze de tijd leest die is ingesteld op uw lokale computer. Power Query Online retourneert {0:+00:00} echter omdat deze de tijd leest die is ingesteld op de virtuele machines in de cloud, die zijn ingesteld op UTC.

Terug naar tabel

Datum- en tijdscheidingstekens

De aanduiding voor aangepaste notatie ':'

De aanduiding voor aangepaste notatie ':' vertegenwoordigt het tijdscheidingsteken, dat wordt gebruikt om uren, minuten en seconden te onderscheiden. Het juiste gelokaliseerde tijdscheidingsteken wordt opgehaald uit de huidige of opgegeven cultuur.

Notitie

Als u het tijdscheidingsteken voor een bepaalde datum- en tijdtekenreeks wilt wijzigen, geeft u het scheidingsteken op binnen een letterlijk tekenreeksscheidingsteken. De tekenreeks hh_dd_ss voor aangepaste notatie produceert bijvoorbeeld een resultaattekenreeks waarin '_' (een onderstrepingsteken) altijd wordt gebruikt als tijdscheidingsteken.

Als de notatieaanduiding ':' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaardaanduiding voor datum- en tijdnotatie en wordt er een expressiefout gegenereerd. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Terug naar tabel

De aangepaste notatieaanduiding '/'

De aangepaste notatieaanduiding '/' vertegenwoordigt het datumscheidingsteken, dat wordt gebruikt om jaren, maanden en dagen te onderscheiden. Het juiste gelokaliseerde datumscheidingsteken wordt opgehaald uit de huidige of opgegeven cultuur.

Notitie

Als u het datumscheidingsteken voor een bepaalde datum- en tijdtekenreeks wilt wijzigen, geeft u het scheidingsteken op binnen een letterlijk tekenreeksscheidingsteken. De tekenreeks voor aangepaste notatie produceert bijvoorbeeld een resultaattekenreeks mm/dd/yyyy waarin '/' altijd wordt gebruikt als het datumscheidingsteken.

Als de notatieaanduiding '/' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaardaanduiding voor datum- en tijdnotatie en wordt er een expressiefout gegenereerd. Voor meer informatie over het gebruik van één opmaakaanduiding gaat u verderop in dit artikel naar Using Single Custom Format Specifiers .

Terug naar tabel

Letterlijke tekens

De volgende tekens in een aangepaste tekenreeks voor datum- en tijdnotatie zijn gereserveerd en worden altijd geïnterpreteerd als opmaaktekens of, in het geval van ", 'en /, als \speciale tekens.

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

Alle andere tekens worden altijd geïnterpreteerd als letterlijke tekens en worden in een opmaakbewerking ongewijzigd in de resultaattekenreeks opgenomen. In een parseringsbewerking moeten ze exact overeenkomen met de tekens in de invoertekenreeks; de vergelijking hoofdlettergevoelig is.

Het volgende voorbeeld bevat de letterlijke tekens 'PST' (voor Pacific Standard Time) en 'PDT' (voor Pacific Daylight Time) om de lokale tijdzone in een notatietekenreeks weer te geven. Houd er rekening mee dat de tekenreeks is opgenomen in de resultaattekenreeks en dat een tekenreeks die de lokale tijdzonetekenreeks bevat, ook wordt geparseerd.

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

Er zijn twee manieren om aan te geven dat tekens moeten worden geïnterpreteerd als letterlijke tekens en niet als reservetekens, zodat ze kunnen worden opgenomen in een resultaattekenreeks of met succes worden geparseerd in een invoertekenreeks:

  • Door elk gereserveerd teken te ontsnappen. Ga naar De escapereeksen gebruiken voor meer informatie.

    Het volgende voorbeeld bevat de letterlijke tekens 'pst' (voor Pacific Standard-tijd) om de lokale tijdzone in een notatietekenreeks weer te geven. Omdat zowel 's' als 't' tekenreeksen met aangepaste notatie zijn, moeten beide tekens worden geïnterpreteerd als letterlijke tekens.

    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
    
  • Door de hele letterlijke tekenreeks in apostrofs te plaatsen. Het volgende voorbeeld is vergelijkbaar met de vorige, behalve dat 'pst' is ingesloten in apostrofs om aan te geven dat de hele gescheiden tekenreeks moet worden geïnterpreteerd als letterlijke tekens.

    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
    

Opmerkingen

Specifieke opmaakaanduidingen voor één aangepaste indeling gebruiken

Een aangepaste tekenreeks voor datum- en tijdnotatie bestaat uit twee of meer tekens. Datum- en tijdnotatiemethoden interpreteren een tekenreeks met één teken als een standaardtekenreeks voor datum- en tijdnotatie. Als ze het teken niet herkennen als een geldige opmaakaanduiding, werpen ze een expressiefout op. Een notatietekenreeks die alleen uit de aanduiding 'h' bestaat, wordt bijvoorbeeld geïnterpreteerd als een standaardtekenreeks voor datum- en tijdnotatie. In dit specifieke geval wordt er echter een uitzondering gegenereerd omdat er geen standaardaanduiding voor datum- en tijdnotatie 'h' is.

Als u een van de aangepaste datum- en tijdnotatieaanduidingen wilt gebruiken als de enige aanduiding in een notatietekenreeks (dat wil gezegd, als u de notatie 'd', 'f', 'F', 'g', 'h', 'H', 'K', 'm', 'M', 's', 't', 'y', 'z', ':' of '/' zelf wilt gebruiken), moet u een spatie voor of na de aanduiding opnemen of een procentnotatieaanduiding (%) opnemen vóór de enkele aangepaste datum- en tijdaanduiding.

'%h' wordt bijvoorbeeld geïnterpreteerd als een aangepaste tekenreeks voor datum- en tijdnotatie waarmee het uur wordt weergegeven dat wordt vertegenwoordigd door de huidige datum- en tijdwaarde. U kunt ook de notatietekenreeks "h" of "h" gebruiken, hoewel dit een spatie in de resultaattekenreeks samen met het uur bevat. In het volgende voorbeeld ziet u deze tekenreeksen met drie indelingen.

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 ' 

De escapereeksen gebruiken

De tekens "d", "f", "F", "g", "h", "H", "K", "m", "M", "s", "t", "y", "z", ":" of "/" tekens in een notatietekenreeks worden geïnterpreteerd als aangepaste notatieaanduidingen in plaats van letterlijke tekens.

Als u wilt voorkomen dat een teken wordt geïnterpreteerd als opmaakaanduiding, kunt u het volgende doen:

  • Voorafgaan met een backslash.
  • Plaats het met één aanhalingsteken.
  • Plaats het tussen twee dubbele aanhalingstekens.

Elk van deze tekens fungeert als een escape-reeks. De escapereeks geeft aan dat het volgende teken of tussenteken een letterlijke tekst is die in de resultaattekenreeks ongewijzigd moet worden opgenomen.

Als u een dubbele aanhalingsteken wilt opnemen in een resultaattekenreeks, moet u deze escapen met een andere dubbele aanhalingsteken ("").

In het volgende voorbeeld worden verschillende escapereeksen gebruikt om te voorkomen dat de opmaakbewerking de tekens 'h' en 'm' interpreteert als opmaakaanduidingen.

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