DateTime.ToLongTimeString 方法

定義

命名空間:

System

組件:

System.Runtime.dll

組件:

netstandard.dll

組件:

mscorlib.dll

將目前 DateTime 物件的值轉換為其相等的完整時間 (Long Time) 字串表示。

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

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 刪除文化特性，則為 "HH： mm： ss";若是 ja-jp 文化特性，則為 "H:mm： ss"。 請注意，其值可能會隨著 .NET 的執行及其版本、作業系統及其版本以及使用者自訂而有所不同。

如需有關目前執行緒文化特性的詳細資訊，請參閱 CultureInfo.CurrentCulture 與 Thread.CurrentCulture 屬性。 如需有關格式字元以及其產生之輸出的詳細資訊，請參閱標準日期和時間格式字串與自訂日期和時間格式字串。 如需有關變更與格式字元關聯之格式樣式的詳細資訊，請參閱 DateTimeFormatInfo 類別。

另請參閱

• CultureInfo
• DateTimeFormat
• DateTimeFormatInfo
• ToString()
• 在 .NET 中將類型格式化
• 自訂日期和時間格式字串