DateTimeFormatInfo Classe

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Origem:

DateTimeFormatInfo.cs

Fornece informações específicas da cultura sobre o formato de 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 objeto DateTimeFormatInfo para a cultura inglesa (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 da API Suplementar para DateTimeFormatInfo.

Construtores

DateTimeFormatInfo()

Inicializa uma nova instância gravável da classe DateTimeFormatInfo independente de 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 mês abreviados associados ao objeto DateTimeFormatInfo atual.
AbbreviatedMonthNames	Obtém ou define uma matriz de cadeia de caracteres unidimensional que contém os nomes abreviados específicos da cultura dos meses.
AMDesignator	Obtém ou define o designador de cadeia de caracteres para 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 um objeto DateTimeFormatInfo somente leitura que formata valores com base na cultura atual.
DateSeparator	Obtém ou define a cadeia de caracteres que separa os componentes de uma data, ou seja, o ano, o mês e o dia.
DayNames	Obtém ou define uma matriz de cadeia de caracteres unidimensional que contém os nomes completos específicos da cultura dos dias da semana.
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 longo de data e tempo longo.
InvariantInfo	Obtém o objeto DateTimeFormatInfo somente leitura padrão que é independente de 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 de longo tempo.
MonthDayPattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor de mês e dia.
MonthGenitiveNames	Obtém ou define uma matriz de cadeia de caracteres de nomes de mês associados ao objeto DateTimeFormatInfo atual.
MonthNames	Obtém ou define uma matriz unidimensional do tipo String que contém os nomes completos específicos da cultura dos meses.
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 por horas que são "post meridiem" (após o meio-dia).
RFC1123Pattern	Obtém a cadeia de caracteres de formato personalizado para um valor de tempo baseado na especificação 1123 da Solicitação de Comentários (RFC) da IETF (Internet Engineering Task Force).
ShortDatePattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor de data curta.
ShortestDayNames	Obtém ou define uma matriz de cadeia de caracteres dos nomes de dia abreviados exclusivos mais curtos associados ao objeto DateTimeFormatInfo atual.
ShortTimePattern	Obtém ou define a cadeia de caracteres de formato personalizado para um valor de tempo curto.
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 do tempo, ou seja, a hora, os minutos e os segundos.
UniversalSortableDateTimePattern	Obtém a cadeia de caracteres de formato personalizado para uma cadeia de caracteres de data e hora universal e classificável, conforme definido pelo 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 específico da cultura do mês especificado com base na cultura associada ao objeto DateTimeFormatInfo atual.
GetAllDateTimePatterns()	Retorna todos os padrões em que os valores de data e hora podem ser formatados.
GetAllDateTimePatterns(Char)	Retorna todos os padrões nos quais os valores de data e hora 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 especificada.
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 IFormatProviderespecificado.
GetMonthName(Int32)	Retorna o nome completo específico da cultura do mês especificado com base na cultura associada ao objeto DateTimeFormatInfo atual.
GetShortestDayName(DayOfWeek)	Obtém o nome de dia abreviado mais curto para 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 Objectatual. (Herdado de Object)
ReadOnly(DateTimeFormatInfo)	Retorna um wrapper de DateTimeFormatInfo somente leitura.
SetAllDateTimePatterns(String[], Char)	Define as cadeias de caracteres de formato de data e hora personalizadas 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