DateTime.ToString 方法

参考

定义

命名空间:: System

程序集:: mscorlib.dll

将当前 DateTime 对象的值转换为其等效的字符串表示形式。

重载

ToString(String, IFormatProvider)	使用指定的格式和区域性特定格式信息将当前 DateTime 对象的值转换为它的等效字符串表示形式。
ToString(String)	使用指定的格式和当前区域性的格式约定将当前 DateTime 对象的值转换为它的等效字符串表示形式。
ToString(IFormatProvider)	使用指定的区域性特定格式信息将当前 DateTime 对象的值转换为它的等效字符串表示形式。
ToString()	使用当前的区域性格式约定将当前 DateTime 对象的值转换为它的等效字符串表示形式。

ToString(String, IFormatProvider)

使用指定的格式和区域性特定格式信息将当前 DateTime 对象的值转换为它的等效字符串表示形式。

public string ToString (string format, IFormatProvider provider);

参数

format: String

标准或自定义日期和时间格式字符串。

provider: IFormatProvider

一个提供区域性特定的格式设置信息的对象。

String

由 DateTime 和 format 指定的当前 provider 对象的值的字符串表示形式。

实现

ToString(String, IFormatProvider)

例外

FormatException

format 的长度为 1，而且它不是为 DateTimeFormatInfo 定义的格式说明符字符之一。

或 -

format 不包含有效的自定义格式模式。

ArgumentOutOfRangeException

日期和时间超出了 provider 所用日历支持的日期范围。

示例

以下示例使用每个标准日期时间格式字符串来显示四个不同区域性的日期和时间的字符串表示形式。

using System;
using System.Globalization;

public class Example
{
   public static void Main1()
   {
      // Create an array of all supported standard date and time format specifiers.
      string[] formats = {"d", "D", "f", "F", "g", "G", "m", "o", "r",
                          "s", "t", "T", "u", "U", "Y"};
      // Create an array of four cultures.
      CultureInfo[] cultures = {CultureInfo.GetCultureInfo("de-DE"),
                                CultureInfo.GetCultureInfo("en-US"),
                                CultureInfo.GetCultureInfo("es-ES"),
                                CultureInfo.GetCultureInfo("fr-FR")};
       // Define date to be displayed.
      DateTime dateToDisplay = new DateTime(2008, 10, 31, 17, 4, 32);

      // Iterate each standard format specifier.
      foreach (string formatSpecifier in formats)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0} Format Specifier {1, 10} Culture {2, 40}",
                              formatSpecifier, culture.Name,
                              dateToDisplay.ToString(formatSpecifier, culture));
         Console.WriteLine();
      }
   }
}

