DateTimeFormatInfo Klasse

Definition

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Quelle:

DateTimeFormatInfo.cs

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

public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider

public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider

type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider

Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider

Vererbung

Object

DateTimeFormatInfo

Implementiert

IFormatProvider ICloneable

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)

Weitere Informationen

• DateTime
• Calendar
• CultureInfo