Udostępnij za pośrednictwem


DateTimeFormatInfo Klasa

Definicja

Zawiera informacje specyficzne dla kultury dotyczące formatu wartości daty i godziny.

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
Dziedziczenie
DateTimeFormatInfo
Atrybuty
Implementuje

Przykłady

W poniższym przykładzie użyto odbicia w celu pobrania właściwości obiektu DateTimeFormatInfo dla kultury języka angielskiego (Stanów Zjednoczonych). Wyświetla wartość tych właściwości, które zawierają niestandardowe ciągi formatu i używa tych ciągów do wyświetlania sformatowanych dat.

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

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz uwagi dotyczące dodatkowego interfejsu API dateTimeFormatInfo.

Konstruktory

DateTimeFormatInfo()

Inicjuje nowe wystąpienie zapisywalne klasy DateTimeFormatInfo, która jest niezależna od kultury (niezmienne).

Właściwości

AbbreviatedDayNames

Pobiera lub ustawia jednowymiarową tablicę typu String zawierającą nazwy skrócone specyficzne dla kultury dni tygodnia.

AbbreviatedMonthGenitiveNames

Pobiera lub ustawia tablicę ciągów skróconych nazw miesięcy skojarzonych z bieżącym obiektem DateTimeFormatInfo.

AbbreviatedMonthNames

Pobiera lub ustawia jednowymiarową tablicę ciągów zawierającą skrócone nazwy miesięcy specyficzne dla kultury.

AMDesignator

Pobiera lub ustawia projektator ciągów przez godziny, które są "ante meridiem" (przed południem).

Calendar

Pobiera lub ustawia kalendarz do użycia dla bieżącej kultury.

CalendarWeekRule

Pobiera lub ustawia wartość określającą, która reguła jest używana do określenia pierwszego tygodnia kalendarzowego roku.

CurrentInfo

Pobiera obiekt DateTimeFormatInfo tylko do odczytu, który formatuje wartości na podstawie bieżącej kultury.

DateSeparator

Pobiera lub ustawia ciąg, który oddziela składniki daty, czyli rok, miesiąc i dzień.

DayNames

Pobiera lub ustawia jednowymiarową tablicę ciągów zawierającą pełne nazwy specyficzne dla kultury dni tygodnia.

FirstDayOfWeek

Pobiera lub ustawia pierwszy dzień tygodnia.

FullDateTimePattern

Pobiera lub ustawia niestandardowy ciąg formatu dla wartości daty długiej i długiej godziny.

InvariantInfo

Pobiera domyślny obiekt DateTimeFormatInfo tylko do odczytu, który jest niezależny od kultury (niezmienny).

IsReadOnly

Pobiera wartość wskazującą, czy obiekt DateTimeFormatInfo jest tylko do odczytu.

LongDatePattern

Pobiera lub ustawia niestandardowy ciąg formatu dla wartości daty długiej.

LongTimePattern

Pobiera lub ustawia niestandardowy ciąg formatu przez długi czas.

MonthDayPattern

Pobiera lub ustawia niestandardowy ciąg formatu dla wartości miesiąca i dnia.

MonthGenitiveNames

Pobiera lub ustawia tablicę ciągów nazw miesięcy skojarzonych z bieżącym obiektem DateTimeFormatInfo.

MonthNames

Pobiera lub ustawia jednowymiarową tablicę typu String zawierającą pełne nazwy miesięcy specyficzne dla kultury.

NativeCalendarName

Pobiera natywną nazwę kalendarza skojarzonego z bieżącym obiektem DateTimeFormatInfo.

PMDesignator

Pobiera lub ustawia projektator ciągów przez godziny, które są "post meridiem" (po południu).

RFC1123Pattern

Pobiera niestandardowy ciąg formatu dla wartości czasu opartej na specyfikacji Internet Engineering Task Force (IETF) request for Comments (RFC) 1123.

ShortDatePattern

Pobiera lub ustawia niestandardowy ciąg formatu dla wartości daty krótkiej.

ShortestDayNames

Pobiera lub ustawia tablicę ciągów najkrótszych unikatowych skróconych nazw dni skojarzonych z bieżącym obiektem DateTimeFormatInfo.

ShortTimePattern

Pobiera lub ustawia niestandardowy ciąg formatu dla krótkiej wartości czasu.

SortableDateTimePattern

Pobiera ciąg formatu niestandardowego dla wartości daty i godziny sortowania.

TimeSeparator

Pobiera lub ustawia ciąg, który oddziela składniki czasu, czyli godzinę, minuty i sekundy.

UniversalSortableDateTimePattern

Pobiera ciąg formatu niestandardowego dla uniwersalnego, sortowalnego ciągu daty i godziny zgodnie z definicją iso 8601.

YearMonthPattern

Pobiera lub ustawia niestandardowy ciąg formatu dla wartości roku i miesiąca.

Metody

Clone()

Tworzy płytkią kopię DateTimeFormatInfo.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.

(Odziedziczone po Object)
GetAbbreviatedDayName(DayOfWeek)

Zwraca nazwę skróconą specyficzną dla kultury określonego dnia tygodnia na podstawie kultury skojarzonej z bieżącym obiektem DateTimeFormatInfo.

GetAbbreviatedEraName(Int32)

Zwraca ciąg zawierający skróconą nazwę określonej ery, jeśli istnieje skrót.

GetAbbreviatedMonthName(Int32)

Zwraca specyficzną dla kultury nazwę skróconą określonego miesiąca na podstawie kultury skojarzonej z bieżącym obiektem DateTimeFormatInfo.

GetAllDateTimePatterns()

Zwraca wszystkie standardowe wzorce, w których można sformatować wartości daty i godziny.

GetAllDateTimePatterns(Char)

Zwraca wszystkie wzorce, w których można sformatować wartości daty i godziny przy użyciu określonego standardowego ciągu formatu.

GetDayName(DayOfWeek)

Zwraca pełną nazwę określonej kultury określonego dnia tygodnia na podstawie kultury skojarzonej z bieżącym obiektem DateTimeFormatInfo.

GetEra(String)

Zwraca liczbę całkowitą reprezentującą określoną erę.

GetEraName(Int32)

Zwraca ciąg zawierający nazwę określonej ery.

GetFormat(Type)

Zwraca obiekt określonego typu, który udostępnia usługę formatowania daty i godziny.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetInstance(IFormatProvider)

Zwraca obiekt DateTimeFormatInfo skojarzony z określonym IFormatProvider.

GetMonthName(Int32)

Zwraca pełną nazwę określonego miesiąca specyficzną dla kultury na podstawie kultury skojarzonej z bieżącym obiektem DateTimeFormatInfo.

GetShortestDayName(DayOfWeek)

Uzyskuje najkrótszą skróconą nazwę dnia dla określonego dnia tygodnia skojarzonego z bieżącym obiektem DateTimeFormatInfo.

GetType()

Pobiera Type bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Object.

(Odziedziczone po Object)
ReadOnly(DateTimeFormatInfo)

Zwraca otokę tylko do odczytu DateTimeFormatInfo.

SetAllDateTimePatterns(String[], Char)

Ustawia niestandardowe ciągi formatu daty i godziny, które odpowiadają określonemu standardowemu ciągowi formatu.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Jawne implementacje interfejsu

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Wypełnia element SerializationInfo danymi potrzebnymi do serializacji obiektu docelowego.

Dotyczy

Zobacz też