C# 格式串(收藏)

标准 DateTime 格式字符串

如果格式字符串只包含下表列出的某个单个格式说明符，则它们被解释为标准格式说明符。如果指定的格式字符是单个字符并且不包含在下表中，则引发异常。如果格式字符串在长度上比单个字符长（即使多余的字符是空白），则格式字符串被解释为自定义格式字符串。请注意，这些格式说明符产生的模式受“区域选项”控制面板中的设置的影响。具有不同区域性或不同日期与时间设置的计算机将显示不同的模式。

格式字符串显示的时间和日期分隔符由与当前区域性的 DateTimeFormat 属性关联的 DateSeparator 和 TimeSeparator 字符定义。然而，如果 InvariantCulture 被“r”、“s”和“u”说明符引用，与 DateSeparator 和 TimeSeparator 字符关联的字符不随当前区域性更改。下表描述了格式化 DateTime 对象的标准格式字符串。

下表显示了格式说明符示例的列表，这些示例应用于公开当前日期和时间信息的 DateTime.Now 的任意值。示例中给出了不同的区域性设置以阐释更改当前区域性的影响。这通常以下面几种方式更改：使用 Microsoft Windows 中的“日期/时间”控制面板，将您自己的 DateTimeFormatInfo 对象作为格式提供程序传递，或将 CultureInfo 对象设置传递给不同的区域性。请注意，对于“r”和“s”格式，更改区域性不影响输出。此表是说明标准日期和时间说明符如何影响格式化的快速指南。请参阅该表下面阐释这些说明符的代码示例部分。

下面的代码示例阐释如何使用对 DateTime 对象使用自定义格式字符串。

[Visual Basic]Dim dt As DateTime = DateTime.NowDim dfi As DateTimeFormatInfo = New DateTimeFormatInfo()Dim ci As CultureInfo = New CultureInfo("de-DE")' Make up a new custom DateTime pattern, for demonstration.dfi.MonthDayPattern = "MM-MMMM, ddd-dddd"' Use the DateTimeFormat from the culture associated ' with the current thread.Console.WriteLine( dt.ToString("d") )    Console.WriteLine( dt.ToString("m") )' Use the DateTimeFormat from the specific culture passed.Console.WriteLine( dt.ToString("d", ci ) )' Use the settings from the DateTimeFormatInfo object passed.Console.WriteLine( dt.ToString("m", dfi ) )' Reset the current thread to a different culture.Thread.CurrentThread.CurrentCulture = New CultureInfo("fr-BE")Console.WriteLine( dt.ToString("d") )

[C#]DateTime dt = DateTime.Now;DateTimeFormatInfo dfi = new DateTimeFormatInfo();CultureInfo ci = new CultureInfo("de-DE");// Make up a new custom DateTime pattern, for demonstration.dfi.MonthDayPattern = "MM-MMMM, ddd-dddd";// Use the DateTimeFormat from the culture associated // with the current thread.Console.WriteLine( dt.ToString("d") );    Console.WriteLine( dt.ToString("m") );// Use the DateTimeFormat from the specific culture passed.Console.WriteLine( dt.ToString("d", ci ) );// Use the settings from the DateTimeFormatInfo object passed.Console.WriteLine( dt.ToString("m", dfi ) );// Reset the current thread to a different culture.Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-BE");Console.WriteLine( dt.ToString("d") );

自定义 DateTime 格式字符串

有时需要对 DateTime 对象的格式化有更多的控制。作为标准 DateTime 格式的替换方法，您可以使用自定义 DateTime 格式字符串构造您自己的 DateTime 格式化模式。实际上，标准格式就是从这些自定义格式说明符派生的。

下表显示了自定义格式说明符并描述了它们产生的值。这些字符串的输出受“区域选项”控制面板中的当前区域性和设置的影响。

向 DateTime.ToString 传递自定义模式时，模式必须至少为两个字符长。如果只传递“d”，则公共语言运行库将其解释为标准格式说明符，这是因为所有单个格式说明符都被解释为标准格式说明符。如果传递单个“h”，则引发异常，原因是不存在标准的“h”格式说明符。若要只使用单个自定义格式进行格式化，请在说明符的前面或后面添加一个空格。例如，格式字符串“h”被解释为自定义格式字符串。

下表显示使用任意值 DateTime.Now（该值显示当前时间）的示例。示例中给出了不同的区域性和时区设置，以阐释更改区域性的影响。可以通过下列方法更改当前区域性：更改 Microsoft Windows 的“日期/时间”控制面板中的值，传递您自己的 DateTimeFormatInfo 对象，或将 CultureInfo 对象设置传递给不同的区域性。此表是说明自定义日期和时间说明符如何影响格式化的快速指南。请参阅该表下面阐释这些说明符的代码示例部分。

请注意，在某些语言（如 C#）中，“\”字符在与 ToString 方法共用时，它前面必须有转义符。

下面的代码示例阐释如何从 DateTime 对象创建自定义格式化字符串。此示例假定当前区域性是美国英语 (en-US)。

[Visual Basic]

Dim MyDate As New DateTime(2000, 1, 1, 0, 0, 0)

Dim MyString As String = MyDate.ToString("dddd - d - MMMM")

//' In the U.S. English culture, MyString has the value: ' "Saturday - 1 - January".

MyString = MyDate.ToString("yyyy gg")

//' In the U.S. English culture, MyString has the value: "2000 A.D.".

[C#]

DateTime MyDate = new DateTime(2000, 1, 1, 0, 0, 0);

String MyString = MyDate.ToString("dddd - d - MMMM");

// In the U.S. English culture, MyString has the value:    "Saturday - 1 - January".

MyString = MyDate.ToString("yyyy gg");

// In the U.S. English culture, MyString has the value: "2000 A.D.".