Tekenreeksen in aangepaste tijdspannenotatie

Artikel
03/22/2025

Een TimeSpan-notatietekenreeks definieert de tekenreeksweergave van een TimeSpan waarde die het resultaat is van een opmaakbewerking. Een tekenreeks met aangepaste notatie bestaat uit een of meer aangepaste TimeSpan opmaakaanduidingen, samen met een willekeurig aantal letterlijke tekens. Een tekenreeks die geen standaard-tijdspannotatietekenreeks is wordt geïnterpreteerd als een aangepaste TimeSpan notatietekenreeks.

Belangrijk

De aangepaste TimeSpan notatieaanduidingen bevatten geen tijdelijke aanduidingen voor scheidingstekens, zoals de symbolen die dagen scheiden van uren, uren van minuten of seconden van fractionele seconden. In plaats daarvan moeten deze symbolen als letterlijke tekenreeks in de aangepaste notatie worden opgenomen. "dd\.hh\:mm" definieert bijvoorbeeld een punt (.) als scheidingsteken tussen dagen en uren en een dubbele punt (:) als scheidingsteken tussen uren en minuten.

Aangepaste TimeSpan opmaakaanduidingen bevatten ook geen tekensymbool waarmee u onderscheid kunt maken tussen negatieve en positieve tijdsintervallen. Als u een tekensymbool wilt opnemen, moet u een opmaaktekenreeks maken met behulp van voorwaardelijke logica. De sectie Andere tekens bevat een voorbeeld.

De tekenreeksweergaven van TimeSpan waarden worden geproduceerd door aanroepen naar de overbelasting van de TimeSpan.ToString methode en door methoden die samengestelde opmaak ondersteunen, zoals String.Format. Zie Opmaaktypen en samengestelde opmaakvoor meer informatie. In het volgende voorbeeld ziet u het gebruik van tekenreeksen voor aangepaste opmaak in opmaakbewerkingen.

using System;

public class Example
{
   public static void Main()
   {
      TimeSpan duration = new TimeSpan(1, 12, 23, 62);

      string output = null;
      output = "Time of Travel: " + duration.ToString("%d") + " days";
      Console.WriteLine(output);
      output = "Time of Travel: " + duration.ToString(@"dd\.hh\:mm\:ss");
      Console.WriteLine(output);

      Console.WriteLine($"Time of Travel: {duration:%d} day(s)");
      Console.WriteLine($"Time of Travel: {duration:dd\\.hh\\:mm\\:ss} days");
   }
}
// The example displays the following output:
//       Time of Travel: 1 days
//       Time of Travel: 01.12:24:02
//       Time of Travel: 1 day(s)
//       Time of Travel: 01.12:24:02 days

Module Example
    Public Sub Main()
        Dim duration As New TimeSpan(1, 12, 23, 62)

        Dim output As String = Nothing
        output = "Time of Travel: " + duration.ToString("%d") + " days"
        Console.WriteLine(output)
        output = "Time of Travel: " + duration.ToString("dd\.hh\:mm\:ss")
        Console.WriteLine(output)

        Console.WriteLine("Time of Travel: {0:%d} day(s)", duration)
        Console.WriteLine("Time of Travel: {0:dd\.hh\:mm\:ss} days", duration)
    End Sub
End Module
' The example displays the following output:
'       Time of Travel: 1 days
'       Time of Travel: 01.12:24:02
'       Time of Travel: 1 day(s)
'       Time of Travel: 01.12:24:02 days

Aangepaste TimeSpan notatietekenreeksen worden ook gebruikt door de TimeSpan.ParseExact en TimeSpan.TryParseExact methoden om de vereiste indeling van invoerreeksen voor parseringsbewerkingen te definiëren. (Parseren converteert de tekenreeksweergave van een waarde naar die waarde.) In het volgende voorbeeld ziet u het gebruik van tekenreeksen in de standaardindeling in parseringsbewerkingen.

using System;

public class Example
{
   public static void Main()
   {
      string value = null;
      TimeSpan interval;

      value = "6";
      if (TimeSpan.TryParseExact(value, "%d", null, out interval))
         Console.WriteLine($"{value} --> {interval.ToString("c")}");
      else
         Console.WriteLine($"Unable to parse '{value}'");

      value = "16:32.05";
      if (TimeSpan.TryParseExact(value, @"mm\:ss\.ff", null, out interval))
         Console.WriteLine($"{value} --> {interval.ToString("c")}");
      else
         Console.WriteLine($"Unable to parse '{value}'");

      value= "12.035";
      if (TimeSpan.TryParseExact(value, "ss\\.fff", null, out interval))
         Console.WriteLine($"{value} --> {interval.ToString("c")}");
      else
         Console.WriteLine($"Unable to parse '{value}'");
   }
}
// The example displays the following output:
//       6 --> 6.00:00:00
//       16:32.05 --> 00:16:32.0500000
//       12.035 --> 00:00:12.0350000

Module Example
    Public Sub Main()
        Dim value As String = Nothing
        Dim interval As TimeSpan

        value = "6"
        If TimeSpan.TryParseExact(value, "%d", Nothing, interval) Then
            Console.WriteLine("{0} --> {1}", value, interval.ToString("c"))
        Else
            Console.WriteLine("Unable to parse '{0}'", value)
        End If

        value = "16:32.05"
        If TimeSpan.TryParseExact(value, "mm\:ss\.ff", Nothing, interval) Then
            Console.WriteLine("{0} --> {1}", value, interval.ToString("c"))
        Else
            Console.WriteLine("Unable to parse '{0}'", value)
        End If

        value = "12.035"
        If TimeSpan.TryParseExact(value, "ss\.fff", Nothing, interval) Then
            Console.WriteLine("{0} --> {1}", value, interval.ToString("c"))
        Else
            Console.WriteLine("Unable to parse '{0}'", value)
        End If
    End Sub
End Module
' The example displays the following output:
'       6 --> 6.00:00:00
'       16:32.05 --> 00:16:32.0500000
'       12.035 --> 00:00:12.0350000

In de volgende tabel worden de aangepaste datum- en tijdnotatieaanduidingen beschreven.

Opmaakaanduiding	Beschrijving	Voorbeeld
"d", "%d"	Het aantal hele dagen in het tijdsinterval. Meer informatie: de aangepaste notatieaanduiding d.	`new TimeSpan(6, 14, 32, 17, 685):` `%d` --> "6" `d\.hh\:mm` --> "6.14:32"
"dd"-"ddddddddd"	Het aantal hele dagen in het tijdsinterval, opgevuld met voorloopnullen, indien nodig. Meer informatie: de aangepaste notatieaanduidingen dd d.	`new TimeSpan(6, 14, 32, 17, 685):` `ddd` --> "006" `dd\.hh\:mm` --> "06.14:32"
"h", "%h"	Het aantal hele uren in het tijdsinterval dat niet wordt geteld als onderdeel van dagen. Uren met één cijfer hebben geen voorloopnul. Meer informatie: de aangepaste notatieaanduiding 'h'.	`new TimeSpan(6, 14, 32, 17, 685):` `%h` --> "14" `hh\:mm` --> "14:32"
"uu"	Het aantal hele uren in het tijdsinterval dat niet wordt geteld als onderdeel van dagen. Uren met één cijfer hebben een voorloopnul. Meer informatie: De aangepaste notatieaanduiding 'uu'.	`new TimeSpan(6, 14, 32, 17, 685):` `hh` --> "14" `new TimeSpan(6, 8, 32, 17, 685):` `hh` --> 08
"m", "%m"	Het aantal hele minuten in het tijdsinterval dat niet is opgenomen als onderdeel van uren of dagen. Minuten met één cijfer hebben geen voorloopnul. Meer informatie: De aangepaste notatieaanduiding 'm'.	`new TimeSpan(6, 14, 8, 17, 685):` `%m` --> "8" `h\:m` --> "14:8"
"mm"	Het aantal hele minuten in het tijdsinterval dat niet is opgenomen als onderdeel van uren of dagen. Minuten met één cijfer hebben een voorloopnul. Meer informatie: De aangepaste notatieaanduiding mm.	`new TimeSpan(6, 14, 8, 17, 685):` `mm` --> "08" `new TimeSpan(6, 8, 5, 17, 685):` `d\.hh\:mm\:ss` --> 6.08:05:17
"s", "%s"	Het aantal hele seconden in het tijdsinterval dat niet is opgenomen als onderdeel van uren, dagen of minuten. Seconden met één cijfer hebben geen voorloopnul. Meer informatie: de aangepaste notatieaanduiding 's'.	`TimeSpan.FromSeconds(12.965)`: `%s` --> 12 `s\.fff` --> 12.965
"ss"	Het aantal hele seconden in het tijdsinterval dat niet is opgenomen als onderdeel van uren, dagen of minuten. Seconden met één cijfer hebben een voorloopnul. Meer informatie: De aangepaste notatieaanduiding 'ss'.	`TimeSpan.FromSeconds(6.965)`: `ss` --> 06 `ss\.fff` --> 06.965
"f", "%f"	De tienden van een seconde in een tijdsinterval. Meer informatie: de aangepaste notatieaanduiding 'f'.	`TimeSpan.FromSeconds(6.895)`: `f` --> 8 `ss\.f` --> 06,8
"ff"	De honderdste van een seconde in een tijdsinterval. Meer informatie: De aangepaste notatieaanduiding 'ff'.	`TimeSpan.FromSeconds(6.895)`: `ff` --> 89 `ss\.ff` --> 06,89
"fff"	De milliseconden in een tijdsinterval. Meer informatie: De aangepaste notatieaanduiding 'fff'.	`TimeSpan.FromSeconds(6.895)`: `fff` --> 895 `ss\.fff` --> 06.895
"ffff"	De tienduizendste van een seconde in een tijdsinterval. Meer informatie: De aangepaste notatieaanduiding 'ffff'.	`TimeSpan.Parse("0:0:6.8954321")`: `ffff` --> 8954 `ss\.ffff` --> 06.8954
"fffff"	De honderdduizendste van een seconde in een tijdsinterval. Meer informatie: De aangepaste notatieaanduiding fffff.	`TimeSpan.Parse("0:0:6.8954321")`: `fffff` --> 89543 `ss\.fffff` --> 06.89543
"ffffff"	De miljoenden van een seconde in een tijdsinterval. Meer informatie: De aangepaste notatieaanduiding ffffff.	`TimeSpan.Parse("0:0:6.8954321")`: `ffffff` --> 895432 `ss\.ffffff` --> 06.895432
"fffffff"	De tien miljoenste van een seconde (of de breuktekens) in een tijdsinterval. Meer informatie: de aangepaste notatieaanduiding fffffff.	`TimeSpan.Parse("0:0:6.8954321")`: `fffffff` --> 8954321 `ss\.fffffff` --> 06.8954321
"F", "%F"	De tienden van een seconde in een tijdsinterval. Er wordt niets weergegeven als het cijfer nul is. Meer informatie: de aangepaste notatieaanduiding F.	`TimeSpan.Parse("00:00:06.32")`: `%F`: 3 `TimeSpan.Parse("0:0:3.091")`: `ss\.F`: 03.
"FF"	De honderdste van een seconde in een tijdsinterval. Eventuele breuknullen of twee nullen worden niet opgenomen. Meer informatie: De aangepaste indelingsaanduiding FF.	`TimeSpan.Parse("00:00:06.329")`: `FF`: 32 `TimeSpan.Parse("0:0:3.101")`: `ss\.FF`: 03.1
"FFF"	De milliseconden in een tijdsinterval. Eventuele breuknullen worden niet opgenomen. Meer informatie:	`TimeSpan.Parse("00:00:06.3291")`: `FFF`: 329 `TimeSpan.Parse("0:0:3.1009")`: `ss\.FFF`: 03.1
"FFFF"	De tienduizendste van een seconde in een tijdsinterval. Eventuele breuknullen worden niet opgenomen. Meer informatie: De aangepaste indelingsaanduiding FFFF.	`TimeSpan.Parse("00:00:06.32917")`: `FFFFF`: 3291 `TimeSpan.Parse("0:0:3.10009")`: `ss\.FFFF`: 03.1
"FFFFF"	De honderdduizendste van een seconde in een tijdsinterval. Eventuele breuknullen worden niet opgenomen. Meer informatie: De aangepaste indelingsaanduiding FFFFF.	`TimeSpan.Parse("00:00:06.329179")`: `FFFFF`: 32917 `TimeSpan.Parse("0:0:3.100009")`: `ss\.FFFFF`: 03.1
"FFFFFF"	De miljoenden van een seconde in een tijdsinterval. Eventuele breuknullen worden niet weergegeven. Meer informatie: de aangepaste indelingsaanduiding FFFFFF.	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 329179 `TimeSpan.Parse("0:0:3.1000009")`: `ss\.FFFFFF`: 03.1
"FFFFFFF"	De tien miljoenen seconden in een tijdsinterval. Eventuele breuknullen of zeven nullen worden niet weergegeven. Meer informatie: de aangepaste notatieaanduiding FFFFFFF.	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 3291791 `TimeSpan.Parse("0:0:3.1900000")`: `ss\.FFFFFF`: 03.19
'tekenreeks'	Letterlijk tekenreeksscheidingsteken. Meer informatie: Andere tekens.	`new TimeSpan(14, 32, 17):` `hh':'mm':'ss` --> "14:32:17"
\	Het escape-teken. Meer informatie: Andere tekens.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` --> "14:32:17"
Elk ander teken	Elk ander niet-gescaped teken wordt geïnterpreteerd als een aangepaste notatieaanduiding. Meer informatie: andere tekens.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` --> "14:32:17"

