DateTimeFormatInfo Clase

Definición

Espacio de nombres:

System.Globalization

Ensamblado:

System.Runtime.dll

Source:

DateTimeFormatInfo.cs

Proporciona información específica de la referencia cultural sobre el formato de los valores de fecha y hora.

public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider

public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider

type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider

Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider

Herencia

Object

DateTimeFormatInfo

Implementaciones

IFormatProvider ICloneable

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)

Consulte también

• DateTime
• Calendar
• CultureInfo