DateTime.ToLongDateString 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将当前 DateTime 对象的值转换为其等效的长日期字符串表示形式。
public:
System::String ^ ToLongDateString();
public string ToLongDateString ();
member this.ToLongDateString : unit -> string
Public Function ToLongDateString () As String
返回
一个字符串,它包含当前 DateTime 对象的长日期字符串表示形式。
示例
下面的示例演示 ToLongDateString 方法。
using System;
using System.Globalization;
class Sample
{
public static void Main()
{
// Initialize a DateTime object.
Console.WriteLine("Initialize the DateTime object to May 16, 2001 3:02:15 AM.\n");
DateTime dateAndTime = new System.DateTime(2001, 5, 16, 3, 2, 15);
// Display the name of the current culture.
Console.WriteLine($"Current culture: \"{CultureInfo.CurrentCulture.Name}\"\n");
var dtfi = CultureInfo.CurrentCulture.DateTimeFormat;
// Display the long date pattern and string.
Console.WriteLine($"Long date pattern: \"{dtfi.LongDatePattern}\"");
Console.WriteLine($"Long date string: \"{dateAndTime.ToLongDateString()}\"\n");
// Display the long time pattern and string.
Console.WriteLine($"Long time pattern: \"{dtfi.LongTimePattern}\"");
Console.WriteLine($"Long time string: \"{dateAndTime.ToLongTimeString()}\"\n");
// Display the short date pattern and string.
Console.WriteLine($"Short date pattern: \"{dtfi.ShortDatePattern}\"");
Console.WriteLine($"Short date string: \"{dateAndTime.ToShortDateString()}\"\n");
// Display the short time pattern and string.
Console.WriteLine($"Short time pattern: \"{dtfi.ShortTimePattern}\"");
Console.WriteLine($"Short time string: \"{dateAndTime.ToShortTimeString()}\"\n");
}
}
// The example displays output similar to the following:
// Current culture: "en-US"
//
// Long date pattern: "dddd, MMMM d, yyyy"
// Long date string: "Wednesday, May 16, 2001"
//
// Long time pattern: "h:mm:ss tt"
// Long time string: "3:02:15 AM"
//
// Short date pattern: "M/d/yyyy"
// Short date string: "5/16/2001"
//
// Short time pattern: "h:mm tt"
// Short time string: "3:02 AM"
Imports System.Globalization
Module Example
Public Sub Main()
' Initialize a DateTime object.
Console.WriteLine($"Initialize the DateTime object to May 16, 2001 3:02:15 AM.{vbCrLf}")
Dim dateAndTime As New DateTime(2001, 5, 16, 3, 2, 15)
' Display the name of the current culture.
Console.WriteLine($"Current culture: ""{CultureInfo.CurrentCulture.Name}""{vbCrLf}")
Dim dtfi = CultureInfo.CurrentCulture.DateTimeFormat
' Display the long date pattern and string.
Console.WriteLine($"Long date pattern: ""{dtfi.LongDatePattern}""")
Console.WriteLine($"Long date string: ""{dateAndTime.ToLongDateString()}{vbCrLf}")
' Display the long time pattern and string.
Console.WriteLine($"Long time pattern: ""{0}""", dtfi.LongTimePattern)
Console.WriteLine($"Long time string: ""{dateAndTime.ToLongTimeString()}{vbCrLf}")
' Display the short date pattern and string.
Console.WriteLine($"Short date pattern: ""{dtfi.ShortDatePattern}""")
Console.WriteLine($"Short date string: ""{dateAndTime.ToShortDateString()}{vbCrLf}")
' Display the short time pattern and string.
Console.WriteLine($"Short time pattern: ""{dtfi.ShortTimePattern}""")
Console.WriteLine($"Short time string: ""{dateAndTime.ToShortTimeString()}{vbCrLf}")
End Sub
End Module
' The example displays output like the following:
' Initialize the DateTime object to May 16, 2001 3:02:15 AM.
'
' Current culture: "en-US"
'
' Long date pattern: "dddd, MMMM d, yyyy"
' Long date string: "Wednesday, May 16, 2001
'
' Long time pattern: "0"
' Long time string: "3:02:15 AM
'
' Short date pattern: "M/d/yyyy"
' Short date string: "5/16/2001
'
' Short time pattern: "h:mm tt"
' Short time string: "3:02 AM
注解
DateTime使用 LongDatePattern 与当前区域性关联的属性所定义的模式来设置当前对象的值的格式。 返回值与通过使用方法指定 "D" 标准 DateTime 格式字符串 返回的值相同 ToString(String) 。
备注
方法返回的字符串 ToLongDateString 是区分区域性的。 它反映由当前区域性的属性定义的模式 DateTimeFormatInfo.LongDatePattern 。 例如,对于 en-us 区域性,标准长日期模式通常为 "dddd,MMMM dd,yyyy";对于 de 消除区域性,它是 "dddd,d"。 MMMM yyyy ";对于 ja-jp 区域性,为 "yyyy" 年 "月" 日 ""。 请注意,根据 .NET 实现及其版本、操作系统及其版本和用户自定义情况,其值会有所不同。
有关当前线程区域性的详细信息,请参阅 CultureInfo.CurrentCulture 和 Thread.CurrentCulture 属性。 有关格式字符、格式模式以及它们生成的输出的详细信息,请参阅标准日期和时间格式字符串和自定义日期和时间格式字符串。 有关更改与格式字符相关的格式模式的详细信息,请参阅 DateTimeFormatInfo 类。