Niestandardowe ciągi formatujące TimeSpan

2025-03-22

Ciąg formatu TimeSpan definiuje reprezentację ciągu TimeSpan wartości, która wynika z operacji formatowania. Ciąg formatu niestandardowego składa się z co najmniej jednego specyfikatora formatu niestandardowego TimeSpan wraz z dowolną liczbą znaków literału. Każdy ciąg, który nie jest ciągiem formatu Standard TimeSpan, jest interpretowany jako niestandardowy ciąg formatu TimeSpan.

Ważne

Specyfikatory formatu niestandardowego TimeSpan nie zawierają symboli separatora zastępczego, takich jak symbole oddzielające dni od godzin, godzin od minut lub sekund od sekund ułamkowych. Zamiast tego te symbole muszą być zawarte w ciągu formatu niestandardowego jako literały ciągu ciągu. Na przykład "dd\.hh\:mm" definiuje kropkę (.) jako separator między dniami a godzinami i dwukropek (:) jako separator między godzinami a minutami.

Specyfikatory formatu niestandardowego TimeSpan również nie zawierają symbolu znaku, który umożliwia rozróżnienie między ujemnymi i dodatnimi interwałami czasu. Aby dołączyć symbol znaku, musisz utworzyć ciąg formatu przy użyciu logiki warunkowej. Sekcja Inne znaki zawiera przykład.

Reprezentacje ciągów wartości TimeSpan są generowane przez wywołania przeciążeń metody TimeSpan.ToString i metod, które obsługują formatowanie złożone, takie jak String.Format. Aby uzyskać więcej informacji, zobacz Typy formatowania i formatowanie złożone. Poniższy przykład ilustruje użycie ciągów formatu niestandardowego w operacjach formatowania.

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

Niestandardowe ciągi formatu TimeSpan są również używane przez metody TimeSpan.ParseExact i TimeSpan.TryParseExact do zdefiniowania wymaganego formatu ciągów wejściowych na potrzeby operacji analizowania. (Analizowanie konwertuje reprezentację ciągu wartości na wartość). Poniższy przykład ilustruje użycie standardowych ciągów formatu w operacjach analizowania.

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

Poniższa tabela zawiera opis niestandardowych specyfikatorów formatu daty i godziny.

Specyfikator formatu	Opis	Przykład
"d", "%d"	Liczba całych dni w interwale czasu. Więcej informacji: Specyfikator formatu niestandardowego "d".	`new TimeSpan(6, 14, 32, 17, 685):` `%d` —> "6" `d\.hh\:mm` —> "6.14:32"
"dd"-"ddddd"	Liczba całych dni w interwale czasu wyściełana zerami wiodącymi zgodnie z potrzebami. Więcej informacji: specyfikatory formatu niestandardowego "dd"-"dd".	`new TimeSpan(6, 14, 32, 17, 685):` `ddd` —> "006" `dd\.hh\:mm` —> "06.14:32"
"h", "%h"	Liczba całych godzin w interwale czasu, które nie są liczone w ramach dni. Godziny jednocyfrowe nie mają zera wiodącego. Więcej informacji: Specyfikator formatu niestandardowego "h".	`new TimeSpan(6, 14, 32, 17, 685):` `%h` —> "14" `hh\:mm` —> "14:32"
"gg"	Liczba całych godzin w interwale czasu, które nie są liczone w ramach dni. Godziny jednocyfrowe mają zero wiodące. Więcej informacji: Specyfikator formatu niestandardowego "hh".	`new TimeSpan(6, 14, 32, 17, 685):` `hh` —> "14" `new TimeSpan(6, 8, 32, 17, 685):` `hh` —> 08
"m", "%m"	Liczba całych minut w interwale czasu, które nie są uwzględniane w ramach godzin lub dni. Minuty z jedną cyfrą nie mają zera wiodącego. Więcej informacji: Specyfikator formatu niestandardowego "m".	`new TimeSpan(6, 14, 8, 17, 685):` `%m` —> "8" `h\:m` —> "14:8"
"mm"	Liczba całych minut w interwale czasu, które nie są uwzględniane w ramach godzin lub dni. Minuty z jedną cyfrą mają zero wiodące. Więcej informacji: Specyfikator formatu niestandardowego "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"	Liczba całych sekund w interwale czasu, które nie są uwzględniane w ramach godzin, dni lub minut. Sekundy jednocyfrowe nie mają zera wiodącego. Więcej informacji: Specyfikator formatu niestandardowego "s".	`TimeSpan.FromSeconds(12.965)`: `%s` —> 12 `s\.fff` —> 12.965
„ss”	Liczba całych sekund w interwale czasu, które nie są uwzględniane w ramach godzin, dni lub minut. Sekundy z jedną cyfrą mają zero wiodące. Więcej informacji: Specyfikator formatu niestandardowego "ss".	`TimeSpan.FromSeconds(6.965)`: `ss` —> 06 `ss\.fff` —> 06.965
"f", "%f"	Dziesiąte części sekundy w interwale czasu. Więcej informacji: Specyfikator formatu niestandardowego "f".	`TimeSpan.FromSeconds(6.895)`: `f` —> 8 `ss\.f` —> 06.8
„ff”	Setne części sekundy w interwale czasu. Więcej informacji: Specyfikator formatu niestandardowego "ff".	`TimeSpan.FromSeconds(6.895)`: `ff` —> 89 `ss\.ff` —> 06.89
„fff”	Milisekundy w interwale czasu. Więcej informacji: Specyfikator formatu niestandardowego "fff".	`TimeSpan.FromSeconds(6.895)`: `fff` —> 895 `ss\.fff` —> 06.895
„ffff”	Dziesięć tysięcznych części sekundy w interwale czasu. Więcej informacji: Specyfikator formatu niestandardowego "ffff".	`TimeSpan.Parse("0:0:6.8954321")`: `ffff` —> 8954 `ss\.ffff` —> 06.8954
„fffff”	Setki tysięcy sekundy w interwale czasu. Więcej informacji: Specyfikator formatu niestandardowego "fffff".	`TimeSpan.Parse("0:0:6.8954321")`: `fffff` —> 89543 `ss\.fffff` —> 06.89543
„ffffff”	Milionowe części sekundy w interwale czasu. Więcej informacji: Specyfikator formatu niestandardowego "ffffff".	`TimeSpan.Parse("0:0:6.8954321")`: `ffffff` —> 895432 `ss\.ffffff` —> 06.895432
„fffffff”	Dziesięć milionów części sekundy (lub ułamkowe kleszcze) w przedziale czasu. Więcej informacji: Specyfikator formatu niestandardowego "fffffff".	`TimeSpan.Parse("0:0:6.8954321")`: `fffffff` —> 8954321 `ss\.fffffff` —> 06.8954321
"F", "%F"	Dziesiąte części sekundy w interwale czasu. Nic nie jest wyświetlane, jeśli cyfra ma wartość zero. Więcej informacji: Specyfikator formatu niestandardowego "F".	`TimeSpan.Parse("00:00:06.32")`: `%F`: 3 `TimeSpan.Parse("0:0:3.091")`: `ss\.F`: 03.
„FF”	Setne części sekundy w interwale czasu. Wszystkie zera końcowe ułamkowe lub dwie cyfry zerowe nie są uwzględniane. Więcej informacji: Specyfikator formatu niestandardowego "FF".	`TimeSpan.Parse("00:00:06.329")`: `FF`: 32 `TimeSpan.Parse("0:0:3.101")`: `ss\.FF`: 03.1
„FFF”	Milisekundy w interwale czasu. Wszystkie zera końcowe ułamkowe nie są uwzględniane. Więcej informacji:	`TimeSpan.Parse("00:00:06.3291")`: `FFF`: 329 `TimeSpan.Parse("0:0:3.1009")`: `ss\.FFF`: 03.1
„FFFF”	Dziesięć tysięcznych części sekundy w interwale czasu. Wszystkie zera końcowe ułamkowe nie są uwzględniane. Więcej informacji: Specyfikator formatu niestandardowego "FFFF".	`TimeSpan.Parse("00:00:06.32917")`: `FFFFF`: 3291 `TimeSpan.Parse("0:0:3.10009")`: `ss\.FFFF`: 03.1
„FFFFF”	Setki tysięcy sekundy w interwale czasu. Wszystkie zera końcowe ułamkowe nie są uwzględniane. Więcej informacji: Specyfikator formatu niestandardowego "FFFFF".	`TimeSpan.Parse("00:00:06.329179")`: `FFFFF`: 32917 `TimeSpan.Parse("0:0:3.100009")`: `ss\.FFFFF`: 03.1
„FFFFFF”	Milionowe części sekundy w interwale czasu. Nie są wyświetlane żadne zera końcowe ułamkowe. Więcej informacji: Specyfikator formatu niestandardowego "FFFFFF".	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 329179 `TimeSpan.Parse("0:0:3.1000009")`: `ss\.FFFFFF`: 03.1
„FFFFFFF”	Dziesięć milionów sekund w interwale czasu. Nie są wyświetlane żadne zera końcowe ułamkowe lub siedem zer. Więcej informacji: Specyfikator formatu niestandardowego "FFFFFFF".	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`: 3291791 `TimeSpan.Parse("0:0:3.1900000")`: `ss\.FFFFFF`: 03.19
"ciąg"	Ogranicznik ciągu literału. Więcej informacji: Inne znaki.	`new TimeSpan(14, 32, 17):` `hh':'mm':'ss` -> "14:32:17"
\	Znak ucieczki. Więcej informacji: Inne znaki.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` -> "14:32:17"
Jakikolwiek inny znak	Każdy inny niewysobowy znak jest interpretowany jako specyfikator formatu niestandardowego. Więcej informacji: Inne znaki.	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` -> "14:32:17"

Specyfikator formatu niestandardowego "d"

Specyfikator formatu niestandardowego "d" zwraca wartość właściwości TimeSpan.Days, która reprezentuje liczbę całych dni w interwale czasu. Zwraca pełną liczbę dni w wartości TimeSpan, nawet jeśli wartość ma więcej niż jedną cyfrę. Jeśli wartość właściwości TimeSpan.Days wynosi zero, specyfikator zwraca wartość "0".

Jeśli specyfikator formatu niestandardowego "d" jest używany samodzielnie, określ "%d", aby nie był błędnie interpretowany jako standardowy ciąg formatu. Poniższy przykład stanowi ilustrację.

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

Poniższy przykład ilustruje użycie specyfikatora formatu niestandardowego "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

Udostępnij za pośrednictwem

Niestandardowe ciągi formatujące TimeSpan

Specyfikator formatu niestandardowego "d"

Specyfikatory formatu niestandardowego "dd"-"ddd"

Specyfikator formatu niestandardowego "h"

Specyfikator formatu niestandardowego "hh"

Specyfikator formatu niestandardowego "m"

Specyfikator formatu niestandardowego "mm"

Specyfikator formatu niestandardowego "s"

Specyfikator formatu niestandardowego "ss"

Specyfikator formatu niestandardowego "f"

Specyfikator formatu niestandardowego "ff"

Specyfikator formatu niestandardowego "fff"

Specyfikator formatu niestandardowego "ffff"

Specyfikator formatu niestandardowego "fffff"

Specyfikator formatu niestandardowego "ffffff"

Specyfikator formatu niestandardowego "fffffff"

Specyfikator formatu niestandardowego "F"

Specyfikator formatu niestandardowego "FF"

Specyfikator formatu niestandardowego "FFF"

Specyfikator formatu niestandardowego "FFFF"

Specyfikator formatu niestandardowego "FFFFF"

Specyfikator formatu niestandardowego "FFFFFF"

Specyfikator formatu niestandardowego "FFFFFFF"

Inne znaki

Zobacz też

Dodatkowe zasoby