DateTimeFormatInfo Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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. |