Compartilhar via


DateTimeFormatInfo Classe

Definição

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

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

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)

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.

Aplica-se a

Confira também