De aangepaste notatieaanduiding 'd'

De aangepaste notatieaanduiding d voert de waarde uit van de eigenschap TimeSpan.Days, die het aantal hele dagen in het tijdsinterval aangeeft. Het volledige aantal dagen wordt uitgevoerd in een TimeSpan waarde, zelfs als de waarde meer dan één cijfer heeft. Als de waarde van de eigenschap TimeSpan.Days nul is, voert de aanduiding '0' uit.

Als de aangepaste notatieaanduiding 'd' alleen wordt gebruikt, geeft u '%d' op, zodat deze niet verkeerd wordt geïnterpreteerd als een standaardnotatietekenreeks. In het volgende voorbeeld ziet u een afbeelding.

TimeSpan ts1 = new TimeSpan(16, 4, 3, 17, 250);
Console.WriteLine(ts1.ToString("%d"));
// Displays 16

Dim ts As New TimeSpan(16, 4, 3, 17, 250)
Console.WriteLine(ts.ToString("%d"))
' Displays 16

In het volgende voorbeeld ziet u het gebruik van de aangepaste notatieaanduiding 'd'.

TimeSpan ts2 = new TimeSpan(4, 3, 17);
Console.WriteLine(ts2.ToString(@"d\.hh\:mm\:ss"));

TimeSpan ts3 = new TimeSpan(3, 4, 3, 17);
Console.WriteLine(ts3.ToString(@"d\.hh\:mm\:ss"));
// The example displays the following output:
//       0.04:03:17
//       3.04:03:17

Dim ts2 As New TimeSpan(4, 3, 17)
Console.WriteLine(ts2.ToString("d\.hh\:mm\:ss"))

Dim ts3 As New TimeSpan(3, 4, 3, 17)
Console.WriteLine(ts3.ToString("d\.hh\:mm\:ss"))
' The example displays the following output:
'       0.04:03:17
'       3.04:03:17

Delen via

Tekenreeksen in aangepaste tijdspannenotatie

De aangepaste notatieaanduiding 'd'

De aangepaste notatieaanduidingen 'dddd'-dd

De aangepaste notatieaanduiding 'h'

De aangepaste notatieaanduiding 'uu'

De aangepaste notatieaanduiding 'm'

De aangepaste notatieaanduiding mm

De aangepaste notatieaanduiding 's'

De aangepaste notatieaanduiding 'ss'

De aangepaste notatieaanduiding 'f'

De aangepaste notatieaanduiding 'ff'

De aangepaste notatieaanduiding 'fff'

De aangepaste notatieaanduiding ffff

De aangepaste notatieaanduiding fffff

De aangepaste notatieaanduiding ffffff

De aangepaste notatieaanduiding fffffff

De aangepaste notatieaanduiding F

De aangepaste notatieaanduiding FF

De aangepaste notatieaanduiding FFF

De aangepaste notatieaanduiding FFFF

De aangepaste notatieaanduiding FFFFF

De aangepaste notatieaanduiding FFFFFF

De aangepaste notatieaanduiding FFFFFFF

Andere tekens

Zie ook

Aanvullende resources