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, 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 a seguir usa reflexão para obter as propriedades do objeto DateTimeFormatInfo 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 da API Suplementar para DateTimeFormatInfo.

Construtores

Nome Description
DateTimeFormatInfo()

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

Propriedades

Nome Description
AbbreviatedDayNames

Obtém ou define uma matriz unidimensional de 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 atual DateTimeFormatInfo .

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 somente DateTimeFormatInfo 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 somente DateTimeFormatInfo leitura padrão que é independente de cultura (invariável).

IsReadOnly

Obtém um valor que indica se o DateTimeFormatInfo objeto é 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 atual DateTimeFormatInfo .

MonthNames

Obtém ou define uma matriz unidimensional de 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 atual DateTimeFormatInfo .

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 mais curtos associados ao objeto atual DateTimeFormatInfo .

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

Nome 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)

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

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 atual DateTimeFormatInfo .

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 atual DateTimeFormatInfo .

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 hash predefinida.

(Herdado de Object)
GetInstance(IFormatProvider)

Retorna o DateTimeFormatInfo objeto associado ao especificado IFormatProvider.

GetMonthName(Int32)

Retorna 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 de dia abreviado mais curto para um dia especificado 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 Objectatual.

(Herdado de Object)
ReadOnly(DateTimeFormatInfo)

Retorna um wrapper somente DateTimeFormatInfo 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

Nome Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

Aplica-se a

Confira também