Cadenas con formato de fecha y hora estándarStandard Date and Time Format Strings

Una cadena de formato de fecha y hora estándar usa un único especificador de formato para definir la representación de texto de un valor de fecha y hora.A standard date and time format string uses a single format specifier to define the text representation of a date and time value. 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; para obtener más información, consulte Cadenas con formato de fecha y hora personalizado.Any date and time format string that contains more than one character, including white space, is interpreted as a custom date and time format string; for more information, see Custom Date and Time Format Strings. Una cadena de formato estándar o personalizado se puede usar de dos maneras:A standard or custom format string can be used in two ways:

  • Para definir la cadena resultante una operación de formato.To define the string that results from a formatting operation.

  • 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.To define the text representation of a date and time value that can be converted to a DateTime or DateTimeOffset value by a parsing operation.

Sugerencia

Puede descargar la Utilidad de formato, que es una aplicación que permite aplicar cadenas de formato a valores numéricos o de fecha y hora, y que muestra la cadena de resultado.You can download the Formatting Utility, an application that enables you to apply format strings to either numeric or date and time values and displays the result string.

Las cadenas con formato de fecha y hora estándar se pueden utilizar tanto con valores DateTime como con valores DateTimeOffset.Standard date and time format strings can be used with both DateTime and DateTimeOffset values.

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.Some of the C# examples in this article run in the Try.NET inline code runner and playground. Haga clic en el botón Ejecutar para ejecutar un ejemplo en una ventana interactiva.Select the Run button to run an example in an interactive window. Una vez que se ejecuta el código, puede modificar y ejecutar el código modificado si vuelve a hacer clic en Ejecutar.Once you execute the code, you can modify it and run the modified code by selecting Run again. 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#.The modified code either runs in the interactive window or, if compilation fails, the interactive window displays all C# compiler error messages.

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.The local time zone of the Try.NET inline code runner and playground is Coordinated Universal Time, or UTC. Esto puede afectar al comportamiento y la salida de ejemplos que ilustran los tipos DateTime, DateTimeOffset y TimeZoneInfo y sus miembros.This may affect the behavior and the output of examples that illustrate the DateTime, DateTimeOffset, and TimeZoneInfo types and their members.

En la tabla siguiente se describen los especificadores de formato de fecha y hora estándar.The following table describes the standard date and time format specifiers. 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.Unless otherwise noted, a particular standard date and time format specifier produces an identical string representation regardless of whether it is used with a DateTime or a DateTimeOffset value. Consulte la sección Notas para obtener información adicional sobre cómo usar cadenas de formato de fecha y hora estándar.See the Notes section for additional information about using standard date and time format strings.

Especificador de formatoFormat specifier DescripciónDescription EjemplosExamples
"d""d" Patrón de fecha corta.Short date pattern.

Más información: El especificador de formato de fecha corta ("d").More information:The Short Date ("d") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 (en-US)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 -> 15/06/2009 (fr-FR)

2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D""D" Patrón de fecha larga.Long date pattern.

Más información: El especificador de formato de fecha larga ("D").More information:The Long Date ("D") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)

2009-06-15T13:45:30 -> 15 июня 2009 г.2009-06-15T13:45:30 -> 15 июня 2009 г. (ru-RU)(ru-RU)

2009-06-15T13:45:30 -> Montag, 15.2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)Juni 2009 (de-DE)
"f""f" Patrón de fecha y hora completa (hora corta).Full date/time pattern (short time).

Más información: El especificador de formato de fecha completa y hora corta ("f").More information: The Full Date Short Time ("f") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45 PM (en-US)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 -> den 15 juni 2009 13:45 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F""F" Patrón de fecha y hora completa (hora larga).Full date/time pattern (long time).

Más información: El especificador de formato de fecha completa y hora larga ("F").More information: The Full Date Long Time ("F") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 1:45:30 PM (en-US)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 -> den 15 juni 2009 13:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g""g" Patrón de fecha y hora general (hora corta).General date/time pattern (short time).

Más información: El especificador de formato de fecha general y hora corta ("g").More information: The General Date Short Time ("g") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45 PM (en-US)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 -> 15/06/2009 13:45 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G""G" Patrón de fecha y hora general (hora larga).General date/time pattern (long time).

Más información: El especificador de formato de fecha general y hora larga ("G").More information: The General Date Long Time ("G") Format Specifier.
2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM (en-US)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 -> 15/06/2009 13:45:30 (es-ES)

2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m""M", "m" Patrón de mes/día.Month/day pattern.

Más información: El especificador de formato de mes ("M", "m").More information: The Month ("M", "m") Format Specifier.
2009-06-15T13:45:30 -> June 15 (en-US)2009-06-15T13:45:30 -> June 15 (en-US)

2009-06-15T13:45:30 -> 15.2009-06-15T13:45:30 -> 15. juni (da-DK)juni (da-DK)

2009-06-15T13:45:30 -> 15 Juni (id-ID)2009-06-15T13:45:30 -> 15 Juni (id-ID)
"O", "o""O", "o" Patrón de fecha y hora de ida y vuelta.Round-trip date/time pattern.

