Export (0) Print
Expand All

DateTime.ToLongTimeString Method

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

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

Return Value

A string containing the name of the day of the week, the name of the month, the numeric day of the hours, minutes, and seconds equivalent to the time value of this instance.

Remarks

The value of this instance is formatted using the long time format character, 'T'. The return value is identical to the value returned by ToString ("T", 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 ToLongTimeString.

[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 | String | CultureInfo | DateTimeFormat | Calendar | DateTimeFormatInfo | ToString

Show:
© 2014 Microsoft