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í objektu DateTimeFormatInfo pro jazykovou verzi v angličtině (USA). Zobrazí hodnotu 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 najdete v tématu Doplňkové poznámky k rozhraní API pro DateTimeFormatInfo.

Konstruktory

DateTimeFormatInfo()

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

Vlastnosti

AbbreviatedDayNames	Získá nebo nastaví jednorozměrné pole typu String obsahující jazykové verze zkrácené názvy dnů v týdnu.
AbbreviatedMonthGenitiveNames	Získá nebo nastaví pole řetězců 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é pole řetězců, který obsahuje jazykové verze-specifické zkrácené názvy měsíců.
AMDesignator	Získá nebo nastaví řetězcový návrh pro hodiny, které jsou "ante meridiem" (před polednem).
Calendar	Získá nebo nastaví kalendář pro použití 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 v roce.
CurrentInfo	Získá objekt jen DateTimeFormatInfo pro čtení, který formátuje hodnoty na základě aktuální jazykové verze.
DateSeparator	Získá nebo nastaví řetězec, který odděluje komponenty data, to znamená rok, měsíc a den.
DayNames	Získá nebo nastaví jednorozměrné pole řetězců, které obsahuje jazykové verze úplné názvy dnů v týdnu.
FirstDayOfWeek	Získá nebo nastaví první den v týdnu.
FullDateTimePattern	Získá nebo nastaví řetězec vlastního formátu pro dlouhé datum a dlouhou hodnotu času.
InvariantInfo	Získá výchozí objekt jen DateTimeFormatInfo pro čtení, který je nezávislý na jazykové verzi (invariantní).
IsReadOnly	Získá hodnotu označ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.
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í úplné 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ý návrh pro hodiny, které jsou "post meridiem" (po poledni).
RFC1123Pattern	Získá vlastní formát řetězec pro hodnotu času, 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 hodnotu krátkého data.
ShortestDayNames	Získá nebo nastaví pole řetězců 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.
SortableDateTimePattern	Získá vlastní formát řetězec pro hodnotě data a času, které lze seřadit.
TimeSeparator	Získá nebo nastaví řetězec, který odděluje komponenty času, tj. hodinu, minuty a sekundy.
UniversalSortableDateTimePattern	Získá vlastní formát řetězec pro univerzální, seřaditelné datum a čas řetězec, 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 souboru DateTimeFormatInfo.
Equals(Object)	Určí, zda se zadaný objekt rovná 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 DateTimeFormatInfo objektu.
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 DateTimeFormatInfo objektu.
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 řetězce standardního 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 DateTimeFormatInfo objektu.
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í hashovací funkce. (Zděděno od Object)
GetInstance(IFormatProvider)	DateTimeFormatInfo Vrátí objekt přidružený k zadanému IFormatProviderobjektu .
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 DateTimeFormatInfo objektu.
GetShortestDayName(DayOfWeek)	Získá nejkratší zkrácený název dne pro zadaný den v týdnu přidružený k aktuálnímu DateTimeFormatInfo objektu.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ReadOnly(DateTimeFormatInfo)	Vrátí obálku jen DateTimeFormatInfo pro čtení.
SetAllDateTimePatterns(String[], Char)	Nastaví vlastní řetězce formátu data a času, které odpovídají zadanému řetězci standardního formátu.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• DateTime
• Calendar
• CultureInfo