Más información: El especificador de formato de operación de ida y vuelta ("O", "o").More information: The Round-trip ("O", "o") Format Specifier.
Valores de DateTime:DateTime values:

2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:002009-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.0000000Z2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z

2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.00000002009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000

Valores de DateTimeOffset:DateTimeOffset values:

2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:002009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r""R", "r" Patrón RFC1123.RFC1123 pattern.

Más información: El especificador de formato RFC1123 ("R", "r").More information: The RFC1123 ("R", "r") Format Specifier.
2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT2009-06-15T13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT
"s""s" Patrón de fecha y hora que se puede ordenar.Sortable date/time pattern.

Más información: El especificador de formato que se puede ordenar ("s").More information: The Sortable ("s") Format Specifier.
2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30

2009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:302009-06-15T13:45:30 (DateTimeKind.Utc) -> 2009-06-15T13:45:30
"t""t" Patrón de hora corta.Short time pattern.

Más información: El especificador de formato de hora corta ("t").More information: The Short Time ("t") Format Specifier.
2009-06-15T13:45:30 -> 1:45 PM (en-US)2009-06-15T13:45:30 -> 1:45 PM (en-US)

2009-06-15T13:45:30 -> 13:45 (hr-HR)2009-06-15T13:45:30 -> 13:45 (hr-HR)

2009-06-15T13:45:30 -> 01:45 م (ar-EG)2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T""T" Patrón de hora larga.Long time pattern.

Más información: El especificador de formato de hora larga ("T").More information: The Long Time ("T") Format Specifier.
2009-06-15T13:45:30 -> 1:45:30 PM (en-US)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 -> 13:45:30 (hr-HR)

2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u""u" Patrón de fecha y hora universal que se puede ordenar.Universal sortable date/time pattern.

Más información: El especificador de formato universal que se puede ordenar ("u").More information: The Universal Sortable ("u") Format Specifier.
Con un valor DateTime de: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30ZWith a DateTime value: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z

Con un valor DateTimeOffset de: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30ZWith a DateTimeOffset value: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U""U" Patrón de fecha y hora completa universal.Universal full date/time pattern.

Más información: El especificador de formato completo universal ("U").More information: The Universal Full ("U") Format Specifier.
2009-06-15T13:45:30 -> Monday, June 15, 2009 8:45:30 PM (en-US)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 -> den 15 juni 2009 20:45:30 (sv-SE)

2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y""Y", "y" Patrón de mes y año.Year month pattern.

Más información: El especificador de formato de mes y año ("Y").More information: The Year Month ("Y") Format Specifier.
2009-06-15T13:45:30 -> June, 2009 (en-US)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 (da-DK)

2009-06-15T13:45:30 -> Juni 2009 (id-ID)2009-06-15T13:45:30 -> Juni 2009 (id-ID)
Cualquier otro carácter únicoAny other single character Especificador desconocido.Unknown specifier. Produce una excepción FormatException en tiempo de ejecución.Throws a run-time FormatException.

Cómo funcionan las cadenas con formato estándarHow Standard Format Strings Work

En una operación de formato, una cadena de formato estándar es simplemente un alias de una cadena con formato personalizado.In a formatting operation, a standard format string is simply an alias for a custom format string. 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.The advantage of using an alias to refer to a custom format string is that, although the alias remains invariant, the custom format string itself can vary. Esto es importante, porque las representaciones de cadena de valores de fecha y hora suelen variar con las referencias culturales.This is important because the string representations of date and time values typically vary by culture. 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.For example, the "d" standard format string indicates that a date and time value is to be displayed using a short date pattern. En la referencia cultural de todos los idiomas, este patrón es "MM/dd/aaaa".For the invariant culture, this pattern is "MM/dd/yyyy". En la referencia cultural fr-FR, es "dd/MM/aaaa".For the fr-FR culture, it is "dd/MM/yyyy". En la referencia cultural ja-JP, es "aaaa/MM/dd."For the ja-JP culture, it is "yyyy/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:If a standard format string in a formatting operation maps to a particular culture's custom format string, your application can define the specific culture whose custom format strings are used in one of these ways:

  • Puede utilizar la referencia cultural predeterminada (o la actual).You can use the default (or current) culture. En el ejemplo siguiente se muestra una fecha con el formato de fecha abreviado de la referencia cultural.The following example displays a date using the current culture's short date format. En este caso, la referencia cultural actual es en-US.In this case, the current culture is 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.You can pass a CultureInfo object representing the culture whose formatting is to be used to a method that has an IFormatProvider parameter. En el ejemplo siguiente se muestra una fecha con el formato de fecha abreviado de la referencia cultural pt-BR.The following example displays a date using the short date format of the pt-BR culture.

    // 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.You can pass a DateTimeFormatInfo object that provides formatting information to a method that has an IFormatProvider parameter. En el ejemplo siguiente se muestra una fecha con el formato de fecha abreviado de un objeto DateTimeFormatInfo en la referencia cultural hr-HR.The following example displays a date using the short date format from a DateTimeFormatInfo object for the hr-HR culture.

    // 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.For information about customizing the patterns or strings used in formatting date and time values, see the NumberFormatInfo class topic.

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.In some cases, the standard format string serves as a convenient abbreviation for a longer custom format string that is invariant. Hay cuatro cadenas de formato estándar que pertenecen a esta categoría: "O" (u "o"), "R" (o "r"), "s" y "u".Four standard format strings fall into this category: "O" (or "o"), "R" (or "r"), "s", and "u". Estas cadenas se corresponden con las cadenas de formato personalizado definidas en la referencia cultural de todos los idiomas.These strings correspond to custom format strings defined by the invariant culture. Generan representaciones de cadena de valores de fecha y hora que están pensados para que sean idénticos en todas las referencias culturales.They produce string representations of date and time values that are intended to be identical across cultures. En la tabla siguiente se proporciona información sobre estas cuatro cadenas de formato de fecha y hora estándar.The following table provides information on these four standard date and time format strings.

