Delen via

Standaardtekenreeksen voor datum- en tijdnotatie

  • Artikel

Een standaardtekenreeks voor datum- en tijdnotatie gebruikt één teken als opmaakaanduiding om de tekstweergave van een tijd- en datumwaarde te definiëren. Een tekenreeks met datum- en tijdnotatie die meer dan één teken bevat, inclusief witruimte, wordt geïnterpreteerd als een aangepaste tekenreeks voor datum- en tijdnotatie. Een standaard- of aangepaste notatietekenreeks kan worden gebruikt om de tekstweergave te definiëren die het resultaat is van een opmaakbewerking.

Tabel met opmaakaanduidingen

In de volgende tabel worden de standaardaanduidingen voor datum- en tijdnotaties beschreven.

Opmaakaanduiding Beschrijving Voorbeelden
"d" Korte datumpatroon.

Meer informatie: De korte datumnotatieaanduiding (d).		 2009-06-15T13:45:30 -> 15-6-2009 (en-US)

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

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D" Lang datumpatroon.

Meer informatie: De lange datumnotatienotatie (D).		 2009-06-15T13:45:30 -> maandag 15 juni 2009 (en-US)

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

2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f" Patroon volledige datum/tijd (korte tijd).

Meer informatie: De korte datumnotatie (f) voor de volledige datum.		 2009-06-15T13:45:30 -> maandag 15 juni 2009 1:45 uur (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνιου 2009 1:45 μμ (el-GR)
"F" Patroon volledige datum/tijd (lange tijd).

Meer informatie: De volledige datum lange tijdnotatie (F).		 2009-06-15T13:45:30 -> maandag 15 juni 2009 1:45:30 pm (en-US)

2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνιου 2009 1:45:30 μμ (el-GR)
"g" Algemeen datum-/tijdpatroon (korte tijd).

Meer informatie: De algemene datum korte tijdnotatie ('g').		 2009-06-15T13:45:30 -> 15/15/2009 1:45 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES)

2009-06-15T13:45:30 -> 6/15 13:45 (zh-CN)
"G" Algemeen datum-/tijdpatroon (lange tijd).

Meer informatie: De algemene datum lange tijdnotatie ('G').		 2009-06-15T13:45:30 -> 15/15/2009 1:45:30 PM (en-US)

2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES)

2009-06-15T13:45:30 -> 6/15 13:45:30 (zh-CN)
"M", "m" Patroon maand/dag.

Meer informatie: De maand ('M', 'm') notatieaanduiding.		 2009-06-15T13:45:30 -> 15 juni (en-US)

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

2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o" retourdatum/-tijdpatroon.

Meer informatie: De round-trip ("O", "o") notatieaanduiding.		 2009-06-15T13:45:30 (Lokaal) --> 2009-06-15T13:45:30.0000000-07:000

2009-06-15T13:45:30 (Utc) --> 2009-06-15T13:45:30.0000000+00:00

2009-06-15T13:45:30 (niet opgegeven) --> 2009-06-15T13:45:30.0000000
"R", "r" RFC1123 patroon.

Meer informatie: De RFC1123 ('R', 'r')-opmaakaanduiding.		 2009-06-15T13:45:30 -> Ma, 15 Jun 2009 13:45:30 GMT
"s" Sorteerbaar datum-/tijdpatroon.

Meer informatie: De sorteerbare notatieaanduiding ('s').		 2009-06-15T13:45:30 (Lokaal) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (Utc) -> 2009-06-15T13:45:30
"t" Korte tijdpatroon.

Meer informatie: De korte tijdnotatieaanduiding ('t').		 2009-06-15T13:45:30 -> 1:45 PM (en-US)

2009-06-15T13:45:30 -> 13:45 (hr-HR)

2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T" Lange tijdpatroon.

Meer informatie: De lange tijdnotatieaanduiding (T).		 2009-06-15T13:45:30 -> 1:45:30 pm (en-US)

2009-06-15T13:45:30 -> 13:45:30 (hr-HR)

2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u" Universeel sorteerbaar datum-/tijdpatroon.

Meer informatie: De universal sortable ("u")-notatieaanduiding.		 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z
"Y", "y" Jaarmaandpatroon.

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

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

2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Elk ander teken met één teken Onbekende aanduiding. Genereert een runtime-expressiefout.

Hoe tekenreeksen met standaardindeling werken

In een opmaakbewerking is een standaardnotatietekenreeks gewoon een alias voor een aangepaste notatietekenreeks. Het voordeel van het gebruik van een alias om te verwijzen naar een tekenreeks met een aangepaste indeling is dat, hoewel de alias invariant blijft, de tekenreeks voor aangepaste notatie zelf kan variëren. Dit is belangrijk omdat de tekenreeksweergaven van datum- en tijdwaarden doorgaans per cultuur verschillen. De tekenreeks 'd' standaardnotatie geeft bijvoorbeeld aan dat een datum- en tijdwaarde moet worden weergegeven met behulp van een kort datumpatroon. Voor de invariante cultuur is dit patroon "MM/dd/jjjj". Voor de fr-FR-cultuur is het "dd/MM/jjjj". Voor de ja-JP-cultuur is het "jjjj/MM/dd".

Als een standaardnotatietekenreeks in een opmaakbewerking wordt toegewezen aan de tekenreeks voor aangepaste opmaak van een bepaalde cultuur, kan uw toepassing de specifieke cultuur definiëren waarvan tekenreeksen voor aangepaste opmaak op een van deze manieren worden gebruikt:

  • U kunt de standaardcultuur (of huidige) gebruiken. In het volgende voorbeeld wordt een datum weergegeven met de korte datumnotatie van de huidige cultuur. In dit geval is de huidige cultuur en-US.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d"])
        //Displays 3/15/2024
    }
in
    Source

  • U kunt een cultuur doorgeven die wordt gebruikt om de datum op te maken volgens de regels van die specifieke cultuur. In het volgende voorbeeld wordt een datum weergegeven met behulp van de korte datumnotatie van de pt-BR-cultuur.

    let
    Source =
    {
        Date.ToText(#date(2024, 3, 15), [Format = "d", Culture = "pt-BR"])
        //Displays 15/03/2024
   }
in
    Source

In sommige gevallen fungeert de standaardnotatietekenreeks als een handige afkorting voor een langere aangepaste notatietekenreeks die invariant is. Vier standaardnotatietekenreeksen vallen in deze categorie: 'O' (of 'o'), 'R' (of 'r'), 's' en 'u'. Deze tekenreeksen komen overeen met tekenreeksen met aangepaste notatie die zijn gedefinieerd door de invariante cultuur. Ze produceren tekenreeksweergaven van datum- en tijdwaarden die zijn bedoeld om identiek te zijn tussen culturen. De volgende tabel bevat informatie over deze vier standaardtekenreeksen voor datum- en tijdnotatie.

Tekenreeks met standaardindeling Gedefinieerd door Tekenreeks voor aangepaste notatie
"O" of "o" Geen jjjj'-'MM'-'dd'T'UU':'mm':'ss'.' fffffffK
"R" of "r" IETF RFC 1123-specificatie ddd, dd MMM jjjj HH':'mm':'ss 'GMT'
"s" ISO 8601 jjjj'-'MM'-'dd'T'UU':'mm':'ss
"u" Sorteerbaar omdat er voorloopnullen worden gebruikt voor jaar, maand, dag, uur, minuut en seconde jjjj'-'MM'-'dd HH':'mm':'ss'Z'

Tekenreeksen met standaardindeling kunnen ook worden gebruikt bij parseringsbewerkingen. Hiervoor moet een invoertekenreeks exact voldoen aan een bepaald patroon om de parseringsbewerking te laten slagen. Veel tekenreeksen met standaardindeling worden toegewezen aan meerdere tekenreeksen voor aangepaste notaties, zodat een datum- en tijdwaarde in verschillende indelingen kan worden weergegeven en de parseringsbewerking nog steeds slaagt.

In de volgende secties worden de standaardnotatieaanduidingen beschreven voor de waarden Datum, Datum/tijd, DateTimeZone en Tijd .

Datumnotaties

Deze groep bevat de volgende indelingen:

De korte datumnotatie ('d')

De standaardnotatieaanduiding d vertegenwoordigt een aangepaste datumnotatie die is gedefinieerd door een specifieke cultuur. De aangepaste notatietekst die wordt geretourneerd door de invariante cultuur is bijvoorbeeld 'MM/dd/jjjj'.

In het volgende voorbeeld wordt de notatieaanduiding d gebruikt om een datumwaarde weer te geven.

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

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

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

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

Terug naar tabel

De lange datumnotatie ('D')

De standaardnotatieaanduiding D vertegenwoordigt een aangepaste datumnotatie die is gedefinieerd door een specifieke cultuur. De tekenreeks voor aangepaste notatie voor de invariante cultuur is bijvoorbeeld 'dddd, dd MMMM jjjj'.

In het volgende voorbeeld wordt de notatieaanduiding D gebruikt om een datum- en tijdwaarde weer te geven.

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

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

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

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

Terug naar tabel

Datum- en tijdnotaties

Deze groep bevat de volgende indelingen:

De notatieaanduiding voor de volledige datumnotatie ('f')

De standaardnotatieaanduiding f vertegenwoordigt een combinatie van de lange datumpatronen ('D') en korte tijdpatronen ('t'), gescheiden door een spatie.

De resultaattekenreeks wordt beïnvloed door de opmaakgegevens van een specifieke cultuur.

In het volgende voorbeeld wordt de notatieaanduiding f gebruikt om een datum- en tijdwaarde weer te geven.

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

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

Terug naar tabel

De notatieaanduiding voor de volledige datum ('F')

De standaardnotatieaanduiding F vertegenwoordigt een aangepaste datum- en tijdnotatie die is gedefinieerd door een specifieke cultuur. De aangepaste notatietekenreeks voor de invariante cultuur is bijvoorbeeld 'dddd, dd MMMM jjjj UU:mm:ss'.

De resultaattekenreeks wordt beïnvloed door de opmaakgegevens van een specifieke cultuur.

In het volgende voorbeeld wordt de notatieaanduiding F gebruikt om een datum- en tijdwaarde weer te geven.

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

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

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

Terug naar tabel

De algemene datumnotatienotatie ('g')

De standaardnotatieaanduiding g vertegenwoordigt een combinatie van de korte datum ('d') en korte tijdpatronen ('t'), gescheiden door een spatie. De resulterende tekst wordt beïnvloed door de opmaakgegevens van een specifieke cultuur.

De resultaattekenreeks wordt beïnvloed door de opmaakgegevens van een specifieke cultuur.

In het volgende voorbeeld wordt de notatieaanduiding g gebruikt om een datum- en tijdwaarde weer te geven.

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

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

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

Terug naar tabel

De algemene datum lange tijdnotatie ('G')

De standaardnotatieaanduiding G vertegenwoordigt een combinatie van de korte datum ('d') en lange tijdpatronen ('T'), gescheiden door een spatie. De resulterende tekst wordt beïnvloed door de opmaakgegevens van een specifieke cultuur.

De resultaattekenreeks wordt beïnvloed door de opmaakgegevens van een specifieke cultuur.

In het volgende voorbeeld wordt de notatieaanduiding G gebruikt om een datum- en tijdwaarde weer te geven.

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

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

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

Terug naar tabel

De round-trip ('O', 'o') notatieaanduiding

De standaardnotatieaanduiding O of O vertegenwoordigt een aangepaste tekenreeks voor datum- en tijdnotatie met behulp van een patroon dat informatie over de tijdzone behoudt en een resultaattekenreeks verzendt die voldoet aan ISO 8601. Voor DateTimeZone-waarden is deze notatieaanduiding ontworpen om datum-, tijd- en tijdzonewaarden in tekst te behouden.

De standaardnotatieaanduiding 'O' of 'o' komt overeen met de 'jjjj'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffxxx" aangepaste notatietekenreeks voor DateTimeZone-waarden . In deze tekst geven de paren enkele aanhalingstekens die afzonderlijke tekens scheiden, zoals de afbreekstreepjes, de dubbele punten en de letter 'T', aan dat het afzonderlijke teken een letterlijke waarde is die niet kan worden gewijzigd. De apostrofs worden niet weergegeven in de uitvoertekenreeks.

De standaardnotatieaanduiding 'O' of 'o' (en de 'jjjj'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffxxx" aangepaste indeling) maakt gebruik van de manieren waarop ISO 8601 tijdzone-informatie vertegenwoordigt om de DateTimeZone waarden te behouden:

  • Het tijdzoneonderdeel van DateTimeZone.ToLocal datum- en tijdwaarden is een verschuiving van UTC (bijvoorbeeld +01:00, -07:00).

  • Het tijdzoneonderdeel van DateTimeZone.ToUtc datum- en tijdwaarden gebruikt +00,00 om UTC weer te geven.

Omdat de standaardnotatieaanduiding 'O' of 'o' voldoet aan een internationale standaard, gebruikt de opmaak- of parseringsbewerking die gebruikmaakt van de aanduiding altijd de invariante cultuur en de Gregoriaanse kalender.

In het volgende voorbeeld wordt de notatieaanduiding 'o' gebruikt om een reeks DateTimeZone-waarden weer te geven op een systeem in de Tijdzone van de Verenigde Staten.

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

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

Notitie

De waarde die door DateTimeZone.ToLocal 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 de lokale tijd, 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.

In het volgende voorbeeld wordt de notatieaanduiding 'o' gebruikt om een opgemaakte tekenreeks te maken en wordt vervolgens de oorspronkelijke datum- en tijdwaarde hersteld door een datum- en tijdparseringsroutine aan te roepen.

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

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

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

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

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

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

Terug naar tabel

De indelingsaanduiding RFC1123 ("R", "r")

De standaardnotatieaanduiding R of R vertegenwoordigt een aangepaste tekenreeks voor datum- en tijdnotatie die niet is gedefinieerd door een specifieke cultuur. Het is altijd hetzelfde, ongeacht de cultuur die wordt gebruikt of de opgegeven formatprovider. De tekenreeks voor aangepaste notatie is 'ddd, dd MMM jjjj HH':'mm':'ss 'GMT'. Wanneer deze standaardnotatieaanduiding wordt gebruikt, gebruikt de opmaak- of parseringsbewerking altijd de invariante cultuur.

Hoewel de RFC 1123-standaard een tijd uitdrukt als Coordinated Universal Time (UTC), wijzigt de opmaakbewerking de waarde van de datum en tijd die wordt opgemaakt niet. Daarom moet u de datum/tijd-waarde converteren naar UTC door de methode DateTimeZone.ToUtc functie aan te roepen voordat u de opmaakbewerking uitvoert.

In het volgende voorbeeld wordt de notatieaanduiding r gebruikt om een tijd- en datumwaarde weer te geven op een systeem in de Tijdzone van de Verenigde Oceaan (zeven uur achter UTC).

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

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

Terug naar tabel

De sorteerbare notatieaanduiding ('s')

De standaardnotatieaanduiding 's' vertegenwoordigt een aangepaste tekenreeks voor datum- en tijdnotatie die een gedefinieerde standaard (ISO 8601) weerspiegelt en alleen-lezen is. Daarom is het altijd hetzelfde, ongeacht de cultuur die wordt gebruikt of de opgegeven indelingsprovider. De tekenreeks voor aangepaste notatie is 'jjjj'-'MM'-'dd'T'UU':'mm':'ss'. Het doel van de notatieaanduiding 's' is het produceren van resultaattekenreeksen die consistent in oplopende of aflopende volgorde sorteren op basis van datum- en tijdwaarden.

Wanneer deze standaardnotatieaanduiding wordt gebruikt, gebruikt de opmaak- of parseringsbewerking altijd de invariante cultuur.

In het volgende voorbeeld wordt de notatieaanduiding 's' gebruikt om een datum- en tijdwaarde weer te geven op een systeem in de Amerikaanse tijdzone Pacific.

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

Terug naar tabel

De universal sortable ("u")-notatieaanduiding

De standaardnotatieaanduiding 'u' vertegenwoordigt een aangepaste tekenreeks voor datum- en tijdnotatie die altijd hetzelfde is, ongeacht de cultuur die wordt gebruikt of de opgegeven notatieprovider. De tekenreeks voor aangepaste notatie is 'jjjj'-'MM'-'dd HH':'mm':'ss'Z''. Het patroon weerspiegelt een gedefinieerde standaard en de eigenschap is alleen-lezen. Wanneer deze standaardnotatieaanduiding wordt gebruikt, gebruikt de opmaak- of parseringsbewerking altijd de invariante cultuur.

Hoewel de resultaattekenreeks een tijd moet uitdrukken als Coordinated Universal Time (UTC), wordt er geen conversie van de oorspronkelijke DateTimeZone-waarde uitgevoerd tijdens de opmaakbewerking. Daarom moet u een DateTimeZone--waarde converteren naar UTC door de functie DateTimeZone.ToUtc aan te roepen voordat u deze opmaakt.

In het volgende voorbeeld wordt de notatieaanduiding 'u' gebruikt om een datum- en tijdwaarde weer te geven.

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

Terug naar tabel

Tijdnotaties

Deze groep bevat de volgende indelingen:

De korte tijdnotatieaanduiding ('t')

De standaardnotatieaanduiding 't' vertegenwoordigt een aangepaste tekenreeks voor datum- en tijdnotatie die is gedefinieerd door de opgegeven cultuur. De tekenreeks voor aangepaste notatie voor de invariante cultuur is bijvoorbeeld 'UU:mm'.

De resultaattekenreeks wordt beïnvloed door de opmaakgegevens van een specifieke cultuur.

In het volgende voorbeeld wordt de notatieaanduiding 't' gebruikt om een datum- en tijdwaarde weer te geven.

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

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

Terug naar tabel

De lange tijdnotatieaanduiding ('T')

De standaardnotatieaanduiding T vertegenwoordigt een aangepaste tekenreeks voor datum- en tijdnotatie die is gedefinieerd door de specifieke cultuur. De tekenreeks voor de aangepaste notatie voor de invariante cultuur is bijvoorbeeld 'UU:mm:ss'.

In het volgende voorbeeld wordt de notatieaanduiding T gebruikt om een datum- en tijdwaarde weer te geven.

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

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

Terug naar tabel

Gedeeltelijke datumnotaties

Deze groep bevat de volgende indelingen:

De maandnotatie ('M', 'm')

De standaardnotatieaanduiding 'M' of 'm' vertegenwoordigt een aangepaste tekenreeks voor datum- en tijdnotatie die is gedefinieerd door de specifieke cultuur. De tekenreeks voor de aangepaste notatie voor de invariante cultuur is bijvoorbeeld 'MMMM dd'.

In het volgende voorbeeld wordt de notatieaanduiding 'm' gebruikt om een datum- en tijdwaarde weer te geven.

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

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

Terug naar tabel

De jaarmaand ("Y", "y") notatieaanduiding

De standaardnotatieaanduiding 'Y' of 'y' vertegenwoordigt een aangepaste tekenreeks voor datumnotatie die is gedefinieerd door een specifieke cultuur. De tekenreeks voor aangepaste notatie voor de invariante cultuur is bijvoorbeeld 'jjjj MMMM'.

In het volgende voorbeeld wordt de notatieaanduiding y gebruikt om een datum- en tijdwaarde weer te geven.

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

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

Terug naar tabel

Gerelateerde inhoud