DateTime.ToLongTimeString Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Преобразует значение текущего объекта DateTime в эквивалентное ему длинное строковое представление времени.

public:
 System::String ^ ToLongTimeString();

public string ToLongTimeString ();

member this.ToLongTimeString : unit -> string

Public Function ToLongTimeString () As String

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

String

Строка, содержащая длинное строковое представление времени текущего объекта DateTime.

Примеры

В следующем примере демонстрируется ToLongTimeString метод.

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

open System
open System.Threading
open System.Globalization

// Create a list of culture names.
let names = [ "en-US"; "en-GB"; "fr-FR"; "de-DE" ]

// Initialize a DateTime object.
let dateValue = DateTime(2013, 5, 28, 10, 30, 15)

// Iterate the array of culture names.
for name in names do
    // Change the culture of the current thread.
    Thread.CurrentThread.CurrentCulture <- CultureInfo.CreateSpecificCulture name
    // Display the name of the current culture and the date.
    printfn $"Current culture: {CultureInfo.CurrentCulture.Name}"
    printfn $"Date: {dateValue:G}"

    // Display the long time pattern and the long time.
    printfn $"Long time pattern: '{DateTimeFormatInfo.CurrentInfo.LongTimePattern}'"
    printfn $"Long time with format string:     {dateValue:T}"
    printfn $"Long time with ToLongTimeString:  {dateValue.ToLongTimeString()}\n"


// 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 языком и региональными параметрами. Возвращаемое значение идентично значению, возвращаемого путем указания строки стандартного формата даты и времени T с ToString(String) помощью метода.

Примечание

Строка, возвращаемая методом ToLongTimeString , учитывает язык и региональные параметры. Он отражает шаблон, определенный свойством текущего языка и региональных параметров DateTimeFormatInfo.LongTimePattern . Например, для языка и региональных параметров en-US стандартный шаблон длительного времени — h:mm:ss tt; для языка и региональных параметров de-DE это "ЧЧ:мм:сс"; для языка и региональных параметров ja-JP это "Ч:мм:сс". Обратите внимание, что его значение может отличаться в зависимости от реализации .NET и ее версии, операционной системы и ее версии, а также настройки пользователя.

Дополнительные сведения о текущих языке и региональных параметрах потока см. в статьях о свойствах CultureInfo.CurrentCulture и Thread.CurrentCulture. Дополнительные сведения о символах и шаблонах формата, а также создаваемых ими выходных данных см. в статьях Строки стандартных форматов даты и времени и Строки настраиваемых форматов даты и времени. Дополнительные сведения об изменении шаблона формата, связанного с символом формата, см. в статье о классе DateTimeFormatInfo.

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

• CultureInfo
• DateTimeFormat
• DateTimeFormatInfo
• ToString()
• Типы форматирования в .NET
• Строки настраиваемых форматов даты и времени