DateTimeFormatInfo.DateSeparator Propriedade

  • Referência

Definição

Namespace:
System.Globalization
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

Define a cadeia de caracteres que separa a os componentes de uma data, ou seja, o ano, mês e 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 da propriedade

String

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

Exceções

ArgumentNullException

A propriedade está sendo definida como null.

InvalidOperationException

A propriedade está sendo definida e o objeto DateTimeFormatInfo é somente leitura.

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 "d", "g" e "g" padrão.

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

Comentários

Se uma cadeia de caracteres de formato personalizado incluir o especificador de formato "/", o DateTime.ToString método exibirá o valor de DateSeparator no lugar do "/" na cadeia de caracteres de resultado.

A DateSeparator propriedade define a cadeia de caracteres que substitui o separador de data (especificador de formato de data e hora personalizado) em uma cadeia de caracteres de resultado em uma operação de formatação. Ele também define a cadeia de caracteres de separador de data em uma operação de análise.

Aplica-se a

Confira também