Cadena con formato estándarStandard format string Se define en la propiedad DateTimeFormatInfo.InvariantInfoDefined by DateTimeFormatInfo.InvariantInfo property Cadena con formato personalizadoCustom format string
"O" u "o""O" or "o" NoneNone yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzyyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz
"R" o "r""R" or "r" RFC1123Pattern ddd, dd MMM yyyy HH':'mm':'ss 'GMT'ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
"s""s" SortableDateTimePattern yyyy'-'MM'-'dd'T'HH':'mm':'ssyyyy'-'MM'-'dd'T'HH':'mm':'ss
"u""u" UniversalSortableDateTimePattern yyyy'-'MM'-'dd HH':'mm':'ss'Z'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.Standard format strings can also be used in parsing operations with the DateTime.ParseExact or DateTimeOffset.ParseExact methods, which require an input string to exactly conform to a particular pattern for the parse operation to succeed. 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.Many standard format strings map to multiple custom format strings, so a date and time value can be represented in a variety of formats and the parse operation will still succeed. 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).You can determine the custom format string or strings that correspond to a standard format string by calling the DateTimeFormatInfo.GetAllDateTimePatterns(Char) method. 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).The following example displays the custom format strings that map to the "d" (short date pattern) standard format string.

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.The following sections describe the standard format specifiers for DateTime and DateTimeOffset values.

El especificador de formato de fecha corta ("d")The Short Date ("d") Format Specifier

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.The "d" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.ShortDatePattern property. Por ejemplo, la cadena de formato personalizado devuelta por la propiedad ShortDatePattern de la referencia cultural de todos los idiomas es "MM/dd/yyyy".For example, the custom format string that is returned by the ShortDatePattern property of the invariant culture is "MM/dd/yyyy".

En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que controlan el formato de la cadena devuelta.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

Propiedad.Property DESCRIPCIÓNDescription
ShortDatePattern Define el formato global de la cadena de resultado.Defines the overall format of the result string.
DateSeparator Define la cadena que separa los componentes de año, mes y día de una fecha.Defines the string that separates the year, month, and day components of a date.

En el ejemplo siguiente se usa el especificador de formato "d" para mostrar un valor de fecha y hora.The following example uses the "d" format specifier to display a date and time value.

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                       

Volver a la tablaBack to table

El especificador de formato de fecha larga ("D")The Long Date ("D") Format Specifier

El especificador de formato estándar "D" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.LongDatePattern actual.The "D" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.LongDatePattern property. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "dddd, dd MMMM yyyy".For example, the custom format string for the invariant culture is "dddd, dd MMMM yyyy".

En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que controlan el formato de la cadena devuelta.The following table lists the properties of the DateTimeFormatInfo object that control the formatting of the returned string.

Propiedad.Property DESCRIPCIÓNDescription
LongDatePattern Define el formato global de la cadena de resultado.Defines the overall format of the result string.
DayNames Define los nombres de días traducidos que pueden aparecer en la cadena de resultado.Defines the localized day names that can appear in the result string.
MonthNames Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.Defines the localized month names that can appear in the result string.

En el ejemplo siguiente se usa el especificador de formato "D" para mostrar un valor de fecha y hora.The following example uses the "D" format specifier to display a date and time value.

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                        

Volver a la tablaBack to table

El especificador de formato de fecha completa y hora corta ("f")The Full Date Short Time ("f") Format Specifier

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.The "f" standard format specifier represents a combination of the long date ("D") and short time ("t") patterns, separated by a space.

La información de formato de un objeto DateTimeFormatInfo específico afecta a la cadena de resultado.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. El especificador de formato personalizado devuelto por las propiedades DateTimeFormatInfo.LongDatePattern y DateTimeFormatInfo.ShortTimePattern de algunas referencias culturales quizás no use todas las propiedades.The custom format specifier returned by the DateTimeFormatInfo.LongDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

Propiedad.Property DESCRIPCIÓNDescription
LongDatePattern Define el formato del componente de fecha de la cadena de resultado.Defines the format of the date component of the result string.
ShortTimePattern Define el formato del componente de hora de la cadena de resultado.Defines the format of the time component of the result string.
DayNames Define los nombres de días traducidos que pueden aparecer en la cadena de resultado.Defines the localized day names that can appear in the result string.
MonthNames Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.Defines the localized month names that can appear in the result string.
TimeSeparator Define la cadena que separa los componentes de hora, minutos y segundos de una hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

