Teilen über


DateTimeFormatInfo Klasse

Definition

Stellt kulturspezifische Informationen zum Format von Datums- und Uhrzeitwerten bereit.

public ref class DateTimeFormatInfo sealed : IFormatProvider
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider, System::Runtime::Serialization::ISerializable
public sealed class DateTimeFormatInfo : IFormatProvider
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
[System.Serializable]
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider, System.Runtime.Serialization.ISerializable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
type DateTimeFormatInfo = class
    interface IFormatProvider
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
[<System.Serializable>]
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
    interface ISerializable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider, ISerializable
Vererbung
DateTimeFormatInfo
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird Spiegelung verwendet, um die Eigenschaften des DateTimeFormatInfo-Objekts für die Englische Kultur (USA) abzurufen. Er zeigt den Wert dieser Eigenschaften an, die benutzerdefinierte Formatzeichenfolgen enthalten, und verwendet diese Zeichenfolgen, um formatierte Datumsangaben anzuzeigen.

using System;
using System.Globalization;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Get the properties of an en-US DateTimeFormatInfo object.
      DateTimeFormatInfo dtfi = CultureInfo.GetCultureInfo("en-US").DateTimeFormat;
      Type typ = dtfi.GetType();
      PropertyInfo[] props = typ.GetProperties();
      DateTime value = new DateTime(2012, 5, 28, 11, 35, 0);

      foreach (var prop in props) {
         // Is this a format pattern-related property?
         if (prop.Name.Contains("Pattern")) {
            string fmt = prop.GetValue(dtfi, null).ToString();
            Console.WriteLine("{0,-33} {1} \n{2,-37}Example: {3}\n",
                              prop.Name + ":", fmt, "",
                              value.ToString(fmt));
         }
      }
   }
}
// The example displays the following output:
//    FullDateTimePattern:              dddd, MMMM dd, yyyy h:mm:ss tt
//                                         Example: Monday, May 28, 2012 11:35:00 AM
//
//    LongDatePattern:                  dddd, MMMM dd, yyyy
//                                         Example: Monday, May 28, 2012
//
//    LongTimePattern:                  h:mm:ss tt
//                                         Example: 11:35:00 AM
//
//    MonthDayPattern:                  MMMM dd
//                                         Example: May 28
//
//    RFC1123Pattern:                   ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
//                                         Example: Mon, 28 May 2012 11:35:00 GMT
//
//    ShortDatePattern:                 M/d/yyyy
//                                         Example: 5/28/2012
//
//    ShortTimePattern:                 h:mm tt
//                                         Example: 11:35 AM
//
//    SortableDateTimePattern:          yyyy'-'MM'-'dd'T'HH':'mm':'ss
//                                         Example: 2012-05-28T11:35:00
//
//    UniversalSortableDateTimePattern: yyyy'-'MM'-'dd HH':'mm':'ss'Z'
//                                         Example: 2012-05-28 11:35:00Z
//
//    YearMonthPattern:                 MMMM, yyyy
//                                         Example: May, 2012
Imports System.Globalization
Imports System.Reflection

Module Example
   Public Sub Main()
      ' Get the properties of an en-US DateTimeFormatInfo object.
      Dim dtfi As DateTimeFormatInfo = CultureInfo.GetCultureInfo("en-US").DateTimeFormat
      Dim typ As Type = dtfi.GetType()
      Dim props() As PropertyInfo = typ.GetProperties()
      Dim value As Date = #05/28/2012 11:35AM# 
      
      For Each prop In props
         ' Is this a format pattern-related property?
         If prop.Name.Contains("Pattern") Then
            Dim fmt As String = CStr(prop.GetValue(dtfi, Nothing))
            Console.WriteLine("{0,-33} {1} {2}{3,-37}Example: {4}", 
                              prop.Name + ":", fmt, vbCrLf, "",
                              value.ToString(fmt)) 
            Console.WriteLine()
         End If
      Next
   End Sub
End Module
' The example displays the following output:
'    FullDateTimePattern:              dddd, MMMM dd, yyyy h:mm:ss tt
'                                         Example: Monday, May 28, 2012 11:35:00 AM
'    
'    LongDatePattern:                  dddd, MMMM dd, yyyy
'                                         Example: Monday, May 28, 2012
'    
'    LongTimePattern:                  h:mm:ss tt
'                                         Example: 11:35:00 AM
'    
'    MonthDayPattern:                  MMMM dd
'                                         Example: May 28
'    
'    RFC1123Pattern:                   ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
'                                         Example: Mon, 28 May 2012 11:35:00 GMT
'    
'    ShortDatePattern:                 M/d/yyyy
'                                         Example: 5/28/2012
'    
'    ShortTimePattern:                 h:mm tt
'                                         Example: 11:35 AM
'    
'    SortableDateTimePattern:          yyyy'-'MM'-'dd'T'HH':'mm':'ss
'                                         Example: 2012-05-28T11:35:00
'    
'    UniversalSortableDateTimePattern: yyyy'-'MM'-'dd HH':'mm':'ss'Z'
'                                         Example: 2012-05-28 11:35:00Z
'    
'    YearMonthPattern:                 MMMM, yyyy
'                                         Example: May, 2012

Hinweise

Weitere Informationen zu dieser API finden Sie unter Ergänzende API-Hinweise für DateTimeFormatInfo.

Konstruktoren

DateTimeFormatInfo()

Initialisiert eine neue schreibbare Instanz der DateTimeFormatInfo Klasse, die kulturunabhängig ist (invariant).

Eigenschaften

AbbreviatedDayNames

Dient zum Abrufen oder Festlegen eines eindimensionalen Arrays vom Typ String, das die kulturspezifischen abgekürzten Namen der Wochentage enthält.

AbbreviatedMonthGenitiveNames

Dient zum Abrufen oder Festlegen eines Zeichenfolgenarrays mit abgekürzten Monatsnamen, die dem aktuellen DateTimeFormatInfo -Objekt zugeordnet sind.

AbbreviatedMonthNames

Dient zum Abrufen oder Festlegen eines eindimensionalen Zeichenfolgenarrays, das die kulturspezifischen abgekürzten Namen der Monate enthält.

AMDesignator

Ruft den Zeichenfolgenentwurfsator für Stunden ab, die "ante meridiem" (vor Mittag) sind, oder legt diesen fest.

Calendar

Ruft den Kalender ab, der für die aktuelle Kultur verwendet werden soll, oder legt diesen fest.

CalendarWeekRule

Dient zum Abrufen oder Festlegen eines Werts, der angibt, welche Regel verwendet wird, um die erste Kalenderwoche des Jahres zu bestimmen.

CurrentInfo

Ruft ein schreibgeschütztes DateTimeFormatInfo-Objekt ab, das Werte basierend auf der aktuellen Kultur formatiert.

DateSeparator

Dient zum Abrufen oder Festlegen der Zeichenfolge, die die Komponenten eines Datums trennt, d. h. das Jahr, den Monat und den Tag.

DayNames

Dient zum Abrufen oder Festlegen eines eindimensionalen Zeichenfolgenarrays, das die kulturspezifischen vollständigen Namen der Wochentage enthält.

FirstDayOfWeek

Ruft den ersten Tag der Woche ab oder legt sie fest.

FullDateTimePattern

Dient zum Abrufen oder Festlegen der benutzerdefinierten Formatzeichenfolge für einen langen Datums- und long-Zeitwert.

InvariantInfo

Ruft das schreibgeschützte DateTimeFormatInfo Objekt ab, das kulturunabhängig ist (invariant).

IsReadOnly

Ruft einen Wert ab, der angibt, ob das DateTimeFormatInfo -Objekt schreibgeschützt ist.

LongDatePattern

Dient zum Abrufen oder Festlegen der benutzerdefinierten Formatzeichenfolge für einen langen Datumswert.

LongTimePattern

Dient zum Abrufen oder Festlegen der benutzerdefinierten Formatzeichenfolge für einen langen Zeitwert.

MonthDayPattern

Dient zum Abrufen oder Festlegen der benutzerdefinierten Formatzeichenfolge für einen Monat- und Tageswert.

MonthGenitiveNames

Dient zum Abrufen oder Festlegen eines Zeichenfolgenarrays von Monatsnamen, die dem aktuellen DateTimeFormatInfo -Objekt zugeordnet sind.

MonthNames

Dient zum Abrufen oder Festlegen eines eindimensionalen Arrays vom Typ String, das die kulturspezifischen vollständigen Namen der Monate enthält.

NativeCalendarName

Ruft den systemeigenen Namen des Kalenders ab, der dem aktuellen DateTimeFormatInfo -Objekt zugeordnet ist.

PMDesignator

Ruft den Zeichenfolgenentwurfsator für Stunden ab, die "post meridiem" (nach Mittag) sind, oder legt diesen fest.

RFC1123Pattern

Ruft die benutzerdefinierte Formatzeichenfolge für einen Zeitwert ab, der auf der Internet Engineering Task Force (IETF) Request for Comments (RFC) 1123-Spezifikation basiert.

ShortDatePattern

Dient zum Abrufen oder Festlegen der benutzerdefinierten Formatzeichenfolge für einen kurzen Datumswert.

ShortestDayNames

Dient zum Abrufen oder Festlegen eines Zeichenfolgenarrays der kürzesten eindeutigen abgekürzten Tagnamen, die dem aktuellen DateTimeFormatInfo -Objekt zugeordnet sind.

ShortTimePattern

Dient zum Abrufen oder Festlegen der benutzerdefinierten Formatzeichenfolge für einen kurzen Zeitwert.

SortableDateTimePattern

Ruft die benutzerdefinierte Formatzeichenfolge für einen sortierbaren Datums- und Uhrzeitwert ab.

TimeSeparator

Dient zum Abrufen oder Festlegen der Zeichenfolge, die die Komponenten der Zeit trennt, d. h. die Stunde, Minuten und Sekunden.

UniversalSortableDateTimePattern

Ruft die benutzerdefinierte Formatzeichenfolge für eine universelle, sortierbare Datums- und Uhrzeitzeichenfolge ab, wie durch ISO 8601 definiert.

YearMonthPattern

Dient zum Abrufen oder Festlegen der benutzerdefinierten Formatzeichenfolge für einen Jahres- und Monatswert.

Methoden

Clone()

Erstellt eine flache Kopie der DateTimeFormatInfo.

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetAbbreviatedDayName(DayOfWeek)

Gibt den kulturspezifischen abgekürzten Namen des angegebenen Wochentags basierend auf der Kultur zurück, die dem aktuellen DateTimeFormatInfo-Objekt zugeordnet ist.

GetAbbreviatedEraName(Int32)

Gibt die Zeichenfolge zurück, die den abgekürzten Namen der angegebenen Ära enthält, wenn eine Abkürzung vorhanden ist.

GetAbbreviatedMonthName(Int32)

Gibt den kulturspezifischen abgekürzten Namen des angegebenen Monats basierend auf der Kultur zurück, die dem aktuellen DateTimeFormatInfo-Objekt zugeordnet ist.

GetAllDateTimePatterns()

Gibt alle Standardmuster zurück, in denen Datums- und Uhrzeitwerte formatiert werden können.

GetAllDateTimePatterns(Char)

Gibt alle Muster zurück, in denen Datums- und Uhrzeitwerte mithilfe der angegebenen Standardformatzeichenfolge formatiert werden können.

GetDayName(DayOfWeek)

Gibt den kulturspezifischen vollständigen Namen des angegebenen Wochentags basierend auf der Kultur zurück, die dem aktuellen DateTimeFormatInfo -Objekt zugeordnet ist.

GetEra(String)

Gibt die ganze Zahl zurück, die die angegebene Ära darstellt.

GetEraName(Int32)

Gibt die Zeichenfolge zurück, die den Namen der angegebenen Ära enthält.

GetFormat(Type)

Gibt ein Objekt des angegebenen Typs zurück, das einen Datums- und Uhrzeitformatierungsdienst bereitstellt.

GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetInstance(IFormatProvider)

Gibt das dem angegebenen IFormatProviderzugeordnete DateTimeFormatInfo -Objekt zurück.

GetMonthName(Int32)

Gibt den kulturspezifischen vollständigen Namen des angegebenen Monats basierend auf der Kultur zurück, die dem aktuellen DateTimeFormatInfo -Objekt zugeordnet ist.

GetShortestDayName(DayOfWeek)

Ruft den kürzesten abgekürzten Tagnamen für einen angegebenen Wochentag ab, der dem aktuellen DateTimeFormatInfo -Objekt zugeordnet ist.

GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ReadOnly(DateTimeFormatInfo)

Gibt einen schreibgeschützten DateTimeFormatInfo Wrapper zurück.

SetAllDateTimePatterns(String[], Char)

Legt die benutzerdefinierten Datums- und Uhrzeitformatzeichenfolgen fest, die einer angegebenen Standardformatzeichenfolge entsprechen.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.

Gilt für:

Weitere Informationen