自定义 TimeSpan 格式字符串

项目
03/22/2025

TimeSpan 格式字符串定义由格式设置作产生的 TimeSpan 值的字符串表示形式。自定义格式字符串由一个或多个自定义 TimeSpan 格式说明符以及任意数量的文本字符组成。任何不是标准 TimeSpan 格式字符串的字符串都解释为自定义 TimeSpan 格式字符串。

重要

自定义 TimeSpan 格式说明符不包含占位符分隔符，例如将天数与小时、小时与分钟或秒分隔的符号从小数秒分隔。相反，这些符号必须作为字符串文本包含在自定义格式字符串中。例如，"dd\.hh\:mm" 将句点（.）定义为天数和小时之间的分隔符，将冒号（:)定义为小时和分钟之间的分隔符）。

自定义 TimeSpan 格式说明符也不包含一个符号符号，用于区分负时间间隔和正时间间隔。若要包含符号符号，必须使用条件逻辑构造格式字符串。其他字符节包括一个示例。

TimeSpan 值的字符串表示形式是通过调用 TimeSpan.ToString 方法的重载以及支持复合格式的方法（如 String.Format）生成的。有关详细信息，请参阅格式设置类型和复合格式。下面的示例演示了在格式设置作中使用自定义格式字符串。

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

TimeSpan.ParseExact 和 TimeSpan.TryParseExact 方法还使用自定义 TimeSpan 格式字符串来定义用于分析作的输入字符串所需的格式。（分析将值的字符串表示形式转换为该值。下面的示例演示如何在分析作中使用标准格式字符串。

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

下表描述了自定义日期和时间格式说明符。

