DateTimeFormatInfo.TimeSeparator Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Globalization
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll
Source:
DateTimeFormatInfo.cs
Source:
DateTimeFormatInfo.cs
Source:
DateTimeFormatInfo.cs

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

String

Cadena que separa los componentes de hora. El valor predeterminado de InvariantInfo es ":".

Excepciones

ArgumentNullException

La propiedad se establece en null.

InvalidOperationException

La propiedad se está estableciendo y el objeto DateTimeFormatInfo es de solo lectura.

Ejemplos

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

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.

Nota

Los patrones de formato estándar, como FullDateTimePattern, no usan necesariamente ":". Es posible que el cambio TimeSeparator no tenga ningún efecto al usar estos patrones.

El separador de tiempo se deriva de la ShortTimePattern propiedad . Se recomienda establecer el separador de tiempo en patrones de tiempo corto o largo en una cadena exacta en lugar de usar el marcador de posición separador de hora. Por ejemplo, para obtener el patrón h-mm-ss, establezca el patrón en "h-mm-ss". Esta práctica también permite establecer patrones como "h'h 'mm'm 'ss's's' (3h 36m 12s) que incluyen varios tipos de separadores. La TimeSeparator propiedad 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. También define la cadena de separador de tiempo en una operación de análisis.

Se aplica a

Consulte también