Vlastní řetězce formátu TimeSpan

Řetězec formátu TimeSpan definuje řetězcovou reprezentaci hodnoty TimeSpan, která je výsledkem operace formátování. Řetězec vlastního formátu se skládá z jednoho nebo několika specifikátorů vlastního TimeSpan formátu spolu s libovolným počtem literálových znaků. Každý řetězec, který není standardním formátovacím řetězcem TimeSpan, je interpretován jako vlastní řetězec formátu TimeSpan.

Důležité

Specifikátory vlastního formátu TimeSpan neobsahují symboly oddělovače zástupných symbolů, jako jsou symboly, které oddělují dny od hodin, hodin od minut nebo sekund od desetinných sekund. Místo toho musí být tyto symboly zahrnuty do řetězce vlastního formátu jako řetězcové literály. Například "dd\.hh\:mm" definuje tečku (.) jako oddělovač mezi dny a hodinami a dvojtečku (:) jako oddělovač mezi hodinami a minutami.

Specifikátory vlastního formátu TimeSpan také neobsahují symbol znaménka, který umožňuje rozlišovat mezi zápornými a kladnými časovými intervaly. Pokud chcete zahrnout symbol znaménka, musíte vytvořit formátovací řetězec pomocí podmíněné logiky. Část Další znaky obsahuje příklad.

Řetězcové reprezentace TimeSpan hodnot jsou vytvářeny voláním přetížení TimeSpan.ToString metody a metodami, které podporují složené formátování, například String.Format. Další informace naleznete v tématu Typy formátování a složené formátování. Následující příklad znázorňuje použití řetězců vlastního formátu v operacích formátování.

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

Vlastní řetězce formátu TimeSpan používají také metody TimeSpan.ParseExact a TimeSpan.TryParseExact k definování požadovaného formátu vstupních řetězců pro operace analýzy. (Analýza převede řetězcovou reprezentaci hodnoty na danou hodnotu.) Následující příklad znázorňuje použití standardních formátovacích řetězců při parsování operací.

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

Následující tabulka popisuje specifikátory vlastního formátu data a času.

