DateTime.ToLongTimeString 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将当前 DateTime 对象的值转换为其等效的长时间字符串表示形式。
public:
System::String ^ ToLongTimeString();
public string ToLongTimeString ();
member this.ToLongTimeString : unit -> string
Public Function ToLongTimeString () As 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";对于取消操作,它是 "HH: mm: ss";对于 ja-jp 区域性,它是 "H:mm: ss"。 请注意,根据 .NET 实现及其版本、操作系统及其版本和用户自定义情况,其值会有所不同。
有关当前线程区域性的详细信息,请参阅 CultureInfo.CurrentCulture 和 Thread.CurrentCulture 属性。 有关格式字符、格式模式以及它们生成的输出的详细信息,请参阅标准日期和时间格式字符串和自定义日期和时间格式字符串。 有关更改与格式字符相关的格式模式的详细信息,请参阅 DateTimeFormatInfo 类。