DateTimeFormatInfo.TimeSeparator Свойство

  • Ссылка

Определение

Пространство имен:
System.Globalization
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
DateTimeFormatInfo.cs
Исходный код:
DateTimeFormatInfo.cs
Исходный код:
DateTimeFormatInfo.cs

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

public:
 property System::String ^ TimeSeparator { System::String ^ get(); void set(System::String ^ value); };
public string TimeSeparator { get; set; }
member this.TimeSeparator : string with get, set
Public Property TimeSeparator As String

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

String

Строка, разделяющая компоненты времени. Значение по умолчанию для объекта InvariantInfo равно ":".

Исключения

ArgumentNullException

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

InvalidOperationException

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

Примеры

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

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      DateTime value = new DateTime(2013, 9, 8, 14, 30, 0);

      string[] formats = { "t", "T", "f", "F", "G", "g" };
      CultureInfo culture = CultureInfo.CreateSpecificCulture("en-US");
      DateTimeFormatInfo dtfi = culture.DateTimeFormat;
      dtfi.TimeSeparator = ".";

      foreach (var fmt in formats)
         Console.WriteLine("{0}: {1}", fmt, value.ToString(fmt, dtfi));
   }
}
// The example displays the following output:
//       t: 2.30 PM
//       T: 2.30.00 PM
//       f: Sunday, September 08, 2013 2.30 PM
//       F: Sunday, September 08, 2013 2.30.00 PM
//       G: 9/8/2013 2.30.00 PM
//       g: 9/8/2013 2.30 PM

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As New Date(2013, 9, 8, 14, 30, 0)
      
      Dim formats() As String = { "t", "T", "f", "F", "G", "g" }
      Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
      Dim dtfi As DateTimeFormatInfo = culture.DateTimeFormat
      dtfi.TimeSeparator = "."
      
      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:
'       t: 2.30 PM
'       T: 2.30.00 PM
'       f: Sunday, September 08, 2013 2.30 PM
'       F: Sunday, September 08, 2013 2.30.00 PM
'       G: 9/8/2013 2.30.00 PM
'       g: 9/8/2013 2.30 PM

Комментарии

Если пользовательский шаблон содержит шаблон формата ":", DateTime.ToString в шаблоне формата отображается значение TimeSeparator вместо ":".

Примечание

Шаблоны стандартного формата, такие как FullDateTimePattern, не обязательно используют ":". Изменение TimeSeparator может не повлиять на использование этих шаблонов.

Разделитель времени является производным ShortTimePattern от свойства . Рекомендуется задать для разделителя времени в коротких или длинных шаблонах времени точную строку, а не использовать заполнитель разделителя времени. Например, чтобы получить шаблон h-mm-ss, задайте для шаблона значение "h-mm-ss". Эта практика также позволяет задать такие шаблоны, как "h'h 'mm'm 's's' (3h 36m 12s), которые включают несколько типов разделителей. Свойство TimeSeparator определяет строку, которая заменяет разделитель времени (":" настраиваемый описатель формата даты и времени) в результирующей строке в операции форматирования. Он также определяет строку разделителя времени в операции синтаксического анализа.

Применяется к

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