Specifikátor formátu	Popis	Příklad
"d", "%d"	Počet celých dnů v časovém intervalu. Další informace: Specifikátor vlastního formátu "d".	`new TimeSpan(6, 14, 32, 17, 685):` `%d` --> "6" `d\.hh\:mm` --> "6.14:32"
"dd"-"dddddddd"	Počet celých dnů v časovém intervalu s počátečními nulami podle potřeby. Další informace: specifikátory vlastního formátu "dd"-"ddddddd".	`new TimeSpan(6, 14, 32, 17, 685):` `ddd` --> "006" `dd\.hh\:mm` --> "06.14:32"
"h", "%h"	Počet celých hodin v časovém intervalu, který se nepočítá jako součást dnů. Jednociferné hodiny nemají úvodní nulu. Další informace: Specifikátor vlastního formátu "h".	`new TimeSpan(6, 14, 32, 17, 685):` `%h` --> "14" `hh\:mm` --> "14:32"
"hh"	Počet celých hodin v časovém intervalu, který se nepočítá jako součást dnů. Jednociferné hodiny mají úvodní nulu. Další informace: Specifikátor vlastního formátu "hh".	`new TimeSpan(6, 14, 32, 17, 685):` `hh` --> "14" `new TimeSpan(6, 8, 32, 17, 685):` `hh` -> 08
"m", "%m"	Počet celých minut v časovém intervalu, který není součástí hodin nebo dnů. Jednociferné minuty nemají úvodní nulu. Další informace: Specifikátor vlastního formátu "m".	`new TimeSpan(6, 14, 8, 17, 685):` `%m` --> "8" `h\:m` --> "14:8"
"mm"	Počet celých minut v časovém intervalu, který není součástí hodin nebo dnů. Jednociferné minuty mají úvodní nulu. Další informace: Specifikátor vlastního formátu "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"	Počet celých sekund v časovém intervalu, který není součástí hodin, dnů nebo minut. Jednociferné sekundy nemají úvodní nulu. Další informace: Specifikátor vlastního formátu "s".	`TimeSpan.FromSeconds(12.965)`: `%s` --> 12 `s\.fff` -> 12,965
"ss"	Počet celých sekund v časovém intervalu, který není součástí hodin, dnů nebo minut. Jednociferné sekundy mají úvodní nulu. Další informace: Specifikátor vlastního formátu "ss".	`TimeSpan.FromSeconds(6.965)`: `ss` --> 06 `ss\.fff` --> 06,965
"f", "%f"	Desetiny sekundy v časovém intervalu Další informace: Specifikátor vlastního formátu "f".	`TimeSpan.FromSeconds(6.895)`: `f` -> 8 `ss\.f` –> 06,8
ff	Setiny sekundy v časovém intervalu. Další informace: Specifikátor vlastního formátu "ff".	`TimeSpan.FromSeconds(6.895)`: `ff` --> 89 `ss\.ff` --> 06,89
"fff"	Milisekundy v časovém intervalu. Další informace: Specifikátor vlastního formátu "fff".	`TimeSpan.FromSeconds(6.895)`: `fff` --> 895 `ss\.fff` -> 06,895
"ffff"	Desetitisíce sekundy v časovém intervalu. Další informace: Specifikátor vlastního formátu "ffff".	`TimeSpan.Parse("0:0:6.8954321")`: `ffff` -> 8954 `ss\.ffff` -> 06,8954
"fffff"	Stotisíce sekundy v časovém intervalu. Další informace: Specifikátor vlastního formátu "fffff".	`TimeSpan.Parse("0:0:6.8954321")`: `fffff` --> 89543 `ss\.fffff` --> 06,89543
"ffffff"	Milionté sekundy v časovém intervalu. Další informace: Specifikátor vlastního formátu "ffffff".	`TimeSpan.Parse("0:0:6.8954321")`: `ffffff` -> 895432 `ss\.ffffff` --> 06.895432
"fffffff"	Desetimilionty sekundy (nebo zlomkového intervalu) v časovém intervalu. Další informace: Specifikátor vlastního formátu "fffffff".	`TimeSpan.Parse("0:0:6.8954321")`: `fffffff` --> 8954321 `ss\.fffffff` --> 06,8954321
"F", "%F"	Desetiny sekundy v časovém intervalu Pokud je číslice nula, nic se nezobrazí. Další informace: Specifikátor vlastního formátu "F".	`TimeSpan.Parse("00:00:06.32")`: `%F`: 3 `TimeSpan.Parse("0:0:3.091")`: `ss\.F`: 03.
"FF"	Setiny sekundy v časovém intervalu. Nezahrnou se žádné desetinné koncové nuly nebo dvě nulové číslice. Další informace: Specifikátor vlastního formátu "FF".	`TimeSpan.Parse("00:00:06.329")`: `FF`: 32 `TimeSpan.Parse("0:0:3.101")`: `ss\.FF`: 03.1
"FFF"	Milisekundy v časovém intervalu. Nezahrnou se žádné desetinné koncové nuly. Další informace:	`TimeSpan.Parse("00:00:06.3291")`: `FFF`: 329 `TimeSpan.Parse("0:0:3.1009")`: `ss\.FFF`: 03.1
"FFFF"	Desetitisíce sekundy v časovém intervalu. Nezahrnou se žádné desetinné koncové nuly. Další informace: Specifikátor vlastního formátu "FFFF".	`TimeSpan.Parse("00:00:06.32917")`: `FFFFF`: 3291 `TimeSpan.Parse("0:0:3.10009")`: `ss\.FFFF`: 03.1
FFFFF	Stotisíce sekundy v časovém intervalu. Nezahrnou se žádné desetinné koncové nuly. Další informace: Specifikátor vlastního formátu "FFFFF".	`TimeSpan.Parse("00:00:06.329179")`: `FFFFF`: 32917 `TimeSpan.Parse("0:0:3.100009")`: `ss\.FFFFF`: 03.1
FFFFFF	Milionté sekundy v časovém intervalu. Nezobrazují se žádné desetinné koncové nuly. Další informace: Specifikátor vlastního formátu "FFFFFF".	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 329179 `TimeSpan.Parse("0:0:3.1000009")`: `ss\.FFFFFF`: 03.1
"FFFFFFF"	Deset milionů sekund v časovém intervalu. Nezobrazují se žádné desetinné koncové nuly nebo sedm nul. Další informace: Specifikátor vlastního formátu "FFFFFFF".	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 3291791 `TimeSpan.Parse("0:0:3.1900000")`: `ss\.FFFFFF`: 03.19
Řetězec	Oddělovač řetězcového literálu. Další informace: Jiné znaky.	`new TimeSpan(14, 32, 17):` `hh':'mm':'ss` --> "14:32:17"
\	Řídicí znak. Další informace: Jiné znaky.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` --> "14:32:17"
Jakýkoli jiný znak	Jakýkoli jiný nepoupravený znak je interpretován jako specifikátor vlastního formátu. Další informace: Jiné znaky.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` --> "14:32:17"

Specifikátor vlastního formátu "d"

Specifikátor vlastního formátu "d" vypíše hodnotu vlastnosti TimeSpan.Days, která představuje počet celých dnů v časovém intervalu. Vypíše úplný počet dní v hodnotě TimeSpan, i když má hodnota více než jednu číslici. Pokud je hodnota vlastnosti TimeSpan.Days nula, specifikátor vypíše hodnotu 0.

Pokud se specifikátor vlastního formátu "d" používá samostatně, zadejte "%d", aby nebyl chybně interpretován jako standardní formátovací řetězec. V následujícím příkladu je uvedena ukázka.

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

Následující příklad ukazuje použití specifikátoru vlastního formátu "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

Sdílet prostřednictvím

Vlastní řetězce formátu TimeSpan

Specifikátor vlastního formátu "d"

Specifikátory vlastního formátu "dd"-"ddddddd"

Specifikátor vlastního formátu "h"

Specifikátor vlastního formátu "hh"

Specifikátor vlastního formátu "m"

Specifikátor vlastního formátu "mm"

Specifikátor vlastního formátu "s"

Specifikátor vlastního formátu "ss"

Specifikátor vlastního formátu "f"

Specifikátor vlastního formátu "ff"

Specifikátor vlastního formátu "fff"

Specifikátor vlastního formátu "ffff"

Specifikátor vlastního formátu "fffff"

Specifikátor vlastního formátu "ffffff"

Specifikátor vlastního formátu "fffffff"

Specifikátor vlastního formátu "F"

Specifikátor vlastního formátu "FF"

Specifikátor vlastního formátu "FFF"

Specifikátor vlastního formátu "FFFF"

Specifikátor vlastního formátu "FFFFF"

Specifikátor vlastního formátu "FFFFFF"

Specifikátor vlastního formátu "FFFFFFF"

Další znaky

Viz také

Váš názor

Další materiály