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.

DateTime.ToLongDateString Method

Converts the value of the current DateTime object to its equivalent long date string representation.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public string ToLongDateString ()
public String ToLongDateString ()
public function ToLongDateString () : String
Not applicable.

Return Value

A string that contains the long date string representation of the current DateTime object.

The value of the current DateTime object is formatted using the long date format character, 'D'. The long date format character represents the pattern defined by the LongDatePattern property associated with the current thread culture. The return value is identical to the value returned by specifying the "D" standard DateTime format string with the ToString(String) method.

For more information about the current thread culture, see the CurrentCulture property. 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.

The following code example demonstrates the ToLongDateString method.

// This code example demonstrates the DateTime.ToLongDateString(),
// DateTime.ToLongTimeString(), DateTime.ToShortDateString(), and
// DateTime.ToShortTimeString() methods.

using System;
using System.Threading;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
    string msg1 = "The date and time patterns are defined in the DateTimeFormatInfo \n" +
                  "object associated with the current thread culture.\n";

// Initialize a DateTime object.
    Console.WriteLine("Initialize the DateTime object to May 16, 2001 3:02:15 AM.\n");
    DateTime myDateTime = new System.DateTime(2001, 5, 16, 3, 2, 15);

// Identify the source of the date and time patterns.
    Console.WriteLine(msg1);

// Display the name of the current culture.
    CultureInfo ci = Thread.CurrentThread.CurrentCulture;
    Console.WriteLine("Current culture: \"{0}\"\n", ci.Name);

// Display the long date pattern and string.
    Console.WriteLine("Long date pattern: \"{0}\"", ci.DateTimeFormat.LongDatePattern);
    Console.WriteLine("Long date string:  \"{0}\"\n", myDateTime.ToLongDateString());

// Display the long time pattern and string.
    Console.WriteLine("Long time pattern: \"{0}\"", ci.DateTimeFormat.LongTimePattern);
    Console.WriteLine("Long time string:  \"{0}\"\n", myDateTime.ToLongTimeString());

// Display the short date pattern and string.
    Console.WriteLine("Short date pattern: \"{0}\"", ci.DateTimeFormat.ShortDatePattern);
    Console.WriteLine("Short date string:  \"{0}\"\n", myDateTime.ToShortDateString());

// Display the short time pattern and string.
    Console.WriteLine("Short time pattern: \"{0}\"", ci.DateTimeFormat.ShortTimePattern);
    Console.WriteLine("Short time string:  \"{0}\"\n", myDateTime.ToShortTimeString());
    }
}

/*
This code example produces the following results:

Initialize the DateTime object to May 16, 2001 3:02:15 AM

The date and time patterns are defined in the DateTimeFormatInfo
object associated with the current thread culture.

Current culture: "en-US"

Long date pattern: "dddd, MMMM dd, 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"

*/

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

Show:
© 2014 Microsoft