En el ejemplo siguiente se usa el especificador de formato "f" para mostrar un valor de fecha y hora.The following example uses the "f" format specifier to display a date and time value.

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                       

Volver a la tablaBack to table

El especificador de formato de fecha completa y hora larga ("F")The Full Date Long Time ("F") Format Specifier

El especificador de formato estándar "F" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.FullDateTimePattern actual.The "F" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.FullDateTimePattern property. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "dddd, dd MMMM yyyy HH:mm:ss".For example, the custom format string for the invariant culture is "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.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. El especificador de formato personalizado devuelto por la propiedad FullDateTimePattern de algunas referencias culturales quizás no use todas las propiedades.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

Propiedad.Property DESCRIPCIÓNDescription
FullDateTimePattern Define el formato global de la cadena de resultado.Defines the overall format of the result string.
DayNames Define los nombres de días traducidos que pueden aparecer en la cadena de resultado.Defines the localized day names that can appear in the result string.
MonthNames Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.Defines the localized month names that can appear in the result string.
TimeSeparator Define la cadena que separa los componentes de hora, minutos y segundos de una hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

En el ejemplo siguiente se usa el especificador de formato "F" para mostrar un valor de fecha y hora.The following example uses the "F" format specifier to display a date and time value.

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                       

Volver a la tablaBack to table

El especificador de formato de fecha general y hora corta ("g")The General Date Short Time ("g") Format Specifier

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.The "g" standard format specifier represents a combination of the short date ("d") and short time ("t") patterns, separated by a space.

La información de formato de un objeto DateTimeFormatInfo específico afecta a la cadena de resultado.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. El especificador de formato personalizado devuelto por las propiedades DateTimeFormatInfo.ShortDatePattern y DateTimeFormatInfo.ShortTimePattern de algunas referencias culturales quizás no use todas las propiedades.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.ShortTimePattern properties of some cultures may not make use of all properties.

Propiedad.Property DESCRIPCIÓNDescription
ShortDatePattern Define el formato del componente de fecha de la cadena de resultado.Defines the format of the date component of the result string.
ShortTimePattern Define el formato del componente de hora de la cadena de resultado.Defines the format of the time component of the result string.
DateSeparator Define la cadena que separa los componentes de año, mes y día de una fecha.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Define la cadena que separa los componentes de hora, minutos y segundos de una hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

En el ejemplo siguiente se usa el especificador de formato "g" para mostrar un valor de fecha y hora.The following example uses the "g" format specifier to display a date and time value.

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                        

Volver a la tablaBack to table

El especificador de formato de fecha general y hora larga ("G")The General Date Long Time ("G") Format Specifier

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.The "G" standard format specifier represents a combination of the short date ("d") and long time ("T") patterns, separated by a space.

La información de formato de un objeto DateTimeFormatInfo específico afecta a la cadena de resultado.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. El especificador de formato personalizado devuelto por las propiedades DateTimeFormatInfo.ShortDatePattern y DateTimeFormatInfo.LongTimePattern de algunas referencias culturales quizás no use todas las propiedades.The custom format specifier that is returned by the DateTimeFormatInfo.ShortDatePattern and DateTimeFormatInfo.LongTimePattern properties of some cultures may not make use of all properties.

Propiedad.Property DESCRIPCIÓNDescription
ShortDatePattern Define el formato del componente de fecha de la cadena de resultado.Defines the format of the date component of the result string.
LongTimePattern Define el formato del componente de hora de la cadena de resultado.Defines the format of the time component of the result string.
DateSeparator Define la cadena que separa los componentes de año, mes y día de una fecha.Defines the string that separates the year, month, and day components of a date.
TimeSeparator Define la cadena que separa los componentes de hora, minutos y segundos de una hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

En el ejemplo siguiente se usa el especificador de formato "G" para mostrar un valor de fecha y hora.The following example uses the "G" format specifier to display a date and time value.

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                       

Volver a la tablaBack to table

El especificador de formato de mes ("M", "m")The Month ("M", "m") Format Specifier

El especificador de formato estándar "M" o "m" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.MonthDayPattern actual.The "M" or "m" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.MonthDayPattern property. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "MMMM dd".For example, the custom format string for the invariant culture is "MMMM dd".

En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que controlan el formato de la cadena devuelta.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

Propiedad.Property DESCRIPCIÓNDescription
MonthDayPattern Define el formato global de la cadena de resultado.Defines the overall format of the result string.
MonthNames Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.Defines the localized month names that can appear in the result string.

En el ejemplo siguiente se usa el especificador de formato "m" para mostrar un valor de fecha y hora.The following example uses the "m" format specifier to display a date and time value.

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                       

Volver a la tablaBack to table

