DateTime.ToLongTimeString Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Converte o valor do objeto atual DateTime para a sua representação equivalente de cordas de longo prazo.
public:
System::String ^ ToLongTimeString();
public string ToLongTimeString();
member this.ToLongTimeString : unit -> string
Public Function ToLongTimeString () As String
Devoluções
Uma cadeia que contém a representação da cadeia de longo tempo do objeto atual DateTime .
Exemplos
O exemplo seguinte demonstra o ToLongTimeString método.
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
Observações
O valor do objeto atual DateTime é formatado usando o padrão definido pela DateTimeFormatInfo.LongTimePattern propriedade associada à cultura atual. O valor de retorno é idêntico ao valor devolvido ao especificar a cadeia de formato padrão "T" de data e hora com o ToString(String) método.
Note
A corda devolvida pelo ToLongTimeString método é sensível à cultura. Reflete o padrão definido pela propriedade da DateTimeFormatInfo.LongTimePattern cultura atual. Por exemplo, para a cultura en-US, o padrão de tempo longo é "h:mm:ss tt"; para a cultura de-DE, é "HH:mm:ss"; para a cultura ja-JP, é "H:mm:ss". Note-se que o seu valor pode variar dependendo da implementação do .NET e da sua versão, do sistema operativo e da sua versão, e da personalização do utilizador.
Para mais informações sobre a cultura atual do tópico, consulte as CultureInfo.CurrentCulture propriedades e Thread.CurrentCulture . Para mais informações sobre caracteres de formato, padrões de formato e a saída que produzem, consulte cadeias de formato padrão de data e hora e cadeias de formatos personalizados de data e hora. Para mais informações sobre a alteração do padrão de formato associado a um carácter de formato, consulte a DateTimeFormatInfo classe.