DateTimeFormatInfo Classe

Definição

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

public ref class DateTimeFormatInfo sealed : IFormatProvider
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider, System::Runtime::Serialization::ISerializable
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider
public sealed class DateTimeFormatInfo : 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
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
type DateTimeFormatInfo = class
    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
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider, ISerializable
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider
Herança
DateTimeFormatInfo
Atributos
Implementações

Exemplos

O exemplo seguinte usa reflexão para obter as propriedades do objeto DateTimeFormatInfo para a cultura inglesa (Estados Unidos). Mostra o valor das propriedades que contêm cadeias de formato personalizadas e utiliza essas cadeias para mostrar 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

Observações

Para mais informações sobre esta API, consulte Observações suplementares da API para DateTimeFormatInfo.

Construtores

Name Description
DateTimeFormatInfo()

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

Propriedades

Name Description
AbbreviatedDayNames

Recebe ou define um array unidimensional de tipos String contendo os nomes abreviados específicos de cultura dos dias da semana.

AbbreviatedMonthGenitiveNames

Obtém ou define um conjunto de cadeias de nomes abreviados dos meses associados ao objeto atual DateTimeFormatInfo .

AbbreviatedMonthNames

Recebe ou define um array de cordas unidimensional que contém os nomes abreviados específicos da cultura dos meses.

AMDesignator

Recebe ou define o designador da corda para as horas que são "ante meridiem" (antes do meio-dia).

Calendar

Obtém ou define o calendário para usar na cultura atual.

CalendarWeekRule

Recebe ou define um valor que especifica qual regra é usada para determinar a primeira semana civil do ano.

CurrentInfo

Recebe um objeto só DateTimeFormatInfo de leitura que formata valores com base na cultura atual.

DateSeparator

Obtém ou define a sequência que separa os componentes de uma data, ou seja, o ano, o mês e o dia.

DayNames

Obtém ou define um array de cordas unidimensional que contém os nomes completos específicos da cultura dos dias da semana.

FirstDayOfWeek

Obtém ou definem no primeiro dia da semana.

FullDateTimePattern

Recebe ou define a string de formato personalizada para um valor de data longa e de tempo longo.

InvariantInfo

Obtém o objeto padrão de apenas DateTimeFormatInfo leitura que é independente da cultura (invariante).

IsReadOnly

Recebe um valor que indica se o DateTimeFormatInfo objeto é apenas de leitura.

LongDatePattern

Obtém ou define a string de formato personalizada para um valor de data longa.

LongTimePattern

Recebe ou define a string de formato personalizada para um valor de longo tempo.

MonthDayPattern

Recebe ou define a string de formato personalizada para um valor de mês e dia.

MonthGenitiveNames

Recebe ou define um conjunto de nomes de meses associados ao objeto atual DateTimeFormatInfo .

MonthNames

Obtém ou define um array unidimensional de tipos String contendo os nomes completos específicos da cultura dos meses.

NativeCalendarName

Obtém o nome nativo do calendário associado ao objeto atual DateTimeFormatInfo .

PMDesignator

Recebe ou define o designador da corda para as horas que são "post meridiem" (depois do meio-dia).

RFC1123Pattern

Recebe a cadeia de formato personalizada para um valor temporal baseada na especificação de Pedido de Comentários da Internet Engineering Task Force (IETF) (RFC) 1123.

ShortDatePattern

Obtém ou define a string de formato personalizada para um valor de data curta.

ShortestDayNames

Recebe ou define um array de cadeias com os nomes de dias abreviados mais curtos associados ao objeto atual DateTimeFormatInfo .

ShortTimePattern

Recebe ou define a string de formato personalizada para um valor de tempo curto.

SortableDateTimePattern

Recebe a cadeia de formato personalizada para um valor de data e hora ordenáveis.

TimeSeparator

Recebe ou define a sequência que separa os componentes do tempo, ou seja, a hora, os minutos e os segundos.

UniversalSortableDateTimePattern

Obtém a cadeia de formato personalizada para uma cadeia universal de data e hora ordenável, conforme definido pela ISO 8601.

YearMonthPattern

Recebe ou define a string de formato personalizada para um valor de ano e mês.

Métodos

Name Description
Clone()

Cria uma cópia superficial do DateTimeFormatInfo.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetAbbreviatedDayName(DayOfWeek)

Devolve o nome abreviado específico da cultura do dia da semana especificado com base na cultura associada ao objeto atual DateTimeFormatInfo .

GetAbbreviatedEraName(Int32)

Devolve a cadeia que contém o nome abreviado da era especificada, caso exista uma abreviatura.

GetAbbreviatedMonthName(Int32)

Devolve o nome abreviado específico da cultura do mês especificado, com base na cultura associada ao objeto atual DateTimeFormatInfo .

GetAllDateTimePatterns()

Devolve todos os padrões padrão em que os valores de data e hora podem ser formatados.

GetAllDateTimePatterns(Char)

Devolve todos os padrões em que os valores de data e hora podem ser formatados usando a cadeia de formato padrão especificada.

GetDayName(DayOfWeek)

Devolve o nome completo específico da cultura do dia da semana especificado, com base na cultura associada ao objeto atual DateTimeFormatInfo .

GetEra(String)

Devolve o inteiro que representa a era especificada.

GetEraName(Int32)

Devolve a cadeia que contém o nome da era especificada.

GetFormat(Type)

Devolve um objeto do tipo especificado que fornece um serviço de formatação de data e hora.

GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetInstance(IFormatProvider)

Devolve o DateTimeFormatInfo objeto associado ao especificado IFormatProvider.

GetMonthName(Int32)

Devolve o nome completo específico da cultura do mês especificado com base na cultura associada ao objeto atual DateTimeFormatInfo .

GetShortestDayName(DayOfWeek)

Obtém o nome abreviado mais curto para um dia específico da semana associado ao objeto atual DateTimeFormatInfo .

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ReadOnly(DateTimeFormatInfo)

Devolve uma embalagem de apenas DateTimeFormatInfo leitura.

SetAllDateTimePatterns(String[], Char)

Define as cadeias de formato de data e hora personalizadas que correspondem a uma cadeia de formato padrão especificada.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Preenche um SerializationInfo com os dados necessários para serializar o objeto alvo.

Aplica-se a

Ver também