标准日期和时间格式字符串

项目
06/05/2023

标准日期和时间格式字符串使用单个字符作为格式说明符来定义 DateTime 或 DateTimeOffset 值的文本表示形式。任何包含一个以上字符（包括空白）的日期和时间格式字符串都会作为自定义日期和时间格式字符串进行解释。可通过两种方式使用标准或自定义格式字符串：

定义由格式设置操作生成的字符串。
定义可通过分析操作转换为 DateTime 或 DateTimeOffset 值的日期和时间值的文本表示形式。

提示

你可以下载格式设置实用工具，它属于一种 .NET Windows 窗体应用程序，通过该应用程序，你可将格式字符串应用于数值或日期和时间值并显示结果字符串。源代码适用于 C# 和 Visual Basic。

注意

本文中的一些 C# 示例在 Try.NET 内联代码运行程序和演练环境中运行。选择“运行”按钮以在交互窗口中运行示例。执行代码后，可通过再次选择“运行”来修改它并运行已修改的代码。已修改的代码要么在交互窗口中运行，要么编译失败时，交互窗口将显示所有 C# 编译器错误消息。

Try.NET 内联代码运行程序和演练环境的本地时区是协调世界时 (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”、“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”标准格式字符串指示应使用短日期模式显示日期和时间值。对于固定区域性，此模式为“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”	None	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 对象属性。

Property	描述
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

Property	描述
LongDatePattern	定义结果字符串的总体格式。
DayNames	定义可在结果字符串中出现的本地化日名称。
MonthNames	定义可在结果字符串中出现的本地化月份名称。

Property	描述
LongDatePattern	定义结果字符串中日期部分的格式。
ShortTimePattern	定义结果字符串中时间部分的格式。
DayNames	定义可在结果字符串中出现的本地化日名称。
MonthNames	定义可在结果字符串中出现的本地化月份名称。
TimeSeparator	定义分隔时间中小时、分钟和秒钟几个组成部分的字符串。
AMDesignator	定义以 12 小时时钟制表示午夜至正午之前这段时间的字符串。
PMDesignator	定义以 12 小时时钟制表示正午至午夜之前这段时间的字符串。

Property	描述
FullDateTimePattern	定义结果字符串的总体格式。
DayNames	定义可在结果字符串中出现的本地化日名称。
MonthNames	定义可在结果字符串中出现的本地化月份名称。
TimeSeparator	定义分隔时间中小时、分钟和秒钟几个组成部分的字符串。
AMDesignator	定义以 12 小时时钟制表示午夜至正午之前这段时间的字符串。
PMDesignator	定义以 12 小时时钟制表示正午至午夜之前这段时间的字符串。

Property	描述
ShortDatePattern	定义结果字符串中日期部分的格式。
LongTimePattern	定义结果字符串中时间部分的格式。
DateSeparator	定义用于分隔日期中年、月、日部分的字符串。
TimeSeparator	定义分隔时间中小时、分钟和秒钟几个组成部分的字符串。
AMDesignator	定义以 12 小时时钟制表示午夜至正午之前这段时间的字符串。
PMDesignator	定义以 12 小时时钟制表示正午至午夜之前这段时间的字符串。

Property	描述
RFC1123Pattern	定义结果字符串的格式。
AbbreviatedDayNames	定义可在结果字符串中出现的缩写的日期名称。
AbbreviatedMonthNames	定义可在结果字符串中出现的缩写的月份名称。

Property	描述
MonthDayPattern	定义结果字符串的总体格式。
MonthNames	定义可在结果字符串中出现的本地化月份名称。

Property	描述
YearMonthPattern	定义结果字符串的总体格式。
MonthNames	定义可在结果字符串中出现的本地化月份名称。

通过

标准日期和时间格式字符串

格式说明符表

标准格式字符串的工作原理

日期格式

短日期（“d”）格式说明符

长日期（“D”）格式说明符

日期和时间格式

完整日期短时间（“f”）格式说明符

完整日期长时间（“F”）格式说明符

常规日期短时间（“g”）格式说明符

常规日期长时间（“G”）格式说明符

往返（“O”、“o”）格式说明符

RFC1123（“R”、“r”）格式说明符

可排序（“s”）格式说明符

通用可排序（“u”）格式说明符

通用完整（“U”）格式说明符

时间格式

短时间（“t”）格式说明符

长时间（“T”）格式说明符

部分日期格式

月（“M”、“m”）格式说明符

年月（“Y”、“y”）格式说明符

控制面板设置

DateTimeFormatInfo 属性

请参阅

其他资源