DateTimeFormatInfo.TimeSeparator Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает строку, разделяющую компоненты времени, то есть час, минуты и секунды.
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
Значение свойства
Строка, разделяющая компоненты времени. Значение по умолчанию InvariantInfo — ":".
Исключения
Для свойства задано значение null.
Свойство задано, и 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's 'ss' (3h 36m 12s), которые включают несколько типов разделителей. Свойство TimeSeparator определяет строку, которая заменяет разделитель времени (":" настраиваемый описатель формата даты и времени) в результирующих строках в операции форматирования. Он также определяет строку разделителя времени в операции синтаксического анализа.