DateTimeFormatInfo.TimeSeparator Propiedad

Definición

Obtiene o establece la cadena que separa los componentes de una hora; es decir, la hora, los minutos y los 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 de propiedad

Cadena que separa los componentes de hora.The string that separates the components of time. El valor predeterminado de InvariantInfo es ":".The default for InvariantInfo is ":".

Excepciones

La propiedad se establece en null.The property is being set to null.

La propiedad está establecida y el objeto DateTimeFormatInfo es de solo lectura.The property is being set and the DateTimeFormatInfo object is read-only.

Ejemplos

En el ejemplo siguiente se crea una instancia de un objeto CultureInfo para la referencia cultural en-US, se cambia el separador de fecha a "." y se muestra una fecha con las cadenas de formato estándar "t", "T", "F", "f", "G" y "g".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

Comentarios

Si el patrón personalizado incluye el patrón de formato ":", DateTime.ToString muestra el valor de TimeSeparator en lugar de ":" en el patrón 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.

El separador de hora se deriva de la propiedad ShortTimePattern.The time separator is derived from the ShortTimePattern property. Se recomienda establecer el separador de hora en patrones de hora corto o largo en una cadena exacta en lugar de utilizar el marcador de posición del separador de hora.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 ejemplo, para obtener el patrón h-mm-SS, establezca el patrón en "h-mm-SS".For example, to obtain the pattern h-mm-ss, set the pattern to "h-mm-ss". Esta práctica también le permite establecer patrones como "h'h ' mm ' SS '" (3H 36m 12S) que incluyen varios 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. La propiedad TimeSeparator define la cadena que reemplaza el separador de hora (":" especificador de formato de fecha y hora personalizado) en una cadena de resultado en una operación de formato.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. También define la cadena de separador de hora en una operación de análisis.It also defines the time separator string in a parsing operation.

Se aplica a

Consulte también: