DateTimeFormatInfo.TimeSeparator Właściwość

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

System.Runtime.dll

Źródło:

DateTimeFormatInfo.cs

Pobiera lub ustawia ciąg, który oddziela składniki czasu, czyli godzinę, minuty i sekundy.

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

Wartość właściwości

String

Ciąg oddzielający składniki czasu. Wartość domyślna InvariantInfo to ":".

Wyjątki

ArgumentNullException

Właściwość jest ustawiana na null.

InvalidOperationException

Właściwość jest ustawiana, a DateTimeFormatInfo obiekt jest tylko do odczytu.

Przykłady

Poniższy przykład tworzy wystąpienie CultureInfo obiektu kultury en-US, zmienia separator daty na "." i wyświetla datę przy użyciu ciągów formatu standardowego "t", "T", "F", "f", "G" i "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

Uwagi

Jeśli wzorzec niestandardowy zawiera wzorzec formatu ":", DateTime.ToString wyświetla wartość TimeSeparator zamiast ":" we wzorcu formatu.

Uwaga

Standardowe wzorce formatów, takie jak FullDateTimePattern, nie muszą używać ciągu ":". Zmiana TimeSeparator może nie mieć wpływu na użycie tych wzorców.

Separator czasu pochodzi z ShortTimePattern właściwości . Zalecamy ustawienie separatora czasu w krótkich lub długich wzorcach czasu na dokładny ciąg zamiast używania symbolu zastępczego separatora czasu. Aby na przykład uzyskać wzorzec h-mm-ss, ustaw wzorzec na "h-mm-ss". Ta praktyka umożliwia również ustawianie wzorców, takich jak "h'h 'mm'm'ss's'" (3h 36m 12s), które zawierają wiele typów separatorów. Właściwość TimeSeparator definiuje ciąg, który zastępuje separator godziny (":" niestandardowy specyfikator formatu daty i godziny) w ciągu wynikowym w operacji formatowania. Definiuje również ciąg separatora czasu w operacji analizowania.

Zobacz też

• DateSeparator
• Niestandardowe ciągi formatu daty i godziny
• Standardowe ciągi formatu daty i godziny