Tekenreeksen met aangepaste datum- en tijdnotatie
Een tekenreeks voor datum- en tijdnotatie definieert de tekstweergave van een DateTime of DateTimeOffset waarde 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.
Tip
U kunt het hulpprogramma Opmaak downloaden, een .NET Core 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.
Aangepaste tekenreeksen voor datum- en tijdnotatie kunnen worden gebruikt met zowel waarden DateTime DateTimeOffset als waarden.
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. 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 C#-compilerfoutberichten weergegeven.
De lokale tijdzone van de Try.NET inline codeloper 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 typen en TimeZoneInfo hun leden illustreren.
Bij opmaakbewerkingen kunnen aangepaste tekenreeksen voor datum- en tijdnotatie worden gebruikt met de ToString methode van een datum- en tijdexemplaren of met een methode die samengestelde opmaak ondersteunt. In het volgende voorbeeld ziet u beide toepassingen.
DateTime thisDate1 = new DateTime(2011, 6, 10);
Console.WriteLine("Today is " + thisDate1.ToString("MMMM dd, yyyy") + ".");
DateTimeOffset thisDate2 = new DateTimeOffset(2011, 6, 10, 15, 24, 16,
TimeSpan.Zero);
Console.WriteLine("The current date and time: {0:MM/dd/yy H:mm:ss zzz}",
thisDate2);
// The example displays the following output:
// Today is June 10, 2011.
// The current date and time: 06/10/11 15:24:16 +00:00
Dim thisDate1 As Date = #6/10/2011#
Console.WriteLine("Today is " + thisDate1.ToString("MMMM dd, yyyy") + ".")
Dim thisDate2 As New DateTimeOffset(2011, 6, 10, 15, 24, 16, TimeSpan.Zero)
Console.WriteLine("The current date and time: {0:MM/dd/yy H:mm:ss zzz}",
thisDate2)
' The example displays the following output:
' Today is June 10, 2011.
' The current date and time: 06/10/11 15:24:16 +00:00
Bij parseringsbewerkingen kunnen tekenreeksen voor aangepaste datum- en tijdnotatie worden gebruikt met de DateTime.ParseExact, DateTime.TryParseExacten DateTimeOffset.ParseExactDateTimeOffset.TryParseExact methoden. Voor deze methoden 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 DateTimeOffset.ParseExact(String, String, IFormatProvider) methode om een datum te parseren die een dag, een maand en een jaar met twee cijfers moet bevatten.
using System;
using System.Globalization;
public class Example1
{
public static void Main()
{
string[] dateValues = { "30-12-2011", "12-30-2011",
"30-12-11", "12-30-11" };
string pattern = "MM-dd-yy";
DateTime parsedDate;
foreach (var dateValue in dateValues)
{
if (DateTime.TryParseExact(dateValue, pattern, null,
DateTimeStyles.None, out parsedDate))
Console.WriteLine("Converted '{0}' to {1:d}.",
dateValue, parsedDate);
else
Console.WriteLine("Unable to convert '{0}' to a date and time.",
dateValue);
}
}
}
// 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.
Imports System.Globalization
Module Example
Public Sub Main()
Dim dateValues() As String = {"30-12-2011", "12-30-2011",
"30-12-11", "12-30-11"}
Dim pattern As String = "MM-dd-yy"
Dim parsedDate As Date
For Each dateValue As String In dateValues
If DateTime.TryParseExact(dateValue, pattern, Nothing,
DateTimeStyles.None, parsedDate) Then
Console.WriteLine("Converted '{0}' to {1:d}.",
dateValue, parsedDate)
Else
Console.WriteLine("Unable to convert '{0}' to a date and time.",
dateValue)
End If
Next
End Sub
End Module
' 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. Zie de sectie Notities voor meer informatie over het gebruik van tekenreeksen voor aangepaste 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 ff aangepaste notatieaanduiding. |
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 opmaakaanduiding 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 ffffff Specifier voor aangepaste indeling. |
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 opmaakaanduiding 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 notatieaanduiding 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 notatieaanduiding 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 opmaakaanduiding K. |
Met DateTime waarden: 2009-06-15T13:45:30, Kind niet opgegeven -> 2009-06-15T13:45:30, Kind Utc -> Z 2009-06-15T13:45:30, Kind Local -> -07:00 (afhankelijk van de lokale computerinstellingen) Met DateTimeOffset waarden: 2009-06-15T01:45:30-07:00 --> -07:00 2009-06-15T08:45:30+00:00 --> +00:00 |
| "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 "mm" Aangepaste notatieaanduiding. |
2009-06-15T01:09:30 -> 09 2009-06-15T01:45:30 -> 45 |
| "M" | De maand, van 1 tot 12. Meer informatie: De aangepaste opmaakaanduiding 'M'. |
2009-06-15T13:45:30 -> 6 |
| "MM" | De maand, van 01 tot 12. Meer informatie: De "MM" aangepaste notatieaanduiding. |
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 -> uJuni (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 yy aangepaste notatieaanduiding. |
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 jjjj. |
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 jjjj. |
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 'zz' Aangepaste opmaakaanduiding. |
2009-06-15T13:45:30-07:00 -> -07 |
| "zzz" | Uren en minuten offset van UTC. Meer informatie: De 'zzz' Aangepaste opmaakaanduiding. |
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 aangepaste notatieaanduiding '/'. |
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: Specifiers voor één aangepaste indeling gebruiken. |
2009-06-15T13:45:30 (%h) -> 1 |
| \ | Het escape-teken. Meer informatie: letterlijke tekens en het escape-teken gebruiken. |
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 DateTime waarde of een DateTimeOffset waarde.
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. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'd' in verschillende notatietekenreeksen.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("d, M",
CultureInfo.InvariantCulture));
// Displays 29, 8
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays 29 August
Console.WriteLine(date1.ToString("d MMMM",
CultureInfo.CreateSpecificCulture("es-MX")));
// Displays 29 agosto
Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("d, M", _
CultureInfo.InvariantCulture))
' Displays 29, 8
Console.WriteLine(date1.ToString("d MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays 29 August
Console.WriteLine(date1.ToString("d MMMM", _
CultureInfo.CreateSpecificCulture("es-MX")))
' Displays 29 agosto
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.
DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);
Console.WriteLine(date1.ToString("dd, MM",
CultureInfo.InvariantCulture));
// 02, 01
Dim date1 As Date = #1/2/2008 6:30:15AM#
Console.WriteLine(date1.ToString("dd, MM", _
CultureInfo.InvariantCulture))
' 02, 01
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 DateTimeFormatInfo.AbbreviatedDayNames eigenschap van de huidige of opgegeven cultuur.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding ddd in een tekenreeks voor aangepaste notatie.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays ven. 29 août
Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays ven. 29 août
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 eigenschap van de DateTimeFormatInfo.DayNames huidige of opgegeven cultuur.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding dddd in een tekenreeks voor aangepaste notatie.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("it-IT")));
// Displays venerdì 29 agosto
Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("it-IT")))
' Displays venerdì 29 agosto
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. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Wanneer u de notatieaanduidingen 'f' gebruikt als onderdeel van een notatietekenreeks die is opgegeven aan de ParseExact, TryParseExactParseExactof TryParseExact methode, geeft het aantal notatieaanduidingen 'f' het aantal belangrijkste cijfers van de fractie seconden aan dat aanwezig moet zijn om de tekenreeks te parseren.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'f' in een tekenreeks voor aangepaste notatie.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
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.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
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.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
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 NT versie 3.5 (en hoger) en Windows Vista is de resolutie van de klok ongeveer 10-15 milliseconden.
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 NT 3.5 (en hoger) en Windows Vista is de resolutie van de klok ongeveer 10-15 milliseconden.
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 NT 3.5 (en hoger) en Windows Vista is de resolutie van de klok ongeveer 10-15 milliseconden.
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 NT 3.5 (en hoger) en Windows Vista is de resolutie van de klok ongeveer 10-15 milliseconden.
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. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het aantal notatieaanduidingen 'F' dat wordt gebruikt met de ParseExactTryParseExact, of ParseExactTryParseExact methode 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.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
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.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
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.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15, 18);
CultureInfo ci = CultureInfo.InvariantCulture;
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci));
// Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci));
// Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci));
// Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci));
// Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci));
// Displays 07:27:15.018
Dim date1 As New Date(2008, 8, 29, 19, 27, 15, 018)
Dim ci As CultureInfo = CultureInfo.InvariantCulture
Console.WriteLine(date1.ToString("hh:mm:ss.f", ci))
' Displays 07:27:15.0
Console.WriteLine(date1.ToString("hh:mm:ss.F", ci))
' Displays 07:27:15
Console.WriteLine(date1.ToString("hh:mm:ss.ff", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.FF", ci))
' Displays 07:27:15.01
Console.WriteLine(date1.ToString("hh:mm:ss.fff", ci))
' Displays 07:27:15.018
Console.WriteLine(date1.ToString("hh:mm:ss.FFF", ci))
' Displays 07:27:15.018
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 NT 3.5 (en hoger) en Windows Vista is de resolutie van de klok ongeveer 10-15 milliseconden.
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 NT 3.5 (en hoger) en Windows Vista is de resolutie van de klok ongeveer 10-15 milliseconden.
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 NT 3.5 (en hoger) en Windows Vista is de resolutie van de klok ongeveer 10-15 milliseconden.
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 NT 3.5 (en hoger) en Windows Vista is de resolutie van de klok ongeveer 10-15 milliseconden.
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. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding g in een tekenreeks voor aangepaste notatie.
DateTime date1 = new DateTime(70, 08, 04);
Console.WriteLine(date1.ToString("MM/dd/yyyy g",
CultureInfo.InvariantCulture));
// Displays 08/04/0070 A.D.
Console.WriteLine(date1.ToString("MM/dd/yyyy g",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays 08/04/0070 ap. J.-C.
Dim date1 As Date = #08/04/0070#
Console.WriteLine(date1.ToString("MM/dd/yyyy g", _
CultureInfo.InvariantCulture))
' Displays 08/04/0070 A.D.
Console.WriteLine(date1.ToString("MM/dd/yyyy g", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays 08/04/0070 ap. J.-C.
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 een FormatException. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'h' in een tekenreeks met een aangepaste notatie.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1 µ
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5 µ
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1 µ
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5 µ
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 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.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
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 standaardnotatieaanduiding voor datum- en tijdnotatie en wordt een FormatException. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'H' in een tekenreeks voor aangepaste notatie.
DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("H:mm:ss",
CultureInfo.InvariantCulture));
// Displays 6:09:01
Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("H:mm:ss", _
CultureInfo.InvariantCulture))
' Displays 6:09:01
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.
DateTime date1 = new DateTime(2008, 1, 1, 6, 9, 1);
Console.WriteLine(date1.ToString("HH:mm:ss",
CultureInfo.InvariantCulture));
// Displays 06:09:01
Dim date1 As Date = #6:09:01AM#
Console.WriteLine(date1.ToString("HH:mm:ss", _
CultureInfo.InvariantCulture))
' Displays 06:09:01
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 DateTime waarden, wordt de resultaattekenreeks gedefinieerd door de waarde van de DateTime.Kind eigenschap:
Voor de lokale tijdzone (een DateTime.Kind eigenschapswaarde van DateTimeKind.Local), produceert deze aanduiding een resultaattekenreeks met de lokale offset van Coordinated Universal Time (UTC), bijvoorbeeld '-07:00'.
Voor een UTC-tijd (een DateTime.Kind eigenschapswaarde van DateTimeKind.Utc), bevat de resultaattekenreeks een Z-teken dat een UTC-datum vertegenwoordigt.
Voor een tijd uit een niet-opgegeven tijdzone (een tijd waarvan DateTime.Kind de eigenschap gelijk DateTimeKind.Unspecifiedis aan), is het resultaat gelijk aan String.Empty.
Voor DateTimeOffset waarden is de notatieaanduiding K gelijk aan de notatieaanduiding 'zzz' en produceert een resultaattekenreeks die de verschuiving van de DateTimeOffset waarde van UTC bevat.
Als de notatieaanduiding K wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaardaanduiding voor datum- en tijdnotatie en wordt een FormatException. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
In het volgende voorbeeld wordt de tekenreeks weergegeven die het resultaat is van het gebruik van de aangepaste indeling 'K' met verschillende DateTime waarden en DateTimeOffset waarden op een systeem in de Tijdzone van de Verenigde Oceaan.
Console.WriteLine(DateTime.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTime.UtcNow.ToString("%K"));
// Displays Z
Console.WriteLine("'{0}'",
DateTime.SpecifyKind(DateTime.Now,
DateTimeKind.Unspecified).ToString("%K"));
// Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"));
// Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"));
// Displays +00:00
Console.WriteLine(new DateTimeOffset(2008, 5, 1, 6, 30, 0,
new TimeSpan(5, 0, 0)).ToString("%K"));
// Displays +05:00
Console.WriteLine(Date.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(Date.UtcNow.ToString("%K"))
' Displays Z
Console.WriteLine("'{0}'", _
Date.SpecifyKind(Date.Now, _
DateTimeKind.Unspecified). _
ToString("%K"))
' Displays ''
Console.WriteLine(DateTimeOffset.Now.ToString("%K"))
' Displays -07:00
Console.WriteLine(DateTimeOffset.UtcNow.ToString("%K"))
' Displays +00:00
Console.WriteLine(New DateTimeOffset(2008, 5, 1, 6, 30, 0, _
New TimeSpan(5, 0, 0)). _
ToString("%K"))
' Displays +05:00
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. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'm' in een tekenreeks voor aangepaste notatie.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1 µ
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5 µ
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1 µ
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5 µ
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.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
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. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'M' in een tekenreeks met een aangepaste notatie.
DateTime date1 = new DateTime(2008, 8, 18);
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("nl-NL")));
// Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM",
CultureInfo.CreateSpecificCulture("lv-LV")));
// Displays (8) Aug, augusts
Dim date1 As Date = #8/18/2008#
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays (8) Aug, August
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
CultureInfo.CreateSpecificCulture("nl-NL")))
' Displays (8) aug, augustus
Console.WriteLine(date1.ToString("(M) MMM, MMMM", _
CultureInfo.CreateSpecificCulture("lv-LV")))
' Displays (8) Aug, augusts
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.
DateTime date1 = new DateTime(2008, 1, 2, 6, 30, 15);
Console.WriteLine(date1.ToString("dd, MM",
CultureInfo.InvariantCulture));
// 02, 01
Dim date1 As Date = #1/2/2008 6:30:15AM#
Console.WriteLine(date1.ToString("dd, MM", _
CultureInfo.InvariantCulture))
' 02, 01
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 eigenschap van de DateTimeFormatInfo.AbbreviatedMonthNames huidige of opgegeven cultuur. Als er een aangepaste notatieaanduiding 'd' of 'dd' is in de tekenreeks voor aangepaste notatie, wordt deze opgehaald uit de DateTimeFormatInfo.AbbreviatedMonthGenitiveNames eigenschap.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding MMM in een tekenreeks voor aangepaste notatie.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays ven. 29 août
Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Fri 29 Aug
Console.WriteLine(date1.ToString("ddd d MMM", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays ven. 29 août
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 eigenschap van de DateTimeFormatInfo.MonthNames huidige of opgegeven cultuur. Als er een aangepaste notatieaanduiding 'd' of 'dd' is in de tekenreeks voor aangepaste notatie, wordt deze opgehaald uit de DateTimeFormatInfo.MonthGenitiveNames eigenschap.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding MMMM in een tekenreeks met aangepaste notatie.
DateTime date1 = new DateTime(2008, 8, 29, 19, 27, 15);
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM",
CultureInfo.CreateSpecificCulture("it-IT")));
// Displays venerdì 29 agosto
Dim date1 As Date = #08/29/2008 7:27:15PM#
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Friday 29 August
Console.WriteLine(date1.ToString("dddd dd MMMM", _
CultureInfo.CreateSpecificCulture("it-IT")))
' Displays venerdì 29 agosto
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. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 's' in een tekenreeks voor aangepaste notatie.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1 µ
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5 µ
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1 µ
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5 µ
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.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
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 DateTimeFormatInfo.AMDesignator of DateTimeFormatInfo.PMDesignator eigenschap van 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. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 't' in een tekenreeks met aangepaste notatie.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1 µ
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.InvariantCulture));
// Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t",
CultureInfo.CreateSpecificCulture("el-GR")));
// Displays 6:9:1.5 µ
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1 µ
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.InvariantCulture))
' Displays 6:9:1.5 P
Console.WriteLine(date1.ToString("h:m:s.F t", _
CultureInfo.CreateSpecificCulture("el-GR")))
' Displays 6:9:1.5 µ
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 DateTimeFormatInfo.AMDesignator of DateTimeFormatInfo.PMDesignator eigenschap van 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.
DateTime date1;
date1 = new DateTime(2008, 1, 1, 18, 9, 1);
Console.WriteLine(date1.ToString("hh:mm:ss tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01 du.
date1 = new DateTime(2008, 1, 1, 18, 9, 1, 500);
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.InvariantCulture));
// Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt",
CultureInfo.CreateSpecificCulture("hu-HU")));
// Displays 06:09:01.50 du.
Dim date1 As Date
date1 = #6:09:01PM#
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01 PM
Console.WriteLine(date1.ToString("hh:mm:ss tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01 du.
date1 = New Date(2008, 1, 1, 18, 9, 1, 500)
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.InvariantCulture))
' Displays 06:09:01.50 PM
Console.WriteLine(date1.ToString("hh:mm:ss.ff tt", _
CultureInfo.CreateSpecificCulture("hu-HU")))
' Displays 06:09:01.50 du.
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'. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding y in een tekenreeks voor aangepaste notatie.
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
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 'yy' geïnterpreteerd op basis van de eigenschap van de Calendar.TwoDigitYearMax huidige kalender van de indelingsprovider. 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. Vervolgens wordt het object van CultureInfo de huidige cultuur gewijzigd in het gebruik van een GregorianCalendar object waarvan TwoDigitYearMax de eigenschap is gewijzigd.
using System;
using System.Globalization;
using System.Threading;
public class Example7
{
public static void Main()
{
string fmt = "dd-MMM-yy";
string value = "24-Jan-49";
Calendar cal = (Calendar)CultureInfo.CurrentCulture.Calendar.Clone();
Console.WriteLine("Two Digit Year Range: {0} - {1}",
cal.TwoDigitYearMax - 99, cal.TwoDigitYearMax);
Console.WriteLine("{0:d}", DateTime.ParseExact(value, fmt, null));
Console.WriteLine();
cal.TwoDigitYearMax = 2099;
CultureInfo culture = (CultureInfo)CultureInfo.CurrentCulture.Clone();
culture.DateTimeFormat.Calendar = cal;
Thread.CurrentThread.CurrentCulture = culture;
Console.WriteLine("Two Digit Year Range: {0} - {1}",
cal.TwoDigitYearMax - 99, cal.TwoDigitYearMax);
Console.WriteLine("{0:d}", DateTime.ParseExact(value, fmt, null));
}
}
// The example displays the following output:
// Two Digit Year Range: 1930 - 2029
// 1/24/1949
//
// Two Digit Year Range: 2000 - 2099
// 1/24/2049
Imports System.Globalization
Imports System.Threading
Module Example
Public Sub Main()
Dim fmt As String = "dd-MMM-yy"
Dim value As String = "24-Jan-49"
Dim cal As Calendar = CType(CultureInfo.CurrentCulture.Calendar.Clone(), Calendar)
Console.WriteLine("Two Digit Year Range: {0} - {1}",
cal.TwoDigitYearMax - 99, cal.TwoDigitYearMax)
Console.WriteLine("{0:d}", DateTime.ParseExact(value, fmt, Nothing))
Console.WriteLine()
cal.TwoDigitYearMax = 2099
Dim culture As CultureInfo = CType(CultureInfo.CurrentCulture.Clone(), CultureInfo)
culture.DateTimeFormat.Calendar = cal
Thread.CurrentThread.CurrentCulture = culture
Console.WriteLine("Two Digit Year Range: {0} - {1}",
cal.TwoDigitYearMax - 99, cal.TwoDigitYearMax)
Console.WriteLine("{0:d}", DateTime.ParseExact(value, fmt, Nothing))
End Sub
End Module
' The example displays the following output:
' Two Digit Year Range: 1930 - 2029
' 1/24/1949
'
' Two Digit Year Range: 2000 - 2099
' 1/24/2049
Het volgende voorbeeld bevat de aangepaste notatieaanduiding yyy in een tekenreeks voor aangepaste notatie.
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
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.
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
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.
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
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.
DateTime date1 = new DateTime(1, 12, 1);
DateTime date2 = new DateTime(2010, 1, 1);
Console.WriteLine(date1.ToString("%y"));
// Displays 1
Console.WriteLine(date1.ToString("yy"));
// Displays 01
Console.WriteLine(date1.ToString("yyy"));
// Displays 001
Console.WriteLine(date1.ToString("yyyy"));
// Displays 0001
Console.WriteLine(date1.ToString("yyyyy"));
// Displays 00001
Console.WriteLine(date2.ToString("%y"));
// Displays 10
Console.WriteLine(date2.ToString("yy"));
// Displays 10
Console.WriteLine(date2.ToString("yyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyy"));
// Displays 2010
Console.WriteLine(date2.ToString("yyyyy"));
// Displays 02010
Dim date1 As Date = #12/1/0001#
Dim date2 As Date = #1/1/2010#
Console.WriteLine(date1.ToString("%y"))
' Displays 1
Console.WriteLine(date1.ToString("yy"))
' Displays 01
Console.WriteLine(date1.ToString("yyy"))
' Displays 001
Console.WriteLine(date1.ToString("yyyy"))
' Displays 0001
Console.WriteLine(date1.ToString("yyyyy"))
' Displays 00001
Console.WriteLine(date2.ToString("%y"))
' Displays 10
Console.WriteLine(date2.ToString("yy"))
' Displays 10
Console.WriteLine(date2.ToString("yyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyy"))
' Displays 2010
Console.WriteLine(date2.ToString("yyyyy"))
' Displays 02010
Verschuiving "z" opmaakaanduiding
De aangepaste notatieaanduiding 'z'
Met DateTime 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 verschuivingswaarde verandert, afhankelijk DateTimeKindvan.
| DateTimeKind waarde | Verschuivingswaarde |
|---|---|
| Local | De ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. |
| Unspecified | De ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. |
| Utc | +0 op .NET Core en .NET 5+. In .NET Framework is de ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. |
Met DateTimeOffset waarden vertegenwoordigt deze notatieaanduiding de verschuiving van de DateTimeOffset waarde van UTC in uren.
Als de notatieaanduiding 'z' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaard datum- en tijdnotatieaanduiding en wordt een FormatException. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'z' in een tekenreeks voor aangepaste notatie.
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00 on .NET Framework
// Displays +0, +00, +00:00 on .NET Core and .NET 5+
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00 on .NET Framework
' Displays +0, +00, +00:00 on .NET Core and .NET 5+
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
De aangepaste notatieaanduiding 'zz'
Met DateTime 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 verschuivingswaarde verandert, afhankelijk DateTimeKindvan.
| DateTimeKind waarde | Verschuivingswaarde |
|---|---|
| Local | De ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. |
| Unspecified | De ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. |
| Utc | +00 op .NET Core en .NET 5+. In .NET Framework is de ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. |
Met DateTimeOffset waarden vertegenwoordigt deze notatieaanduiding de verschuiving van de DateTimeOffset waarde van UTC in uren.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'zz' in een tekenreeks voor aangepaste notatie.
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00 on .NET Framework
// Displays +0, +00, +00:00 on .NET Core and .NET 5+
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00 on .NET Framework
' Displays +0, +00, +00:00 on .NET Core and .NET 5+
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
De aangepaste notatieaanduiding 'zzz'
Met DateTime 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 verschuivingswaarde verandert, afhankelijk DateTimeKindvan.
| DateTimeKind waarde | Verschuivingswaarde |
|---|---|
| Local | De ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. |
| Unspecified | De ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. |
| Utc | +00:00 op .NET Core en .NET 5+. In .NET Framework is de ondertekende offset van de tijdzone van het lokale besturingssysteem van UTC. |
Met DateTimeOffset waarden vertegenwoordigt deze notatieaanduiding de verschuiving van de DateTimeOffset waarde van UTC in uren en minuten.
Het volgende voorbeeld bevat de aangepaste notatieaanduiding 'zzz' in een tekenreeks voor aangepaste notatie.
DateTime date1 = DateTime.UtcNow;
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date1));
// Displays -7, -07, -07:00 on .NET Framework
// Displays +0, +00, +00:00 on .NET Core and .NET 5+
DateTimeOffset date2 = new DateTimeOffset(2008, 8, 1, 0, 0, 0,
new TimeSpan(6, 0, 0));
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}",
date2));
// Displays +6, +06, +06:00
Dim date1 As Date = Date.UtcNow
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date1))
' Displays -7, -07, -07:00 on .NET Framework
' Displays +0, +00, +00:00 on .NET Core and .NET 5+
Dim date2 As New DateTimeOffset(2008, 8, 1, 0, 0, 0, _
New Timespan(6, 0, 0))
Console.WriteLine(String.Format("{0:%z}, {0:zz}, {0:zzz}", _
date2))
' Displays +6, +06, +06:00
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 eigenschap van de DateTimeFormatInfo.TimeSeparator 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 u het tijdscheidingsteken voor alle datums voor een cultuur wilt wijzigen, wijzigt u de waarde van de eigenschap van de DateTimeFormatInfo.TimeSeparator huidige cultuur of instantieert u een DateTimeFormatInfo object, wijst u het teken toe aan TimeSeparator de eigenschap en roept u een overbelasting aan van de opmaakmethode die een IFormatProvider parameter bevat.
Als de notatieaanduiding ':' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaardaanduiding voor datum- en tijdnotatie en wordt een FormatException. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
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 eigenschap van de DateTimeFormatInfo.DateSeparator 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 u het datumscheidingsteken voor alle datums voor een cultuur wilt wijzigen, wijzigt u de waarde van de eigenschap van de DateTimeFormatInfo.DateSeparator huidige cultuur of maakt u een DateTimeFormatInfo object, wijst u het teken toe aan DateSeparator de eigenschap en roept u een overbelasting aan van de opmaakmethode die een IFormatProvider parameter bevat.
Als de notatieaanduiding '/' wordt gebruikt zonder andere aangepaste notatieaanduidingen, wordt deze geïnterpreteerd als een standaardaanduiding voor datum- en tijdnotatie en wordt een FormatException. Zie Using Single Custom Format Specifiers verderop in dit artikel voor meer informatie over het gebruik van één opmaakaanduiding.
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.
FHKMdfghmstyz%:/"'\
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.
using System;
using System.Globalization;
public class Example5
{
public static void Main()
{
String[] formats = { "dd MMM yyyy hh:mm tt PST",
"dd MMM yyyy hh:mm tt PDT" };
var dat = new DateTime(2016, 8, 18, 16, 50, 0);
// Display the result string.
Console.WriteLine(dat.ToString(formats[1]));
// Parse a string.
String value = "25 Dec 2016 12:00 pm PST";
DateTime newDate;
if (DateTime.TryParseExact(value, formats, null,
DateTimeStyles.None, out newDate))
Console.WriteLine(newDate);
else
Console.WriteLine("Unable to parse '{0}'", value);
}
}
// The example displays the following output:
// 18 Aug 2016 04:50 PM PDT
// 12/25/2016 12:00:00 PM
Imports System.Globalization
Module Example
Public Sub Main()
Dim formats() As String = {"dd MMM yyyy hh:mm tt PST",
"dd MMM yyyy hh:mm tt PDT"}
Dim dat As New Date(2016, 8, 18, 16, 50, 0)
' Display the result string.
Console.WriteLine(dat.ToString(formats(1)))
' Parse a string.
Dim value As String = "25 Dec 2016 12:00 pm PST"
Dim newDate As Date
If Date.TryParseExact(value, formats, Nothing,
DateTimeStyles.None, newDate) Then
Console.WriteLine(newDate)
Else
Console.WriteLine("Unable to parse '{0}'", value)
End If
End Sub
End Module
' The example displays the following output:
' 18 Aug 2016 04:50 PM PDT
' 12/25/2016 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. Zie Het escapeteken 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.
using System;
using System.Globalization;
public class Example3
{
public static void Main()
{
String format = "dd MMM yyyy hh:mm tt p\\s\\t";
var dat = new DateTime(2016, 8, 18, 16, 50, 0);
// Display the result string.
Console.WriteLine(dat.ToString(format));
// Parse a string.
String value = "25 Dec 2016 12:00 pm pst";
DateTime newDate;
if (DateTime.TryParseExact(value, format, null,
DateTimeStyles.None, out newDate))
Console.WriteLine(newDate);
else
Console.WriteLine("Unable to parse '{0}'", value);
}
}
// The example displays the following output:
// 18 Aug 2016 04:50 PM pst
// 12/25/2016 12:00:00 PM
Imports System.Globalization
Module Example
Public Sub Main()
Dim fmt As String = "dd MMM yyyy hh:mm tt p\s\t"
Dim dat As New Date(2016, 8, 18, 16, 50, 0)
' Display the result string.
Console.WriteLine(dat.ToString(fmt))
' Parse a string.
Dim value As String = "25 Dec 2016 12:00 pm pst"
Dim newDate As Date
If Date.TryParseExact(value, fmt, Nothing,
DateTimeStyles.None, newDate) Then
Console.WriteLine(newDate)
Else
Console.WriteLine("Unable to parse '{0}'", value)
End If
End Sub
End Module
' The example displays the following output:
' 18 Aug 2016 04:50 PM pst
' 12/25/2016 12:00:00 PM
- Door de hele letterlijke tekenreeks tussen aanhalingstekens of apostrofs te plaatsen. Het volgende voorbeeld is vergelijkbaar met de vorige, behalve dat 'pst' tussen aanhalingstekens staat om aan te geven dat de hele tekenreeks met scheidingstekens moet worden geïnterpreteerd als letterlijke tekens.
using System;
using System.Globalization;
public class Example6
{
public static void Main()
{
String format = "dd MMM yyyy hh:mm tt \"pst\"";
var dat = new DateTime(2016, 8, 18, 16, 50, 0);
// Display the result string.
Console.WriteLine(dat.ToString(format));
// Parse a string.
String value = "25 Dec 2016 12:00 pm pst";
DateTime newDate;
if (DateTime.TryParseExact(value, format, null,
DateTimeStyles.None, out newDate))
Console.WriteLine(newDate);
else
Console.WriteLine("Unable to parse '{0}'", value);
}
}
// The example displays the following output:
// 18 Aug 2016 04:50 PM pst
// 12/25/2016 12:00:00 PM
Imports System.Globalization
Module Example
Public Sub Main()
Dim fmt As String = "dd MMM yyyy hh:mm tt ""pst"""
Dim dat As New Date(2016, 8, 18, 16, 50, 0)
' Display the result string.
Console.WriteLine(dat.ToString(fmt))
' Parse a string.
Dim value As String = "25 Dec 2016 12:00 pm pst"
Dim newDate As Date
If Date.TryParseExact(value, fmt, Nothing,
DateTimeStyles.None, newDate) Then
Console.WriteLine(newDate)
Else
Console.WriteLine("Unable to parse '{0}'", value)
End If
End Sub
End Module
' The example displays the following output:
' 18 Aug 2016 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 notatieaanduiding, gooien ze een FormatException. 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.
DateTime dat1 = new DateTime(2009, 6, 15, 13, 45, 0);
Console.WriteLine("'{0:%h}'", dat1);
Console.WriteLine("'{0: h}'", dat1);
Console.WriteLine("'{0:h }'", dat1);
// The example displays the following output:
// '1'
// ' 1'
// '1 '
Dim dat1 As Date = #6/15/2009 1:45PM#
Console.WriteLine("'{0:%h}'", dat1)
Console.WriteLine("'{0: h}'", dat1)
Console.WriteLine("'{0:h }'", dat1)
' The example displays the following output:
' '1'
' ' 1'
' '1 '
Het escape-teken 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 dit voorafgaan door een backslash (\), het escape-teken. Het escapeteken geeft aan dat het volgende teken een letterlijke tekenreeks is die niet moet worden opgenomen in de resultaattekenreeks.
Als u een backslash wilt opnemen in een resultaattekenreeks, moet u deze escapen met een andere backslash (\\).
Notitie
Sommige compilers, zoals de C++- en C#-compilers, kunnen ook één backslash-teken interpreteren als een escape-teken. Als u ervoor wilt zorgen dat een tekenreeks correct wordt geïnterpreteerd bij het opmaken, kunt u het letterlijke teken van de letterlijke tekenreeks (het @-teken) voor de tekenreeks in C# gebruiken of een ander backslash-teken toevoegen vóór elke backslash in C# en C++. In het volgende C#-voorbeeld ziet u beide benaderingen.
In het volgende voorbeeld wordt het escape-teken gebruikt om te voorkomen dat de opmaakbewerking de tekens 'h' en 'm' interpreteert als opmaakaanduidingen.
DateTime date = new DateTime(2009, 06, 15, 13, 45, 30, 90);
string fmt1 = "h \\h m \\m";
string fmt2 = @"h \h m \m";
Console.WriteLine("{0} ({1}) -> {2}", date, fmt1, date.ToString(fmt1));
Console.WriteLine("{0} ({1}) -> {2}", date, fmt2, date.ToString(fmt2));
// The example displays the following output:
// 6/15/2009 1:45:30 PM (h \h m \m) -> 1 h 45 m
// 6/15/2009 1:45:30 PM (h \h m \m) -> 1 h 45 m
Dim date1 As Date = #6/15/2009 13:45#
Dim fmt As String = "h \h m \m"
Console.WriteLine("{0} ({1}) -> {2}", date1, fmt, date1.ToString(fmt))
' The example displays the following output:
' 6/15/2009 1:45:00 PM (h \h m \m) -> 1 h 45 m
Configuratiescherm-instellingen
De instellingen voor landinstellingen en taalopties in Configuratiescherm invloed hebben op de resultaattekenreeks die wordt geproduceerd door een opmaakbewerking die veel van de aangepaste datum- en tijdnotatieaanduidingen bevat. Deze instellingen worden gebruikt om het DateTimeFormatInfo object te initialiseren dat is gekoppeld aan de huidige cultuur, die waarden biedt die worden gebruikt voor het beheren van opmaak. Computers die verschillende instellingen gebruiken, genereren verschillende resultaattekenreeksen.
Als u de CultureInfo(String) constructor gebruikt om een nieuw CultureInfo object te instantiëren dat dezelfde cultuur vertegenwoordigt als de huidige systeemcultuur, worden alle aanpassingen die zijn ingesteld door het item Landinstellingen in Configuratiescherm toegepast op het nieuwe CultureInfo object. U kunt de CultureInfo(String, Boolean) constructor gebruiken om een CultureInfo object te maken dat niet overeenkomt met de aanpassingen van een systeem.
Eigenschappen van DateTimeFormatInfo
Opmaak wordt beïnvloed door eigenschappen van het huidige DateTimeFormatInfo object, dat impliciet wordt geleverd door de huidige cultuur of expliciet door de parameter van de IFormatProvider methode die opmaak aanroept. Voor de IFormatProvider parameter moet u een CultureInfo object opgeven dat een cultuur of een DateTimeFormatInfo object vertegenwoordigt.
De resultaattekenreeks die wordt geproduceerd door veel van de aangepaste datum- en tijdnotatieaanduidingen, is ook afhankelijk van eigenschappen van het huidige DateTimeFormatInfo object. Uw toepassing kan het resultaat wijzigen dat wordt geproduceerd door een aantal aangepaste datum- en tijdnotatieaanduidingen door de bijbehorende DateTimeFormatInfo eigenschap te wijzigen. De notatieaanduiding 'ddd' voegt bijvoorbeeld een verkorte weekdagnaam toe die in de AbbreviatedDayNames tekenreeksmatrix is gevonden aan de resultaattekenreeks. Op dezelfde manier voegt de notatieaanduiding MMMM een volledige maandnaam toe die in de MonthNames tekenreeksmatrix is gevonden aan de resultaattekenreeks.