El especificador de formato de operación de ida y vuelta ("O", "o")The Round-trip ("O", "o") Format Specifier

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.The "O" or "o" standard format specifier represents a custom date and time format string using a pattern that preserves time zone information and emits a result string that complies with ISO 8601. En los valores DateTime, este especificador de formato está diseñado para conservar los valores de fecha y hora junto con la propiedad DateTime.Kind en el texto.For DateTime values, this format specifier is designed to preserve date and time values along with the DateTime.Kind property in text. La cadena con formato se puede recuperar usando el método DateTime.Parse(String, IFormatProvider, DateTimeStyles) o DateTime.ParseExact si el parámetro styles está establecido en DateTimeStyles.RoundtripKind.The formatted string can be parsed back by using the DateTime.Parse(String, IFormatProvider, DateTimeStyles) or DateTime.ParseExact method if the styles parameter is set to DateTimeStyles.RoundtripKind.

El especificador de formato estándar "O" u "o" corresponde a la cadena de formato personalizado "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" para los valores DateTime y a "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" para los valores DateTimeOffset.The "O" or "o" standard format specifier corresponds to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string for DateTime values and to the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzzz" custom format string for DateTimeOffset values. En esta cadena, los pares de comillas que delimitan los caracteres individuales (como guiones, signos de dos puntos y la letra "T") indican que el carácter individual es un literal que no se puede cambiar.In this string, the pairs of single quotation marks that delimit individual characters, such as the hyphens, the colons, and the letter "T", indicate that the individual character is a literal that cannot be changed. Los apóstrofos no aparecen en la cadena de salida.The apostrophes do not appear in the output string.

El especificador de formato estándar "O" u "o" (y la cadena de formato personalizado "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK") aprovecha los tres modos en que se representa la información de zona horaria en ISO 8601 para conservar la propiedad Kind de valores DateTime:The "O" or "o" standard format specifier (and the "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffK" custom format string) takes advantage of the three ways that ISO 8601 represents time zone information to preserve the Kind property of DateTime values:

  • El componente de zona horaria de valores de fecha y hora DateTimeKind.Local es un desfase con respecto a la hora UTC (por ejemplo, +01:00, -07:00).The time zone component of DateTimeKind.Local date and time values is an offset from UTC (for example, +01:00, -07:00). Todos los valores DateTimeOffset también se representan en este formato.All DateTimeOffset values are also represented in this format.

  • El componente de zona horaria de valores de fecha y hora DateTimeKind.Utc usa "Z" (que es un desfase cero) para representar la hora UTC.The time zone component of DateTimeKind.Utc date and time values uses "Z" (which stands for zero offset) to represent UTC.

  • Los valores de fecha y hora DateTimeKind.Unspecified no tienen información de zona horaria.DateTimeKind.Unspecified date and time values have no time zone information.

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.Because the "O" or "o" standard format specifier conforms to an international standard, the formatting or parsing operation that uses the specifier always uses the invariant culture and the Gregorian calendar.

Las cadenas que se pasan a los métodos Parse, TryParse, ParseExact y TryParseExact de DateTime y DateTimeOffset se pueden analizar con el especificador de formato "O" u "o" si están en uno de estos formatos.Strings that are passed to the Parse, TryParse, ParseExact, and TryParseExact methods of DateTime and DateTimeOffset can be parsed by using the "O" or "o" format specifier if they are in one of these formats. En el caso de objetos DateTime, la sobrecarga de análisis a la que llama también debe incluir un parámetro styles con un valor de DateTimeStyles.RoundtripKind.In the case of DateTime objects, the parsing overload that you call should also include a styles parameter with a value of DateTimeStyles.RoundtripKind. Observe que si llama a un método de análisis con la cadena de formato personalizado que se corresponde con el especificador de formato "O" u "o", no obtendrá los mismos resultados que "O" u "o".Note that if you call a parsing method with the custom format string that corresponds to the "O" or "o" format specifier, you won't get the same results as "O" or "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 aquellos valores de fecha y hora que carecen de un componente de zona horaria o que usan "Z" para indicar la hora UTC.This is because parsing methods that use a custom format string can't parse the string representation of date and time values that lack a time zone component or use "Z" to indicate UTC.

En el ejemplo siguiente se utiliza el especificador de formato "o" para mostrar una serie de valores DateTime y un valor DateTimeOffset en un sistema de la zona horaria del Pacífico de EE. UU.The following example uses the "o" format specifier to display a series of DateTime values and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

using System;

public class Example
{
   public static void Main()
   {
       DateTime dat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                   DateTimeKind.Unspecified);
       Console.WriteLine("{0} ({1}) --> {0:O}", dat, dat.Kind); 
   
       DateTime uDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Utc);
       Console.WriteLine("{0} ({1}) --> {0:O}", uDat, uDat.Kind);
       
       DateTime lDat = new DateTime(2009, 6, 15, 13, 45, 30, 
                                    DateTimeKind.Local);
       Console.WriteLine("{0} ({1}) --> {0:O}\n", lDat, lDat.Kind);
       
       DateTimeOffset dto = new DateTimeOffset(lDat);
       Console.WriteLine("{0} --> {0:O}", dto);
   }
}
// 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 Parse de fecha y hora.The following example uses the "o" format specifier to create a formatted string, and then restores the original date and time value by calling a date and time Parse method.

