DateTime.ToLongTimeString Метод

Определение

Преобразует значение текущего объекта DateTime в эквивалентное ему длинное строковое представление времени.Converts the value of the current DateTime object to its equivalent long time string representation.

public:
 System::String ^ ToLongTimeString();
public string ToLongTimeString ();
member this.ToLongTimeString : unit -> string
Public Function ToLongTimeString () As String

Возвращаемое значение

String

Строка, содержащая длинное строковое представление времени текущего объекта DateTime.A string that contains the long time string representation of the current DateTime object.

Примеры

В следующем примере демонстрируется ToLongTimeString метод.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
Imports System.Threading
Imports System.Globalization

Public Class Example
   Public Shared Sub Main() 
      ' Create an array of culture names.
      Dim names() As String = { "en-US", "en-GB", "fr-FR", "de-DE" }
      ' Initialize a DateTime object.
      Dim dateValue As New DateTime(2013, 5, 28, 10, 30, 15)
        
      ' Iterate the array of culture names.
      For Each 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}", dateValue.ToLongTimeString())
         Console.WriteLine()
      Next
   End Sub 
End Class 
' 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

Комментарии

Значение текущего DateTime объекта форматируется с использованием шаблона, определенного DateTimeFormatInfo.LongTimePattern свойством, связанным с языком и региональными параметрами текущего потока.The value of the current DateTime object is formatted using the pattern defined by the DateTimeFormatInfo.LongTimePattern property associated with the current thread culture. Возвращаемое значение идентично значению, возвращаемому при указании строки "T" стандартного формата даты и времени с помощью ToString(String) метода.The return value is identical to the value returned by specifying the "T" standard date and time format string with the ToString(String) method.

Примечание

Строка, возвращаемая ToLongTimeString методом, зависит от языка и региональных параметров.The string returned by the ToLongTimeString method is culture-sensitive. Он отражает шаблон, определенный свойством текущего языка и региональных параметров DateTimeFormatInfo.LongTimePattern .It reflects the pattern defined by the current culture's DateTimeFormatInfo.LongTimePattern property. Например, для языка и региональных параметров en-US стандартный длинный шаблон времени — «ч: СС TT»; для региональных параметров de-DE это "чч: мм: СС"; для языка и региональных параметров ja-JP это "ч: СС".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". Обратите внимание, что его значение может изменяться в зависимости от реализации .NET и ее версии, операционной системы и ее версии, а также пользовательской настройки.Note that its value can vary depending on the .NET implementation and its version, the operating system and its version, and user customization.

Дополнительные сведения о текущих языке и региональных параметрах потока см. в статьях о свойствах CultureInfo.CurrentCulture и Thread.CurrentCulture.For more information about the current thread culture, see the CultureInfo.CurrentCulture and Thread.CurrentCulture properties. Дополнительные сведения о символах и шаблонах формата, а также создаваемых ими выходных данных см. в статьях Строки стандартных форматов даты и времени и Строки настраиваемых форматов даты и времени.For more information about format characters, format patterns, and the output they produce, see Standard date and time format strings and Custom date and time format strings. Дополнительные сведения об изменении шаблона формата, связанного с символом формата, см. в статье о классе DateTimeFormatInfo.For more information about changing the format pattern associated with a format character, see the DateTimeFormatInfo class.

Применяется к

См. также раздел