// The example displays the following output:
//    d Format Specifier      de-DE Culture                               31.10.2008
//    d Format Specifier      en-US Culture                               10/31/2008
//    d Format Specifier      es-ES Culture                               31/10/2008
//    d Format Specifier      fr-FR Culture                               31/10/2008
//    
//    D Format Specifier      de-DE Culture                Freitag, 31. Oktober 2008
//    D Format Specifier      en-US Culture                 Friday, October 31, 2008
//    D Format Specifier      es-ES Culture           viernes, 31 de octubre de 2008
//    D Format Specifier      fr-FR Culture                 vendredi 31 octobre 2008
//    
//    f Format Specifier      de-DE Culture          Freitag, 31. Oktober 2008 17:04
//    f Format Specifier      en-US Culture         Friday, October 31, 2008 5:04 PM
//    f Format Specifier      es-ES Culture     viernes, 31 de octubre de 2008 17:04
//    f Format Specifier      fr-FR Culture           vendredi 31 octobre 2008 17:04
//    
//    F Format Specifier      de-DE Culture       Freitag, 31. Oktober 2008 17:04:32
//    F Format Specifier      en-US Culture      Friday, October 31, 2008 5:04:32 PM
//    F Format Specifier      es-ES Culture  viernes, 31 de octubre de 2008 17:04:32
//    F Format Specifier      fr-FR Culture        vendredi 31 octobre 2008 17:04:32
//    
//    g Format Specifier      de-DE Culture                         31.10.2008 17:04
//    g Format Specifier      en-US Culture                       10/31/2008 5:04 PM
//    g Format Specifier      es-ES Culture                         31/10/2008 17:04
//    g Format Specifier      fr-FR Culture                         31/10/2008 17:04
//    
//    G Format Specifier      de-DE Culture                      31.10.2008 17:04:32
//    G Format Specifier      en-US Culture                    10/31/2008 5:04:32 PM
//    G Format Specifier      es-ES Culture                      31/10/2008 17:04:32
//    G Format Specifier      fr-FR Culture                      31/10/2008 17:04:32
//    
//    m Format Specifier      de-DE Culture                              31. Oktober
//    m Format Specifier      en-US Culture                               October 31
//    m Format Specifier      es-ES Culture                            31 de octubre
//    m Format Specifier      fr-FR Culture                               31 octobre
//    
//    o Format Specifier      de-DE Culture              2008-10-31T17:04:32.0000000
//    o Format Specifier      en-US Culture              2008-10-31T17:04:32.0000000
//    o Format Specifier      es-ES Culture              2008-10-31T17:04:32.0000000
//    o Format Specifier      fr-FR Culture              2008-10-31T17:04:32.0000000
//    
//    r Format Specifier      de-DE Culture            Fri, 31 Oct 2008 17:04:32 GMT
//    r Format Specifier      en-US Culture            Fri, 31 Oct 2008 17:04:32 GMT
//    r Format Specifier      es-ES Culture            Fri, 31 Oct 2008 17:04:32 GMT
//    r Format Specifier      fr-FR Culture            Fri, 31 Oct 2008 17:04:32 GMT
//    
//    s Format Specifier      de-DE Culture                      2008-10-31T17:04:32
//    s Format Specifier      en-US Culture                      2008-10-31T17:04:32
//    s Format Specifier      es-ES Culture                      2008-10-31T17:04:32
//    s Format Specifier      fr-FR Culture                      2008-10-31T17:04:32
//    
//    t Format Specifier      de-DE Culture                                    17:04
//    t Format Specifier      en-US Culture                                  5:04 PM
//    t Format Specifier      es-ES Culture                                    17:04
//    t Format Specifier      fr-FR Culture                                    17:04
//    
//    T Format Specifier      de-DE Culture                                 17:04:32
//    T Format Specifier      en-US Culture                               5:04:32 PM
//    T Format Specifier      es-ES Culture                                 17:04:32
//    T Format Specifier      fr-FR Culture                                 17:04:32
//    
//    u Format Specifier      de-DE Culture                     2008-10-31 17:04:32Z
//    u Format Specifier      en-US Culture                     2008-10-31 17:04:32Z
//    u Format Specifier      es-ES Culture                     2008-10-31 17:04:32Z
//    u Format Specifier      fr-FR Culture                     2008-10-31 17:04:32Z
//    
//    U Format Specifier      de-DE Culture       Freitag, 31. Oktober 2008 09:04:32
//    U Format Specifier      en-US Culture      Friday, October 31, 2008 9:04:32 AM
//    U Format Specifier      es-ES Culture   viernes, 31 de octubre de 2008 9:04:32
//    U Format Specifier      fr-FR Culture        vendredi 31 octobre 2008 09:04:32
//    
//    Y Format Specifier      de-DE Culture                             Oktober 2008
//    Y Format Specifier      en-US Culture                             October 2008
//    Y Format Specifier      es-ES Culture                          octubre de 2008
//    Y Format Specifier      fr-FR Culture                             octobre 2008

下面的示例演示了使用固定设置 DateTime 值格式的不同方法 DateTimeFormatInfo 。

using System;
using System.Globalization;

public class MainClass
{
    public static void Main(string[] args)
    {
        DateTime dt = DateTime.Now;
        String[] format = {
            "d", "D",
            "f", "F",
            "g", "G",
            "m",
            "r",
            "s",
            "t", "T",
            "u", "U",
            "y",
            "dddd, MMMM dd yyyy",
            "ddd, MMM d \"'\"yy",
            "dddd, MMMM dd",
            "M/yy",
            "dd-MM-yy",
        };
        string date;
        for (int i = 0; i < format.Length; i++)
        {
            date = dt.ToString(format[i], DateTimeFormatInfo.InvariantInfo);
            Console.WriteLine(string.Concat(format[i], " :", date));
        }

        /** Output.
         *
         * d :08/17/2000
         * D :Thursday, August 17, 2000
         * f :Thursday, August 17, 2000 16:32
         * F :Thursday, August 17, 2000 16:32:32
         * g :08/17/2000 16:32
         * G :08/17/2000 16:32:32
         * m :August 17
         * r :Thu, 17 Aug 2000 23:32:32 GMT
         * s :2000-08-17T16:32:32
         * t :16:32
         * T :16:32:32
         * u :2000-08-17 23:32:32Z
         * U :Thursday, August 17, 2000 23:32:32
         * y :August, 2000
         * dddd, MMMM dd yyyy :Thursday, August 17 2000
         * ddd, MMM d "'"yy :Thu, Aug 17 '00
         * dddd, MMMM dd :Thursday, August 17
         * M/yy :8/00
         * dd-MM-yy :17-08-00
         */
    }
}

注解

参数可以包含单个格式说明符字符 (标准日期和时间格式字符串) 或自定义格式模式 (format 请参阅自定义日期和时间格式字符串) 。如果 format 为或空字符串 (") ，则使用标准格式说明器 null "G"。

参数定义与标准格式说明符相对应的模式，以及日期和时间组件的符号和 provider 名称。 provider参数可以是以下任一项：

一 CultureInfo 个对象，该对象表示要反映在返回的字符串中的格式设置约定的区域性。 DateTimeFormatInfo属性返回 CultureInfo.DateTimeFormat 的对象定义返回的字符串的格式。
一 DateTimeFormatInfo 个定义日期和时间数据格式的对象。
实现接口的自定义 IFormatProvider 对象。其 GetFormat 方法返回 DateTimeFormatInfo 提供格式设置信息的对象。

如果 provider null 为， DateTimeFormatInfo 则使用与当前区域性关联的。有关详细信息，请参阅 CultureInfo.CurrentCulture。

调用方说明

ToString(String, IFormatProvider)方法返回参数使用的日历中日期和时间的字符串 provider 表示形式。其日历由属性 Calendar 定义。如果当前实例的值早于或 DateTime MinSupportedDateTime 晚于 MaxSupportedDateTime ，则方法将引发 ArgumentOutOfRangeException 。下面的示例进行了这方面的演示。它尝试设置超出类范围的日期 UmAlQuraCalendar 的格式。

：：：code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetime.tostring.argumentoutofrangeexception/cs/datetime.tostring.argumentoutofrangeexception4.cs" interactive="try-dotnet" id="Snippet4"：：：：：：code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetime.tostring.argumentoutofrangeexception/vb/datetime.tostring.argumentoutofrangeexception4.vb" id="Snippet4"：：：

另请参阅

适用于

.NET 7 和其他版本

产品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0
Xamarin.iOS	10.8
Xamarin.Mac	3.0

ToString(String)

使用指定的格式和当前区域性的格式约定将当前 DateTime 对象的值转换为它的等效字符串表示形式。

public string ToString (string format);

参数

format: String

标准或自定义日期和时间格式字符串。

String

由 DateTime 指定的当前 format 对象的值的字符串表示形式。

例外

FormatException

format 的长度为 1，而且它不是为 DateTimeFormatInfo 定义的格式说明符字符之一。

或 -

format 不包含有效的自定义格式模式。

ArgumentOutOfRangeException

此日期和时间超出了当前区域性所用日历支持的日期范围。

示例

下面的示例使用每个标准日期和时间格式字符串以及一系列自定义日期和时间格式字符串来显示值的字符串 DateTime 表示形式。该示例的线程当前区域性为 en-US。

using System;

public class DateToStringExample2
{
   public static void Main0()
   {
      DateTime dateValue = new DateTime(2008, 6, 15, 21, 15, 07);
      // Create an array of standard format strings.
      string[] standardFmts = {"d", "D", "f", "F", "g", "G", "m", "o",
                               "R", "s", "t", "T", "u", "U", "y"};
      // Output date and time using each standard format string.
      foreach (string standardFmt in standardFmts)
         Console.WriteLine("{0}: {1}", standardFmt,
                           dateValue.ToString(standardFmt));
      Console.WriteLine();

      // Create an array of some custom format strings.
      string[] customFmts = {"h:mm:ss.ff t", "d MMM yyyy", "HH:mm:ss.f",
                             "dd MMM HH:mm:ss", @"\Mon\t\h\: M", "HH:mm:ss.ffffzzz" };
      // Output date and time using each custom format string.
      foreach (string customFmt in customFmts)
         Console.WriteLine("'{0}': {1}", customFmt,
                           dateValue.ToString(customFmt));
   }
}
// This example displays the following output to the console:
//       d: 6/15/2008
//       D: Sunday, June 15, 2008
//       f: Sunday, June 15, 2008 9:15 PM
//       F: Sunday, June 15, 2008 9:15:07 PM
//       g: 6/15/2008 9:15 PM
//       G: 6/15/2008 9:15:07 PM
//       m: June 15
//       o: 2008-06-15T21:15:07.0000000
//       R: Sun, 15 Jun 2008 21:15:07 GMT
//       s: 2008-06-15T21:15:07
//       t: 9:15 PM
//       T: 9:15:07 PM
//       u: 2008-06-15 21:15:07Z
//       U: Monday, June 16, 2008 4:15:07 AM
//       y: June, 2008
//
//       'h:mm:ss.ff t': 9:15:07.00 P
//       'd MMM yyyy': 15 Jun 2008
//       'HH:mm:ss.f': 21:15:07.0
//       'dd MMM HH:mm:ss': 15 Jun 21:15:07
//       '\Mon\t\h\: M': Month: 6
//       'HH:mm:ss.ffffzzz': 21:15:07.0000-07:00

注解

方法返回特定格式的日期和时间值的字符串表示形式，该格式使用当前区域性的格式设置 ToString(String) 约定;有关详细信息，请参阅 CultureInfo.CurrentCulture 。

参数应包含单个格式说明符 (请参阅标准日期和时间格式字符串) 或自定义格式模式 (请参阅自定义日期和时间格式字符串) ，该字符串定义返回字符串 format 的格式。如果 format 为 null 或空字符串，则使用常规格式说明法"G"。

此方法的一些用法包括：

获取一个字符串，该字符串以当前区域性的短日期和时间格式显示日期和时间。为此，请使用"G"格式说明器。
获取仅包含月份和年份的字符串。为此，请使用"MM/yyyy"格式字符串。格式字符串使用当前区域性的日期分隔符。
获取包含特定格式的日期和时间的字符串。例如，"MM/dd/yyyyyHH：mm"格式字符串以固定格式（如"19//03//2013 18：06"）显示日期和时间字符串。格式字符串使用"/"作为固定日期分隔符，而不考虑区域性特定的设置。
获取可用于序列化日期字符串的压缩格式的日期。例如，"yyyyMMmdd"格式字符串显示四位数年份，后跟两位数月份和两位数日期，没有日期分隔符。

以下示例使用这三个格式字符串，通过使用 en-US 和 fr-FR 区域性的约定来显示日期和时间值。

using System;
using System.Globalization;

public class Example3
{
    public static void Main3()
    {
        string[] formats = { "G", "MM/yyyy", @"MM\/dd\/yyyy HH:mm", "yyyyMMdd" };
        string[] cultureNames = { "en-US", "fr-FR" };
        DateTime date = new DateTime(2015, 8, 18, 13, 31, 17);
        foreach (var cultureName in cultureNames)
        {
            var culture = new CultureInfo(cultureName);
            CultureInfo.CurrentCulture = culture;
            Console.WriteLine(culture.NativeName);
            foreach (var format in formats)
                Console.WriteLine($"   {format}: {date.ToString(format)}");
            Console.WriteLine();
        }
    }
}
// The example displays the following output:
//       English (United States)
//          G: 8/18/2015 1:31:17 PM
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818
//
//       français (France)
//          G: 18/08/2015 13:31:17
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818

调用方说明

ToString(String)方法返回当前区域性使用的日历中日期和时间的字符串表示形式。如果当前实例的值早于或 DateTime MinSupportedDateTime 晚于 MaxSupportedDateTime ，则方法将引发 ArgumentOutOfRangeException 。下面的示例进行了这方面的演示。当当前区域性为希伯来语或希伯来语时，它会尝试设置类 (HebrewCalendar 日期) 。

：：：code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetime.tostring.argumentoutofrangeexception/cs/datetime.tostring.argumentoutofrangeexception3.cs" interactive="try-dotnet" id="Snippet3"：：：：：：code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetime.tostring.argumentoutofrangeexception/vb/datetime.tostring.argumentoutofrangeexception3.vb" id="Snippet3"：：：

另请参阅

适用于

.NET 7 和其他版本

产品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0
Xamarin.iOS	10.8
Xamarin.Mac	3.0

ToString(IFormatProvider)

使用指定的区域性特定格式信息将当前 DateTime 对象的值转换为它的等效字符串表示形式。

public string ToString (IFormatProvider provider);

参数

provider: IFormatProvider

一个提供区域性特定的格式设置信息的对象。

String

由 DateTime 指定的当前 provider 对象的值的字符串表示形式。

实现

ToString(IFormatProvider)

例外

ArgumentOutOfRangeException

日期和时间超出了 provider 所用日历支持的日期范围。

示例

以下示例使用表示五个不同区域性的对象显示日期和时间 CultureInfo 的字符串表示形式。

using System;
using System.Globalization;

public class Example2
{
   public static void Main2()
   {
      CultureInfo[] cultures = new CultureInfo[] {CultureInfo.InvariantCulture,
                                                  new CultureInfo("en-us"),
                                                  new CultureInfo("fr-fr"),
                                                  new CultureInfo("de-DE"),
                                                  new CultureInfo("es-ES"),
                                                  new CultureInfo("ja-JP")};

      DateTime thisDate = new DateTime(2009, 5, 1, 9, 0, 0);

      foreach (CultureInfo culture in cultures)
      {
         string cultureName;
         if (string.IsNullOrEmpty(culture.Name))
            cultureName = culture.NativeName;
         else
            cultureName = culture.Name;

         Console.WriteLine("In {0}, {1}",
                           cultureName, thisDate.ToString(culture));
      }
      }
}
// The example produces the following output:
//    In Invariant Language (Invariant Country), 05/01/2009 09:00:00
//    In en-US, 5/1/2009 9:00:00 AM
//    In fr-FR, 01/05/2009 09:00:00
//    In de-DE, 01.05.2009 09:00:00
//    In es-ES, 01/05/2009 9:00:00
//    In ja-JP, 2009/05/01 9:00:00

注解

当前对象的值 DateTime 是使用常规日期和时间格式说明符 ( "G" ) ，后者使用短日期模式和长时间模式设置输出格式。

短日期和长时间模式的格式由 provider 参数定义。 provider参数可以是以下任一项：

一 CultureInfo 个对象，该对象表示要反映在返回的字符串中的格式设置约定的区域性。 DateTimeFormatInfo属性返回 CultureInfo.DateTimeFormat 的对象定义返回的字符串的格式。
一 DateTimeFormatInfo 个定义日期和时间数据格式的对象。
实现接口的自定义 IFormatProvider 对象。其 GetFormat 方法返回 DateTimeFormatInfo 提供格式设置信息的对象。

如果 provider null 为， DateTimeFormatInfo 则使用与当前区域性关联的对象。有关详细信息，请参阅 CultureInfo.CurrentCulture。

调用方说明

方法返回由参数表示的区域性使用的日历中日期和时间 ToString(IFormatProvider) 的字符串 provider 表示形式。其日历由属性 Calendar 定义。如果当前实例的值早于或 DateTime MinSupportedDateTime 晚于 MaxSupportedDateTime ，则方法将引发 ArgumentOutOfRangeException 。下面的示例进行了这方面的演示。它尝试设置超出类范围的日期 JapaneseCalendar 的格式。

：：：code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetime.tostring.argumentoutofrangeexception/cs/datetime.tostring.argumentoutofrangeexception1.cs" interactive="try-dotnet" id="Snippet1"：：：：：：code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetime.tostring.argumentoutofrangeexception/vb/datetime.tostring.argumentoutofrangeexception1.vb" id="Snippet1"：：：

另请参阅

适用于

.NET 7 和其他版本

产品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0
Xamarin.iOS	10.8
Xamarin.Mac	3.0

ToString()

使用当前的区域性格式约定将当前 DateTime 对象的值转换为它的等效字符串表示形式。

public override string ToString ();

String

当前 DateTime 对象的值的字符串表示形式。

例外

ArgumentOutOfRangeException

此日期和时间超出了当前区域性所用日历支持的日期范围。

示例

下面的示例说明方法返回的值的字符串表示形式如何 DateTime ToString() 取决于当前线程的区域性。它将当前区域性更改为 en-us、fr-fr 和 ja-jp，在每种情况下，都调用 ToString() 方法，以返回使用该区域性的日期和时间值的字符串表示形式。

using System;
using System.Globalization;

public class DateToStringExample
{
    public static void Main()
    {
        CultureInfo currentCulture = CultureInfo.CurrentCulture;
        DateTime exampleDate = new DateTime(2021, 5, 1, 18, 32, 6);

        // Change the current culture to en-US and display the date.
        CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("en-US");
        Console.WriteLine(exampleDate.ToString());

        // Change the current culture to fr-FR and display the date.
        CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("fr-FR");
        Console.WriteLine(exampleDate.ToString());

        // Change the current culture to ja-JP and display the date.
        CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("ja-JP");
        Console.WriteLine(exampleDate.ToString());

        // Restore the original culture
        CultureInfo.CurrentCulture = currentCulture;
    }
}

// The example displays the following output to the console:
//       5/1/2021 6:32:06 PM
//       01/05/2021 18:32:06
//       2021/05/01 18:32:06

注解

当前对象的值 DateTime 是使用常规日期和时间格式说明符 ( "G" ) 进行格式设置的。若要使用特定的日期和时间格式说明符来设置其格式，请调用 ToString(String) 方法。若要使用常规日期和时间格式说明符对特定区域性 ( "G" ) ，请调用 ToString(IFormatProvider) 方法。若要使用特定的日期和时间格式说明符以及特定区域性的约定对其进行格式化，请调用 ToString(String, IFormatProvider) 方法。

此方法使用派生自当前区域性的格式设置信息。特别是，它将由 ShortDatePattern 属性返回的对象的和属性返回的自定义格式字符串组合在一起 LongTimePattern DateTimeFormatInfo Thread.CurrentThread.CurrentCulture.DateTimeFormat 。有关详细信息，请参阅 CultureInfo.CurrentCulture。方法的其他重载 ToString 使你能够指定要使用其格式设置的区域性，并定义值的输出模式 DateTime 。

调用方说明

ToString()方法返回当前区域性使用的日历中的日期和时间的字符串表示形式。如果当前实例的值 DateTime 早于 MinSupportedDateTime 或晚于 MaxSupportedDateTime ，则该方法将引发 ArgumentOutOfRangeException 。下面的示例进行了这方面的演示。 HijriCalendar如果当前区域性为阿拉伯语 (叙利亚) ，则它会尝试设置位于类范围之外的日期的格式。

：：： code language = "csharp" source = "~/samples/snippets/csharp/VS_Snippets_CLR_System/system.datetime.tostring.argumentoutofrangeexception/cs/datetime.tostring.argumentoutofrangeexception2.cs" id = "Snippet2"：：：：：： code language = "vb" source = "~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.datetime.tostring.argumentoutofrangeexception/vb/datetime.tostring.argumentoutofrangeexception2.vb" id = "Snippet2"：：：

另请参阅

适用于

.NET 7 和其他版本

产品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0
Xamarin.iOS	10.8
Xamarin.Mac	3.0

本站仅提供存储服务，所有内容均由用户发布，如发现有害或侵权内容，请点击举报。