DateTimeFormatInfo.DateSeparator Property
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the string that separates the components of a date, that is, the year, month, and day.
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
The string that separates the components of a date, that is, the year, month, and day. The default for InvariantInfo is "/".
The property is being set to null
.
The property is being set and the DateTimeFormatInfo object is read-only.
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
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
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.
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 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: