Export (0) Print
Expand All

DateTime.ToLongTimeString Method

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.

Important noteImportant

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.

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

public class Sample 
{
   public static void Main() 
   {
      // Create an array of culture names.
      String[] names = { "en-US", "en-GB", "fr-FR", "de-DE" };
      // Initialize a DateTime object.
      DateTime dateValue = new System.DateTime(2013, 5, 28, 10, 30, 15);

      // Iterate the array of culture names. 
      foreach (var name in names) {
         // Change the culture of the current thread.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(name);
         // Display the name of the current culture and the date.
         Console.WriteLine("Current culture: {0}", CultureInfo.CurrentCulture.Name);
         Console.WriteLine("Date: {0:G}", dateValue);        

         // Display the long time pattern and the long time.
         Console.WriteLine("Long time pattern: '{0}'", 
                           DateTimeFormatInfo.CurrentInfo.LongTimePattern);
         Console.WriteLine("Long time with format string:     {0:T}", dateValue);
         Console.WriteLine("Long time with ToLongTimeString:  {0}\n", 
                           dateValue.ToLongTimeString());
      }
   }
}
// The example displays the following output: 
//       Current culture: en-US 
//       Date: 5/28/2013 10:30:15 AM 
//       Long time pattern: 'h:mm:ss tt' 
//       Long time with format string:     10:30:15 AM 
//       Long time with ToLongTimeString:  10:30:15 AM 
//        
//       Current culture: en-GB 
//       Date: 28/05/2013 10:30:15 
//       Long time pattern: 'HH:mm:ss' 
//       Long time with format string:     10:30:15 
//       Long time with ToLongTimeString:  10:30:15 
//        
//       Current culture: fr-FR 
//       Date: 28/05/2013 10:30:15 
//       Long time pattern: 'HH:mm:ss' 
//       Long time with format string:     10:30:15 
//       Long time with ToLongTimeString:  10:30:15 
//        
//       Current culture: de-DE 
//       Date: 28.05.2013 10:30:15 
//       Long time pattern: 'HH:mm:ss' 
//       Long time with format string:     10:30:15 
//       Long time with ToLongTimeString:  10:30:15

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft