DateTime.ToLongTimeString Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte o valor do atual objeto DateTime na representação de cadeia de caracteres de hora completa equivalente.
public:
System::String ^ ToLongTimeString();public string ToLongTimeString ();member this.ToLongTimeString : unit -> stringPublic Function ToLongTimeString () As StringRetornos
Uma cadeia de caracteres que contém a representação de cadeia de caracteres de hora completa do atual objeto DateTime.
Exemplos
O exemplo a seguir 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
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
Comentários
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 retornado especificando-se a cadeia de caracteres de formato de data e hora padrão "T" com o ToString(String) método.
Observação
A cadeia de caracteres retornada pelo ToLongTimeString método é sensível à cultura. Ele reflete o padrão definido pela propriedade da cultura atual DateTimeFormatInfo.LongTimePattern . Por exemplo, para a cultura en-US, o padrão de tempo longo padrão é "h:mm: SS TT"; para a cultura de-DE, é "HH: mm: SS"; para a cultura ja-JP, é "H:mm: SS". Observe que seu valor pode variar dependendo da implementação do .NET e de sua versão, do sistema operacional e de sua versão e da personalização do usuário.
Para obter mais informações sobre a cultura do thread atual, confira as propriedades CultureInfo.CurrentCulture e Thread.CurrentCulture. Para obter mais informações sobre caracteres, padrões de formatos e a saída que eles produzem, confira Cadeias de caracteres de formato padrão de data e hora e Cadeias de caracteres de formato personalizado de data e hora. Para obter mais informações sobre como alterar o padrão de formato associado a um caractere de formato, consulte a classe DateTimeFormatInfo.