DateTimeFormatInfo Klasse

Definition

Stellt kulturabhängige Informationen zum Format von Datum und Zeitangaben 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 reflektion verwendet, um die Eigenschaften des DateTimeFormatInfo -Objekts für die englische Kultur (USA) abzurufen. Es 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 Zusätzliche API-Hinweise für DateTimeFormatInfo.

Konstruktoren

DateTimeFormatInfo()

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

Eigenschaften

AbbreviatedDayNames

Ruft ein eindimensionales Array vom Typ String ab, das die kulturabhängigen abgekürzten Namen der Wochentage enthält, oder legt dieses fest.

AbbreviatedMonthGenitiveNames

Ruft ein Zeichenfolgenarray der abgekürzten Monatsnamen ab, die dem aktuellen DateTimeFormatInfo-Objekt zugeordnet sind, oder legt dieses fest.

AbbreviatedMonthNames

Ruft ein eindimensionales Zeichenfolgenarray ab, das die kulturabhängigen abgekürzten Namen der Monate enthält, oder legt dieses fest.

AMDesignator

Ruft den Zeichenfolgenkennzeichner für Zeitangaben vor 12 Uhr mittags („ante meridiem“, a.m.) ab oder legt diesen fest.

Calendar

Ruft den für die aktuelle Kultur zu verwendenden Kalender ab oder legen diesen fest.

CalendarWeekRule

Ruft einen Wert ab, der die Regel zum Bestimmen der ersten Kalenderwoche eines Jahres angibt, oder legt diesen fest.

CurrentInfo

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

DateSeparator

Ruft die Zeichenfolge ab, die die Datumskomponenten trennt, d. h. Jahr, Monat und Tag, oder legt diese fest.

DayNames

Ruft ein eindimensionales Zeichenfolgenarray ab, das die kulturabhängigen vollständigen Namen der Wochentage enthält, oder legt dieses fest.

FirstDayOfWeek

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

FullDateTimePattern

Ruft die benutzerdefinierte Formatzeichenfolge für einen langen Datums- und Uhrzeitwert ab oder legt dieses fest.

InvariantInfo

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

IsReadOnly

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

LongDatePattern

Ruft die benutzerdefinierte Formatzeichenfolge für einen langen Datumswert ab oder legt diese fest.

LongTimePattern

Ruft die benutzerdefinierte Formatzeichenfolge für einen langen Uhrzeitwert ab oder legt diese fest.

MonthDayPattern

Ruft die benutzerdefinierte Formatzeichenfolge für einen Monats- und Tageswert ab oder legt diese fest.

MonthGenitiveNames

Ruft ein Zeichenfolgenarray der Monatsnamen ab, die dem aktuellen DateTimeFormatInfo-Objekt zugeordnet sind, oder legt dieses fest.

MonthNames

Ruft ein eindimensionales Array vom Typ String ab, das die kulturabhängigen vollständigen Namen der Monate enthält, oder legt dieses fest.

NativeCalendarName

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

PMDesignator

Ruft den Zeichenfolgenkennzeichner für Zeitangaben nach 12 Uhr mittags ("post meridiem", p.m.) ab oder legt diesen fest.

RFC1123Pattern

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

ShortDatePattern

Ruft die benutzerdefinierte Formatzeichenfolge für einen kurzen Datumswert ab oder legt diese fest.

ShortestDayNames

Ruft ein Zeichenfolgenarray der am stärksten abgekürzten, eindeutigen Tagesnamen ab, die dem aktuellen DateTimeFormatInfo-Objekt zugeordnet sind, oder legt diese fest.

ShortTimePattern

Ruft die benutzerdefinierte Formatzeichenfolge für einen kurzen Uhrzeitwert ab oder legt diese fest.

SortableDateTimePattern

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

TimeSeparator

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

UniversalSortableDateTimePattern

Ruft die benutzerdefinierte Formatzeichenfolge für eine universelle sortierbare Datums- und Zeitzeichenfolge gemäß ISO 8601 ab.

YearMonthPattern

Ruft die benutzerdefinierte Formatzeichenfolge für einen Jahres- und Monatswert ab oder legt diese fest.

Methoden

Clone()

Erstellt eine flache Kopie von DateTimeFormatInfo.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetAbbreviatedDayName(DayOfWeek)

Gibt den kulturabhängigen abgekürzten Namen des angegebenen Wochentags entsprechend der Kultur zurück, die dem aktuellen DateTimeFormatInfo-Objekt zugeordnet ist.

GetAbbreviatedEraName(Int32)

Gibt die Zeichenfolge zurück, die den abgekürzten Namen des angegebenen Zeitraums enthält, sofern eine Abkürzung vorhanden ist.

GetAbbreviatedMonthName(Int32)

Gibt den kulturabhängigen abgekürzten Namen des angegebenen Monats entsprechend der Kultur zurück, die dem aktuellen DateTimeFormatInfo-Objekt zugeordnet ist.

GetAllDateTimePatterns()

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

GetAllDateTimePatterns(Char)

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

GetDayName(DayOfWeek)

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

GetEra(String)

Gibt die Ganzzahl zurück, die den angegebenen Zeitraum darstellt.

GetEraName(Int32)

Gibt die Zeichenfolge mit dem Namen des angegebenen Zeitraums zurück.

GetFormat(Type)

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

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetInstance(IFormatProvider)

Gibt das DateTimeFormatInfo-Objekt zurück, das dem angegebenen IFormatProvider zugeordnet ist.

GetMonthName(Int32)

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

GetShortestDayName(DayOfWeek)

Ruft den am stärksten abgekürzten Tagesnamen für einen angegebenen Wochentag ab, der dem aktuellen DateTimeFormatInfo-Objekt zugeordnet ist.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ReadOnly(DateTimeFormatInfo)

Gibt einen schreibgeschützten DateTimeFormatInfo-Wrapper zurück.

SetAllDateTimePatterns(String[], Char)

Legt die benutzerdefinierten Formatzeichenfolgen für Datum und Uhrzeit 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 SerializationInfo mit den Daten auf, die zur Serialisierung des Zielobjekts benötigt werden.

Gilt für:

Weitere Informationen