DateTimeFormatInfo.DateSeparator Propriedade

Definição

Obtém ou define a sequência que separa os componentes de uma data, ou seja, o ano, o mês e o dia.

public:
 property System::String ^ DateSeparator { System::String ^ get(); void set(System::String ^ value); };
public string DateSeparator { get; set; }
member this.DateSeparator : string with get, set
Public Property DateSeparator As String

Valor de Propriedade

A corda que separa os componentes de uma data, ou seja, o ano, o mês e o dia. O padrão para InvariantInfo é "/".

Exceções

A propriedade está a ser definida para null.

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 "d", "G" e "g".

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      DateTime value = new DateTime(2013, 9, 8);

      string[] formats = { "d", "G", "g" };
      CultureInfo culture = CultureInfo.CreateSpecificCulture("en-US");
      DateTimeFormatInfo dtfi = culture.DateTimeFormat;
      dtfi.DateSeparator = "-";

      foreach (var fmt in formats)
         Console.WriteLine("{0}: {1}", fmt, value.ToString(fmt, dtfi));
   }
}
// The example displays the following output:
//       d: 9-8-2013
//       G: 9-8-2013 12:00:00 AM
//       g: 9-8-2013 12:00 AM
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As New Date(2013, 9, 8)
      
      Dim formats() As String = { "d", "G", "g" }
      Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
      Dim dtfi As DateTimeFormatInfo = culture.DateTimeFormat
      dtfi.DateSeparator = "-"
      
      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:
'       d: 9-8-2013
'       G: 9-8-2013 12:00:00 AM
'       g: 9-8-2013 12:00 AM

Observações

Se uma cadeia de formato personalizada incluir o especificador de formato "/", o DateTime.ToString método mostra o valor de DateSeparator em vez do "/" na cadeia de resultados.

A DateSeparator propriedade define a cadeia que substitui o separador de data ("/" especificador de formato personalizado de data e hora) numa cadeia de resultados numa operação de formatação. Também define a cadeia de separação de data numa operação de análise sintática.

Aplica-se a

Ver também