Tekenreeksen met aangepaste TimeSpan-indeling

Artikel
04/08/2023

Een TimeSpan opmaaktekenreeks definieert de tekenreeksweergave van een TimeSpan waarde die het resultaat is van een opmaakbewerking. Een tekenreeks voor aangepaste notatie bestaat uit een of meer aangepaste TimeSpan notatieaanduidingen, samen met een willekeurig aantal letterlijke tekens. Tekenreeksen die geen tekenreeks in de standaardtijdspanne-indeling zijn, worden geïnterpreteerd als een aangepaste TimeSpan notatietekenreeks.

Belangrijk

De aanduidingen voor aangepaste TimeSpan notatie bevatten geen tijdelijke aanduidingen voor scheidingstekens, zoals de symbolen die dagen van uren, uren van minuten of seconden van fractionele seconden scheiden. In plaats daarvan moeten deze symbolen worden opgenomen in de tekenreeks met aangepaste notatie als letterlijke tekenreeksen. Definieert bijvoorbeeld "dd\.hh\:mm" een punt (.) als het 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 overloads van de TimeSpan.ToString methode en door methoden die samengestelde opmaak ondersteunen, zoals String.Format. Zie Opmaaktypen en Samengestelde opmaak voor meer informatie. In het volgende voorbeeld ziet u het gebruik van tekenreeksen voor aangepaste indelingen 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: {0:%d} day(s)", duration);
      Console.WriteLine("Time of Travel: {0:dd\\.hh\\:mm\\:ss} days", duration);
   }
}
// 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

Tekenreeksen voor aangepaste TimeSpan notatie worden ook gebruikt door de TimeSpan.ParseExact methoden en TimeSpan.TryParseExact 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 bij 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("{0} --> {1}", value, interval.ToString("c"));
      else
         Console.WriteLine("Unable to parse '{0}'", value);

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

      value= "12.035";
      if (TimeSpan.TryParseExact(value, "ss\\.fff", null, out interval))
         Console.WriteLine("{0} --> {1}", value, interval.ToString("c"));
      else
         Console.WriteLine("Unable to parse '{0}'", 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 aanduiding voor aangepaste indeling 'd'.	`new TimeSpan(6, 14, 32, 17, 685):` `%d` --> "6" `d\.hh\:mm` --> "6.14:32"
"dd"-"dddddddd"	Het aantal hele dagen in het tijdsinterval, indien nodig opgevuld met voorloopnullen. Meer informatie: De aangepaste indelingsaanduidingen 'ddddd'.	`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 aanduiding voor aangepaste indeling 'h'.	`new TimeSpan(6, 14, 32, 17, 685):` `%h` --> "14" `hh\:mm` --> "14:32"
"hh"	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 aanduiding "hh" aangepaste indeling.	`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 aanduiding voor aangepaste notatie '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 indelingsaanduiding '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 aanduiding voor aangepaste indeling 'ss'.	`TimeSpan.FromSeconds(6.965)`: `ss` --> 06 `ss\.fff` --> 06.965
"f", "%f"	De tienden van een seconde in een tijdsinterval. Meer informatie: De aanduiding voor aangepaste indeling 'f'.	`TimeSpan.FromSeconds(6.895)`: `f` --> 8 `ss\.f` --> 06,8
"ff"	De honderdsten van een seconde in een tijdsinterval. Meer informatie: De aanduiding voor aangepaste indeling 'ff'.	`TimeSpan.FromSeconds(6.895)`: `ff` --> 89 `ss\.ff` --> 06,89
"fff"	De milliseconden in een tijdsinterval. Meer informatie: De aanduiding voor aangepaste indeling 'fff'.	`TimeSpan.FromSeconds(6.895)`: `fff` --> 895 `ss\.fff` --> 06.895
"ffff"	De tienduizendste van een seconde in een tijdsinterval. Meer informatie: De aanduiding voor aangepaste indeling '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 aanduiding voor aangepaste indeling 'fffff'.	`TimeSpan.Parse("0:0:6.8954321")`: `fffff` --> 89543 `ss\.fffff` --> 06,89543
"ffffff"	De miljoenste van een seconde in een tijdsinterval. Meer informatie: De aanduiding 'ffffff' aangepaste indeling.	`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 aanduiding voor aangepaste indeling '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 aanduiding voor aangepaste indeling 'F'.	`TimeSpan.Parse("00:00:06.32")`: `%F`: 3 `TimeSpan.Parse("0:0:3.091")`: `ss\.F`: 03.
"FF"	De honderdsten van een seconde in een tijdsinterval. Eventuele eventuele eventuele afsluitende nullen of twee nultekens worden niet opgenomen. Meer informatie: De aanduiding voor aangepaste FF-indeling.	`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 naloopnullen voor breuken worden niet meegeleverd. 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 naloopnullen voor breuken worden niet meegeleverd. Meer informatie: De aanduiding voor aangepaste indeling '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 naloopnullen voor breuken worden niet meegeleverd. 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 miljoenste van een seconde in een tijdsinterval. Eventuele breuknullen worden niet weergegeven. Meer informatie: De aanduiding voor aangepaste indeling 'FFFFFF'.	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 329179 `TimeSpan.Parse("0:0:3.1000009")`: `ss\.FFFFFF`: 03.1
"FFFFFFF"	De tien miljoen seconden in een tijdsinterval. Eventuele eventuele eventuele afsluitende nullen of zeven nullen worden niet weergegeven. Meer informatie: De aanduiding voor aangepaste indeling '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"
Een ander teken	Elk ander teken zonder opmaak wordt geïnterpreteerd als een aangepaste opmaakaanduiding. Meer informatie: Andere tekens.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` --> "14:32:17"

De aangepaste indelingsaanduiding 'd'

De aangepaste notatieaanduiding 'd' voert de waarde van de TimeSpan.Days eigenschap uit, die het aantal hele dagen in het tijdsinterval aangeeft. Het volledige aantal dagen in een TimeSpan waarde wordt weergegeven, zelfs als de waarde meer dan één cijfer heeft. Als de waarde van de TimeSpan.Days eigenschap 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. Het volgende voorbeeld bevat 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 indelingsaanduiding '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 met aangepaste TimeSpan-indeling

De aangepaste indelingsaanduiding 'd'

De aangepaste indelingsaanduidingen "ddd"

De aangepaste indelingsaanduiding 'h'

De aangepaste indelingsaanduiding 'hh'

De aangepaste notatieaanduiding 'm'

De aangepaste notatieaanduiding 'mm'

De aangepaste indelingsaanduiding 's'

De aangepaste indelingsaanduiding 'ss'

De aangepaste indelingsaanduiding 'f'

De aangepaste indelingsaanduiding 'ff'

De aangepaste indelingsaanduiding 'fff'

De aangepaste indelingsaanduiding 'ffff'

De aangepaste indelingsaanduiding 'fffff'

De aangepaste indelingsaanduiding 'ffffff'

De aangepaste indelingsaanduiding 'fffffff'

De aangepaste indelingSaanduiding 'F'

De aangepaste indelingsaanduiding 'FF'

De aangepaste indelingsaanduiding 'FFF'

De aanduiding voor aangepaste FFFF-indeling

De aangepaste indelingsaanduiding 'FFFFF'

De aanduiding voor aangepaste FFFFFF-indeling

De aangepaste indelingsaanduiding 'FFFFFFF'

Andere tekens

Zie ook

Feedback

Aanvullende resources