Compartir a través de


DateTimeFormatInfo Clase

Definición

Proporciona información específica de la referencia cultural sobre el 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 objeto DateTimeFormatInfo 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 grabable de la clase DateTimeFormatInfo independiente de la referencia cultural (invariable).

Propiedades

AbbreviatedDayNames

Obtiene o establece una matriz unidimensional de tipo String que contiene los nombres abreviados específicos de la referencia cultural de los días de la semana.

AbbreviatedMonthGenitiveNames

Obtiene o establece una matriz de cadenas de nombres de mes abreviados asociados al objeto DateTimeFormatInfo actual.

AbbreviatedMonthNames

Obtiene o establece una matriz de cadenas unidimensionales que contiene los nombres abreviados específicos de la referencia cultural de los meses.

AMDesignator

Obtiene o establece el designador de cadenas durante horas que son "ante meridiem" (antes del mediodía).

Calendar

Obtiene o establece el calendario que se va a usar para la referencia cultural actual.

CalendarWeekRule

Obtiene o establece un valor que especifica qué regla se usa para determinar la primera semana natural del año.

CurrentInfo

Obtiene un objeto DateTimeFormatInfo de solo lectura que da formato a los valores en función de 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 cadenas unidimensionales 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 una fecha larga y un valor de tiempo largo.

InvariantInfo

Obtiene el objeto de solo lectura predeterminado DateTimeFormatInfo 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 durante un valor de tiempo prolongado.

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 mes asociados al objeto DateTimeFormatInfo actual.

MonthNames

Obtiene o establece una matriz unidimensional 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 cadenas durante horas que son "post meridiem" (después del mediodía).

RFC1123Pattern

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

ShortDatePattern

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

ShortestDayNames

Obtiene o establece una matriz de cadenas de los nombres de día abreviados más cortos más cortos asociados al objeto DateTimeFormatInfo actual.

ShortTimePattern

Obtiene o establece la cadena de formato personalizado para un valor de tiempo corto.

SortableDateTimePattern

Obtiene la cadena de formato personalizado para un valor de fecha y hora ordenable.

TimeSeparator

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

UniversalSortableDateTimePattern

Obtiene la cadena de formato personalizado para una cadena de fecha y hora universal y ordenable, tal 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 del DateTimeFormatInfo.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetAbbreviatedDayName(DayOfWeek)

Devuelve el nombre abreviado específico de la referencia cultural del día especificado de la semana en función de la referencia cultural asociada al objeto DateTimeFormatInfo actual.

GetAbbreviatedEraName(Int32)

Devuelve la cadena que contiene el nombre abreviado de la era especificada, si existe una abreviatura.

GetAbbreviatedMonthName(Int32)

Devuelve el nombre abreviado específico de la referencia cultural del mes especificado en función de la referencia cultural asociada al objeto DateTimeFormatInfo actual.

GetAllDateTimePatterns()

Devuelve todos los patrones estándar en los que se pueden dar formato a los valores de fecha y hora.

GetAllDateTimePatterns(Char)

Devuelve todos los patrones en los que se pueden dar formato a los valores de fecha y hora mediante la cadena de formato estándar especificada.

GetDayName(DayOfWeek)

Devuelve el nombre completo específico de la referencia cultural del día especificado de la semana en función de la referencia cultural asociada al objeto DateTimeFormatInfo actual.

GetEra(String)

Devuelve el 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()

Actúa como función hash predeterminada.

(Heredado de Object)
GetInstance(IFormatProvider)

Devuelve el objeto DateTimeFormatInfo asociado al IFormatProviderespecificado.

GetMonthName(Int32)

Devuelve el nombre completo específico de la referencia cultural del mes especificado en función de la referencia cultural asociada al objeto DateTimeFormatInfo actual.

GetShortestDayName(DayOfWeek)

Obtiene el nombre de día abreviado más corto para un día especificado de la semana asociado al objeto DateTimeFormatInfo actual.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
ReadOnly(DateTimeFormatInfo)

Devuelve un contenedor de DateTimeFormatInfo de solo lectura.

SetAllDateTimePatterns(String[], Char)

Establece las cadenas de 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 una serializaciónInfo con los datos necesarios para serializar el objeto de destino.

Se aplica a

Consulte también