信息
您所需的主题如下所示。但此主题未包含在此库中。

TimeSpan.ToString 方法 (String)

2013/12/13

使用指定的格式将当前 TimeSpan 对象的值转换为其等效的字符串表示形式。

Namespace:  System
程序集:  mscorlib(位于 mscorlib.dll 中)

public string ToString(
	string format
)

参数

format
类型: System.String
标准或自定义的 TimeSpan 格式字符串。

返回值

类型: System.String
当前 TimeSpan 值的字符串表示形式,该值使用 format 参数指定的格式。

异常条件
FormatException

无法识别或不支持 format 参数。

format 参数可以是用于 TimeSpan 值的任何有效或自定义的格式说明符。如果 format 等于 String.Empty 或者是 null,则当前 TimeSpan 对象的返回值会使用通用格式说明符(“c”)来设置格式。如果 format 是其他任何值,则该方法将引发 FormatException

返回的字符串的格式通过当前区域性的格式设置约定来定义。

.NET Framework 提供了广泛的格式设置支持,下面的格式设置主题中对此有更详细的描述:

下面的示例使用标准 TimeSpan 格式字符串显示 TimeSpan 值数组中每个元素的字符串表示形式。


using System;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      TimeSpan[] spans = { TimeSpan.Zero, new TimeSpan(-14, 0, 0, 0, 0), 
                           new TimeSpan(1, 2, 3), 
                           new TimeSpan(0, 0, 0, 0, 250), 
                           new TimeSpan(99, 23, 59, 59, 999),
                           new TimeSpan(3, 0, 0), 
                           new TimeSpan(0, 0, 0, 0, 25) };
      string[] fmts = { "c", "g", "G", @"hh\:mm\:ss", "%m' min.'" };
      foreach (TimeSpan span in spans)
      {
         foreach (string fmt in fmts)
            outputBlock.Text += String.Format("{0}: {1}", fmt, span.ToString(fmt)) + "\n";

         outputBlock.Text += "\n";
      }
   }
}
// The example displays the following output:
//       c: 00:00:00
//       g: 0:00:00
//       G: 0:00:00:00.0000000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: -14.00:00:00
//       g: -14:0:00:00
//       G: -14:00:00:00.0000000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: 01:02:03
//       g: 1:02:03
//       G: 0:01:02:03.0000000
//       hh\:mm\:ss: 01:02:03
//       %m' min.': 2 min.
//       
//       c: 00:00:00.2500000
//       g: 0:00:00.25
//       G: 0:00:00:00.2500000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: 99.23:59:59.9990000
//       g: 99:23:59:59.999
//       G: 99:23:59:59.9990000
//       hh\:mm\:ss: 23:59:59
//       %m' min.': 59 min.
//       
//       c: 03:00:00
//       g: 3:00:00
//       G: 0:03:00:00.0000000
//       hh\:mm\:ss: 03:00:00
//       %m' min.': 0 min.
//       
//       c: 00:00:00.0250000
//       g: 0:00:00.025
//       G: 0:00:00:00.0250000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.


Windows Phone OS

受以下版本支持: 8.0, 7.1

Windows Phone

显示: