DateTime.ToLongTimeString DateTime.ToLongTimeString DateTime.ToLongTimeString DateTime.ToLongTimeString Method

定义

将当前 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

返回

一个字符串,它包含当前 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. 返回值与通过使用ToString(String)方法指定 "T"标准日期和时间格式字符串返回的值相同。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 区域性,标准长时间模式为 "h:mm: ss tt";对于取消操作,它是 "HH: mm: ss";对于 ja-jp 区域性,它是 "H:mm: ss"。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.CurrentCultureThread.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.

适用于

另请参阅