Standaardtekenreeksen voor datum- en tijdnotatie

Artikel
03/22/2025

Een standaardtekenreeks voor datum- en tijdnotatie gebruikt één teken als opmaakaanduiding om de tekstweergave van een DateTime of een DateTimeOffset waarde 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 tekenreeks met een standaard- of aangepaste notatie kan op twee manieren worden gebruikt:

De tekenreeks definiëren die het resultaat is van een opmaakbewerking.
De tekstweergave definiëren van een datum- en tijdwaarde die kan worden geconverteerd naar een DateTime of DateTimeOffset waarde door een parseringsbewerking.

Hint

U kunt het Opmaakhulpprogramma downloaden, een .NET Windows Forms-toepassing waarmee u notatietekenreeksen kunt toepassen op numerieke waarden of datum- en tijdwaarden en de resultaattekenreeks kunt weergeven. Broncode is beschikbaar voor C#- en Visual Basic-.

Notitie

Enkele van de C#-voorbeelden in dit artikel worden uitgevoerd in de Try.NET inline coderunner en playground. Selecteer de knop uitvoeren om een voorbeeld uit te voeren in een interactief venster. Zodra u de code hebt uitgevoerd, kunt u deze wijzigen en de gewijzigde code uitvoeren door opnieuw uit te voeren. De gewijzigde code wordt uitgevoerd in het interactieve venster of, als de compilatie mislukt, worden alle C#-compilerfoutberichten weergegeven.

De lokale tijdzone van de Try.NET inline coderunner en speeltuin is Coordinated Universal Time of UTC. Dit kan van invloed zijn op het gedrag en de uitvoer van voorbeelden die de DateTime, DateTimeOffseten TimeZoneInfo typen en hun leden illustreren.

Tabel met opmaakaanduidingen

In de volgende tabel worden de standaardaanduidingen voor datum- en tijdnotaties beschreven. Tenzij anders vermeld, produceert een bepaalde standaardnotatie voor datum- en tijdnotatie een identieke tekenreeksweergave, ongeacht of deze wordt gebruikt met een DateTime of een DateTimeOffset waarde. Zie Eigenschappen van configuratiescherm en DateTimeFormatInfo voor meer informatie over het gebruik van tekenreeksen voor datum- en tijdnotatie.

Opmaakaanduiding	Beschrijving	Voorbeelden
"d"	Korte datumpatroon. Meer informatie:De korte datumnotatie ('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 datumnotatie ("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.	DateTime waarden: 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.00000000 DateTimeOffset waarden: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:000
"R", "r"	RFC1123 patroon. Meer informatie: De RFC1123 ('R', 'r')-opmaakaanduiding.	DateTimeOffset invoer: 2009-06-15T13:45:30 -> ma, 15 juni 2009 20:45:30 GMT DateTime invoer: 2009-06-15T13:45:30 -> ma, 15 juni 2009 13:45:30 GMT
"s"	Sorteerbaar datum-/tijdpatroon. Meer informatie: De sorteerbare notatieaanduiding ('s').	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.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.	Met een DateTime waarde: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Met een DateTimeOffset waarde: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Universeel patroon voor volledige datum/tijd. Meer informatie: De universele volledige indeling (U).	2009-06-15T13:45:30 -> maandag 15 juni 2009 8:45:30 uur (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνου 2009 8:45:30 μμ (el-GR)
"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-FormatException.

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.

// Display using current (en-us) culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008

' Display using current (en-us) culture's short date format
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

U kunt een CultureInfo object doorgeven dat de cultuur vertegenwoordigt waarvan de opmaak moet worden gebruikt voor een methode met een IFormatProvider parameter. In het volgende voorbeeld wordt een datum weergegeven met behulp van de korte datumnotatie van de pt-BR-cultuur.

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

U kunt een DateTimeFormatInfo-object doorgeven dat opmaakgegevens biedt aan een methode met een IFormatProvider parameter. In het volgende voorbeeld wordt een datum weergegeven met behulp van de korte datumnotatie van een DateTimeFormatInfo-object voor de hr-HR cultuur.

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

Notitie

Zie het onderwerp NumberFormatInfo klasse voor meer informatie over het aanpassen van de patronen of tekenreeksen die worden gebruikt bij het opmaken van datum- en tijdwaarden.

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 de eigenschap DateTimeFormatInfo.InvariantInfo	Tekenreeks voor aangepaste notatie
"O" of "o"	Geen	jjjj'-'MM'-'dd'T'UU':'mm':'ss'.' fffffffK
"R" of "r"	RFC1123Pattern	ddd, dd MMM jjjj HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	jjjj'-'MM'-'dd'T'UU':'mm':'ss
"u"	UniversalSortableDateTimePattern	jjjj'-'MM'-'dd HH':'mm':'ss'Z'

Tekenreeksen met standaardindeling kunnen ook worden gebruikt in parseringsbewerkingen met de methoden DateTime.ParseExact of DateTimeOffset.ParseExact, waarvoor een invoertekenreeks exact moet 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. U kunt de tekenreeks of tekenreeksen van de aangepaste notatie bepalen die overeenkomen met een standaardnotatietekenreeks door de methode DateTimeFormatInfo.GetAllDateTimePatterns(Char) aan te roepen. In het volgende voorbeeld worden de tekenreeksen voor aangepaste notatie weergegeven die zijn toegewezen aan de standaardnotatietekenreeks 'd' (korte datumpatroon).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine($"   {customString}");
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

In de volgende secties worden de standaardopmaakaanduidingen voor DateTime en DateTimeOffset waarden beschreven.

Datumnotaties

Deze groep bevat de volgende indelingen:

De korte datumnotatie ('d')
De lange datumnotatie ('D')

De korte datumnotatie ('d')

De standaardnotatieaanduiding d vertegenwoordigt een aangepaste tekenreeks voor datum- en tijdnotatie die is gedefinieerd door de DateTimeFormatInfo.ShortDatePattern eigenschap van een specifieke cultuur. De tekenreeks voor aangepaste notatie die wordt geretourneerd door de eigenschap ShortDatePattern van de invariante cultuur is bijvoorbeeld 'MM/dd/jjjj'.

De volgende tabel bevat de DateTimeFormatInfo objecteigenschappen waarmee de opmaak van de geretourneerde tekenreeks wordt beheerd.

Vastgoed	Beschrijving
ShortDatePattern	Hiermee definieert u de algehele indeling van de resultaattekenreeks.
DateSeparator	Hiermee definieert u de tekenreeks waarmee de onderdelen van het jaar, de maand en de dag van een datum worden gescheiden.

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

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008

Vastgoed	Beschrijving
LongDatePattern	Hiermee definieert u de algehele indeling van de resultaattekenreeks.
DayNames	Hiermee definieert u de gelokaliseerde dagnamen die in de resultaattekenreeks kunnen worden weergegeven.
MonthNames	Definieert de gelokaliseerde maandnamen die in de resultaattekenreeks kunnen worden weergegeven.

Vastgoed	Beschrijving
LongDatePattern	Hiermee definieert u de notatie van het datumonderdeel van de resultaattekenreeks.
ShortTimePattern	Hiermee definieert u de indeling van het tijdonderdeel van de resultaattekenreeks.
DayNames	Hiermee definieert u de gelokaliseerde dagnamen die in de resultaattekenreeks kunnen worden weergegeven.
MonthNames	Definieert de gelokaliseerde maandnamen die in de resultaattekenreeks kunnen worden weergegeven.
TimeSeparator	Hiermee definieert u de tekenreeks die het uur, de minuut en de tweede onderdelen van een tijd scheidt.
AMDesignator	Definieert de tekenreeks die tijden aangeeft van middernacht tot vóór de middag in een 12-uurs klok.
PMDesignator	Hiermee definieert u de tekenreeks die tijden aangeeft van middag tot middernacht in een 12-uurs klok.

Vastgoed	Beschrijving
FullDateTimePattern	Hiermee definieert u de algehele indeling van de resultaattekenreeks.
DayNames	Hiermee definieert u de gelokaliseerde dagnamen die in de resultaattekenreeks kunnen worden weergegeven.
MonthNames	Definieert de gelokaliseerde maandnamen die in de resultaattekenreeks kunnen worden weergegeven.
TimeSeparator	Hiermee definieert u de tekenreeks die het uur, de minuut en de tweede onderdelen van een tijd scheidt.
AMDesignator	Definieert de tekenreeks die tijden aangeeft van middernacht tot vóór de middag in een 12-uurs klok.
PMDesignator	Hiermee definieert u de tekenreeks die tijden aangeeft van middag tot middernacht in een 12-uurs klok.

Vastgoed	Beschrijving
ShortDatePattern	Hiermee definieert u de notatie van het datumonderdeel van de resultaattekenreeks.
LongTimePattern	Hiermee definieert u de indeling van het tijdonderdeel van de resultaattekenreeks.
DateSeparator	Hiermee definieert u de tekenreeks waarmee de onderdelen van het jaar, de maand en de dag van een datum worden gescheiden.
TimeSeparator	Hiermee definieert u de tekenreeks die het uur, de minuut en de tweede onderdelen van een tijd scheidt.
AMDesignator	Definieert de tekenreeks die tijden aangeeft van middernacht tot vóór de middag in een 12-uurs klok.
PMDesignator	Hiermee definieert u de tekenreeks die tijden aangeeft van middag tot middernacht in een 12-uurs klok.

Vastgoed	Beschrijving
RFC1123Pattern	Hiermee definieert u de indeling van de resultaattekenreeks.
AbbreviatedDayNames	Definieert de verkorte dagnamen die in de resultaattekenreeks kunnen worden weergegeven.
AbbreviatedMonthNames	Hiermee definieert u de verkorte maandnamen die in de resultaattekenreeks kunnen worden weergegeven.

Vastgoed	Beschrijving
MonthDayPattern	Hiermee definieert u de algehele indeling van de resultaattekenreeks.
MonthNames	Definieert de gelokaliseerde maandnamen die in de resultaattekenreeks kunnen worden weergegeven.

Vastgoed	Beschrijving
YearMonthPattern	Hiermee definieert u de algehele indeling van de resultaattekenreeks.
MonthNames	Definieert de gelokaliseerde maandnamen die in de resultaattekenreeks kunnen worden weergegeven.

Delen via

Standaardtekenreeksen voor datum- en tijdnotatie

Tabel met opmaakaanduidingen

Hoe tekenreeksen met standaardindeling werken

Datumnotaties

De korte datumnotatie ('d')

De lange datumnotatie ('D')

Datum- en tijdnotaties

De notatieaanduiding voor de volledige datumnotatie ('f')

De notatieaanduiding voor de volledige datum ('F')

De algemene datumnotatienotatie ('g')

De algemene datum lange tijdnotatie ('G')

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

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

De sorteerbare notatieaanduiding ('s')

De universal sortable ("u")-notatieaanduiding

De universal full ("U")-notatieaanduiding

Tijdnotaties

De korte tijdnotatieaanduiding ('t')

De lange tijdnotatieaanduiding ('T')

Gedeeltelijke datumnotaties

De maandnotatie ('M', 'm')

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

Configuratiescherm-instellingen

Eigenschappen van DateTimeFormatInfo

Zie ook

Aanvullende resources