DateTimeFormatInfo.TimeSeparator Свойство

Определение

Возвращает или задает строку, разделяющую компоненты времени — час, минуты и секунды.Gets or sets the string that separates the components of time, that is, the hour, minutes, and seconds.

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

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

Строка, разделяющая компоненты времени.The string that separates the components of time. Значение по умолчанию для объекта InvariantInfo равно ":".The default for InvariantInfo is ":".

Исключения

Для свойства задается значение null.The property is being set to null.

Для свойства задается значение, а объект DateTimeFormatInfo доступен только для чтения.The property is being set and the DateTimeFormatInfo object is read-only.

Примеры

В следующем примере создается CultureInfo объект для языка и региональных параметров en-US, изменяется его разделитель дат на "." и отображается дата с использованием строк стандартного формата "t", "t", "f", "f", "g" и "g".The following example instantiates a CultureInfo object for the en-US culture, changes its date separator to ".", and displays a date by using the "t", "T", "F", "f", "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, 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 значение вместо ":".If the custom pattern includes the format pattern ":", DateTime.ToString displays the value of TimeSeparator in place of the ":" in the format pattern.

Разделитель времени является производным от ShortTimePattern свойства.The time separator is derived from the ShortTimePattern property. Рекомендуется задать для разделителя времени в коротком или длинном шаблоне точное строковое значение вместо использования заполнителя разделителя времени.We recommend that you set the time separator in short or long time patterns to an exact string instead of using the time separator placeholder. Например, чтобы получить шаблон h-mm-ss, задайте для шаблона значение "h-mm-ss".For example, to obtain the pattern h-mm-ss, set the pattern to "h-mm-ss". Эта практика также позволяет задать такие шаблоны, как "х'х" mm "SS" (3h 36m 12S), которые включают несколько типов разделителей.This practice also enables you to set patterns such as "h'h 'mm'm 'ss's'" (3h 36m 12s) that include multiple types of separators. TimeSeparator Свойство определяет строку, которая заменяет разделитель времени (":" настраиваемый описатель формата даты и времени) в результирующей строке в операции форматирования.The TimeSeparator property defines the string that replaces the time separator (":" custom date and time format specifier) in a result string in a formatting operation. Он также определяет строку разделителя времени в операции синтаксического анализа.It also defines the time separator string in a parsing operation.

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

Дополнительно