DateTimeFormatInfo Osztály

Definíció

Kultúraspecifikus információkat nyújt a dátum- és időértékek formátumáról.

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
Öröklődés
DateTimeFormatInfo
Attribútumok
Megvalósítás

Példák

Az alábbi példa tükröződés használatával lekéri az angol (Egyesült Államok) kultúra DateTimeFormatInfo objektumának tulajdonságait. Megjeleníti az egyéni formázási sztringeket tartalmazó tulajdonságok értékét, és ezeket a sztringeket használja a formázott dátumok megjelenítéséhez.

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

Megjegyzések

Az API-val kapcsolatos további információkért lásd a DateTimeFormatInfo kiegészítő API-megjegyzéseit.

Konstruktorok

Name Description
DateTimeFormatInfo()

Inicializálja a DateTimeFormatInfo kultúrafüggetlen (invariant) osztály új írható példányát.

Tulajdonságok

Name Description
AbbreviatedDayNames

Lekéri vagy beállítja a hét napjainak kultúraspecifikus rövidített neveit tartalmazó egydimenziós tömböt String .

AbbreviatedMonthGenitiveNames

Lekéri vagy beállítja az aktuális DateTimeFormatInfo objektumhoz társított rövidített hónapnevekből álló sztringtömböt.

AbbreviatedMonthNames

Lekéri vagy beállít egy egydimenziós sztringtömböt, amely tartalmazza a hónapok kultúraspecifikus rövidített neveit.

AMDesignator

Lekéri vagy beállítja a sztringtervezőt órákra, amelyek "ante meridiem" (dél előtt).

Calendar

Lekéri vagy beállítja a naptárt az aktuális kultúrához.

CalendarWeekRule

Lekéri vagy beállít egy értéket, amely meghatározza, hogy melyik szabályt használja az év első naptári hetének meghatározásához.

CurrentInfo

Egy írásvédett DateTimeFormatInfo objektumot kap, amely az aktuális kultúra alapján formáz értékeket.

DateSeparator

Lekéri vagy beállítja a dátum, vagyis az év, a hónap és a nap összetevőit elválasztó sztringet.

DayNames

Lekéri vagy beállít egy egydimenziós sztringtömböt, amely tartalmazza a hét napjainak kultúraspecifikus teljes nevét.

FirstDayOfWeek

Lekéri vagy beállítja a hét első napját.

FullDateTimePattern

Lekéri vagy beállítja az egyéni formázási sztringet egy hosszú dátumhoz és hosszú időhöz.

InvariantInfo

Lekéri az alapértelmezett írásvédett DateTimeFormatInfo objektumot, amely kultúrafüggetlen (invariant).

IsReadOnly

Beolvas egy értéket, amely jelzi, hogy az DateTimeFormatInfo objektum írásvédett-e.

LongDatePattern

Lekéri vagy beállítja az egyéni formázási sztringet egy hosszú dátumértékhez.

LongTimePattern

Hosszú ideig lekéri vagy beállítja az egyéni formázási sztringet.

MonthDayPattern

Lekéri vagy beállítja az egyéni formátumsztringet egy hónapra és napra vonatkozóan.

MonthGenitiveNames

Lekéri vagy beállítja az aktuális DateTimeFormatInfo objektumhoz társított hónapnevekből álló sztringtömböt.

MonthNames

Lekéri vagy beállítja a hónapok kultúraspecifikus teljes nevét tartalmazó egydimenziós tömböt String .

NativeCalendarName

Lekéri az aktuális DateTimeFormatInfo objektumhoz társított naptár natív nevét.

PMDesignator

Lekéri vagy beállítja a sztringtervezőt órákra, amelyek "post meridiem" (dél után).

RFC1123Pattern

Az Internet Engineering Task Force (IETF) Request for Comments (RFC) 1123 specifikáción alapuló időérték egyéni formátumsztringjének lekérése.

ShortDatePattern

Lekéri vagy beállítja az egyéni formázási sztringet egy rövid dátumértékhez.

ShortestDayNames

Lekéri vagy beállítja az aktuális DateTimeFormatInfo objektumhoz társított legrövidebb rövidített napnevekből álló sztringtömböt.

ShortTimePattern

Rövid időre lekéri vagy beállítja az egyéni formátumsztringet.

SortableDateTimePattern

Lekéri az egyéni formátumsztringet egy rendezhető dátum- és időértékhez.

TimeSeparator

Lekéri vagy beállítja azt a sztringet, amely elválasztja az idő összetevőit, vagyis az órát, a percet és a másodpercet.

UniversalSortableDateTimePattern

Lekéri az ISO 8601 által meghatározott univerzális, rendezhető dátum- és idősztring egyéni formátumsztringét.

YearMonthPattern

Lekéri vagy beállítja az egyéni formátumsztringet egy évre és hónapra vonatkozóan.

Metódusok

Name Description
Clone()

Létrehoz egy sekély másolatot a DateTimeFormatInfo.

Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetAbbreviatedDayName(DayOfWeek)

A hét megadott napjának kultúraspecifikus rövidített nevét adja vissza az aktuális DateTimeFormatInfo objektumhoz társított kultúra alapján.

GetAbbreviatedEraName(Int32)

A megadott korszak rövidített nevét tartalmazó sztringet adja vissza, ha létezik rövidítés.

GetAbbreviatedMonthName(Int32)

A megadott hónap kultúraspecifikus rövidített nevét adja vissza az aktuális DateTimeFormatInfo objektumhoz társított kultúra alapján.

GetAllDateTimePatterns()

Azokat a szabványos mintákat adja vissza, amelyekben a dátum- és időértékek formázhatók.

GetAllDateTimePatterns(Char)

Azokat a mintákat adja vissza, amelyekben a dátum- és időértékek a megadott szabványos formátumsztring használatával formázhatók.

GetDayName(DayOfWeek)

A hét megadott napjának kultúraspecifikus teljes nevét adja vissza az aktuális DateTimeFormatInfo objektumhoz társított kultúra alapján.

GetEra(String)

A megadott korszakot képviselő egész számot adja vissza.

GetEraName(Int32)

A megadott korszak nevét tartalmazó sztringet adja vissza.

GetFormat(Type)

Egy megadott típusú objektumot ad vissza, amely dátum- és időformázási szolgáltatást biztosít.

GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetInstance(IFormatProvider)

DateTimeFormatInfo A megadott IFormatProviderobjektumhoz társított objektumot adja vissza.

GetMonthName(Int32)

A megadott hónap kultúraspecifikus teljes nevét adja vissza az aktuális DateTimeFormatInfo objektumhoz társított kultúra alapján.

GetShortestDayName(DayOfWeek)

Lekérte az aktuális DateTimeFormatInfo objektumhoz társított hét egy adott napjának legrövidebb rövidített napnevét.

GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
ReadOnly(DateTimeFormatInfo)

Írásvédett DateTimeFormatInfo burkolót ad vissza.

SetAllDateTimePatterns(String[], Char)

Beállítja a megadott szabványos formátumsztringnek megfelelő egyéni dátum- és időformátum-sztringeket.

ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

Explicit interfész-implementációk

Name Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Feltölt egy szerializálásiinfo-t a célobjektum szerializálásához szükséges adatokkal.

A következőre érvényes:

Lásd még