Egyéni TimeSpan formátumú sztringek

2025-03-22

A TimeSpan formázási sztring egy formázási műveletből származó TimeSpan érték sztring-ábrázolását határozza meg. Az egyéni formázási sztringek egy vagy több egyéni TimeSpan formátumjelölőből és tetszőleges számú literális karakterből állnak. Minden olyan sztring, amely nem Standard TimeSpan formátumú sztring, egyéni TimeSpan formátumsztringként lesz értelmezve.

Fontos

Az egyéni TimeSpan formátumjelölők nem tartalmaznak helyőrző elválasztó szimbólumokat, például a napokat óráktól, óráktól perctől és másodperctől elválasztó szimbólumokat. Ehelyett ezeket a szimbólumokat sztringkonstansként kell szerepeltetni az egyéni formátumsztringben. A "dd\.hh\:mm" például egy pontot (.) határoz meg elválasztóként napok és órák között, és kettőspontot (:) elválasztóként órák és percek között.

Az egyéni TimeSpan formátumjelölők nem tartalmaznak olyan jelszimbólumot, amely lehetővé teszi a negatív és a pozitív időintervallumok közötti különbséget. A jelszimbólumok hozzáadásához feltételes logikával kell formázni a sztringet. Az Egyéb karakterek szakasz tartalmaz egy példát.

A TimeSpan értékek sztring-ábrázolását a TimeSpan.ToString metódus túlterhelésére irányuló hívások, valamint az összetett formázást támogató metódusok, például a String.Format. További információ: Formázástípusok és Összetett formázás. Az alábbi példa az egyéni formázási sztringek formázási műveletekben való használatát mutatja be.

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

Az egyéni TimeSpan formázási sztringeket a TimeSpan.ParseExact és TimeSpan.TryParseExact metódusok is használják az elemzési műveletekhez szükséges bemeneti sztringek formátumának meghatározásához. (Az elemzés egy érték sztring-ábrázolását konvertálja erre az értékre.) Az alábbi példa a standard formátumú sztringek használatát mutatja be az elemzési műveletekben.

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

Az alábbi táblázat az egyéni dátum- és időformátum-meghatározókat ismerteti.

