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.".