格式说明符	说明	示例
“d”、“%d”	时间间隔中的整天数。更多信息：“d”自定义格式说明符。	`new TimeSpan(6, 14, 32, 17, 685):` `%d` -->“6” `d\.hh\:mm` -->“6.14：32”
“dd”-“ddddd”	时间间隔中的整天数，根据需要填充前导零。详细信息：“dd”-“ddddd”自定义格式说明符。	`new TimeSpan(6, 14, 32, 17, 685):` `ddd` -->“006” `dd\.hh\:mm` -->“06.14：32”
“h”、“%h”	时间间隔中不计为天数的整小时数。单位数小时数没有前导零。更多信息：“h”自定义格式说明符。	`new TimeSpan(6, 14, 32, 17, 685):` `%h` -->“14” `hh\:mm` ->“14：32”
“hh”	时间间隔中不计为天数的整小时数。一位数小时数有前导零。更多信息：“hh”自定义格式说明符。	`new TimeSpan(6, 14, 32, 17, 685):` `hh` -->“14” `new TimeSpan(6, 8, 32, 17, 685):` `hh` --> 08
“m”、“%m”	时间间隔中不包括在小时或天数中的整分钟数。单个数字分钟没有前导零。更多信息：“m”自定义格式说明符。	`new TimeSpan(6, 14, 8, 17, 685):` `%m` -->“8” `h\:m` -->“14：8”
“mm”	时间间隔中不包括在小时或天数中的整分钟数。单位数分钟具有前导零。更多信息：“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”	时间间隔中未包含在小时、天或分钟中的整秒数。一位数秒没有前导零。更多信息：“s”自定义格式说明符。	`TimeSpan.FromSeconds(12.965)`: `%s` --> 12 `s\.fff` --> 12.965
“ss”	时间间隔中未包含在小时、天或分钟中的整秒数。一位数秒具有前导零。更多信息：“ss”自定义格式说明符。	`TimeSpan.FromSeconds(6.965)`: `ss` --> 06 `ss\.fff` --> 06.965
“f”、“%f”	时间间隔中的第十秒。更多信息：“f”自定义格式说明符。	`TimeSpan.FromSeconds(6.895)`: `f` --> 8 `ss\.f` --> 06.8
“ff”	时间间隔中的秒数百分之一。更多信息：“ff”自定义格式说明符。	`TimeSpan.FromSeconds(6.895)`: `ff` --> 89 `ss\.ff` --> 06.89
“fff”	时间间隔中的毫秒。更多信息：“fff”自定义格式说明符。	`TimeSpan.FromSeconds(6.895)`: `fff` --> 895 `ss\.fff` --> 06.895
“ffff”	时间间隔内一秒的十万分之一。更多信息：“ffff”自定义格式说明符。	`TimeSpan.Parse("0:0:6.8954321")`: `ffff` --> 8954 `ss\.ffff` --> 06.8954
“fffff”	时间间隔中的秒数十万分之一。更多信息：“fffff”自定义格式说明符。	`TimeSpan.Parse("0:0:6.8954321")`: `fffff` --> 89543 `ss\.fffff` --> 06.89543
“ffffff”	时间间隔内每秒的百万分之一。更多信息：“ffffff”自定义格式说明符。	`TimeSpan.Parse("0:0:6.8954321")`: `ffffff` --> 895432 `ss\.ffffff` --> 06.895432
“fffffff”	以时间间隔为单位的第 1000 万分之一（或小数刻度）。更多信息：“fffffff”自定义格式说明符。	`TimeSpan.Parse("0:0:6.8954321")`: `fffffff` --> 8954321 `ss\.fffffff` --> 06.8954321
“F”、“%F”	时间间隔中的第十秒。如果数字为零，则不显示任何内容。更多信息：“F”自定义格式说明符。	`TimeSpan.Parse("00:00:06.32")`: `%F`： 3 `TimeSpan.Parse("0:0:3.091")`: `ss\.F`：03。
“FF”	时间间隔中的秒数百分之一。不包括任何小数尾随零或两个零位数字。更多信息：“FF”自定义格式说明符。	`TimeSpan.Parse("00:00:06.329")`: `FF`： 32 `TimeSpan.Parse("0:0:3.101")`: `ss\.FF`： 03.1
“FFF”	时间间隔中的毫秒。不包括任何小数尾随零。详细信息：	`TimeSpan.Parse("00:00:06.3291")`: `FFF`： 329 `TimeSpan.Parse("0:0:3.1009")`: `ss\.FFF`： 03.1
“FFFF”	时间间隔内一秒的十万分之一。不包括任何小数尾随零。更多信息：“FFFF”自定义格式说明符。	`TimeSpan.Parse("00:00:06.32917")`: `FFFFF`： 3291 `TimeSpan.Parse("0:0:3.10009")`: `ss\.FFFF`： 03.1
“FFFFF”	时间间隔中的秒数十万分之一。不包括任何小数尾随零。更多信息：“FFFFF”自定义格式说明符。	`TimeSpan.Parse("00:00:06.329179")`: `FFFFF`： 32917 `TimeSpan.Parse("0:0:3.100009")`: `ss\.FFFFF`： 03.1
“FFFFFF”	时间间隔内每秒的百万分之一。不显示任何小数尾随零。更多信息：“FFFFFF”自定义格式说明符。	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`：329179 `TimeSpan.Parse("0:0:3.1000009")`: `ss\.FFFFFF`： 03.1
“FFFFFFF”	时间间隔为 1000 万秒。不显示任何小数尾随零或七个零。更多信息：“FFFFFFF”自定义格式说明符。	`TimeSpan.Parse("00:00:06.3291791")`: `FFFFFF`：3291791 `TimeSpan.Parse("0:0:3.1900000")`: `ss\.FFFFFF`： 03.19
'string'	文本字符串分隔符。详细信息：其他字符。	`new TimeSpan(14, 32, 17):` `hh':'mm':'ss` -->“14：32：17”
\	转义字符。详细信息：其他字符。	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` -->“14：32：17”
任何其他字符	任何其他未转义字符都解释为自定义格式说明符。详细信息：其他字符。	`new TimeSpan(14, 32, 17):` `hh\:mm\:ss` -->“14：32：17”

“d”自定义格式说明符

“d”自定义格式说明符输出 TimeSpan.Days 属性的值，该值表示时间间隔中的整天数。它以 TimeSpan 值输出完整天数，即使该值具有多个数字也是如此。如果 TimeSpan.Days 属性的值为零，则说明符输出“0”。

如果单独使用“d”自定义格式说明符，请指定“%d”，这样就不会将其误解释为标准格式字符串。下面的示例进行了这方面的演示。

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

以下示例演示了如何使用“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

通过

自定义 TimeSpan 格式字符串

“d”自定义格式说明符

“dd”-“dd”自定义格式说明符

“h”自定义格式说明符

“hh”自定义格式说明符

“m”自定义格式说明符

“mm”自定义格式说明符

“s”自定义格式说明符

“ss”自定义格式说明符

“f”自定义格式说明符

“ff”自定义格式说明符

“fff”自定义格式说明符

“ffff”自定义格式说明符

“fffff”自定义格式说明符

“ffffff”自定义格式说明符

“fffffff”自定义格式说明符

“F”自定义格式说明符

“FF”自定义格式说明符

“FFF”自定义格式说明符

“FFFF”自定义格式说明符

“FFFFF”自定义格式说明符

“FFFFFF”自定义格式说明符

“FFFFFFF”自定义格式说明符

其他字符

另请参阅

其他资源