DateTimeFormatInfo Classe

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Source:

DateTimeFormatInfo.cs

Fornece informações específicas da cultura sobre o formato dos valores de data e hora.

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

Herança

Object

DateTimeFormatInfo

Implementações

IFormatProvider ICloneable

Exemplos

O exemplo a seguir usa reflexão para obter as propriedades do DateTimeFormatInfo objeto para a cultura em inglês (Estados Unidos). Ele exibe o valor dessas propriedades que contêm cadeias de caracteres de formato personalizado e usa essas cadeias de caracteres para exibir datas formatadas.

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

Comentários

Para obter mais informações sobre essa API, consulte Comentários de API complementares para DateTimeFormatInfo.

Construtores

DateTimeFormatInfo()

Inicializa uma nova instância gravável da classe DateTimeFormatInfo que é independente da cultura (invariável).

Propriedades

AbbreviatedDayNames	Obtém ou define uma matriz unidimensional do tipo String que contém os nomes abreviados específicos da cultura dos dias da semana.
AbbreviatedMonthGenitiveNames	Obtém ou define uma matriz de cadeia de caracteres de nomes de meses abreviados associada ao objeto DateTimeFormatInfo atual.
AbbreviatedMonthNames	Obtém ou define uma matriz unidimensional de cadeia de caracteres que contém os nomes dos meses abreviados, específicos da cultura.
AMDesignator	Obtém ou define o designador de cadeia de caracteres de horas que são "ante meridiem" (antes do meio-dia).
Calendar	Obtém ou define o calendário a ser usado para a cultura atual.
CalendarWeekRule	Obtém ou define um valor que especifica qual regra é usada para determinar a primeira semana do ano.
CurrentInfo	Obtém o objeto DateTimeFormatInfo somente leitura que formata valores com base na cultura atual.
DateSeparator	Define a cadeia de caracteres que separa a os componentes de uma data, ou seja, o ano, mês e dia.
DayNames	Obtém ou define uma matriz unidimensional de cadeia de caracteres que contém os nomes dos dias da semana completos específicos da cultura.
FirstDayOfWeek	Obtém ou define o primeiro dia da semana.
FullDateTimePattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor temporal longo e valor de data longo.
InvariantInfo	Obtém o objeto DateTimeFormatInfo padrão somente leitura que é independente da cultura (invariável).
IsReadOnly	Obtém um valor que indica se o objeto DateTimeFormatInfo é somente leitura.
LongDatePattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor de data longa.
LongTimePattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor temporal extenso.
MonthDayPattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor de mês e de dia.
MonthGenitiveNames	Obtém ou define uma matriz de cadeia de caracteres de nomes de meses associada ao objeto DateTimeFormatInfo atual.
MonthNames	Obtém ou define uma matriz unidimensional de tipo String que contém os nomes dos dias da semana completos específicos da cultura.
NativeCalendarName	Obtém o nome nativo do calendário associado ao objeto DateTimeFormatInfo atual.
PMDesignator	Obtém ou define o designador de cadeia de caracteres de horas que são "post meridiem" (depois do meio-dia).
RFC1123Pattern	Obtém a cadeia de caracteres de formato personalizado para um valor temporal baseado na especificação RFC (Request for Comments) 1123 da IETF (Internet Engineering Task Force).
ShortDatePattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor de data abreviada.
ShortestDayNames	Obtém ou define uma matriz de cadeia de caracteres dos nomes de dias abreviados únicos mais curtos associados ao objeto DateTimeFormatInfo atual.
ShortTimePattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor temporal abreviado.
SortableDateTimePattern	Obtém a cadeia de caracteres de formato personalizado para um valor de data e hora classificável.
TimeSeparator	Obtém ou define a cadeia de caracteres que separa os componentes de tempo, ou seja, a hora, os minutos e os segundos.
UniversalSortableDateTimePattern	Obtém a cadeia de caracteres de formato personalizado para um valor de data e hora classificável e universal, conforme definido por ISO 8601.
YearMonthPattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor de ano e mês.

Métodos

Clone()	Cria uma cópia superficial do DateTimeFormatInfo.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetAbbreviatedDayName(DayOfWeek)	Retorna o nome abreviado, específico da cultura, do dia da semana especificado com base na cultura associada ao objeto DateTimeFormatInfo atual.
GetAbbreviatedEraName(Int32)	Retorna a cadeia de caracteres que contém o nome abreviado da era especificada, se houver uma abreviação.
GetAbbreviatedMonthName(Int32)	Retorna o nome abreviado da cultura específica do mês especificado com base na cultura associada ao objeto DateTimeFormatInfo atual.
GetAllDateTimePatterns()	Retorna todos os padrões padrão nos quais os valores de data e hora podem ser formatados.
GetAllDateTimePatterns(Char)	Retorna todos os padrões nos quais os valores temporais podem ser formatados usando a cadeia de caracteres de formato padrão especificada.
GetDayName(DayOfWeek)	Retorna o nome completo, específico da cultura, do dia da semana especificado com base na cultura associada ao objeto DateTimeFormatInfo atual.
GetEra(String)	Retorna o inteiro que representa a era especificada.
GetEraName(Int32)	Retorna a cadeia de caracteres que contém o nome da era especificado.
GetFormat(Type)	Retorna um objeto do tipo especificado que fornece um serviço de formatação de data e hora.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetInstance(IFormatProvider)	Retorna o objeto DateTimeFormatInfo associado ao IFormatProvider especificado.
GetMonthName(Int32)	Retorna o nome completo da cultura específica do mês especificado com base na cultura associada ao objeto DateTimeFormatInfo atual.
GetShortestDayName(DayOfWeek)	Obtém o nome abreviado do dia mais curto de um dia especificado da semana associado ao objeto DateTimeFormatInfo atual.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ReadOnly(DateTimeFormatInfo)	Retorna um wrapper DateTimeFormatInfo de somente leitura.
SetAllDateTimePatterns(String[], Char)	Define as cadeias de caracteres de formato de data e hora personalizado que correspondem a uma cadeia de caracteres de formato padrão especificada.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• DateTime
• Calendar
• CultureInfo