DateTimeFormatInfo.DateSeparator Property
Gets or sets the string that separates the components of a date, that is, the year, month, and day.
Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Property Value
Type: System.StringThe string that separates the components of a date, that is, the year, month, and day. The default for InvariantInfo is "/".
| Exception | Condition |
|---|---|
| ArgumentNullException | The property is being set to null. |
| InvalidOperationException | The property is being set and the DateTimeFormatInfo object is read-only. |
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.
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.
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
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
