自定义 TimeSpan 格式字符串

项目
05/09/2023

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: {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

自定义 TimeSpan 格式字符串也被 TimeSpan.ParseExact 和 TimeSpan.TryParseExact 方法用于定义分析操作所需的输入字符串格式。（分析将值的字符串表示形式转换成该值。）以下示例演示了标准格式字符串在分析操作中的用法。

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

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

格式说明符	说明	示例
“d”，“%d”	时间间隔中的整天数。更多信息：“d”自定义格式说明符。	`new TimeSpan(6, 14, 32, 17, 685):` `%d` --> "6" `d\.hh\:mm` --> "6.14:32"
"dd"-"dddddddd"	时间间隔中的整天数，根据需要使用前导零填充。更多信息：“dd”-“dddddddd”自定义格式说明符。	`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”	时间间隔中的千万分之几秒（或小数时钟周期）。更多信息：“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”	时间间隔中的千万分之几秒。不显示任何小数尾随零或七个零。更多信息：“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”-“dddddddd”自定义格式说明符

“h”自定义格式说明符

“hh”自定义格式说明符

“m”自定义格式说明符

“mm”自定义格式说明符

“s”自定义格式说明符

“ss”自定义格式说明符

“f”自定义格式说明符

“ff”自定义格式说明符

“fff”自定义格式说明符

“ffff”自定义格式说明符

“fffff”自定义格式说明符

“ffffff”自定义格式说明符

“fffffff”自定义格式说明符

“F”自定义格式说明符

“FF”自定义格式说明符

“FFF”自定义格式说明符

“FFFF”自定义格式说明符

“FFFFF”自定义格式说明符

“FFFFFF”自定义格式说明符

“FFFFFFF”自定义格式说明符

其他字符

请参阅

其他资源