DateTimeFormatInfo Třída

Definice

Poskytuje informace specifické pro jazykovou verzi o formátu hodnot data a času.

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
Dědičnost
DateTimeFormatInfo
Atributy
Implementuje

Příklady

Následující příklad používá reflexi k získání vlastností DateTimeFormatInfo objektu pro jazykovou verzi angličtiny (Spojené státy). Zobrazí hodnotu těchto vlastností, které obsahují řetězce vlastního formátu, a používá tyto řetězce k zobrazení formátovaných kalendářních 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

Poznámky

Další informace o tomto rozhraní API naleznete v tématu doplňkové poznámky k rozhraní API pro DateTimeFormatInfo.

Konstruktory

DateTimeFormatInfo()

Inicializuje novou zapisovatelnou instanci třídy DateTimeFormatInfo, která je nezávislá na jazykové verzi (invariantní).

Vlastnosti

AbbreviatedDayNames

Získá nebo nastaví jednorozměrné pole typu String obsahující zkrácené názvy dnů v týdnu specifické pro jazykovou verzi.

AbbreviatedMonthGenitiveNames

Získá nebo nastaví řetězcové pole zkrácených názvů měsíců přidružených k aktuálnímu DateTimeFormatInfo objektu.

AbbreviatedMonthNames

Získá nebo nastaví jednorozměrné řetězcové pole, které obsahuje zkrácené názvy měsíců specifické pro jazykovou verzi.

AMDesignator

Získá nebo nastaví řetězcový designator pro hodiny, které jsou "ante meridiem" (před polednem).

Calendar

Získá nebo nastaví kalendář pro aktuální jazykovou verzi.

CalendarWeekRule

Získá nebo nastaví hodnotu, která určuje, které pravidlo se používá k určení prvního kalendářního týdne roku.

CurrentInfo

Získá objekt jen pro čtení DateTimeFormatInfo, který formátuje hodnoty na základě aktuální jazykové verze.

DateSeparator

Získá nebo nastaví řetězec, který odděluje komponenty data, tj. rok, měsíc a den.

DayNames

Získá nebo nastaví jednorozměrné řetězcové pole obsahující celé názvy dnů v týdnu specifické pro jazykovou verzi.

FirstDayOfWeek

Získá nebo nastaví první den v týdnu.

FullDateTimePattern

Získá nebo nastaví řetězec vlastního formátu pro dlouhou hodnotu data a dlouhého času.

InvariantInfo

Získá výchozí DateTimeFormatInfo jen pro čtení objektu, který je nezávislý na jazykové verzi (invariant).

IsReadOnly

Získá hodnotu určující, zda DateTimeFormatInfo objekt je jen pro čtení.

LongDatePattern

Získá nebo nastaví řetězec vlastního formátu pro dlouhou hodnotu data.

LongTimePattern

Získá nebo nastaví řetězec vlastního formátu pro dlouhou hodnotu času.

MonthDayPattern

Získá nebo nastaví řetězec vlastního formátu pro hodnotu měsíce a dne.

MonthGenitiveNames

Získá nebo nastaví pole řetězců názvů měsíců přidružených k aktuálnímu DateTimeFormatInfo objektu.

MonthNames

Získá nebo nastaví jednorozměrné pole typu String obsahující celé názvy měsíců specifické pro jazykovou verzi.

NativeCalendarName

Získá nativní název kalendáře přidruženého k aktuálnímu DateTimeFormatInfo objektu.

PMDesignator

Získá nebo nastaví řetězcový designator pro hodiny, které jsou "post meridiem" (po poledne).

RFC1123Pattern

Získá řetězec vlastního formátu pro časovou hodnotu, která je založena na Internet Engineering Task Force (IETF) Request for Comments (RFC) specifikace 1123.

ShortDatePattern

Získá nebo nastaví řetězec vlastního formátu pro krátkou hodnotu data.

ShortestDayNames

Získá nebo nastaví řetězcové pole nejkratších jedinečných zkrácených názvů dnů přidružených k aktuálnímu DateTimeFormatInfo objektu.

ShortTimePattern

Získá nebo nastaví řetězec vlastního formátu pro krátkou hodnotu času.

SortableDateTimePattern

Získá řetězec vlastního formátu pro hodnotu seřaditelného data a času.

TimeSeparator

Získá nebo nastaví řetězec, který odděluje součásti času, tj. hodiny, minuty a sekundy.

UniversalSortableDateTimePattern

Získá řetězec vlastního formátu pro univerzální, seřazený řetězec data a času, jak je definováno ISO 8601.

YearMonthPattern

Získá nebo nastaví řetězec vlastního formátu pro hodnotu roku a měsíce.

Metody

Clone()

Vytvoří mělkou kopii DateTimeFormatInfo.

Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

(Zděděno od Object)
GetAbbreviatedDayName(DayOfWeek)

Vrátí zkrácený název konkrétní jazykové verze zadaného dne v týdnu na základě jazykové verze přidružené k aktuálnímu objektu DateTimeFormatInfo.

GetAbbreviatedEraName(Int32)

Vrátí řetězec obsahující zkrácený název zadané éry, pokud existuje zkratka.

GetAbbreviatedMonthName(Int32)

Vrátí zkrácený název konkrétní jazykové verze zadaného měsíce na základě jazykové verze přidružené k aktuálnímu objektu DateTimeFormatInfo.

GetAllDateTimePatterns()

Vrátí všechny standardní vzory, ve kterých lze formátovat hodnoty data a času.

GetAllDateTimePatterns(Char)

Vrátí všechny vzory, ve kterých lze hodnoty data a času formátovat pomocí zadaného standardního řetězce formátu.

GetDayName(DayOfWeek)

Vrátí úplný název konkrétní jazykové verze zadaného dne v týdnu na základě jazykové verze přidružené k aktuálnímu objektu DateTimeFormatInfo.

GetEra(String)

Vrátí celé číslo představující zadanou éru.

GetEraName(Int32)

Vrátí řetězec obsahující název zadané éry.

GetFormat(Type)

Vrátí objekt zadaného typu, který poskytuje službu formátování data a času.

GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetInstance(IFormatProvider)

Vrátí objekt DateTimeFormatInfo přidružený k zadanému IFormatProvider.

GetMonthName(Int32)

Vrátí úplný název konkrétní jazykové verze zadaného měsíce na základě jazykové verze přidružené k aktuálnímu objektu DateTimeFormatInfo.

GetShortestDayName(DayOfWeek)

Získá nejkratší zkrácený název dne pro zadaný den v týdnu přidružený k aktuálnímu objektu DateTimeFormatInfo.

GetType()

Získá Type aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
ReadOnly(DateTimeFormatInfo)

Vrátí obálku jen pro čtení DateTimeFormatInfo.

SetAllDateTimePatterns(String[], Char)

Nastaví vlastní řetězce formátu data a času, které odpovídají zadanému standardnímu řetězci formátu.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Explicitní implementace rozhraní

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Naplní SerializationInfo daty potřebnými k serializaci cílového objektu.

Platí pro

Viz také