標準日期和時間格式字串

發行項
05/22/2023

標準日期和時間格式字串使用單一字元作為格式指定名稱，定義 DateTime 或 DateTimeOffset 值的文字表示。任何包含一個以上字元 (包含空白字元) 的日期和時間格式字串都會解譯為自訂日期和時間格式字串。標準或自訂格式字串有兩種使用方式：

定義執行格式化作業後所產生的字串。
定義日期和時間值的文字表示，可藉由剖析作業轉換成 DateTime 或 DateTimeOffset 值。

提示

您可以下載格式公用程式，這是 .NET Windows Forms應用程式，可讓您將格式字串套用至數值或日期和時間值，並顯示結果字串。提供 C# 和 Visual Basic 的原始程式碼。

注意

本文中的某些 C# 範例會在 Try.NET 內嵌程式碼執行器和測試區執行。選取 [執行] 按鈕以在互動式視窗中執行範例。執行程式碼之後，您便可以修改它，並再選取一次 [執行] 來執行修改過的程式碼。修改過的程式碼會在互動式視窗中執行，或是如果編譯失敗的話，互動式視窗會顯示所有 C# 編譯器錯誤訊息。

Try.NET 內嵌程式碼執行器與 Playground 的當地時區是全球標準時間 (UTC)。這可能會影響示範 DateTime、DateTimeOffset 與 TimeZoneInfo 型別與其成員之範例的行為與輸出。

格式指定名稱的資料表

下表描述標準日期和時間的格式規範。除非特別註明，否則特定標準日期和時間格式規範會產生相同的字串表示，無論是與 DateTime 或 DateTimeOffset 值搭配使用。如需使用標準日期和時間格式字串的詳細資訊，請參閱控制台設定和 DateTimeFormatInfo 屬性。

格式規範	描述	範例
"d"	簡短日期模式。詳細資訊：簡短日期 ("d") 格式指定名稱。	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	完整日期模式。詳細資訊：完整日期 ("D") 格式指定名稱。	2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	完整日期/時間模式 (簡短時間)。詳細資訊：完整日期簡短時間 ("f") 格式指定名稱。	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	完整日期/時間模式 (完整時間)。詳細資訊：完整日期完整時間 ("F") 格式指定名稱。	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	一般日期/時間模式 (簡短時間)。詳細資訊：一般日期簡短時間 ("g") 格式指定名稱。	2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	一般日期/時間模式 (完整時間)。詳細資訊：一般日期完整時間 ("G") 格式指定名稱。	2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M"、"m"	月/日模式。詳細資訊：月 ("M"、"m") 格式指定名稱。	2009-06-15T13:45:30 -> June 15 (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O"、"o"	來回日期/時間模式。詳細資訊：來回 ("O"、"o") 格式指定名稱。	DateTime 值： 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 DateTimeOffset 值： 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R"、"r"	RFC1123 模式。詳細資訊：RFC1123 ("R"、"r") 格式指定名稱。	DateTimeOffset input：2009-06-15T13：45：30 - > Mon， 15 Jun 2009 20：45：30 GMT DateTime input：2009-06-15T13：45：30 - > Mon， 15 Jun 2009 13：45：30 GMT
"s"	可排序日期/時間模式。詳細資訊：可排序 ("s") 格式指定名稱。	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t"	簡短時間模式。詳細資訊：簡短時間 ("t") 格式指定名稱。	2009-06-15T13:45:30 -> 1:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	完整時間模式。詳細資訊：完整時間 ("T") 格式指定名稱。	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	國際可排序日期/時間模式。詳細資訊：國際可排序 ("u") 格式指定名稱。	使用 DateTime 值：2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z 使用 DateTimeOffset 值：2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	國際完整日期/時間模式。詳細資訊：國際完整 ("U") 格式指定名稱。	2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y"	年月模式。詳細資訊：年月 ("Y") 格式指定名稱。	2009-06-15T13:45:30 -> June 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
任何其他單一字元	未知的規範。	擲回執行階段 FormatException。

標準格式字串的運作方式

在格式化作業中，標準格式字串只是自訂格式字串的別名。使用別名來表示自訂格式字串的好處是，儘管別名保持不變，自訂格式字串本身則可有變化。這點非常重要，因為日期和時間值的字串表示通常會因文化特性而不同。例如，"d" 標準格式字串表示日期和時間值將使用簡短日期模式顯示。在不因文化特性而異 (Invariant Culture) 的情況下，此模式為 "MM/dd/yyyy"。若為 fr-FR 文化特性，則是 "dd/MM/yyyy"。若為 ja-JP 文化特性，則是 "yyyy/MM/dd"。

如果格式化作業中的標準格式字串對應至特定文化特性的自訂格式字串，您的應用程式可以定義特定文化特性，以下列其中一種方式使用自訂格式字串：

您可以使用預設 (或目前的) 文化特性。下列範例顯示的日期使用了目前文化特性的簡短日期格式。在此例中，目前的文化特性是 en-US。

// Display using current (en-us) culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008

' Display using current (en-us) culture's short date format
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

您可以將表示要用來進行格式化之文化特性的 CultureInfo 物件傳遞至具有 IFormatProvider 參數的方法。下列範例顯示的日期使用了 pt-BR 文化特性的簡短日期格式。

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

您可以將提供格式化資訊的 DateTimeFormatInfo 物件傳遞至具有 IFormatProvider 參數的方法。下列範例顯示的日期使用了取自於 hr-HR 文化特性之 DateTimeFormatInfo 物件的簡短日期格式。

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

注意

如需有關自訂格式化日期與時間值所使用之模式或字串的詳細資訊，請參閱 NumberFormatInfo 類別主題。

在某些情況下，標準格式字串可做為不變之長自訂格式字串的簡便縮寫。有四個標準格式字串屬於此分類："O" (或 "o")、"R" (或 "r")、"s" 和 "u"。這些字串相當於不因文化特性而異所定義的自訂格式字串。它們針對日期和時間值所產生的字串表示在各文化特性中都相同。下表提供這四種標準日期和時間格式字串的相關資訊。

標準格式字串	由 DateTimeFormatInfo.InvariantInfo 屬性定義	自訂格式字串
"O" 或 "o"	無	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK
"R" 或 "r"	RFC1123Pattern	ddd、dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

標準格式字串也可以在剖析作業中搭配 DateTime.ParseExact 或 DateTimeOffset.ParseExact 方法使用，這些方法都需要輸入字串完全符合特定模式，剖析作業才會成功。許多標準格式字串都對應至多個自訂格式字串，因此日期和時間值可以用各種不同的格式表示，而剖析作業仍然會成功。您可以藉由呼叫 DateTimeFormatInfo.GetAllDateTimePatterns(Char) 方法判斷對應至標準格式字串的自訂格式字串。下列範例會顯示對應至 "d" (簡短日期模式) 標準格式字串的自訂格式字串。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine("   {0}", customString);
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

下列各節描述 DateTime 和 DateTimeOffset 值的標準格式規範。

日期格式

此群組包含下列格式：

簡短日期 ("d") 格式指定名稱
完整日期 ("D") 格式指定名稱

簡短日期 ("d")

"d" 標準格式規範表示由特定文化特性之 DateTimeFormatInfo.ShortDatePattern 屬性所定義的自訂日期和時間格式字串。例如，不因文化特性而異的 ShortDatePattern 屬性傳回的自訂格式字串為 "MM/dd/yyyy"。

下表列出可控制傳回字串之格式設定的 DateTimeFormatInfo 物件屬性。

屬性	描述
ShortDatePattern	定義結果字串的整體格式。
DateSeparator	定義分隔日期之年份、月份和日期元件的字串。

下列範例使用 "d" 格式規範來顯示日期和時間值。

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008

屬性	描述
LongDatePattern	定義結果字串的整體格式。
DayNames	定義可顯示在結果字串中的當地語系化日期名稱。
MonthNames	定義可顯示在結果字串中的當地語系化月份名稱。

屬性	描述
LongDatePattern	定義結果字串之日期元件的格式。
ShortTimePattern	定義結果字串之時間元件的格式。
DayNames	定義可顯示在結果字串中的當地語系化日期名稱。
MonthNames	定義可顯示在結果字串中的當地語系化月份名稱。
TimeSeparator	定義分隔時間之小時、分鐘和秒鐘元件的字串。
AMDesignator	定義表示從午夜到中午之前時間 (12 小時制) 的字串。
PMDesignator	定義表示從中午到午夜之前時間 (12 小時制) 的字串。

屬性	描述
FullDateTimePattern	定義結果字串的整體格式。
DayNames	定義可顯示在結果字串中的當地語系化日期名稱。
MonthNames	定義可顯示在結果字串中的當地語系化月份名稱。
TimeSeparator	定義分隔時間之小時、分鐘和秒鐘元件的字串。
AMDesignator	定義表示從午夜到中午之前時間 (12 小時制) 的字串。
PMDesignator	定義表示從中午到午夜之前時間 (12 小時制) 的字串。

屬性	描述
ShortDatePattern	定義結果字串之日期元件的格式。
LongTimePattern	定義結果字串之時間元件的格式。
DateSeparator	定義分隔日期之年份、月份和日期元件的字串。
TimeSeparator	定義分隔時間之小時、分鐘和秒鐘元件的字串。
AMDesignator	定義表示從午夜到中午之前時間 (12 小時制) 的字串。
PMDesignator	定義表示從中午到午夜之前時間 (12 小時制) 的字串。

屬性	描述
RFC1123Pattern	定義結果字串的格式。
AbbreviatedDayNames	定義可顯示在結果字串中的縮寫日期名稱。
AbbreviatedMonthNames	定義可顯示在結果字串中的縮寫月份名稱。

屬性	描述
MonthDayPattern	定義結果字串的整體格式。
MonthNames	定義可顯示在結果字串中的當地語系化月份名稱。

屬性	描述
YearMonthPattern	定義結果字串的整體格式。
MonthNames	定義可顯示在結果字串中的當地語系化月份名稱。

共用方式為

標準日期和時間格式字串

格式指定名稱的資料表

標準格式字串的運作方式

日期格式

簡短日期 ("d")

完整日期 ("D") 格式規範

日期和時間格式

完整日期簡短時間 ("f") 格式規範

完整日期完整時間 ("F") 格式規範

一般日期簡短時間 ("g") 格式規範

一般日期完整時間 ("G") 格式規範

來回行程 ("O"、"o") 格式規範

RFC1123 ("R"、"r") 格式規範

可排序 ("s") 格式規範

國際可排序 ("u") 格式規範

國際完整 ("U") 格式規範

時間格式

簡短時間 ("t") 格式規範

完整時間 ("T") 格式規範

部分日期格式

月 ("M"、"m") 格式規範

年月 ("Y"、"y") 格式規範

控制台設定

DateTimeFormatInfo 屬性

另請參閱

其他資源