DateTimeFormatInfo.DateSeparator Property

Definition

Gets or sets the string that separates the components of a date, that is, the year, month, and day.

C#
public string DateSeparator { get; set; }

Property Value

The string that separates the components of a date, that is, the year, month, and day. The default for InvariantInfo is "/".

Exceptions

The property is being set to null.

The property is being set and the DateTimeFormatInfo object is read-only.

Examples

The following example instantiates a CultureInfo object for the en-US culture, changes its date separator to "-", and displays a date by using the "d", "G", and "g" standard format strings.

C#
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

Remarks

If a custom format string includes the "/" format specifier, the DateTime.ToString method displays the value of DateSeparator in place of the "/" in the result string.

The DateSeparator property defines the string that replaces the date separator ("/" custom date and time format specifier) in a result string in a formatting operation. It also defines the date separator string in a parsing operation.

Applies to

Product Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

See also