Standaardtekenreeksen voor datum- en tijdnotatie

Artikel
04/08/2023

Een standaardtekenreeks met datum- en tijdnotatie gebruikt één teken als notatieaanduiding 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-waarde DateTimeOffset door een parseerbewerking.

Tip

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

Notitie

Sommige 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. Nadat u de code hebt uitgevoerd, kunt u deze wijzigen en de gewijzigde code uitvoeren door opnieuw Uitvoeren te selecteren. De gewijzigde code wordt uitgevoerd in het interactieve venster of, als de compilatie mislukt, worden alle foutberichten van de C#-compiler weergegeven.

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

Tabel met opmaakaanduidingen

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

Opmaakaanduiding	Beschrijving	Voorbeelden
"d"	Kort 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"	Volledig datum-/tijdpatroon (korte tijd). Meer informatie: De aanduiding voor de volledige datumnotatie korte tijd ('f').	2009-06-15T13:45:30 -> maandag 15 juni 2009 13:45 (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"	Volledig datum-/tijdpatroon (lange tijd). Meer informatie: De aanduiding voor de volledige datum-lange tijdnotatie ('F').	2009-06-15T13:45:30 -> Maandag 15 juni 2009 13:45:30 (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 datumnotatienotatie ('g').	2009-06-15T13:45:30 -> 15-6-2009 13:45 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 6/2009 15 13:45 (zh-CN)
"G"	Algemeen datum-/tijdpatroon (lange tijd). Meer informatie: De algemene datum lange tijd ('G')-notatie.	2009-06-15T13:45:30 -> 15-6-2009 13:45:30 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 6-2009 15 13:45:30 (zh-CN)
"M", "m"	Maand-/dagpatroon. Meer informatie: De maandnotatieaanduiding ('M', 'm').	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"	datum/tijd-patroon van retour. Meer informatie: De indelingsaanduiding van de retour ("O", "o")	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.00000000Z 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:00
"R", "r"	RFC1123-patroon. Meer informatie: De indelingsaanduiding RFC1123 ('R', 'r').	DateTimeOffset invoer: 2009-06-15T13:45:30 -> ma, 15 jun 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 indelingsaanduiding voor sorteren ('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 aanduiding voor de korte tijdnotatie ('t').	2009-06-15T13:45:30 -> 13:45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Lange tijd patroon. Meer informatie: De aanduiding voor de lange tijdnotatie (T).	2009-06-15T13:45:30 -> 13:45:30 (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)-indelingsaanduiding.	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 volledig datum/tijd-patroon. Meer informatie: De universal full (U)-indelingsaanduiding.	2009-06-15T13:45:30 -> maandag 15 juni 2009 2009 20:45:30 (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 jaarmaandnotatie ('Y') specifier.	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)
Een ander enkel teken	Onbekende aanduiding.	Genereert een runtime FormatException.

Hoe standaardnotatietekenreeksen 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 aangepaste notatie is dat, hoewel de alias invariant blijft, de tekenreeks van de aangepaste indeling zelf kan variëren. Dit is belangrijk omdat de tekenreeksweergaven van datum- en tijdwaarden doorgaans verschillen per cultuur. De standaardnotatietekenreeks 'd' 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 aangepaste notatietekenreeks van een bepaalde cultuur, kan uw toepassing de specifieke cultuur definiëren waarvan tekenreeksen met aangepaste opmaak op een van de volgende manieren worden gebruikt:

U kunt de standaardcultuur (of de huidige cultuur) 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 dat de cultuur vertegenwoordigt waarvan de opmaak moet worden gebruikt, doorgeven aan een methode die een IFormatProvider parameter heeft. In het volgende voorbeeld wordt een datum weergegeven met 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 met opmaakgegevens doorgeven aan een methode met een IFormatProvider parameter. In het volgende voorbeeld wordt een datum weergegeven met 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 klasseonderwerp voor informatie over het aanpassen van de patronen of tekenreeksen die worden gebruikt bij het NumberFormatInfo 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 aangepaste notatietekenreeksen die zijn gedefinieerd door de invariante cultuur. Ze produceren tekenreeksweergaven van datum- en tijdwaarden die zijn bedoeld om identiek te zijn in verschillende culturen. De volgende tabel bevat informatie over deze vier standaard tekenreeksen voor datum- en tijdnotatie.

Standaardnotatietekenreeks	Gedefinieerd door de eigenschap DateTimeFormatInfo.InvariantInfo	Tekenreeks met aangepaste opmaak
"O" of "o"	Geen	jjjj'-'MM'-'dd'T'UU':'mm':'ss'.' fffffffK
"R" of "r"	RFC1123Pattern	ddd, dd MMM jjjj UU':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	jjjj'-'MM'-'dd'T'UU':'mm':'ss
"u"	UniversalSortableDateTimePattern	jjjj'-'MM'-'dd uu':'mm':'ss'Z'

Tekenreeksen in de standaardindeling kunnen ook worden gebruikt bij het parseren van bewerkingen met de DateTime.ParseExact methoden of DateTimeOffset.ParseExact , waarvoor een invoertekenreeks precies moet voldoen aan een bepaald patroon om de parseerbewerking te laten slagen. Veel tekenreeksen met standaardnotatie worden toegewezen aan meerdere tekenreeksen met aangepaste notaties, zodat een datum- en tijdwaarde in verschillende indelingen kan worden weergegeven en de parseringsbewerking nog steeds slaagt. U kunt de aangepaste notatietekenreeks of tekenreeksen bepalen die overeenkomen met een standaardnotatietekenreeks door de DateTimeFormatInfo.GetAllDateTimePatterns(Char) methode aan te roepen. In het volgende voorbeeld worden de aangepaste notatietekenreeksen weergegeven die zijn toegewezen aan de standaardnotatietekenreeks 'd' (kort 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("   {0}", 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 standaardindelingsaanduidingen 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 eigenschap van DateTimeFormatInfo.ShortDatePattern een specifieke cultuur. De aangepaste notatietekenreeks die wordt geretourneerd door de ShortDatePattern eigenschap van de invariante cultuur is bijvoorbeeld 'MM/dd/jjjj'.

De volgende tabel bevat de DateTimeFormatInfo objecteigenschappen die de opmaak van de geretourneerde tekenreeks bepalen.

Eigenschap	Beschrijving
ShortDatePattern	Hiermee definieert u de algehele indeling van de resultaattekenreeks.
DateSeparator	Hiermee definieert u de tekenreeks die de jaar-, maand- en dagonderdelen van een datum scheidt.

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

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

Eigenschap	Beschrijving
LongDatePattern	Definieert de notatie van het datumonderdeel van de resultaattekenreeks.
ShortTimePattern	Hiermee definieert u de notatie van het tijdonderdeel van de resultaattekenreeks.
DayNames	Definieert de gelokaliseerde dagnamen die kunnen worden weergegeven in de resultaatreeks.
MonthNames	Definieert de gelokaliseerde maandnamen die kunnen worden weergegeven in de resultaattekenreeks.
TimeSeparator	Definieert 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 voor 12-uurstijd.
PMDesignator	Definieert de tekenreeks die tijden aangeeft van 's middags tot voor middernacht in een 12-uurs klok.

Eigenschap	Beschrijving
FullDateTimePattern	Hiermee definieert u de algehele indeling van de resultaattekenreeks.
DayNames	Definieert de gelokaliseerde dagnamen die kunnen worden weergegeven in de resultaatreeks.
MonthNames	Definieert de gelokaliseerde maandnamen die kunnen worden weergegeven in de resultaattekenreeks.
TimeSeparator	Definieert 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 voor 12-uurstijd.
PMDesignator	Definieert de tekenreeks die tijden aangeeft van 's middags tot voor middernacht in een 12-uurs klok.

Eigenschap	Beschrijving
ShortDatePattern	Definieert de notatie van het datumonderdeel van de resultaattekenreeks.
LongTimePattern	Hiermee definieert u de notatie van het tijdonderdeel van de resultaattekenreeks.
DateSeparator	Hiermee definieert u de tekenreeks die de jaar-, maand- en dagonderdelen van een datum scheidt.
TimeSeparator	Definieert 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 voor 12-uurstijd.
PMDesignator	Definieert de tekenreeks die tijden aangeeft van 's middags tot voor middernacht in een 12-uurs klok.

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

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

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

Delen via

Standaardtekenreeksen voor datum- en tijdnotatie

Tabel met opmaakaanduidingen

Hoe standaardnotatietekenreeksen werken

Datumnotaties

De korte datumnotatie ('d')

De lange datumnotatie ('D')

Datum- en tijdnotaties

De volledige datumnotatie ('f')

De volledige datum lange tijd ('F')-notatie

De algemene datumnotatie ('g')

De algemene datum-lange tijdnotatie ('G')

De indelingsaanduiding voor de retour ("O", "o")

De RFC1123 -indeling ('R', 'r')

De aanduiding voor de sorteerbare notatie ('s')

De universal sortable (u)-indelingsaanduiding

De universal full (U)-indelingsaanduiding

Tijdnotaties

De aanduiding voor de korte tijdnotatie ('t')

De aanduiding lange tijdnotatie ('T')

Gedeeltelijke datumnotaties

De aanduiding voor de maandnotatie ('M', 'm')

De jaarnotatie ('Y', 'y')

Configuratiescherm-instellingen

Eigenschappen van DateTimeFormatInfo

Zie ook

Aanvullende resources