// 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 {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  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 {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  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 {0} {1} to {2} {3}.", originalDate, originalDate.Kind, 
                  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 {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.
' 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.

Volver a la tablaBack to table

El especificador de formato RFC1123 ("R", "r")The RFC1123 ("R", "r") Format Specifier

El especificador de formato estándar "R" o "r" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.RFC1123Pattern.The "R" or "r" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.RFC1123Pattern property. El patrón refleja una norma definida y la propiedad es de solo lectura.The pattern reflects a defined standard, and the property is read-only. Por consiguiente, siempre es el mismo, sea cual fuere la referencia cultural utilizada o el proveedor de formato proporcionado.Therefore, it is always the same, regardless of the culture used or the format provider supplied. La cadena de formato personalizado es "ddd, dd MMM yyyy HH':'mm':'ss 'GMT'".The custom format string is "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.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Las siguientes propiedades del objeto DateTimeFormatInfo devuelto por la propiedad DateTimeFormatInfo.InvariantInfo que representa la referencia cultural de todos los idiomas afectan a la cadena de resultado.The result string is affected by the following properties of the DateTimeFormatInfo object returned by the DateTimeFormatInfo.InvariantInfo property that represents the invariant culture.

Propiedad.Property DESCRIPCIÓNDescription
RFC1123Pattern Define el formato de la cadena de resultado.Defines the format of the result string.
AbbreviatedDayNames Define los nombres de días abreviados que pueden aparecer en la cadena de resultado.Defines the abbreviated day names that can appear in the result string.
AbbreviatedMonthNames Define los nombres de meses abreviados que pueden aparecer en la cadena de resultado.Defines the abbreviated month names that can appear in the result string.

Aunque la norma RFC 1123 expresa una hora según la hora universal coordinada (hora UTC), la operación de formato no modifica el valor del objeto DateTime al que se está dando formato.Although the RFC 1123 standard expresses a time as Coordinated Universal Time (UTC), the formatting operation does not modify the value of the DateTime object that is being formatted. Por consiguiente, debe convertir el valor DateTime en una hora UTC llamando al método DateTime.ToUniversalTime antes de realizar la operación de formato.Therefore, you must convert the DateTime value to UTC by calling the DateTime.ToUniversalTime method before you perform the formatting operation. En cambio, los valores DateTimeOffset realizan esta conversión automáticamente; no es necesario llamar al método DateTimeOffset.ToUniversalTime antes de la operación de formato.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

En el ejemplo siguiente se utiliza el especificador de formato "r" para mostrar un DateTime y un valor DateTimeOffset en un sistema de la zona horaria del Pacífico de EE. UU.The following example uses the "r" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

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                        

Volver a la tablaBack to table

El especificador de formato que se puede ordenar ("s")The Sortable ("s") Format Specifier

El especificador de formato estándar "s" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.SortableDateTimePattern.The "s" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.SortableDateTimePattern property. El patrón refleja una norma definida (ISO 8601) y la propiedad es de solo lectura.The pattern reflects a defined standard (ISO 8601), and the property is read-only. Por consiguiente, siempre es el mismo, sea cual fuere la referencia cultural utilizada o el proveedor de formato proporcionado.Therefore, it is always the same, regardless of the culture used or the format provider supplied. La cadena de formato personalizado es "yyyy'-'MM'-'dd'T'HH':'mm':'ss".The custom format string is "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.The purpose of the "s" format specifier is to produce result strings that sort consistently in ascending or descending order based on date and time values. 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 al que se está dando formato para reflejar su propiedad DateTime.Kind o su valor DateTimeOffset.Offset.As a result, although the "s" standard format specifier represents a date and time value in a consistent format, the formatting operation does not modify the value of the date and time object that is being formatted to reflect its DateTime.Kind property or its DateTimeOffset.Offset value. Por ejemplo, las cadenas de resultado que se producen al dar formato a los valores de fecha y hora 2014-11-15T18:32:17+00:00 y 2014-11-15T18:32:17+08:00 son idénticas.For example, the result strings produced by formatting the date and time values 2014-11-15T18:32:17+00:00 and 2014-11-15T18:32:17+08:00 are identical.

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.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

En el ejemplo siguiente se utiliza el especificador de formato "s" para mostrar un valor DateTime y DateTimeOffset en un sistema de la zona horaria del Pacífico de EE. UU.The following example uses the "s" format specifier to display a DateTime and a DateTimeOffset value on a system in the U.S. Pacific Time zone.

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                       

Volver a la tablaBack to table

El especificador de formato de hora corta ("t")The Short Time ("t") Format Specifier

El especificador de formato estándar "t" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.ShortTimePattern actual.The "t" standard format specifier represents a custom date and time format string that is defined by the current DateTimeFormatInfo.ShortTimePattern property. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "HH:mm".For example, the custom format string for the invariant culture is "HH:mm".

La información de formato de un objeto DateTimeFormatInfo específico afecta a la cadena de resultado.The result string is affected by the formatting information of a specific DateTimeFormatInfo object. En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. El especificador de formato personalizado devuelto por la propiedad DateTimeFormatInfo.ShortTimePattern de algunas referencias culturales quizás no use todas las propiedades.The custom format specifier that is returned by the DateTimeFormatInfo.ShortTimePattern property of some cultures may not make use of all properties.

Propiedad.Property DESCRIPCIÓNDescription
ShortTimePattern Define el formato del componente de hora de la cadena de resultado.Defines the format of the time component of the result string.
TimeSeparator Define la cadena que separa los componentes de hora, minutos y segundos de una hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

En el ejemplo siguiente se usa el especificador de formato "t" para mostrar un valor de fecha y hora.The following example uses the "t" format specifier to display a date and time value.

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                      

Volver a la tablaBack to table

El especificador de formato de hora larga ("T")The Long Time ("T") Format Specifier

El especificador de formato estándar "T" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.LongTimePattern de una referencia cultural concreta.The "T" standard format specifier represents a custom date and time format string that is defined by a specific culture's DateTimeFormatInfo.LongTimePattern property. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "HH:mm:ss".For example, the custom format string for the invariant culture is "HH:mm:ss".

En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. El especificador de formato personalizado devuelto por la propiedad DateTimeFormatInfo.LongTimePattern de algunas referencias culturales quizás no use todas las propiedades.The custom format specifier that is returned by the DateTimeFormatInfo.LongTimePattern property of some cultures may not make use of all properties.

Propiedad.Property DESCRIPCIÓNDescription
LongTimePattern Define el formato del componente de hora de la cadena de resultado.Defines the format of the time component of the result string.
TimeSeparator Define la cadena que separa los componentes de hora, minutos y segundos de una hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

En el ejemplo siguiente se usa el especificador de formato "T" para mostrar un valor de fecha y hora.The following example uses the "T" format specifier to display a date and time value.

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                      

Volver a la tablaBack to table

El especificador de formato universal que se puede ordenar ("u")The Universal Sortable ("u") Format Specifier

El especificador de formato estándar "u" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.UniversalSortableDateTimePattern.The "u" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.UniversalSortableDateTimePattern property. El patrón refleja una norma definida y la propiedad es de solo lectura.The pattern reflects a defined standard, and the property is read-only. Por consiguiente, siempre es el mismo, sea cual fuere la referencia cultural utilizada o el proveedor de formato proporcionado.Therefore, it is always the same, regardless of the culture used or the format provider supplied. La cadena de formato personalizado es "yyyy'-'MM'-'dd HH':'mm':'ss'Z'".The custom format string is "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.When this standard format specifier is used, the formatting or parsing operation always uses the invariant culture.

Aunque la cadena de resultado debe expresar una hora como una hora universal coordinada (hora UTC), no se realiza ninguna conversión del valor DateTime original durante la operación de formato.Although the result string should express a time as Coordinated Universal Time (UTC), no conversion of the original DateTime value is performed during the formatting operation. Por consiguiente, debe convertir un valor DateTime en una hora UTC llamando al método DateTime.ToUniversalTime antes de aplicarle formato.Therefore, you must convert a DateTime value to UTC by calling the DateTime.ToUniversalTime method before formatting it. En cambio, los valores DateTimeOffset realizan esta conversión automáticamente; no es necesario llamar al método DateTimeOffset.ToUniversalTime antes de la operación de formato.In contrast, DateTimeOffset values perform this conversion automatically; there is no need to call the DateTimeOffset.ToUniversalTime method before the formatting operation.

En el ejemplo siguiente se usa el especificador de formato "u" para mostrar un valor de fecha y hora.The following example uses the "u" format specifier to display a date and time value.

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                       

Volver a la tablaBack to table

El especificador de formato completo universal ("U")The Universal Full ("U") Format Specifier

El especificador de formato estándar "U" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.FullDateTimePattern de una referencia cultural especificada.The "U" standard format specifier represents a custom date and time format string that is defined by a specified culture's DateTimeFormatInfo.FullDateTimePattern property. El patrón es igual que el patrón de "F".The pattern is the same as the "F" pattern. Sin embargo, el valor DateTime se convierte automáticamente en una hora UTC antes de darle formato.However, the DateTime value is automatically converted to UTC before it is formatted.

En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que pueden controlar el formato de la cadena devuelta.The following table lists the DateTimeFormatInfo object properties that may control the formatting of the returned string. El especificador de formato personalizado devuelto por la propiedad FullDateTimePattern de algunas referencias culturales quizás no use todas las propiedades.The custom format specifier that is returned by the FullDateTimePattern property of some cultures may not make use of all properties.

Propiedad.Property DESCRIPCIÓNDescription
FullDateTimePattern Define el formato global de la cadena de resultado.Defines the overall format of the result string.
DayNames Define los nombres de días traducidos que pueden aparecer en la cadena de resultado.Defines the localized day names that can appear in the result string.
MonthNames Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.Defines the localized month names that can appear in the result string.
TimeSeparator Define la cadena que separa los componentes de hora, minutos y segundos de una hora.Defines the string that separates the hour, minute, and second components of a time.
AMDesignator Define la cadena que indica las horas comprendidas desde medianoche hasta antes del mediodía en un reloj de 12 horas.Defines the string that indicates times from midnight to before noon in a 12-hour clock.
PMDesignator Define la cadena que indica las horas comprendidas desde el mediodía hasta antes de medianoche en un reloj de 12 horas.Defines the string that indicates times from noon to before midnight in a 12-hour clock.

El especificador de formato "U" no es compatible con el tipo DateTimeOffset y provoca una excepción FormatException si se usa para dar formato a un valor DateTimeOffset.The "U" format specifier is not supported by the DateTimeOffset type and throws a FormatException if it is used to format a DateTimeOffset value.

En el ejemplo siguiente se usa el especificador de formato "U" para mostrar un valor de fecha y hora.The following example uses the "U" format specifier to display a date and time value.

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                       

Volver a la tablaBack to table

El especificador de formato de mes y año ("Y", "y")The Year Month ("Y", "y") Format Specifier

El especificador de formato estándar "Y" o "y" representa una cadena de formato de fecha y hora personalizado que está definida por la propiedad DateTimeFormatInfo.YearMonthPattern de una referencia cultural especificada.The "Y" or "y" standard format specifier represents a custom date and time format string that is defined by the DateTimeFormatInfo.YearMonthPattern property of a specified culture. Por ejemplo, la cadena de formato personalizado para la referencia cultural de todos los idiomas es "yyyy MMMM".For example, the custom format string for the invariant culture is "yyyy MMMM".

En la tabla siguiente se enumeran las propiedades del objeto DateTimeFormatInfo que controlan el formato de la cadena devuelta.The following table lists the DateTimeFormatInfo object properties that control the formatting of the returned string.

Propiedad.Property DESCRIPCIÓNDescription
YearMonthPattern Define el formato global de la cadena de resultado.Defines the overall format of the result string.
MonthNames Define los nombres de meses traducidos que pueden aparecer en la cadena de resultado.Defines the localized month names that can appear in the result string.

En el ejemplo siguiente se usa el especificador de formato "y" para mostrar un valor de fecha y hora.The following example uses the "y" format specifier to display a date and time value.

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                       

Volver a la tablaBack to table

NotasNotes

Configuración del Panel de controlControl Panel Settings

Los valores de configuración del elemento Configuración regional y de idioma del Panel de control influyen en la cadena de resultado generada por una operación de formato.The settings in the Regional and Language Options item in Control Panel influence the result string produced by a formatting operation. Estas configuraciones se utilizan para inicializar el objeto DateTimeFormatInfo asociado a la referencia cultural del subproceso actual, que proporciona valores que se utilizan para controlar el formato.These settings are used to initialize the DateTimeFormatInfo object associated with the current thread culture, which provides values used to govern formatting. Los equipos que usan configuraciones diferentes generarán cadenas de resultado distintas.Computers that use different settings generate different result strings.

Asimismo, si se usa el constructor CultureInfo.CultureInfo(String) para crear instancias de un nuevo objeto CultureInfo que representa la misma referencia cultural que la referencia cultural del sistema actual, cualquier personalización establecida por el elemento Configuración regional y de idioma del Panel de control se aplicará al nuevo objeto CultureInfo .In addition, if you use the CultureInfo.CultureInfo(String) constructor to instantiate a new CultureInfo object that represents the same culture as the current system culture, any customizations established by the Regional and Language Options item in Control Panel will be applied to the new CultureInfo object. Puede usar el constructor CultureInfo.CultureInfo(String, Boolean) para crear un objeto CultureInfo que no refleje las personalizaciones de un sistema.You can use the CultureInfo.CultureInfo(String, Boolean) constructor to create a CultureInfo object that does not reflect a system's customizations.

Propiedades de DateTimeFormatInfoDateTimeFormatInfo Properties

El formato se ve influenciado por las propiedades del objeto DateTimeFormatInfo actual, proporcionado implícitamente por la referencia cultural del subproceso actual o explícitamente por el parámetro IFormatProvider del método que invoca el formato.Formatting is influenced by properties of the current DateTimeFormatInfo object, which is provided implicitly by the current thread culture or explicitly by the IFormatProvider parameter of the method that invokes formatting. En 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 determinada referencia cultural.For the IFormatProvider parameter, your application should specify a CultureInfo object, which represents a culture, or a DateTimeFormatInfo object, which represents a particular culture's date and time formatting conventions. Muchos de los especificadores de formato de fecha y hora estándar son alias de patrones de formato definidos en las propiedades del objeto DateTimeFormatInfo actual.Many of the standard date and time format specifiers are aliases for formatting patterns defined by properties of the current DateTimeFormatInfo object. La aplicación puede modificar el resultado generado por algunos especificadores de formato de fecha y hora estándar al cambiar los patrones de formato de fecha y hora correspondientes de la propiedad DateTimeFormatInfo apropiada.Your application can change the result produced by some standard date and time format specifiers by changing the corresponding date and time format patterns of the corresponding DateTimeFormatInfo property.

Vea tambiénSee also