DateTimeFormatInfo Třída

Definice

Obor názvů:

System.Globalization

Sestavení:

System.Runtime.dll

Zdroj:

DateTimeFormatInfo.cs

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

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

Dědičnost

Object

DateTimeFormatInfo

Implementuje

IFormatProvider ICloneable

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)

Viz také

• DateTime
• Calendar
• CultureInfo