DateTimeFormatInfo.TimeSeparator Eigenschaft

  • Referenz

Definition

Namespace:
System.Globalization
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
DateTimeFormatInfo.cs
Quelle:
DateTimeFormatInfo.cs
Quelle:
DateTimeFormatInfo.cs

Ruft die Zeichenfolge ab, die die Bestandteile der Uhrzeit trennt, d. h. Stunde, Minuten und Sekunden, oder legt diese fest.

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

String

Die Zeichenfolge, die die Bestandteile der Uhrzeit trennt. Die Standardeinstellung für InvariantInfo ist ":".

Ausnahmen

ArgumentNullException

Die Eigenschaft wird auf null festgelegt.

InvalidOperationException

Die Eigenschaft wird festgelegt, und das DateTimeFormatInfo-Objekt ist schreibgeschützt.

Beispiele

Im folgenden Beispiel wird ein CultureInfo Objekt für die Kultur en-US instanziiert, das Datumstrennzeichen in "." geändert und ein Datum mithilfe der Standardformatzeichenfolgen "t", "T", "F", "f", "G" und "g" angezeigt.

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 Formatmuster ":" enthält, DateTime.ToString zeigt den Wert von TimeSeparator anstelle von ":" im Formatmuster an.

Hinweis

Standardformatmuster wie FullDateTimePatternverwenden nicht unbedingt ":". Änderungen TimeSeparator haben möglicherweise keine Auswirkungen, wenn diese Muster verwendet werden.

Das Zeittrennzeichen wird von der ShortTimePattern -Eigenschaft abgeleitet. Es wird empfohlen, das Zeittrennzeichen in kurzen oder langen Zeitmustern auf eine genaue Zeichenfolge festzulegen, anstatt den Zeittrennzeichenplatzhalter zu verwenden. Um beispielsweise das Muster h-mm-ss zu erhalten, legen Sie das Muster auf "h-mm-ss" fest. Diese Vorgehensweise ermöglicht es Ihnen auch, Muster wie "h'h 'mm'm 'ss's'" (3h 36m 12s) festzulegen, die mehrere Typen von Trennzeichen enthalten. Die TimeSeparator -Eigenschaft definiert die Zeichenfolge, die das Zeittrennzeichen (":" benutzerdefinierter Formatbezeichner für Datum und Uhrzeit) in einer Ergebniszeichenfolge in einem Formatierungsvorgang ersetzt. Außerdem wird die Zeittrennzeichenzeichenfolge in einem Analysevorgang definiert.

Gilt für:

Weitere Informationen