DateTime::ToLongTimeString Method ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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

public:
String^ ToLongTimeString()

Return Value

Type: System::String^

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

The value of the current DateTime object is formatted using the pattern defined by the DateTimeFormatInfo::LongTimePattern property associated with the current thread culture. The return value is identical to the value returned by specifying the "T" standard date and time format string with the ToString(String^) method.

System_CAPS_importantImportant

The string returned by the ToLongTimeString method is culture-sensitive. It reflects the pattern defined by the LongTimePattern property of the current culture's DateTimeFormatInfo object. For example, for the en-US culture, the standard long time pattern is "h:mm:ss tt"; for the de-DE culture, it is "HH:mm:ss"; for the ja-JP culture, it is "H:mm:ss". The specific format string on a particular computer can also be customized so that it differs from the standard long time format string.

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 Types in the .NET Framework topic. For more information about changing the format pattern associated with a format character, see the DateTimeFormatInfo class.

The following example demonstrates the ToLongTimeString method.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: