標(biāo)準(zhǔn) DateTime 格式字符串

如果格式字符串只包含下表列出的某個單個格式說明符，則它們被解釋為標(biāo)準(zhǔn)格式說明符。如果指定的格式字符是單個字符并且不包含在下表中，則引發(fā)異常。如果格式字符串在長度上比單個字符長（即使多余的字符是空白），則格式字符串被解釋為自定義格式字符串。請注意，這些格式說明符產(chǎn)生的模式受“區(qū)域選項”控制面板中的設(shè)置的影響。具有不同區(qū)域性或不同日期與時間設(shè)置的計算機將顯示不同的模式。

格式字符串顯示的時間和日期分隔符由與當(dāng)前區(qū)域性的 DateTimeFormat 屬性關(guān)聯(lián)的 DateSeparator 和 TimeSeparator 字符定義。然而，如果 InvariantCulture 被“r”、“s”和“u”說明符引用，與 DateSeparator 和 TimeSeparator 字符關(guān)聯(lián)的字符不隨當(dāng)前區(qū)域性更改。下表描述了格式化 DateTime 對象的標(biāo)準(zhǔn)格式字符串。

下表顯示了格式說明符示例的列表，這些示例應(yīng)用于公開當(dāng)前日期和時間信息的 DateTime.Now 的任意值。示例中給出了不同的區(qū)域性設(shè)置以闡釋更改當(dāng)前區(qū)域性的影響。這通常以下面幾種方式更改：使用 Microsoft Windows 中的“日期/時間”控制面板，將您自己的 DateTimeFormatInfo 對象作為格式提供程序傳遞，或?qū)?CultureInfo 對象設(shè)置傳遞給不同的區(qū)域性。請注意，對于“r”和“s”格式，更改區(qū)域性不影響輸出。此表是說明標(biāo)準(zhǔn)日期和時間說明符如何影響格式化的快速指南。請參閱該表下面闡釋這些說明符的代碼示例部分。

下面的代碼示例闡釋如何使用對 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 對象的格式化有更多的控制。作為標(biāo)準(zhǔn) DateTime 格式的替換方法，您可以使用自定義 DateTime 格式字符串構(gòu)造您自己的 DateTime 格式化模式。實際上，標(biāo)準(zhǔn)格式就是從這些自定義格式說明符派生的。

下表顯示了自定義格式說明符并描述了它們產(chǎn)生的值。這些字符串的輸出受“區(qū)域選項”控制面板中的當(dāng)前區(qū)域性和設(shè)置的影響。

向 DateTime.ToString 傳遞自定義模式時，模式必須至少為兩個字符長。如果只傳遞“d”，則公共語言運行庫將其解釋為標(biāo)準(zhǔn)格式說明符，這是因為所有單個格式說明符都被解釋為標(biāo)準(zhǔn)格式說明符。如果傳遞單個“h”，則引發(fā)異常，原因是不存在標(biāo)準(zhǔn)的“h”格式說明符。若要只使用單個自定義格式進行格式化，請在說明符的前面或后面添加一個空格。例如，格式字符串“h”被解釋為自定義格式字符串。

下表顯示使用任意值 DateTime.Now（該值顯示當(dāng)前時間）的示例。示例中給出了不同的區(qū)域性和時區(qū)設(shè)置，以闡釋更改區(qū)域性的影響。可以通過下列方法更改當(dāng)前區(qū)域性：更改 Microsoft Windows 的“日期/時間”控制面板中的值，傳遞您自己的 DateTimeFormatInfo 對象，或?qū)?CultureInfo 對象設(shè)置傳遞給不同的區(qū)域性。此表是說明自定義日期和時間說明符如何影響格式化的快速指南。請參閱該表下面闡釋這些說明符的代碼示例部分。

請注意，在某些語言（如 C#）中，“/”字符在與 ToString 方法共用時，它前面必須有轉(zhuǎn)義符。

下面的代碼示例闡釋如何從 DateTime 對象創(chuàng)建自定義格式化字符串。此示例假定當(dāng)前區(qū)域性是美國英語 (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.".