Formátumkijelölő	Leírás	Példa
"d", "%d"	Az időintervallum egész napjainak száma. További információ: A "d" egyéni formátumkijelölő.	`new TimeSpan(6, 14, 32, 17, 685):` `%d` -> "6" `d\.hh\:mm` -> "6.14:32"
"dd"-"ddddddddddd"	Az időintervallum egész napjainak száma, szükség szerint kezdő nullákkal elválasztva. További információ: A "dd"-"ddddddd" egyéni formátumjelölők.	`new TimeSpan(6, 14, 32, 17, 685):` `ddd` -> "006" `dd\.hh\:mm` -> "06.14:32"
"h", "%h"	Az időintervallum teljes óráinak száma, amely nem számít bele a napok közé. Az egyjegyű órákban nincs kezdő nulla. További információ: A "h" egyéni formátumkijelölő.	`new TimeSpan(6, 14, 32, 17, 685):` `%h` -> "14" `hh\:mm` -> "14:32"
"óó"	Az időintervallum teljes óráinak száma, amely nem számít bele a napok közé. Az egyjegyű órák kezdő nullával rendelkeznek. További információ: A "hh" egyéni formátumkijelölő.	`new TimeSpan(6, 14, 32, 17, 685):` `hh` -> "14" `new TimeSpan(6, 8, 32, 17, 685):` `hh` -> 08
"m", "%m" "	A teljes percek száma az időintervallumban, amely nem szerepel az órák vagy napok részeként. Az egyjegyű percek nem rendelkeznek kezdő nullával. További információ: Az "m" egyéni formátumkijelölő.	`new TimeSpan(6, 14, 8, 17, 685):` `%m` -> "8" `h\:m` -> "14:8"
"mm"	A teljes percek száma az időintervallumban, amely nem szerepel az órák vagy napok részeként. Az egyjegyű percek kezdő nullával rendelkeznek. További információ: Az "mm" egyéni formátumkijelölő.	`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"	A teljes másodpercek száma az időintervallumban, amely nem szerepel az órák, napok vagy percek részeként. Az egyjegyű másodpercnek nincs kezdő nullája. További információ: Az "s" egyéni formátumkijelölő.	`TimeSpan.FromSeconds(12.965)`: `%s` -> 12 `s\.fff` -> 12.965
"ss"	A teljes másodpercek száma az időintervallumban, amely nem szerepel az órák, napok vagy percek részeként. Az egyjegyű másodpercek kezdő nullával rendelkeznek. További információ: Az "ss" egyéni formátumkijelölő.	`TimeSpan.FromSeconds(6.965)`: `ss` -> 06 `ss\.fff` -> 06.965
"f", "%f" "	A másodperc tizede egy időintervallumban. További információ: Az "f" egyéni formátumkijelölő.	`TimeSpan.FromSeconds(6.895)`: `f` -> 8 `ss\.f` -> 06.8
"FF"	Egy időintervallum másodpercének százada. További információ: Az "ff" egyéni formátumkijelölő.	`TimeSpan.FromSeconds(6.895)`: `ff` -> 89 `ss\.ff` -> 06.89
"FFF"	Az ezredmásodperc egy időintervallumban. További információ: Az "fff" egyéni formátumkijelölő.	`TimeSpan.FromSeconds(6.895)`: `fff` -> 895 `ss\.fff` -> 06.895
"FFFFF"	Egy időintervallumban a másodperc 10 ezred része. További információ: Az "ffff" egyéni formátumkijelölő.	`TimeSpan.Parse("0:0:6.8954321")`: `ffff` -> 8954 `ss\.ffff` -> 06.8954
"fffff"	Egy időintervallum 100 ezredmásedik része. További információ: Az "fffff" egyéni formátumkijelölő.	`TimeSpan.Parse("0:0:6.8954321")`: `fffff` -> 89543 `ss\.fffff` -> 06.89543
"ffffff"	Egy másodperc milliomodik része egy időintervallumban. További információ: Az "ffffff" egyéni formátumkijelölő.	`TimeSpan.Parse("0:0:6.8954321")`: `ffffff` -> 895432 `ss\.ffffff` -> 06.895432
"fffffff"	A másodperc tízmilliomodik része (vagy a törtjelek) egy időintervallumban. További információ: Az "fffffff" egyéni formátumkijelölő.	`TimeSpan.Parse("0:0:6.8954321")`: `fffffff` -> 8954321 `ss\.fffffff` -> 06.8954321
"F", "%F"	A másodperc tizede egy időintervallumban. Semmi sem jelenik meg, ha a számjegy nulla. További információ: Az "F" egyéni formátumkijelölő.	`TimeSpan.Parse("00:00:06.32")`: `%F`: 3 `TimeSpan.Parse("0:0:3.091")`: `ss\.F`: 03.
"FF"	Egy időintervallum másodpercének százada. A tört záró nullákat vagy két nulla számjegyet nem tartalmazza. További információ: Az "FF" egyéni formátumkijelölő.	`TimeSpan.Parse("00:00:06.329")`: `FF`: 32 `TimeSpan.Parse("0:0:3.101")`: `ss\.FF`: 03.1
"FFF"	Az ezredmásodperc egy időintervallumban. A tört záró nullák nincsenek belefoglalva. További információ:	`TimeSpan.Parse("00:00:06.3291")`: `FFF`: 329 `TimeSpan.Parse("0:0:3.1009")`: `ss\.FFF`: 03.1
"FFFF"	Egy időintervallumban a másodperc 10 ezred része. A tört záró nullák nincsenek belefoglalva. További információ: Az "FFFF" egyéni formátumkijelölő.	`TimeSpan.Parse("00:00:06.32917")`: `FFFFF`: 3291 `TimeSpan.Parse("0:0:3.10009")`: `ss\.FFFF`: 03.1
"FFFFF"	Egy időintervallum 100 ezredmásedik része. A tört záró nullák nincsenek belefoglalva. További információ: Az "FFFFF" egyéni formátumkijelölő.	`TimeSpan.Parse("00:00:06.329179")`: `FFFFF`: 32917 `TimeSpan.Parse("0:0:3.100009")`: `ss\.FFFFF`: 03.1
FFFFFF	Egy másodperc milliomodik része egy időintervallumban. A tört záró nullák nem jelennek meg. További információ: Az "FFFFFF" egyéni formátumkijelölő.	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 329179 `TimeSpan.Parse("0:0:3.1000009")`: `ss\.FFFFFF`: 03.1
"FFFFFFF"	A 10 millió másodperc egy időintervallumban. A tört záró nullák vagy hét nullák nem jelennek meg. További információ: Az "FFFFFFF" egyéni formátumkijelölő.	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 3291791 `TimeSpan.Parse("0:0:3.1900000")`: `ss\.FFFFFF`: 03.19
"sztring"	Literális sztringelválasztó. További információ: Egyéb karakterek.	`new TimeSpan(14, 32, 17):` `hh':'mm':'ss` -> "14:32:17"
\	A menekülő karakter. További információ: Egyéb karakterek.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` -> "14:32:17"
Bármely más karakter	A rendszer minden más nem beágyazott karaktert egyéni formátumkijelölőként értelmez. További információ: Egyéb karakterek.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` -> "14:32:17"

A "d" egyéni formátumkijelölő

A "d" egyéni formátumkijelölő a TimeSpan.Days tulajdonság értékét adja ki, amely az időintervallum egész napjainak számát jelöli. Egy TimeSpan értékben a napok teljes számát adja ki, még akkor is, ha az érték egynél több számjegyből áll. Ha a TimeSpan.Days tulajdonság értéke nulla, a kijelölő a "0" értéket adja ki.

Ha a "d" egyéni formátumjelölőt egyedül használja, adja meg a "%d" értéket, hogy ne értelmezze félre szabványos formátumsztringként. Az alábbi példa egy illusztrációt tartalmaz.

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

Az alábbi példa a "d" egyéni formátumkijelölő használatát szemlélteti.

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

Megosztás a következőn keresztül:

Egyéni TimeSpan formátumú sztringek

A "d" egyéni formátumkijelölő

A "dd"-"ddddddddd" egyéni formátumkijelölők

A "h" egyéni formátumkijelölő

A "hh" egyéni formátumkijelölő

Az "m" egyéni formátumkijelölő

Az "mm" egyéni formátumkijelölő

Az "s" egyéni formátumkijelölő

Az "ss" egyéni formátumkijelölője

Az "f" egyéni formátumkijelölő

Az "ff" egyéni formátumkijelölő

Az "fff" egyéni formátumkijelölő

Az "ffff" egyéni formátumkijelölő

Az "fffff" egyéni formátumkijelölő

Az "ffffff" egyéni formátumkijelölője

Az "fffffff" egyéni formátumkijelölő

Az "F" egyéni formátumkijelölő

Az "FF" egyéni formátumkijelölő

Az "FFF" egyéni formátumkijelölője

Az "FFFF" egyéni formátumkijelölője

Az "FFFFF" egyéni formátumkijelölője

Az "FFFFFF" egyéni formátumjelölője

Az "FFFFFFF" egyéni formátumkijelölője

Egyéb karakterek

Lásd még

További források