Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

DateTimeFormatInfo (Clase)

Define el modo en que se aplica formato y se muestran los valores DateTime, dependiendo de la referencia cultural.

System.Object
  System.Globalization.DateTimeFormatInfo

Espacio de nombres:  System.Globalization
Ensamblado:  mscorlib (en mscorlib.dll)
[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class DateTimeFormatInfo : ICloneable, 
	IFormatProvider

El tipo DateTimeFormatInfo expone los siguientes miembros.

  Nombre Descripción
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif DateTimeFormatInfo Inicializa una nueva instancia de la clase DateTimeFormatInfo en la que se puede escribir y que es independiente de la referencia cultural (invariable).
Arriba
  Nombre Descripción
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif 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.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif AbbreviatedMonthGenitiveNames Obtiene o establece una matriz de cadenas de nombres abreviados de los meses asociada al objeto DateTimeFormatInfo actual.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif AbbreviatedMonthNames Obtiene o establece una matriz de una dimensión de tipo String que contiene abreviaturas específicas de la referencia cultural de los meses.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif AMDesignator Obtiene o establece el designador de cadena para las horas que son "ante meridiem" (antes de mediodía).
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif Calendar Obtiene o establece el calendario que se utilizará para la referencia cultural actual.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif CalendarWeekRule Obtiene o establece el valor que especifica la regla que se utiliza para determinar la primera semana del calendario del año.
Propiedad pública Miembro estático Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif CurrentInfo Obtiene un objeto DateTimeFormatInfo de sólo lectura que aplica formato a los valores basándose en la referencia cultural actual.
Propiedad pública Compatible con XNA Framework DateSeparator Obtiene o establece la cadena que separa los componentes de una fecha; es decir, el año, el mes y el día.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif DayNames 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 días de la semana.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif FirstDayOfWeek Obtiene o establece el primer día de la semana.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif FullDateTimePattern Obtiene o establece el modelo de formato para un valor de fecha y hora largas, que está asociado al modelo de formato "F".
Propiedad pública Miembro estático Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif InvariantInfo Obtiene el objeto DateTimeFormatInfo predeterminado de solo lectura que es independiente de la referencia cultural (invariable).
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif IsReadOnly Obtiene un valor que indica si el objeto DateTimeFormatInfo es de sólo lectura.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif LongDatePattern Obtiene o establece la cadena de formato personalizada, que está asociada a la cadena de formato estándar "D" para un valor de fecha larga.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif LongTimePattern Obtiene o establece el modelo de formato para un valor de hora larga, que está asociado al modelo de formato "T".
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif MonthDayPattern Obtiene o establece el modelo de formato para un valor de mes y día, que está asociado a los formatos de formato "m" y "M".
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif MonthGenitiveNames Obtiene o establece una matriz de cadenas de nombres de los meses asociada al objeto DateTimeFormatInfo actual.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif 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.
Propiedad pública NativeCalendarName Obtiene el nombre nativo del calendario asociado al objeto DateTimeFormatInfo actual.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif PMDesignator Obtiene o establece el designador de cadena para las horas que son "post meridiem" (después de mediodía).
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif RFC1123Pattern Obtiene el modelo de formato para un valor de hora, que se basa en la especificación Request for Comments (RFC) 1123 de Internet Engineering Task Force (IETF) y está asociada a los modelos de formato "r" y "R".
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif ShortDatePattern Obtiene o establece el modelo de formato para un valor de fecha corta, que está asociado al modelo de formato "d".
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif 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.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif ShortTimePattern Obtiene o establece el modelo de formato para un valor de hora corta, que está asociado al modelo de formato "t".
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif SortableDateTimePattern Obtiene el modelo de formato para un valor de fecha y hora que se puede organizar, que está asociado al modelo de formato "s".
Propiedad pública Compatible con XNA Framework TimeSeparator Obtiene o establece la cadena que separa los componentes de una hora; es decir, la hora, los minutos y los segundos.
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif UniversalSortableDateTimePattern Obtiene el modelo de formato para un valor universal de fecha y hora que se puede ordenar y está asociado al modelo de formato "u".
Propiedad pública Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif YearMonthPattern Obtiene o establece el modelo de formato para un valor de año y mes, que está asociado a los modelos de formato "y" e "Y".
Arriba
  Nombre Descripción
Método público Compatible con XNA Framework Clone Crea una copia superficial del objeto DateTimeFormatInfo.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif Finalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetAbbreviatedDayName Para el día de la semana especificado, devuelve su abreviatura según la referencia cultural asociada al objeto DateTimeFormatInfo actual.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetAbbreviatedEraName Devuelve la cadena que contiene la abreviatura de la era especificada, si existe.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetAbbreviatedMonthName Para el mes especificado, devuelve su abreviatura según la referencia cultural asociada al objeto DateTimeFormatInfo actual.
Método público Compatible con XNA Framework GetAllDateTimePatterns() Devuelve todos los modelos estándar en los que se puede aplicar formato a los valores de fecha y hora.
Método público Compatible con XNA Framework 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.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetDayName Para el día de la semana especificado, devuelve su nombre completo según la referencia cultural asociada al objeto DateTimeFormatInfo actual.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetEra Devuelve el valor entero que representa la era especificada.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetEraName Devuelve la cadena que contiene el nombre de la era especificada.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetFormat Devuelve un objeto del tipo especificado que proporciona un servicio de formato DateTime.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público Miembro estático Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetInstance Devuelve el objeto DateTimeFormatInfo asociado al objeto IFormatProvider especificado.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetMonthName Para el mes especificado, devuelve su nombre completo según la referencia cultural asociada al objeto DateTimeFormatInfo actual.
Método público GetShortestDayName Obtiene la abreviatura más corta para un día de la semana especificado asociado al objeto DateTimeFormatInfo actual.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público Miembro estático Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif ReadOnly Devuelve un contenedor de DateTimeFormatInfo de solo lectura.
Método público SetAllDateTimePatterns Establece las cadenas del formato de fecha y hora personalizadas que corresponden a una cadena de formato estándar especificada.
Método público Compatible con XNA Framework c6dw49cz.PortableClassLibrary(es-es,VS.100).gif ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Arriba

Esta clase contiene información, como modelos de fecha, modelos de hora y designadores de AM/PM. A los valores de DateTime se les da formato mediante modelos personalizados o estándar almacenados en las propiedades de un objeto DateTimeFormatInfo.

Al utilizar el constructor DateTimeFormatInfo directamente en la aplicación, únicamente se crea información de fecha y hora para la referencia cultural de todos los idiomas. La aplicación usa la propiedad InvariantInfo para una versión de solo lectura o el constructor DateTimeFormatInfo para una versión modificable. No es posible crear un objeto DateTimeFormatInfo para una referencia cultural neutra.

Para crear un objeto DateTimeFormatInfo para una referencia cultural concreta, la aplicación crea un objeto CultureInfo para esa referencia cultural y recupera la propiedad CultureInfo.DateTimeFormat. Los datos de fecha y hora obtenidos de esta manera solo se aplican a la referencia cultural concreta.

Para crear un objeto DateTimeFormatInfo para la referencia cultural del subproceso actual, la aplicación debe usar la propiedad CurrentInfo.

El usuario puede optar por invalidar algunos de los valores asociados a la referencia cultural actual de Windows a través de de la configuración referente a las opciones de configuración regional y de idioma del Panel de control. Por ejemplo, el usuario puede mostrar la fecha en un formato diferente o utilizar una moneda diferente a la predeterminada para la referencia cultural. Si la propiedad CultureInfo.UseUserOverride se establece en true, las propiedades de los objetos CultureInfo.DateTimeFormat, CultureInfo.NumberFormat y CultureInfo.TextInfo también se recuperan desde la configuración del usuario. Si la configuración del usuario no es compatible con la referencia cultural asociada al objeto CultureInfo (por ejemplo, si el calendario seleccionado no es uno de los calendarios indicados por OptionalCalendars), no se definen los resultados de los métodos ni los valores de las propiedades.

En las versiones anteriores a la versión 2.0 de .NET Framework, si la propiedad CultureInfo.UseUserOverride se establece en true, el objeto sólo lee las propiedades reemplazables por el usuario cuando se obtiene acceso a cada una por primera vez. Debido a que DateTimeFormatInfo tiene más de una propiedad reemplazable por el usuario, esta "inicialización relajada" puede generar una incoherencia entre dichas propiedades cuando la aplicación tiene acceso a una propiedad, el usuario cambia a otra referencia cultural o reemplaza propiedades de la referencia cultural actual de usuario, y después la aplicación obtiene acceso a una propiedad distinta. Por ejemplo, se puede tener acceso a LongDatePattern en una secuencia como ésta. A continuación, el usuario puede cambiar los modelos en el Panel de control. Cuando se obtiene acceso, ShortDatePattern sigue los nuevos valores. Si el usuario elige una referencia cultural distinta, en lugar de reemplazar simplemente un modelo determinado, se puede producir una incoherencia similar.

En la versión 2.0 de .NET Framework y en versiones posteriores, DateTimeFormatInfo no utiliza esta "inicialización relajada". En su lugar, lee todas las propiedades reemplazables por el usuario al crearse. Sigue existiendo cierta vulnerabilidad ya que ni la creación de objetos ni el proceso de invalidación por parte del usuario son atómicos y los valores correspondientes pueden cambiar a mitad del proceso de creación de objetos. Sin embargo, esta situación debe ser muy poco habitual.

Este cambio es de especial importancia en el caso de la serialización. La versión 2.0 de .NET Framework y las versiones posteriores conservan todos los valores reemplazables y no solamente aquellos a los que se tiene acceso cuando se produce la serialización.

La aplicación puede reemplazar modelos estándar por modelos personalizados estableciendo las propiedades adjuntas de un objeto DateTimeFormatInfo en el que se pueda escribir. Para determinar si se puede escribir en un objeto DateTimeFormatInfo, la aplicación debe utilizar la propiedad IsReadOnly.

La tabla siguiente enumera los modelos de formato de DateTime estándar asociados a propiedades DateTimeFormatInfo. Para obtener más información, vea Cadenas con formato de fecha y hora estándar.

Modelo de formato

Propiedad asociada/descripción

d

ShortDatePattern

D

LongDatePattern

f

Fecha y hora completas (fecha larga y hora corta)

F

FullDateTimePattern (fecha larga y hora larga)

g

General (fecha corta y hora corta)

G

General (fecha corta y hora larga)

m, M

MonthDayPattern

o, O

Modelo de fecha y hora de ida y vuelta; con este modelo de formato, la operación de formato o de análisis siempre usa la referencia cultural de todos los idiomas

r, R

RFC1123Pattern; con este modelo de formato, la operación de formato o análisis siempre usa la referencia cultural de todos los idiomas

s

SortableDateTimePattern (se basa en ISO 8601) utilizando la hora local; con este modelo de formato, la operación de formato o análisis siempre usa la referencia cultural de todos los idiomas

t

ShortTimePattern

T

LongTimePattern

u

UniversalSortableDateTimePattern utilizando el formato para la presentación de hora universal; con este modelo de formato, la operación de formato o análisis siempre usa la referencia cultural de todos los idiomas

U

Fecha y hora completas (fecha larga y hora larga) utilizando la hora universal

y, Y

YearMonthPattern

En la tabla siguiente se muestran los modelos de formato DateTime personalizados y su funcionamiento. Para obtener más información, vea Cadenas de formato de fecha y hora personalizadas.

Modelo de formato

Descripción

d, %d

Día del mes. Los días con un solo dígito no se escriben con un cero a la izquierda. La aplicación especifica "%d" si el modelo de formato no se combina con otros modelos de formato.

dd

Día del mes. Los días con un solo dígito se escriben con un cero a la izquierda.

ddd

La abreviatura del día de la semana, como se ha definido en AbbreviatedDayNames.

dddd

El nombre completo del día de la semana, como se ha definido en DayNames.

f, %f

La fracción de un segundo con la precisión de un solo dígito. El resto de los dígitos se truncan. La aplicación especifica "%f" si el modelo de formato no se combina con otros modelos de formato.

ff

La fracción de un segundo con la precisión de dos dígitos. El resto de los dígitos se truncan.

fff

La fracción de un segundo con la precisión de tres dígitos. El resto de los dígitos se truncan.

ffff

La fracción de un segundo con la precisión de cuatro dígitos. El resto de los dígitos se truncan.

fffff

La fracción de un segundo con la precisión de cinco dígitos. El resto de los dígitos se truncan.

ffffff

La fracción de un segundo con la precisión de seis dígitos. El resto de los dígitos se truncan.

fffffff

La fracción de un segundo con la precisión de siete dígitos. El resto de los dígitos se truncan.

F, %F

Muestra el dígito más significativo de la fracción de segundos. Si el dígito es cero, no se muestra nada. La aplicación especifica "%F" si el modelo de formato no se combina con otros modelos de formato.

FF

Muestra los dos dígitos más significativos de la fracción de segundos. Sin embargo, no se muestran ceros finales o dos dígitos cero.

FFF

Muestra los tres dígitos más significativos de la fracción de segundos. Sin embargo, no se muestran ceros finales o tres dígitos cero.

FFFF

Muestra los cuatro dígitos más significativos de la fracción de segundos. Sin embargo, no se muestran ceros finales o cuatro dígitos cero.

FFFFF

Muestra los cinco dígitos más significativos de la fracción de segundos. Sin embargo, no se muestran ceros finales o cinco dígitos cero.

FFFFFF

Muestra los seis dígitos más significativos de la fracción de segundos. Sin embargo, no se muestran ceros finales o seis dígitos cero.

FFFFFFF

Muestra los siete dígitos más significativos de la fracción de segundos. Sin embargo, no se muestran ceros finales o siete dígitos cero.

gg

El período o la era. Este modelo se pasa por alto si la fecha a la que se va a aplicar formato no tiene asociada una cadena de período o de era.

h, %h

La hora en un reloj de 12 horas. Las horas con un solo dígito no se escriben con un cero a la izquierda. La aplicación especifica "%h" si el modelo de formato no se combina con otros modelos de formato.

hh

La hora en un reloj de 12 horas. Las horas con un solo dígito se escriben con un cero a la izquierda.

H, %H

La hora en un reloj de 24 horas. Las horas con un solo dígito no se escriben con un cero a la izquierda. La aplicación especifica "%H" si el modelo de formato no se combina con otros modelos de formato.

HH

La hora en un reloj de 24 horas. Las horas con un solo dígito se escriben con un cero a la izquierda.

K

Distintos valores de la propiedad Kind, es decir, Local, Utc o Unspecified.

m, %m

Minutos. Los minutos con un solo dígito se escriben con un cero a la izquierda. La aplicación especifica "%m" si el modelo de formato no se combina con otros modelos de formato.

mm

Minutos. Los minutos con un solo dígito se escriben con un cero a la izquierda.

M, %M

El valor numérico del mes. Los meses con un solo dígito no se escriben con un cero a la izquierda. La aplicación especifica "%M" si el modelo de formato no se combina con otros modelos de formato.

MM

El valor numérico del mes. Los meses con un solo dígito se escriben con un cero a la izquierda.

MMM

La abreviatura del mes, como se ha definido en AbbreviatedMonthNames.

MMMM

El nombre completo del mes, como se ha definido en MonthNames.

s, %s

Segundos. Los segundos con un solo dígito se escriben con un cero a la izquierda. La aplicación especifica "%s" si el modelo de formato no se combina con otros modelos de formato.

ss

Segundos. Los segundos con un solo dígito se escriben con un cero a la izquierda.

t, %t

El primer carácter del designador AM/PM que se ha definido en AMDesignator o PMDesignator, si lo hubiera. La aplicación especifica "%t" si el modelo de formato no se combina con otros modelos de formato.

tt

El designador AM/PM que se ha definido en AMDesignator o PMDesignator, si lo hubiera. La aplicación debe utilizar este modelo de formato para los idiomas en los que sea necesario mantener la distinción entre a.m. y p.m. Un ejemplo es el japonés, en el que los designadores de a.m. y p.m. se diferencian en el segundo carácter en vez de en el primero.

y, %y

El año sin el siglo. Si el año sin el siglo es menor que 10, el año se muestra sin ceros a la izquierda. La aplicación especifica "%y" si el modelo de formato no se combina con otros modelos de formato.

yy

El año sin el siglo. Si el año sin el siglo es menor que 10, el año se muestra sin un cero a la izquierda.

yyy

El año con tres dígitos. Si el año es menor que 100, se muestra con un cero a la izquierda.

yyyy

El año con cuatro o cinco dígitos (dependiendo del calendario utilizado), incluido el siglo. Se rellena con ceros a la izquierda para obtener cuatro dígitos. Los calendarios budista tailandés y coreano tienen años de cinco dígitos. Los usuarios que seleccionen el modelo "aaaa" ven cinco dígitos sin ceros a la izquierda en los calendarios que tienen cinco dígitos. Excepción: los calendarios japonés y taiwanés siempre se comportan como si se hubiera seleccionado "aa".

yyyyy

El año con cinco dígitos. Se rellena con ceros a la izquierda para obtener cinco dígitos. Excepción: los calendarios japonés y taiwanés siempre se comportan como si se hubiera seleccionado "aa".

yyyyyy

El año con seis dígitos. Se rellena con ceros a la izquierda para obtener seis dígitos. Excepción: los calendarios japonés y taiwanés siempre se comportan como si se hubiera seleccionado "aa". El modelo se puede continuar con una cadena más larga de "a" que se rellene con más ceros a la izquierda.

z, %z

El desplazamiento de la zona horaria ("+" o "-" seguido sólo de la hora). Las horas con un solo dígito no se escriben con un cero a la izquierda. Por ejemplo, la Hora estándar del Pacífico es "-8". La aplicación especifica "%z" si el modelo de formato no se combina con otros modelos de formato.

zz

El desplazamiento de la zona horaria ("+" o "-" seguido sólo de la hora). Las horas con un solo dígito se escriben con un cero a la izquierda. Por ejemplo, la Hora estándar del Pacífico es "-08".

zzz

El desplazamiento de la zona horaria ("+" o "-" seguido de la hora y los minutos). Las horas y los minutos con un solo dígito se escriben con ceros a la izquierda. Por ejemplo, la Hora estándar del Pacífico es "-08:00".

:

El separador de hora predeterminado que se ha definido en TimeSeparator.

/

El separador de fecha predeterminado que se ha definido en DateSeparator.

% c

Donde c es un modelo de formato si se utiliza por si solo. Para utilizar el modelo de formato "d", "f", "F", "h", "m", "s", "t", "y", "z", "H" o "M" por sí solo, la aplicación especifica "%d", "%f", "%F", "%h", "%m", "%s", "%t", "%y", "%z", "%H" o "%M".

El carácter "%" puede omitirse si el modelo de formato se combina con caracteres literales u otros modelos de formato.

\ c

Donde c es cualquier carácter. Muestra el carácter literalmente. Para mostrar el carácter de barra diagonal inversa, la aplicación debe utilizar "\\".

Sólo los modelos de formato enumerados en la segunda tabla anterior se pueden utilizar para crear modelos personalizados. Los modelos de formato estándar enumerados en la primera tabla sólo se utilizan para crear modelos estándar. Los modelos personalizados tienen al menos dos caracteres de longitud, por ejemplo:

  • DateTime.ToString("d") devuelve el valor de DateTime; "d" es el modelo de fecha corto estándar.

  • DateTime.ToString("%d") devuelve el día del mes; "%d" es un modelo personalizado.

  • DateTime.ToString("d ") devuelve el día del mes seguido de un carácter de espacio en blanco; "d" es un modelo personalizado.

La aplicación puede crear un objeto DateTimeFormatInfo o un objeto NumberFormatInfo sólo para la referencia cultural de todos los idiomas o para referencias culturales específicas, no para referencias culturales neutras. Para obtener más información acerca de la referencia cultural invariable y referencias culturales neutras, vea la clase CultureInfo.

Esta clase implementa la interfaz ICloneable para habilitar la duplicación de objetos DateTimeFormatInfo. También implementa IFormatProvider para proporcionar información de formato a aplicaciones.

En el siguiente ejemplo de código se imprimen los diferentes modelos de formato para la referencia cultural en-US. También se muestra el valor de las propiedades adjuntas a los modelos de formato.


using System;
using System.Globalization;


public class SamplesDTFI  {

   public static void Main()  {

      // Creates and initializes a DateTimeFormatInfo associated with the en-US culture.
      DateTimeFormatInfo myDTFI = new CultureInfo( "en-US", false ).DateTimeFormat;

      // Creates a DateTime with the Gregorian date January 3, 2002 (year=2002, month=1, day=3).
      // The Gregorian calendar is the default calendar for the en-US culture.
      DateTime myDT = new DateTime( 2002, 1, 3 );

      // Displays the format pattern associated with each format character.
      Console.WriteLine( "FORMAT  en-US EXAMPLE" );
      Console.WriteLine( "CHAR    VALUE OF ASSOCIATED PROPERTY, IF ANY\n" );
      Console.WriteLine( "  d     {0}", myDT.ToString("d", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.ShortDatePattern, "(ShortDatePattern)" );
      Console.WriteLine( "  D     {0}", myDT.ToString("D", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.LongDatePattern, "(LongDatePattern)" );
      Console.WriteLine( "  f     {0}\n", myDT.ToString("f", myDTFI) );
      Console.WriteLine( "  F     {0}", myDT.ToString("F", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.FullDateTimePattern, "(FullDateTimePattern)" );
      Console.WriteLine( "  g     {0}\n", myDT.ToString("g", myDTFI) );
      Console.WriteLine( "  G     {0}\n", myDT.ToString("G", myDTFI) );
      Console.WriteLine( "  m     {0}", myDT.ToString("m", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.MonthDayPattern, "(MonthDayPattern)" );
      Console.WriteLine( "  M     {0}", myDT.ToString("M", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.MonthDayPattern, "(MonthDayPattern)" );
      Console.WriteLine( "  o     {0}\n", myDT.ToString("o", myDTFI) );
      Console.WriteLine( "  r     {0}", myDT.ToString("r", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.RFC1123Pattern, "(RFC1123Pattern)" );
      Console.WriteLine( "  R     {0}", myDT.ToString("R", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.RFC1123Pattern, "(RFC1123Pattern)" );
      Console.WriteLine( "  s     {0}", myDT.ToString("s", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.SortableDateTimePattern, "(SortableDateTimePattern)" );
      Console.WriteLine( "  t     {0}", myDT.ToString("t", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.ShortTimePattern, "(ShortTimePattern)" );
      Console.WriteLine( "  T     {0}", myDT.ToString("T", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.LongTimePattern, "(LongTimePattern)" );
      Console.WriteLine( "  u     {0}", myDT.ToString("u", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.UniversalSortableDateTimePattern, "(UniversalSortableDateTimePattern)" );
      Console.WriteLine( "  U     {0}\n", myDT.ToString("U", myDTFI) );
      Console.WriteLine( "  y     {0}", myDT.ToString("y", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.YearMonthPattern, "(YearMonthPattern)" );
      Console.WriteLine( "  Y     {0}", myDT.ToString("Y", myDTFI) );
      Console.WriteLine( "        {0} {1}\n", myDTFI.YearMonthPattern, "(YearMonthPattern)" );

   }

}

/*
This code produces the following output.

FORMAT  en-US EXAMPLE
CHAR    VALUE OF ASSOCIATED PROPERTY, IF ANY

  d     1/3/2002
        M/d/yyyy (ShortDatePattern)

  D     Thursday, January 03, 2002
        dddd, MMMM dd, yyyy (LongDatePattern)

  f     Thursday, January 03, 2002 12:00 AM

  F     Thursday, January 03, 2002 12:00:00 AM
        dddd, MMMM dd, yyyy h:mm:ss tt (FullDateTimePattern)

  g     1/3/2002 12:00 AM

  G     1/3/2002 12:00:00 AM

  m     January 03
        MMMM dd (MonthDayPattern)

  M     January 03
        MMMM dd (MonthDayPattern)

  o     2002-01-03T00:00:00.0000000

  r     Thu, 03 Jan 2002 00:00:00 GMT
        ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)

  R     Thu, 03 Jan 2002 00:00:00 GMT
        ddd, dd MMM yyyy HH':'mm':'ss 'GMT' (RFC1123Pattern)

  s     2002-01-03T00:00:00
        yyyy'-'MM'-'dd'T'HH':'mm':'ss (SortableDateTimePattern)

  t     12:00 AM
        h:mm tt (ShortTimePattern)

  T     12:00:00 AM
        h:mm:ss tt (LongTimePattern)

  u     2002-01-03 00:00:00Z
        yyyy'-'MM'-'dd HH':'mm':'ss'Z' (UniversalSortableDateTimePattern)

  U     Thursday, January 03, 2002 8:00:00 AM

  y     January, 2002
        MMMM, yyyy (YearMonthPattern)

  Y     January, 2002
        MMMM, yyyy (YearMonthPattern)

*/


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Compatible con:

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar