DateTimeFormatInfo.TimeSeparator DateTimeFormatInfo.TimeSeparator DateTimeFormatInfo.TimeSeparator DateTimeFormatInfo.TimeSeparator Property

Definição

Obtém ou define a cadeia de caracteres que separa os componentes de tempo, ou seja, a hora, os minutos e os segundos.Gets or sets the string that separates the components of time, that is, the hour, minutes, and seconds.

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.The string that separates the components of time. O padrão para InvariantInfo é ":".The default for InvariantInfo is ":".

Exceções

A propriedade está sendo definida como null.The property is being set to null.

A propriedade está sendo definida e o objeto DateTimeFormatInfo é somente leitura.The property is being set and the DateTimeFormatInfo object is read-only.

Exemplos

O exemplo a seguir instancia um CultureInfo objeto para a cultura en-US, altera seu separador de data para "." e exibe uma data usando as cadeias de caracteres de formato "t", "t", "f", "f", "g" e "g" padrão.The following example instantiates a CultureInfo object for the en-US culture, changes its date separator to ".", and displays a date by using the "t", "T", "F", "f", "G", and "g" standard format strings.

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 ":" DateTime.ToString , o exibirá TimeSeparator o valor em vez de ":" no padrão de formato.If the custom pattern includes the format pattern ":", DateTime.ToString displays the value of TimeSeparator in place of the ":" in the format pattern.

O separador de tempo é ShortTimePattern derivado da propriedade.The time separator is derived from the ShortTimePattern property. Recomendamos que você defina o separador de tempo em padrões de tempo curto ou longo para uma cadeia de caracteres exata em vez de usar o espaço reservado de separador de tempo.We recommend that you set the time separator in short or long time patterns to an exact string instead of using the time separator placeholder. Por exemplo, para obter o padrão h-mm-SS, defina o padrão como "h-mm-ss".For example, to obtain the pattern h-mm-ss, set the pattern to "h-mm-ss". Essa prática também permite que você defina padrões como "h'h ' mm ' ss ' s '" (3h 36m 12s) que incluem vários tipos de separadores.This practice also enables you to set patterns such as "h'h 'mm'm 'ss's'" (3h 36m 12s) that include multiple types of separators. A TimeSeparator propriedade define a cadeia de caracteres que substitui o separador de tempo (":" personalizado data e o especificador de formato de hora) em uma cadeia de caracteres de resultado em uma operação de formatação.The TimeSeparator property defines the string that replaces the time separator (":" custom date and time format specifier) in a result string in a formatting operation. Ele também define a cadeia de caracteres de separador de tempo em uma operação de análise.It also defines the time separator string in a parsing operation.

Aplica-se a

Veja também