Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
This topic has not yet been rated - Rate this topic

DateTime.ToLongDateString Method

Converts the value of this instance to its equivalent long date string representation.

[Visual Basic]
Public Function ToLongDateString() As String
[C#]
public string ToLongDateString();
[C++]
public: String* ToLongDateString();
[JScript]
public function ToLongDateString() : String;

Return Value

A string containing the name of the day of the week, the name of the month, the numeric day of the month, and the year equivalent to the date value of this instance.

Remarks

The value of this instance is formatted using the long date format character, 'D'. The return value is identical to the value returned by ToString ("D", null).

For more information about format characters, format patterns, and the output they produce, see the Formatting Overview topic. For more information about changing the format pattern associated with a format character see the DateTimeFormatInfo class.

This method uses formatting information derived from the current culture. For more information about the current culture, see the CurrentCulture class. You can use the CultureInfo.DateTimeFormat property to obtain the DateTimeFormatInfo for the current culture.

Example

[Visual Basic, C#, C++] The following sample demonstrates ToLongDateString.

[Visual Basic] 
Dim dTime As New System.DateTime(2001, 5, 16, 3, 2, 15)

' If the current culture is "en-US",
' longDateString gets "Wednesday, May 16, 2001"
Dim longDateString As String
longDateString = dTime.ToLongDateString()

' If the current culture is "en-US",
' longTimeString gets "3:02:15 AM"
Dim longTimeString As String
longTimeString = dTime.ToLongTimeString()

[C#] 
System.DateTime dTime = new System.DateTime(2001, 5, 16, 3, 2, 15);

// If the current culture is "en-US",
// longDateString gets "Wednesday, May 16, 2001"
string longDateString = dTime.ToLongDateString();

// If the current culture is "en-US",
// longTimeString gets "3:02:15 AM"
string longTimeString = dTime.ToLongTimeString();            

[C++] 
System::DateTime dTime = System::DateTime(2001, 5, 16, 3, 2, 15);

// If the current culture is "en-US",
// longDateString gets "Wednesday, May 16, 2001"
String* longDateString = dTime.ToLongDateString();

// If the current culture is "en-US",
// longTimeString gets "3:02:15 AM"
String* longTimeString = dTime.ToLongTimeString();            

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

DateTime Structure | DateTime Members | System Namespace | Formatting Overview | CultureInfo | DateTimeFormat | DateTimeFormatInfo | ToString

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.