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)

Public Property DateSeparator As String

Property Value

Type: System.String

The 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.

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

.NET Framework
Available since 1.1
Return to top
Show: