Cadenas con formato de fecha y hora estándar

Artikulua
06/05/2023

Una cadena de formato de fecha y hora estándar usa un único carácter como especificador de formato para definir la representación de texto de un valor DateTime o DateTimeOffset. Cualquier cadena con formato de fecha y hora que contenga más de un carácter, incluido un espacio en blanco, se interpreta como una cadena con formato de fecha y hora personalizado. Una cadena de formato estándar o personalizado se puede usar de dos maneras:

Para definir la cadena resultante una operación de formato.
Para definir la representación de texto de un valor de fecha y hora que se puede convertir en un valor DateTime o DateTimeOffset mediante una operación de análisis.

Sugerencia

Puede descargar la Utilidad de formato, que es una aplicación de Windows Forms de .NET que permite aplicar cadenas de formato a valores numéricos o de fecha y hora, y que muestra la cadena de resultado. El código fuente está disponible para C# y Visual Basic.

Nota

Algunos de los ejemplos de C# de este artículo se ejecutan en el ejecutor de código en línea y área de juegos de Try.NET. Haga clic en el botón Ejecutar para ejecutar un ejemplo en una ventana interactiva. Una vez que se ejecuta el código, puede modificar y ejecutar el código modificado si vuelve a hacer clic en Ejecutar. El código modificado se ejecuta en la ventana interactiva o, si se produce un error en la compilación, en la ventana interactiva se muestran todos los mensajes de error del compilador de C#.

La zona horaria local del ejecutor de código en línea de Try.NET y del área de juegos es la hora universal coordinada o UTC. Esto puede afectar al comportamiento y la salida de ejemplos que ilustran los tipos DateTime, DateTimeOffset y TimeZoneInfo y sus miembros.

Tabla de especificadores de formato

En la tabla siguiente se describen los especificadores de formato de fecha y hora estándar. A menos que se indique lo contrario, un determinado especificador de formato de fecha y hora estándar genera una representación de cadena idéntica independientemente de que se use con un valor DateTime o DateTimeOffset. Vea Configuración del Panel de control y Propiedades de DateTimeFormatInfo para obtener información adicional sobre el uso de cadenas de formato de fecha y hora estándar.

