DateTimeFormatInfo.TimeSeparator Propriedade
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.
Obtém ou define a cadeia de caracteres que separa os componentes de tempo, ou seja, a hora, os minutos e os segundos.
public:
property System::String ^ TimeSeparator { System::String ^ get(); void set(System::String ^ value); };
public string TimeSeparator { get; set; }
member this.TimeSeparator : string with get, set
Public Property TimeSeparator As String
Valor da propriedade
A cadeia de caracteres que separa os componentes de tempo. O padrão para InvariantInfo é ":".
Exceções
A propriedade está sendo definida como null
.
A propriedade está sendo definida e o objeto DateTimeFormatInfo é somente leitura.
Exemplos
O exemplo a seguir instania um objeto para a cultura en-US, altera seu separador de data para "." e exibe uma data usando as cadeias de caracteres de formato padrão CultureInfo "t", "T", "F", "f", "G" e "g".
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
DateTime value = new DateTime(2013, 9, 8, 14, 30, 0);
string[] formats = { "t", "T", "f", "F", "G", "g" };
CultureInfo culture = CultureInfo.CreateSpecificCulture("en-US");
DateTimeFormatInfo dtfi = culture.DateTimeFormat;
dtfi.TimeSeparator = ".";
foreach (var fmt in formats)
Console.WriteLine("{0}: {1}", fmt, value.ToString(fmt, dtfi));
}
}
// The example displays the following output:
// t: 2.30 PM
// T: 2.30.00 PM
// f: Sunday, September 08, 2013 2.30 PM
// F: Sunday, September 08, 2013 2.30.00 PM
// G: 9/8/2013 2.30.00 PM
// g: 9/8/2013 2.30 PM
Imports System.Globalization
Module Example
Public Sub Main()
Dim value As New Date(2013, 9, 8, 14, 30, 0)
Dim formats() As String = { "t", "T", "f", "F", "G", "g" }
Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
Dim dtfi As DateTimeFormatInfo = culture.DateTimeFormat
dtfi.TimeSeparator = "."
For Each fmt In formats
Console.WriteLine("{0}: {1}", fmt, value.ToString(fmt, dtfi))
Next
End Sub
End Module
' The example displays the following output:
' t: 2.30 PM
' T: 2.30.00 PM
' f: Sunday, September 08, 2013 2.30 PM
' F: Sunday, September 08, 2013 2.30.00 PM
' G: 9/8/2013 2.30.00 PM
' g: 9/8/2013 2.30 PM
Comentários
Se o padrão personalizado incluir o padrão de formato ":", exibirá o valor de no lugar de DateTime.ToString TimeSeparator ":" no padrão de formato.
O separador de tempo é derivado da ShortTimePattern propriedade . É recomendável definir o separador de tempo em padrões de tempo curto ou longo como uma cadeia de caracteres exata em vez de usar o espaço reservado do separador de tempo. Por exemplo, para obter o padrão h-mm-ss, de definir o padrão como "h-mm-ss". Essa prática também permite definir padrões como "h'h 'mm'm'ss'" (3h 36m 12s) que incluem vários tipos de separadores. A propriedade define a cadeia de caracteres que substitui o separador de hora (":" especificador de formato de data e hora personalizado) em uma cadeia de caracteres de resultado em uma operação TimeSeparator de formatação. Ele também define a cadeia de caracteres do separador de tempo em uma operação de análise.