Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Una cadena de formato de fecha y hora estándar usa un solo carácter como especificador de formato para definir la representación de texto de un DateTime o un valor de 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 personalizada se puede usar de dos maneras:
Para definir la cadena resultante de una operación de formato.
Para definir la representación de texto de un valor de fecha y hora que se puede convertir en una DateTime o DateTimeOffset valor mediante una operación de análisis.
Sugerencia
Puede descargar la utilidad de formato de , una aplicación de Windows Forms de .NET que le permite aplicar cadenas de formato a valores numéricos o numéricos o de fecha y hora y mostrar la cadena de resultado. El código fuente está disponible para de C# y Visual Basic.
Nota:
Algunos de los ejemplos de C# de este artículo se ejecutan en la Try.NET ejecutor de código insertado y área de juegos. 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 insertado Try.NET y el área de juegos es hora universal coordinada o UTC. Esto puede afectar al comportamiento y a la salida de ejemplos que ilustran los tipos de DateTime, DateTimeOffsety 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 especificador de formato de fecha y hora estándar determinado genera una representación de cadena idéntica independientemente de si se usa con un DateTime o un valor de DateTimeOffset. Consulte configuración del Panel de control y propiedades 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: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: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"). |
DateTime valores: 2009-06-15T13:45:30 (DateTimeKind.Local):> 2009-06-15T13:45:30.0000000-07:000 2009-06-15T13:45:30 (DateTimeKind.Utc):> 2009-06-15T13:45:30.000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified):> 2009-06-15T13:45:30.00000000 DateTimeOffset valores: 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 entrada: 2009-06-15T13:45:30 -> Mon, 15 jun 2009 20:45:30 GMT DateTime entrada: 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 de DateTime: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Con un valor de 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: Especificador de formato completo universal ("U"). |
2009-06-15T13:45:30 -> lunes, 15 de junio de 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 un FormatExceptionen 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/2008Puede pasar un objeto CultureInfo que representa la referencia cultural cuyo formato se va a usar en 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/2008Puede pasar un objeto DateTimeFormatInfo que proporcione información de formato a un método que tenga un parámetro IFormatProvider. En el ejemplo siguiente se muestra una fecha con el formato de fecha corta de un objeto DateTimeFormatInfo para la referencia cultural de 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 cómo personalizar los patrones o cadenas usados en el formato de valores de fecha y hora, consulte el tema de 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 | Definido por la propiedad DateTimeFormatInfo.InvariantInfo | Cadena con formato personalizado |
|---|---|---|
| "O" u "o" | Ninguno | 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 requieren 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 puede representar en una variedad de formatos y la operación de análisis seguirá siendo correcta. Puede determinar la cadena de formato personalizado o las cadenas que corresponden a una cadena de formato estándar llamando al método DateTimeFormatInfo.GetAllDateTimePatterns(Char). En el ejemplo siguiente se muestran las cadenas de 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($" {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 secciones siguientes se describen los especificadores de formato estándar para los valores de DateTime y DateTimeOffset.
Formatos de fecha
Este grupo incluye los formatos siguientes:
El especificador de formato de fecha corta ("d")
El especificador de formato estándar "d" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.ShortDatePattern de una referencia cultural específica. Por ejemplo, la cadena de formato personalizado que devuelve la propiedad ShortDatePattern de la referencia cultural invariable es "MM/dd/aaaa".
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 general 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
El especificador de formato de fecha larga ("D")
El especificador de formato estándar "D" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.LongDatePattern actual. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "dddd, dd MMMM yyyy".
En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que controlan el formato de la cadena devuelta.
| Propiedad | Descripción |
|---|---|
| LongDatePattern | Define el formato general de la cadena de resultado. |
| DayNames | Define los nombres de día localizados que pueden aparecer en la cadena de resultado. |
| MonthNames | Define los nombres de mes localizados que pueden aparecer en la cadena de resultado. |
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",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008
Console.WriteLine(date1.ToString("D",
CultureInfo.CreateSpecificCulture("pt-BR")));
// Displays quinta-feira, 10 de abril de 2008
Console.WriteLine(date1.ToString("D",
CultureInfo.CreateSpecificCulture("es-MX")));
// Displays jueves, 10 de abril de 2008
Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("D", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008
Console.WriteLine(date1.ToString("D", _
CultureInfo.CreateSpecificCulture("pt-BR")))
' Displays quinta-feira, 10 de abril de 2008
Console.WriteLine(date1.ToString("D", _
CultureInfo.CreateSpecificCulture("es-MX")))
' Displays jueves, 10 de abril de 2008
Formatos de fecha y hora
Este grupo incluye los formatos siguientes:
- 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").
- especificador de formato completo universal ("U")
El especificador de formato de fecha completa y hora corta ("f")
El especificador de formato estándar "f" representa una combinación de los patrones de fecha larga ("D") y hora corta ("t"), separados por un espacio.
La cadena de resultado se ve afectada por la información de formato de un objeto DateTimeFormatInfo específico. En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta. Es posible que el especificador de formato personalizado devuelto por las propiedades DateTimeFormatInfo.LongDatePattern y DateTimeFormatInfo.ShortTimePattern de algunas referencias culturales no use todas las propiedades.
| 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ía localizados que pueden aparecer en la cadena de resultado. |
| MonthNames | Define los nombres de mes localizados que pueden aparecer en la cadena de resultado. |
| TimeSeparator | Define la cadena que separa los componentes de hora, minuto y segundo de una hora. |
| AMDesignator | Define la cadena que indica las horas de medianoche a antes del mediodía en un reloj de 12 horas. |
| PMDesignator | Define la cadena que indica horas del mediodía a la medianoche en un reloj de 12 horas. |
En el ejemplo siguiente se usa el especificador de formato "f" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("f",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30 AM
Console.WriteLine(date1.ToString("f",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("f", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30 AM
Console.WriteLine(date1.ToString("f", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30
El especificador de formato de fecha completa y hora larga ("F")
El especificador de formato estándar "F" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.FullDateTimePattern actual. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "dddd, dd MMMM yyyy HH:mm:ss".
En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta. Es posible que el especificador de formato personalizado devuelto por la propiedad FullDateTimePattern de algunas referencias culturales no use todas las propiedades.
| Propiedad | Descripción |
|---|---|
| FullDateTimePattern | Define el formato general de la cadena de resultado. |
| DayNames | Define los nombres de día localizados que pueden aparecer en la cadena de resultado. |
| MonthNames | Define los nombres de mes localizados que pueden aparecer en la cadena de resultado. |
| TimeSeparator | Define la cadena que separa los componentes de hora, minuto y segundo de una hora. |
| AMDesignator | Define la cadena que indica las horas de medianoche a antes del mediodía en un reloj de 12 horas. |
| PMDesignator | Define la cadena que indica horas del mediodía a la medianoche en un reloj de 12 horas. |
En el ejemplo siguiente se usa el especificador de formato "F" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("F",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 6:30:00 AM
Console.WriteLine(date1.ToString("F",
CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays jeudi 10 avril 2008 06:30:00
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("F", _
CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 6:30:00 AM
Console.WriteLine(date1.ToString("F", _
CultureInfo.CreateSpecificCulture("fr-FR")))
' Displays jeudi 10 avril 2008 06:30:00
El especificador de formato de fecha general y hora corta ("g")
El especificador de formato estándar "g" representa una combinación de los patrones de fecha corta ("d") y hora corta ("t"), separados por un espacio.
La cadena de resultado se ve afectada por la información de formato de un objeto DateTimeFormatInfo específico. En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta. Es posible que el especificador de formato personalizado devuelto por el DateTimeFormatInfo.ShortDatePattern y las propiedades DateTimeFormatInfo.ShortTimePattern de algunas referencias culturales no usen todas las propiedades.
| Propiedad | Descripción |
|---|---|
| ShortDatePattern | 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. |
| 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, minuto y segundo de una hora. |
| AMDesignator | Define la cadena que indica las horas de medianoche a antes del mediodía en un reloj de 12 horas. |
| PMDesignator | Define la cadena que indica horas del mediodía a la medianoche en un reloj de 12 horas. |
En el ejemplo siguiente se usa el especificador de formato "g" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("g",
DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30
Console.WriteLine(date1.ToString("g",
CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30 AM
Console.WriteLine(date1.ToString("g",
CultureInfo.CreateSpecificCulture("fr-BE")));
// Displays 10/04/2008 6:30
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("g", _
DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30
Console.WriteLine(date1.ToString("g", _
CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30 AM
Console.WriteLine(date1.ToString("g", _
CultureInfo.CreateSpecificCulture("fr-BE")))
' Displays 10/04/2008 6:30
El especificador de formato de fecha general y hora larga ("G")
El especificador de formato estándar "G" representa una combinación de los patrones de fecha corta ("d") y hora larga ("T"), separados por un espacio.
La cadena de resultado se ve afectada por la información de formato de un objeto DateTimeFormatInfo específico. En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta. Es posible que el especificador de formato personalizado devuelto por el DateTimeFormatInfo.ShortDatePattern y las propiedades DateTimeFormatInfo.LongTimePattern de algunas referencias culturales no usen todas las propiedades.
| 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, minuto y segundo de una hora. |
| AMDesignator | Define la cadena que indica las horas de medianoche a antes del mediodía en un reloj de 12 horas. |
| PMDesignator | Define la cadena que indica horas del mediodía a la medianoche en un reloj de 12 horas. |
En el ejemplo siguiente se usa el especificador de formato "G" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("G",
DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G",
CultureInfo.CreateSpecificCulture("en-us")));
// Displays 4/10/2008 6:30:00 AM
Console.WriteLine(date1.ToString("G",
CultureInfo.CreateSpecificCulture("nl-BE")));
// Displays 10/04/2008 6:30:00
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("G", _
DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008 06:30:00
Console.WriteLine(date1.ToString("G", _
CultureInfo.CreateSpecificCulture("en-us")))
' Displays 4/10/2008 6:30:00 AM
Console.WriteLine(date1.ToString("G", _
CultureInfo.CreateSpecificCulture("nl-BE")))
' Displays 10/04/2008 6:30:00
El especificador de formato de operación de ida y vuelta ("O", "o")
El especificador de formato estándar "O" u "o" representa una cadena de formato de fecha y hora personalizado mediante un patrón que conserva la información de la zona horaria y emite una cadena de resultado que cumple con la norma ISO 8601. Para DateTime valores, este especificador de formato está diseñado para conservar los valores de fecha y hora junto con la propiedad DateTime.Kind en texto. La cadena con formato se puede analizar mediante el método DateTime.Parse(String, IFormatProvider, DateTimeStyles) o DateTime.ParseExact si el parámetro styles está establecido en DateTimeStyles.RoundtripKind.
El especificador de formato estándar "O" o "o" corresponde al especificador de formato "aaaa"-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK" cadena de formato personalizado para DateTime valores y a "aaaa"-'MM'-'dd'T'HH':'mm':'ss'.' cadena de formato personalizado fffffffzzz" para DateTimeOffset valores. En esta cadena, los pares de comillas simples que delimitan caracteres individuales, como los guiones, los dos puntos y la letra "T", indican que el carácter individual es un literal que no se puede cambiar. Los apóstrofos no aparecen en la cadena de salida.
Especificador de formato estándar "O" o "o" (y "aaaa"-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK" cadena de formato personalizado) aprovecha las tres formas en que ISO 8601 representa información de zona horaria para conservar la propiedad Kind de los valores de DateTime:
El componente de zona horaria de DateTimeKind.Local valores de fecha y hora es un desplazamiento de UTC (por ejemplo, +01:00, -07:00). Todos los valores de DateTimeOffset también se representan en este formato.
El componente de zona horaria de DateTimeKind.Utc valores de fecha y hora usa "Z" (que significa cero desplazamiento) para representar UTC.
DateTimeKind.Unspecified valores de fecha y hora no tienen información de zona horaria.
Dado que el especificador de formato estándar "O" u "o" se ajusta a un estándar internacional, la operación de formato o análisis que utiliza el especificador siempre usa la referencia cultural de todos los idiomas y el calendario gregoriano.
Las cadenas que se pasan al Parse, TryParse, ParseExacty TryParseExact métodos de DateTime y DateTimeOffset se pueden analizar mediante el especificador de formato "O" o "o" si están en uno de estos formatos. En el caso de los objetos DateTime, la sobrecarga de análisis que llama también debe incluir un parámetro styles con un valor de DateTimeStyles.RoundtripKind. Tenga en cuenta que si llama a un método de análisis con la cadena de formato personalizado que corresponde al especificador de formato "O" o "o", no obtendrá los mismos resultados que "O" o "o". Esto se debe a que los métodos de análisis que usan una cadena de formato personalizado no pueden analizar la representación de cadena de valores de fecha y hora que carecen de un componente de zona horaria o usan "Z" para indicar UTC.
En el ejemplo siguiente se usa el especificador de formato "o" para mostrar una serie de valores de DateTime y un valor de DateTimeOffset en un sistema de la zona horaria del Pacífico de EE. UU.
using System;
public class Example
{
public static void Main()
{
DateTime dat = new DateTime(2009, 6, 15, 13, 45, 30,
DateTimeKind.Unspecified);
Console.WriteLine($"{dat} ({dat.Kind}) --> {dat:O}");
DateTime uDat = new DateTime(2009, 6, 15, 13, 45, 30,
DateTimeKind.Utc);
Console.WriteLine($"{uDat} ({uDat.Kind}) --> {uDat:O}");
DateTime lDat = new DateTime(2009, 6, 15, 13, 45, 30,
DateTimeKind.Local);
Console.WriteLine($"{lDat} ({lDat.Kind}) --> {lDat:O}\n");
DateTimeOffset dto = new DateTimeOffset(lDat);
Console.WriteLine($"{dto} --> {dto:O}");
}
}
// The example displays the following output:
// 6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
// 6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
// 6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
//
// 6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00
Module Example
Public Sub Main()
Dim dat As New Date(2009, 6, 15, 13, 45, 30,
DateTimeKind.Unspecified)
Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind)
Dim uDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Utc)
Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind)
Dim lDat As New Date(2009, 6, 15, 13, 45, 30, DateTimeKind.Local)
Console.WriteLine("{0} ({1}) --> {0:O}", lDat, lDat.Kind)
Console.WriteLine()
Dim dto As New DateTimeOffset(lDat)
Console.WriteLine("{0} --> {0:O}", dto)
End Sub
End Module
' The example displays the following output:
' 6/15/2009 1:45:30 PM (Unspecified) --> 2009-06-15T13:45:30.0000000
' 6/15/2009 1:45:30 PM (Utc) --> 2009-06-15T13:45:30.0000000Z
' 6/15/2009 1:45:30 PM (Local) --> 2009-06-15T13:45:30.0000000-07:00
'
' 6/15/2009 1:45:30 PM -07:00 --> 2009-06-15T13:45:30.0000000-07:00
En el ejemplo siguiente se usa el especificador de formato "o" para crear una cadena con formato y, a continuación, se restaura el valor de fecha y hora original llamando a un método de fecha y hora Parse.
// Round-trip DateTime values.
DateTime originalDate, newDate;
string dateString;
// Round-trip a local time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 10, 6, 30, 0), DateTimeKind.Local);
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine($"Round-tripped {originalDate} {originalDate.Kind} to {newDate} {newDate.Kind}.");
// Round-trip a UTC time.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 12, 9, 30, 0), DateTimeKind.Utc);
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine($"Round-tripped {originalDate} {originalDate.Kind} to {newDate} {newDate.Kind}.");
// Round-trip time in an unspecified time zone.
originalDate = DateTime.SpecifyKind(new DateTime(2008, 4, 13, 12, 30, 0), DateTimeKind.Unspecified);
dateString = originalDate.ToString("o");
newDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine($"Round-tripped {originalDate} {originalDate.Kind} to {newDate} {newDate.Kind}.");
// Round-trip a DateTimeOffset value.
DateTimeOffset originalDTO = new DateTimeOffset(2008, 4, 12, 9, 30, 0, new TimeSpan(-8, 0, 0));
dateString = originalDTO.ToString("o");
DateTimeOffset newDTO = DateTimeOffset.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine($"Round-tripped {originalDTO} to {newDTO}.");
// The example displays the following output:
// Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
// Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
// Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
// Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.
' Round-trip DateTime values.
Dim originalDate, newDate As Date
Dim dateString As String
' Round-trip a local time.
originalDate = Date.SpecifyKind(#4/10/2008 6:30AM#, DateTimeKind.Local)
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
newDate, newDate.Kind)
' Round-trip a UTC time.
originalDate = Date.SpecifyKind(#4/12/2008 9:30AM#, DateTimeKind.Utc)
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
newDate, newDate.Kind)
' Round-trip time in an unspecified time zone.
originalDate = Date.SpecifyKind(#4/13/2008 12:30PM#, DateTimeKind.Unspecified)
dateString = originalDate.ToString("o")
newDate = Date.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} {1} to {2} {3}.", originalDate, originalDate.Kind, _
newDate, newDate.Kind)
' Round-trip a DateTimeOffset value.
Dim originalDTO As New DateTimeOffset(#4/12/2008 9:30AM#, New TimeSpan(-8, 0, 0))
dateString = originalDTO.ToString("o")
Dim newDTO As DateTimeOffset = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.RoundtripKind)
Console.WriteLine("Round-tripped {0} to {1}.", originalDTO, newDTO)
' The example displays the following output:
' Round-tripped 4/10/2008 6:30:00 AM Local to 4/10/2008 6:30:00 AM Local.
' Round-tripped 4/12/2008 9:30:00 AM Utc to 4/12/2008 9:30:00 AM Utc.
' Round-tripped 4/13/2008 12:30:00 PM Unspecified to 4/13/2008 12:30:00 PM Unspecified.
' Round-tripped 4/12/2008 9:30:00 AM -08:00 to 4/12/2008 9:30:00 AM -08:00.
El especificador de formato RFC1123 ("R", "r")
El especificador de formato estándar "R" o "r" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.RFC1123Pattern. El patrón refleja una norma definida y la propiedad es de solo lectura. Por consiguiente, siempre es el mismo, sea cual fuere la referencia cultural utilizada o el proveedor de formato proporcionado. La cadena de formato personalizado es "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'". Cuando se utiliza este especificador de formato estándar, la operación de formato o análisis utiliza siempre la referencia cultural de todos los idiomas.
La cadena de resultado se ve afectada por las siguientes propiedades del objeto DateTimeFormatInfo devuelto por la propiedad DateTimeFormatInfo.InvariantInfo que representa la referencia cultural invariable.
| Propiedad | Descripción |
|---|---|
| RFC1123Pattern | Define el formato de la cadena de resultado. |
| AbbreviatedDayNames | Define los nombres de día abreviados que pueden aparecer en la cadena de resultado. |
| AbbreviatedMonthNames | Define los nombres abreviados de mes que pueden aparecer en la cadena de resultado. |
Aunque el estándar RFC 1123 expresa una hora como hora universal coordinada (UTC), la operación de formato no modifica el valor del objeto de DateTime al que se da formato. Por lo tanto, debe convertir el valor de DateTime a UTC llamando al método DateTime.ToUniversalTime antes de realizar la operación de formato. En cambio, DateTimeOffset valores realizan esta conversión automáticamente; No es necesario llamar al método DateTimeOffset.ToUniversalTime antes de la operación de formato.
En el ejemplo siguiente se usa el especificador de formato "r" para mostrar un DateTime y un valor de DateTimeOffset en un sistema de la zona horaria del Pacífico de EE. UU.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
DateTimeOffset dateOffset = new DateTimeOffset(date1,
TimeZoneInfo.Local.GetUtcOffset(date1));
Console.WriteLine(date1.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT
Console.WriteLine(dateOffset.ToUniversalTime().ToString("r"));
// Displays Thu, 10 Apr 2008 13:30:00 GMT
Dim date1 As Date = #4/10/2008 6:30AM#
Dim dateOffset As New DateTimeOffset(date1, TimeZoneInfo.Local.GetUtcOFfset(date1))
Console.WriteLine(date1.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT
Console.WriteLine(dateOffset.ToUniversalTime.ToString("r"))
' Displays Thu, 10 Apr 2008 13:30:00 GMT
El especificador de formato que se puede ordenar ("s")
El especificador de formato estándar "s" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.SortableDateTimePattern. El patrón refleja un estándar definido (ISO 8601) y la propiedad es de solo lectura. Por consiguiente, siempre es el mismo, sea cual fuere la referencia cultural utilizada o el proveedor de formato proporcionado. La cadena de formato personalizado es "yyyy'-'MM'-'dd'T'HH':'mm':'ss".
La finalidad del especificador de formato "s" es generar cadenas de resultado de forma coherente en orden ascendente o descendente según los valores de fecha y hora. Como resultado, aunque el especificador de formato estándar "s" representa un valor de fecha y hora en un formato coherente, la operación de formato no modifica el valor del objeto de fecha y hora que se está formateando para reflejar su propiedad DateTime.Kind o su valor de DateTimeOffset.Offset. Por ejemplo, las cadenas de resultado generadas mediante el formato de los valores de fecha y hora 2014-11-15T18:32:17+00:00 y 2014-11-15T18:32:17+08:00 son idénticos.
Cuando se utiliza este especificador de formato estándar, la operación de formato o análisis utiliza siempre la referencia cultural de todos los idiomas.
En el ejemplo siguiente se usa el especificador de formato "s" para mostrar un DateTime y un valor de DateTimeOffset en un sistema de la zona horaria del Pacífico de EE. UU.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("s"));
// Displays 2008-04-10T06:30:00
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("s"))
' Displays 2008-04-10T06:30:00
El especificador de formato universal que se puede ordenar ("u")
El especificador de formato estándar "u" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.UniversalSortableDateTimePattern. El patrón refleja una norma definida y la propiedad es de solo lectura. Por consiguiente, siempre es el mismo, sea cual fuere la referencia cultural utilizada o el proveedor de formato proporcionado. La cadena de formato personalizado es "yyyy'-'MM'-'dd HH':'mm':'ss'Z'". Cuando se utiliza este especificador de formato estándar, la operación de formato o análisis utiliza siempre la referencia cultural de todos los idiomas.
Aunque la cadena de resultado debe expresar una hora como hora universal coordinada (UTC), no se realiza ninguna conversión del valor de DateTime original durante la operación de formato. Por lo tanto, debe convertir un valor de DateTime a UTC llamando al método DateTime.ToUniversalTime antes de aplicarle formato. En cambio, DateTimeOffset valores realizan esta conversión automáticamente; no es necesario llamar al método DateTimeOffset.ToUniversalTime antes de la operación de formato.
En el ejemplo siguiente se usa el especificador de formato "u" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToUniversalTime().ToString("u"));
// Displays 2008-04-10 13:30:00Z
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToUniversalTime.ToString("u"))
' Displays 2008-04-10 13:30:00Z
Especificador de formato completo universal ("U")
El especificador de formato estándar "U" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.FullDateTimePattern de una referencia cultural especificada. El patrón es el mismo que el patrón "F". Sin embargo, el valor de DateTime se convierte automáticamente a UTC antes de dar formato.
En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta. Es posible que el especificador de formato personalizado devuelto por la propiedad FullDateTimePattern de algunas referencias culturales no use todas las propiedades.
| Propiedad | Descripción |
|---|---|
| FullDateTimePattern | Define el formato general de la cadena de resultado. |
| DayNames | Define los nombres de día localizados que pueden aparecer en la cadena de resultado. |
| MonthNames | Define los nombres de mes localizados que pueden aparecer en la cadena de resultado. |
| TimeSeparator | Define la cadena que separa los componentes de hora, minuto y segundo de una hora. |
| AMDesignator | Define la cadena que indica las horas de medianoche a antes del mediodía en un reloj de 12 horas. |
| PMDesignator | Define la cadena que indica horas del mediodía a la medianoche en un reloj de 12 horas. |
El especificador de formato "U" no es compatible con el tipo de DateTimeOffset y produce un FormatException si se usa para dar formato a un valor de DateTimeOffset.
En el ejemplo siguiente se usa el especificador de formato "U" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("U",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays Thursday, April 10, 2008 1:30:00 PM
Console.WriteLine(date1.ToString("U",
CultureInfo.CreateSpecificCulture("sv-FI")));
// Displays den 10 april 2008 13:30:00
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("en-US")))
' Displays Thursday, April 10, 2008 1:30:00 PM
Console.WriteLine(date1.ToString("U", CultureInfo.CreateSpecificCulture("sv-FI")))
' Displays den 10 april 2008 13:30:00
Formatos de hora
Este grupo incluye los formatos siguientes:
El especificador de formato de hora corta ("t")
El especificador de formato estándar "t" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.ShortTimePattern actual. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "HH:mm".
La cadena de resultado se ve afectada por la información de formato de un objeto DateTimeFormatInfo específico. En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta. Es posible que el especificador de formato personalizado devuelto por la propiedad DateTimeFormatInfo.ShortTimePattern de algunas referencias culturales no use todas las propiedades.
| Propiedad | Descripción |
|---|---|
| ShortTimePattern | Define el formato del componente de hora de la cadena de resultado. |
| TimeSeparator | Define la cadena que separa los componentes de hora, minuto y segundo de una hora. |
| AMDesignator | Define la cadena que indica las horas de medianoche a antes del mediodía en un reloj de 12 horas. |
| PMDesignator | Define la cadena que indica horas del mediodía a la medianoche en un reloj de 12 horas. |
En el ejemplo siguiente se usa el especificador de formato "t" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("t",
CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30 AM
Console.WriteLine(date1.ToString("t",
CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("t", _
CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30 AM
Console.WriteLine(date1.ToString("t", _
CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30
El especificador de formato de hora larga ("T")
El especificador de formato estándar "T" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.LongTimePattern de una referencia cultural específica. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "HH:mm:ss".
En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta. Es posible que el especificador de formato personalizado devuelto por la propiedad DateTimeFormatInfo.LongTimePattern de algunas referencias culturales no use todas las propiedades.
| Propiedad | Descripción |
|---|---|
| LongTimePattern | Define el formato del componente de hora de la cadena de resultado. |
| TimeSeparator | Define la cadena que separa los componentes de hora, minuto y segundo de una hora. |
| AMDesignator | Define la cadena que indica las horas de medianoche a antes del mediodía en un reloj de 12 horas. |
| PMDesignator | Define la cadena que indica horas del mediodía a la medianoche en un reloj de 12 horas. |
En el ejemplo siguiente se usa el especificador de formato "T" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("T",
CultureInfo.CreateSpecificCulture("en-us")));
// Displays 6:30:00 AM
Console.WriteLine(date1.ToString("T",
CultureInfo.CreateSpecificCulture("es-ES")));
// Displays 6:30:00
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("T", _
CultureInfo.CreateSpecificCulture("en-us")))
' Displays 6:30:00 AM
Console.WriteLine(date1.ToString("T", _
CultureInfo.CreateSpecificCulture("es-ES")))
' Displays 6:30:00
Formatos de fecha parcial
Este grupo incluye los formatos siguientes:
El especificador de formato de mes ("M", "m")
El especificador de formato estándar "M" o "m" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.MonthDayPattern actual. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "MMMM dd".
En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que controlan el formato de la cadena devuelta.
| Propiedad | Descripción |
|---|---|
| MonthDayPattern | Define el formato general de la cadena de resultado. |
| MonthNames | Define los nombres de mes localizados que pueden aparecer en la cadena de resultado. |
En el ejemplo siguiente se usa el especificador de formato "m" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("m",
CultureInfo.CreateSpecificCulture("en-us")));
// Displays April 10
Console.WriteLine(date1.ToString("m",
CultureInfo.CreateSpecificCulture("ms-MY")));
// Displays 10 April
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("m", _
CultureInfo.CreateSpecificCulture("en-us")))
' Displays April 10
Console.WriteLine(date1.ToString("m", _
CultureInfo.CreateSpecificCulture("ms-MY")))
' Displays 10 April
El especificador de formato de mes y año ("Y", "y")
El especificador de formato estándar "Y" o "y" representa una cadena de formato de fecha y hora personalizada definida por la propiedad DateTimeFormatInfo.YearMonthPattern de una referencia cultural especificada. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "yyyy MMMM".
En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que controlan el formato de la cadena devuelta.
| Propiedad | Descripción |
|---|---|
| YearMonthPattern | Define el formato general de la cadena de resultado. |
| MonthNames | Define los nombres de mes localizados que pueden aparecer en la cadena de resultado. |
En el ejemplo siguiente se usa el especificador de formato "y" para mostrar un valor de fecha y hora.
DateTime date1 = new DateTime(2008, 4, 10, 6, 30, 0);
Console.WriteLine(date1.ToString("Y",
CultureInfo.CreateSpecificCulture("en-US")));
// Displays April, 2008
Console.WriteLine(date1.ToString("y",
CultureInfo.CreateSpecificCulture("af-ZA")));
// Displays April 2008
Dim date1 As Date = #4/10/2008 6:30AM#
Console.WriteLine(date1.ToString("Y", CultureInfo.CreateSpecificCulture("en-US")))
' Displays April, 2008
Console.WriteLine(date1.ToString("y", CultureInfo.CreateSpecificCulture("af-ZA")))
' Displays April 2008
Configuración del Panel de control
En Windows, la configuración de la opciones regionales y de idioma elemento del Panel de control influye en la cadena de resultado generada por una operación de formato. Esta configuración se usa para inicializar el objeto DateTimeFormatInfo asociado a la referencia cultural actual, que proporciona valores usados para controlar el formato. Los equipos que usan diferentes configuraciones generan cadenas de resultado diferentes.
Además, si usa el constructor de CultureInfo(String) para crear instancias de un nuevo objeto de CultureInfo que represente la misma referencia cultural que la referencia cultural del sistema actual, las personalizaciones establecidas por el elemento Regional y Language Options en el Panel de control se aplicarán al nuevo objeto CultureInfo. Puede usar el constructor CultureInfo(String, Boolean) para crear un objeto CultureInfo que no refleje las personalizaciones de un sistema.
Propiedades dateTimeFormatInfo
El formato se ve afectado por las propiedades del objeto DateTimeFormatInfo actual, que la referencia cultural actual proporciona implícitamente o explícitamente el parámetro IFormatProvider del método que invoca el formato. Para el parámetro IFormatProvider, la aplicación debe especificar un objeto CultureInfo, que representa una referencia cultural o un objeto DateTimeFormatInfo, que representa las convenciones de formato de fecha y hora de una referencia cultural determinada. Muchos de los especificadores de formato de fecha y hora estándar son alias para los patrones de formato definidos por propiedades del objeto DateTimeFormatInfo actual. La aplicación puede cambiar el resultado generado por algunos especificadores de formato de fecha y hora estándar cambiando los patrones de formato de fecha y hora correspondientes de la propiedad DateTimeFormatInfo correspondiente.
Consulte también
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
