DateTimeFormatInfo.TimeSeparator Propriedade

Definição

Espaço de Nomes:
System.Globalization
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll
Origem:
DateTimeFormatInfo.cs
Origem:
DateTimeFormatInfo.cs
Origem:
DateTimeFormatInfo.cs
Origem:
DateTimeFormatInfo.cs
Origem:
DateTimeFormatInfo.cs

Recebe ou define a sequência que separa os componentes do 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 de Propriedade

String

A corda que separa os componentes do tempo. O padrão para InvariantInfo é ":".

Exceções

ArgumentNullException

A propriedade está a ser definida para null.

InvalidOperationException

A propriedade está a ser definida e o DateTimeFormatInfo objeto é apenas de leitura.

Exemplos

O exemplo seguinte instancia um CultureInfo objeto para a cultura en-US, altera o seu separador de data para "." e apresenta uma data usando as cadeias de formatos padrão "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

Observações

Se o padrão personalizado incluir o padrão de formato ":", DateTime.ToString mostra o valor de TimeSeparator em vez do ":" no padrão de formato.

Note

Padrões de formato padrão, como FullDateTimePattern, não usam necessariamente ":". Mudar TimeSeparator pode não ter efeito ao usar estes padrões.

O separador temporal é derivado da ShortTimePattern propriedade. Recomendamos que defina o separador temporal em padrões de tempo curtos ou longos com uma string exata, em vez de usar o marcador temporal do separador. Por exemplo, para obter o padrão h-mm-ss, defina o padrão para "h-mm-ss". Esta prática também permite definir padrões como "h'h 'mm'm 'ss''s''" (3h 36m 12s) que incluem vários tipos de separadores. A TimeSeparator propriedade define a cadeia que substitui o separador temporal (":" especificador personalizado de formato de data e hora) numa cadeia de resultados numa operação de formatação. Também define a cadeia de separação temporal numa operação de análise sintática.

Aplica-se a

Ver também