Especificador de formato	Descripción	Ejemplos
"d"	Patrón de fecha corta. Más información: El especificador de formato de fecha corta ("d").	2009-06-15T13:45:30 -> 6/15/2009 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Patrón de fecha larga. Más información: El especificador de formato de fecha larga ("D").	2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Patrón de fecha y hora completa (hora corta). Más información: El especificador de formato de fecha completa y hora corta ("f").	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Patrón de fecha y hora completa (hora larga). Más información: El especificador de formato de fecha completa y hora larga ("F").	2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Patrón de fecha y hora general (hora corta). Más información: El especificador de formato de fecha general y hora corta ("g").	2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Patrón de fecha y hora general (hora larga). Más información: El especificador de formato de fecha general y hora larga ("G").	2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Patrón de mes/día. Más información: El especificador de formato de mes ("M", "m").	2009-06-15T13:45:30 -> June 15 (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o"	Patrón de fecha y hora de ida y vuelta. Más información: El especificador de formato de operación de ida y vuelta ("O", "o").	Valores de DateTime: 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 Valores de DateTimeOffset: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r"	Patrón RFC1123. Más información: El especificador de formato RFC1123 ("R", "r").	DateTimeOffset input: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT DateTime input: 2009-06-15T13:45:30 -> Mon, 15 Jun 2009 13:45:30 GMT
"s"	Patrón de fecha y hora que se puede ordenar. Más información: El especificador de formato que se puede ordenar ("s").	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t"	Patrón de hora corta. Más información: El especificador de formato de hora corta ("t").	2009-06-15T13:45:30 -> 1:45 PM (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Patrón de hora larga. Más información: El especificador de formato de hora larga ("T").	2009-06-15T13:45:30 -> 1:45:30 PM (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Patrón de fecha y hora universal que se puede ordenar. Más información: El especificador de formato universal que se puede ordenar ("u").	Con un valor DateTime: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Con un valor DateTimeOffset: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Patrón de fecha y hora completa universal. Más información: El especificador de formato completo universal ("U").	2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y"	Patrón de mes y año. Más información: El especificador de formato de mes y año ("Y").	2009-06-15T13:45:30 -> June 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Cualquier otro carácter único	Especificador desconocido.	Produce una excepción FormatException en tiempo de ejecución.

Cómo funcionan las cadenas con formato estándar

En una operación de formato, una cadena de formato estándar es simplemente un alias de una cadena con formato personalizado. La ventaja de usar un alias para referirse a una cadena de formato personalizado es que, aunque el alias permanece invariable, la propia cadena de formato personalizado puede variar. Esto es importante, porque las representaciones de cadena de valores de fecha y hora suelen variar con las referencias culturales. Por ejemplo, la cadena de formato estándar "d" indica que un valor de fecha y hora se va a mostrar utilizando un patrón de fecha corta. En la referencia cultural de todos los idiomas, este patrón es "MM/dd/aaaa". En la referencia cultural fr-FR, es "dd/MM/aaaa". En la referencia cultural ja-JP, es "aaaa/MM/dd."

Si una cadena con formato estándar en una operación de formato se asigna a una cadena con formato personalizado de una referencia cultural específica, la aplicación puede definir la referencia cultural concreta cuyas cadenas con formato personalizado se usan de uno de los modos siguientes:

Puede utilizar la referencia cultural predeterminada (o la actual). En el ejemplo siguiente se muestra una fecha con el formato de fecha abreviado de la referencia cultural. En este caso, la referencia cultural actual es en-US.

// Display using current (en-us) culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008

' Display using current (en-us) culture's short date format
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

Puede pasar un objeto CultureInfo que represente la referencia cultural cuyo formato se va a usar a un método que tenga un parámetro IFormatProvider. En el ejemplo siguiente se muestra una fecha con el formato de fecha abreviado de la referencia cultural pt-BR.

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

Puede pasar un objeto DateTimeFormatInfo que proporcione información sobre el formato a un método que tenga un parámetro IFormatProvider. En el ejemplo siguiente se muestra una fecha con el formato de fecha abreviado de un objeto DateTimeFormatInfo en la referencia cultural hr-HR.

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

Nota

Para obtener información sobre la personalización de patrones o cadenas usadas para dar formato a valores de fecha y hora, vea el tema sobre la clase NumberFormatInfo.

En algunos casos, la cadena con formato estándar actúa como la abreviatura correspondiente de una cadena con formato personalizado más larga que es invariable. Hay cuatro cadenas de formato estándar que pertenecen a esta categoría: "O" (u "o"), "R" (o "r"), "s" y "u". Estas cadenas se corresponden con las cadenas de formato personalizado definidas en la referencia cultural de todos los idiomas. Generan representaciones de cadena de valores de fecha y hora que están pensados para que sean idénticos en todas las referencias culturales. En la tabla siguiente se proporciona información sobre estas cuatro cadenas de formato de fecha y hora estándar.

Cadena con formato estándar	Se define en la propiedad DateTimeFormatInfo.InvariantInfo	Cadena con formato personalizado
"O" u "o"	None	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK
"R" o "r"	RFC1123Pattern	ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s"	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Las cadenas de formato estándar también se pueden usar en operaciones de análisis con los métodos DateTime.ParseExact o DateTimeOffset.ParseExact, que necesitan que una cadena de entrada se ajuste exactamente a un patrón determinado para que la operación de análisis se realice correctamente. Muchas cadenas de formato estándar se asignan a varias cadenas de formato personalizado, por lo que un valor de fecha y hora se pueden representar en diversos formatos y la operación de análisis todavía se realizará correctamente. Puede determinar la cadena o las cadenas con formato personalizado correspondientes a una cadena con formato estándar llamando al método DateTimeFormatInfo.GetAllDateTimePatterns(Char). En el ejemplo siguiente se muestran las cadenas con formato personalizado que se asignan a la cadena de formato estándar "d" (patrón de fecha corta).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine("   {0}", customString);
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

En las próximas secciones se describen los especificadores de formato estándar para los valores DateTime y DateTimeOffset.

Formatos de fecha

Este grupo incluye los formatos siguientes:

El especificador de formato de fecha corta ("d")
El especificador de formato de fecha larga ("D")

El especificador de formato de fecha corta ("d")

El especificador de formato estándar "d" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.ShortDatePattern de una referencia cultural concreta. Por ejemplo, la cadena de formato personalizado devuelta por la propiedad ShortDatePattern de la referencia cultural de todos los idiomas es "MM/dd/yyyy".

En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que controlan el formato de la cadena devuelta.

Propiedad.	Descripción
ShortDatePattern	Define el formato global de la cadena de resultado.
DateSeparator	Define la cadena que separa los componentes de año, mes y día de una fecha.

En el ejemplo siguiente se usa el especificador de formato "d" para mostrar un valor de fecha y hora.

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008

Propiedad.	Descripción
LongDatePattern	Define el formato global de la cadena de resultado.
DayNames	Define los nombres de días traducidos que pueden aparecer en la cadena de resultado.
MonthNames	Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.

Propiedad.	Descripción
LongDatePattern	Define el formato del componente de fecha de la cadena de resultado.
ShortTimePattern	Define el formato del componente de hora de la cadena de resultado.
DayNames	Define los nombres de días traducidos que pueden aparecer en la cadena de resultado.
MonthNames	Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.
TimeSeparator	Define la cadena que separa los componentes de hora, minutos y segundos de una hora.
AMDesignator	Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.
PMDesignator	Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.

Propiedad.	Descripción
FullDateTimePattern	Define el formato global de la cadena de resultado.
DayNames	Define los nombres de días traducidos que pueden aparecer en la cadena de resultado.
MonthNames	Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.
TimeSeparator	Define la cadena que separa los componentes de hora, minutos y segundos de una hora.
AMDesignator	Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.
PMDesignator	Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.

Propiedad.	Descripción
ShortDatePattern	Define el formato del componente de fecha de la cadena de resultado.
LongTimePattern	Define el formato del componente de hora de la cadena de resultado.
DateSeparator	Define la cadena que separa los componentes de año, mes y día de una fecha.
TimeSeparator	Define la cadena que separa los componentes de hora, minutos y segundos de una hora.
AMDesignator	Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.
PMDesignator	Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.

Propiedad.	Descripción
RFC1123Pattern	Define el formato de la cadena de resultado.
AbbreviatedDayNames	Define los nombres de días abreviados que pueden aparecer en la cadena de resultado.
AbbreviatedMonthNames	Define los nombres de meses abreviados que pueden aparecer en la cadena de resultado.

Propiedad.	Descripción
MonthDayPattern	Define el formato global de la cadena de resultado.
MonthNames	Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.

Propiedad.	Descripción
YearMonthPattern	Define el formato global de la cadena de resultado.
MonthNames	Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.

Partekatu honen bidez:

Cadenas con formato de fecha y hora estándar

Tabla de especificadores de formato

Cómo funcionan las cadenas con formato estándar

Formatos de fecha

El especificador de formato de fecha corta ("d")

El especificador de formato de fecha larga ("D")

Formatos de fecha y hora

El especificador de formato de fecha completa y hora corta ("f")

El especificador de formato de fecha completa y hora larga ("F")

El especificador de formato de fecha general y hora corta ("g")

El especificador de formato de fecha general y hora larga ("G")

El especificador de formato de operación de ida y vuelta ("O", "o")

El especificador de formato RFC1123 ("R", "r")

El especificador de formato que se puede ordenar ("s")

El especificador de formato universal que se puede ordenar ("u")

El especificador de formato completo universal ("U")

Formatos de hora

El especificador de formato de hora corta ("t")

El especificador de formato de hora larga ("T")

Formatos de fecha parcial

El especificador de formato de mes ("M", "m")

El especificador de formato de mes y año ("Y", "y")

Configuración del Panel de control

Propiedades de DateTimeFormatInfo

Vea también

Baliabide gehigarriak