DateTimeFormatInfo Clase

Definición

Proporciona información específica de la referencia cultural acerca del formato de los valores de fecha y 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
Herencia
DateTimeFormatInfo
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se usa la reflexión para obtener las propiedades del DateTimeFormatInfo objeto para la referencia cultural inglés (Estados Unidos). Muestra el valor de esas propiedades que contienen cadenas de formato personalizado y usa esas cadenas para mostrar fechas con formato.

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

Comentarios

Para obtener más información sobre esta API, consulte Comentarios de api complementarias para DateTimeFormatInfo.

Constructores

DateTimeFormatInfo()

Inicializa una nueva instancia de la clase DateTimeFormatInfo en la que se puede escribir y que es independiente de la referencia cultural (invariable).

Propiedades

AbbreviatedDayNames

Obtiene o establece una matriz de una dimensión de tipo String que contiene las abreviaturas de nombres específicas de la referencia cultural de los días de la semana.

AbbreviatedMonthGenitiveNames

Obtiene o establece una matriz de cadenas de nombres abreviados de los meses asociada al objeto DateTimeFormatInfo actual.

AbbreviatedMonthNames

Obtiene o establece una matriz de cadenas de una dimensión que contiene abreviaturas específicas de la referencia cultural de los meses.

AMDesignator

Obtiene o establece el designador de cadena para las horas que son "ante meridiem" (antes de mediodía).

Calendar

Obtiene o establece el calendario que se utilizará para la referencia cultural actual.

CalendarWeekRule

Obtiene o establece el valor que especifica la regla que se utiliza para determinar la primera semana del calendario del año.

CurrentInfo

Obtiene un objeto DateTimeFormatInfo de solo lectura que aplica formato a los valores basándose en la referencia cultural actual.

DateSeparator

Obtiene o establece la cadena que separa los componentes de una fecha; es decir, el año, el mes y el día.

DayNames

Obtiene o establece una matriz de cadena de una dimensión que contiene los nombres completos específicos de la referencia cultural de los días de la semana.

FirstDayOfWeek

Obtiene o establece el primer día de la semana.

FullDateTimePattern

Obtiene o establece la cadena de formato personalizado para un valor de fecha y hora largas.

InvariantInfo

Obtiene el objeto DateTimeFormatInfo predeterminado de solo lectura que es independiente de la referencia cultural (invariable).

IsReadOnly

Obtiene un valor que indica si el objeto DateTimeFormatInfo es de solo lectura.

LongDatePattern

Obtiene o establece la cadena de formato personalizado para un valor de fecha larga.

LongTimePattern

Obtiene o establece la cadena de formato personalizado para un valor de hora larga.

MonthDayPattern

Obtiene o establece la cadena de formato personalizado para un valor de mes y día.

MonthGenitiveNames

Obtiene o establece una matriz de cadenas de nombres de los meses asociada al objeto DateTimeFormatInfo actual.

MonthNames

Obtiene o establece una matriz de una dimensión de tipo String que contiene los nombres completos específicos de la referencia cultural de los meses.

NativeCalendarName

Obtiene el nombre nativo del calendario asociado al objeto DateTimeFormatInfo actual.

PMDesignator

Obtiene o establece el designador de cadena para las horas que son "post meridiem" (después de mediodía).

RFC1123Pattern

Obtiene la cadena de formato personalizado para un valor de hora basado en la especificación 1123 de Solicitudes de comentarios (RFC) del Grupo de trabajo de ingeniería de Internet (IETF).

ShortDatePattern

Obtiene o establece la cadena de formato personalizado para un valor de fecha corta.

ShortestDayNames

Obtiene o establece una matriz de cadenas con los nombres abreviados más cortos y únicos para los días asociada al objeto DateTimeFormatInfo actual.

ShortTimePattern

Obtiene o establece la cadena de formato personalizado para un valor de hora corta.

SortableDateTimePattern

Obtiene la cadena de formato personalizado para un valor de fecha y hora que se puede ordenar.

TimeSeparator

Obtiene o establece la cadena que separa los componentes de una hora; es decir, la hora, los minutos y los segundos.

UniversalSortableDateTimePattern

Obtiene la cadena de formato personalizado para una cadena de fecha y hora universal que se puede ordenar, como se define en ISO 8601.

YearMonthPattern

Obtiene o establece la cadena de formato personalizado para un valor de año y mes.

Métodos

Clone()

Crea una copia superficial de la colección DateTimeFormatInfo.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetAbbreviatedDayName(DayOfWeek)

Para el día de la semana especificado, devuelve su abreviatura según la referencia cultural asociada al objeto DateTimeFormatInfo actual.

GetAbbreviatedEraName(Int32)

Devuelve la cadena que contiene la abreviatura de la era especificada, si existe.

GetAbbreviatedMonthName(Int32)

Para el mes especificado, devuelve su abreviatura según la referencia cultural asociada al objeto DateTimeFormatInfo actual.

GetAllDateTimePatterns()

Devuelve todos los modelos estándar en los que se puede aplicar formato a los valores de fecha y hora.

GetAllDateTimePatterns(Char)

Devuelve todos los modelos en los que se puede aplicar formato a valores de fecha y hora mediante la cadena de formato estándar especificado.

GetDayName(DayOfWeek)

Para el día de la semana especificado, devuelve su nombre completo según la referencia cultural asociada al objeto DateTimeFormatInfo actual.

GetEra(String)

Devuelve el valor entero que representa la era especificada.

GetEraName(Int32)

Devuelve la cadena que contiene el nombre de la era especificada.

GetFormat(Type)

Devuelve un objeto del tipo especificado que proporciona un servicio de formato de fecha y hora.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetInstance(IFormatProvider)

Devuelve el objeto DateTimeFormatInfo asociado al objeto IFormatProvider especificado.

GetMonthName(Int32)

Para el mes especificado, devuelve su nombre completo según la referencia cultural asociada al objeto DateTimeFormatInfo actual.

GetShortestDayName(DayOfWeek)

Obtiene la abreviatura más corta para un día de la semana especificado asociado al objeto DateTimeFormatInfo actual.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ReadOnly(DateTimeFormatInfo)

Devuelve un contenedor de DateTimeFormatInfo de solo lectura.

SetAllDateTimePatterns(String[], Char)

Establece las cadenas del formato de fecha y hora personalizadas que corresponden a una cadena de formato estándar especificada.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Rellena un objeto SerializationInfo con los datos necesarios para serializar el objeto de destino.

Se aplica a

Consulte también