DateTimeFormatInfo.TimeSeparator Eigenschaft

Definition

Ruft die Zeichenfolge ab, die die Bestandteile der Uhrzeit trennt, d. h. Stunde, Minuten und Sekunden, oder legt diese fest.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

Eigenschaftswert

Die Zeichenfolge, die die Bestandteile der Uhrzeit trennt.The string that separates the components of time. Die Standardeinstellung für InvariantInfo ist ":".The default for InvariantInfo is ":".

Ausnahmen

Die Eigenschaft wird auf null festgelegt.The property is being set to null.

Die Eigenschaft wird festgelegt, und das DateTimeFormatInfo-Objekt ist schreibgeschützt.The property is being set and the DateTimeFormatInfo object is read-only.

Beispiele

Im folgenden Beispiel wird ein CultureInfo-Objekt für die Kultur "en-US" instanziiert, das Datums Trennzeichen in "." geändert und ein Datum mithilfe der Standardformat Zeichenfolgen "t", "t", "f", "f", "g" und "g" angezeigt.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

Hinweise

Wenn das benutzerdefinierte Muster das Format Muster ":" enthält, zeigt DateTime.ToString den Wert TimeSeparator anstelle von ":" im Format Muster an.If the custom pattern includes the format pattern ":", DateTime.ToString displays the value of TimeSeparator in place of the ":" in the format pattern.

Das Zeit Trennzeichen wird von der ShortTimePattern-Eigenschaft abgeleitet.The time separator is derived from the ShortTimePattern property. Es wird empfohlen, das Zeit Trennzeichen in kurzen oder langen Zeit Mustern auf eine exakte Zeichenfolge festzulegen, anstatt den Platzhalter für Zeit Trennzeichen zu verwenden.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. Wenn Sie z. b. das Muster "h-mm-ss" abrufen möchten, legen Sie das Muster auf "h-mm-ss" fest.For example, to obtain the pattern h-mm-ss, set the pattern to "h-mm-ss". Mit dieser Vorgehensweise können Sie auch Muster wie z. b. "h' h ' mm es '" (3H 36M 12S) festlegen, die mehrere Trennzeichen Typen enthalten.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. Die TimeSeparator-Eigenschaft definiert die Zeichenfolge, die das Zeit Trennzeichen (":" benutzerdefinierter Format Bezeichner für Datum und Uhrzeit) in einer Ergebnis Zeichenfolge in einem Formatierungs Vorgang ersetzt.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. Außerdem wird die Zeit Trennzeichen-Zeichenfolge in einem Verarbeitungsvorgang definiert.It also defines the time separator string in a parsing operation.

Gilt für:

Siehe auch