DateTimeFormatInfo.DateSeparator Свойство

Определение

Пространство имен:

System.Globalization

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

DateTimeFormatInfo.cs

Возвращает или задает строку, разделяющую компоненты даты, то есть год, месяц и день.

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

Значение свойства

String

Строка, разделяющая компоненты даты, то есть год, месяц и день. Значение по умолчанию InvariantInfo — "/".

Исключения

ArgumentNullException

Для свойства задано значение null.

InvalidOperationException

Свойство задано, и DateTimeFormatInfo объект доступен только для чтения.

Примеры

В следующем примере создается CultureInfo экземпляр объекта для языка и региональных параметров en-US, изменяется разделитель даты на "-" и отображается дата с помощью строк стандартного формата "d", "G" и "g".

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

Комментарии

Если строка настраиваемого формата содержит описатель формата "/", DateTime.ToString метод отображает значение DateSeparator вместо "/" в результирующем строке.

Свойство DateSeparator определяет строку, которая заменяет разделитель даты ("/" настраиваемый описатель формата даты и времени) в результирующих строках в операции форматирования. Он также определяет строку разделителя дат в операции синтаксического анализа.

См. также раздел

• TimeSeparator
• Настраиваемые строки формата даты и времени
• Стандартные строки формата даты и времени