DateTimeOffset.ToString Método

Definición

Convierte el valor del objeto DateTimeOffset actual en su representación de cadena equivalente.Converts the value of the current DateTimeOffset object to its equivalent string representation.

Sobrecargas

ToString()

Convierte el valor del objeto DateTimeOffset actual en su representación de cadena equivalente.Converts the value of the current DateTimeOffset object to its equivalent string representation.

ToString(IFormatProvider)

Convierte el valor del objeto DateTimeOffset actual en su representación de cadena equivalente usando la información de formato específica de la referencia cultural especificada.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified culture-specific formatting information.

ToString(String)

Convierte el valor del objeto DateTimeOffset actual en su representación de cadena equivalente usando el formato especificado.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

ToString(String, IFormatProvider)

Convierte el valor del objeto DateTimeOffset actual en la representación de cadena equivalente usando el formato y la información de formato específica de la referencia cultural especificados.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.

ToString()

Convierte el valor del objeto DateTimeOffset actual en su representación de cadena equivalente.Converts the value of the current DateTimeOffset object to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Devoluciones

Representación de cadena de un objeto DateTimeOffset que incluye el desplazamiento anexado al final de la cadena.A string representation of a DateTimeOffset object that includes the offset appended at the end of the string.

Excepciones

La fecha y hora se encuentra fuera del intervalo de fechas admitido por el calendario usado por la cultura actual.The date and time is outside the range of dates supported by the calendar used by the current culture.

Ejemplos

En el ejemplo siguiente se muestran las llamadas al método ToString() y se muestra su salida en un sistema cuya referencia cultural actual es en-US.The following example illustrates calls to the ToString() method and displays its output on a system whose current culture is en-us.

DateTimeOffset thisDate;

// Show output for UTC time
thisDate = DateTimeOffset.UtcNow;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 7:13:50 PM +00:00

// Show output for local time 
thisDate = DateTimeOffset.Now;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 12:13:50 PM -07:00

// Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0));
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 2:13:50 PM -05:00
Dim thisDate As DateTimeOffset

' Show output for UTC time
thisDate = DateTimeOffset.UtcNow
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 7:13:50 PM +00:00

' Show output for local time 
thisDate = DateTimeOffset.Now
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 12:13:50 PM -07:00

' Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0))
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 2:13:50 PM -05:00

Comentarios

El valor devuelto de este método es idéntico al del método DateTime.ToString(), salvo que incluye un espacio seguido del desplazamiento anexado al final de la cadena.The return value of this method is identical to that of the DateTime.ToString() method, except that it includes a space followed by the offset appended at the end of the string. En otras palabras, da formato a los resultados mediante el patrón de fecha corta, el patrón de hora larga y el zzz cadena de formato personalizado, con cada elemento separado del elemento anterior por un espacio.In other words, it formats output using the short date pattern, the long time pattern, and the zzz custom format string, with each element separated from the previous element by a space. Por ejemplo, si DateTime.ToString() devuelve un valor de 1/12/2008 6:15:50 PM, ToString() devuelve un valor de 1/12/2008 6:15:50 PM-08:00 para una hora que es ocho horas detrás de la hora universal coordinada (UTC).For example, if DateTime.ToString() returns a value of 1/12/2008 6:15:50 PM, ToString() returns a value of 1/12/2008 6:15:50 PM -08:00 for a time that is eight hours behind Coordinated Universal Time (UTC).

Este método usa la información de formato derivada de la referencia cultural actual.This method uses formatting information derived from the current culture. Para obtener más información, vea CurrentCulture.For more information, see CurrentCulture. Otras sobrecargas del método ToString permiten especificar la referencia cultural cuyo formato se va a usar y definir el modelo de salida del valor DateTimeOffset.Other overloads of the ToString method enable you to specify the culture whose formatting to use, and to define the output pattern of the DateTimeOffset value.

Notas a los autores de las llamadas

El método ToString() devuelve la representación de cadena de la fecha y hora en el calendario utilizado por la referencia cultural actual.The ToString() method returns the string representation of the date and time in the calendar used by the current culture. Si el valor de la instancia de DateTimeOffset actual es anterior a MinSupportedDateTime o posterior a MaxSupportedDateTime, el método produce una ArgumentOutOfRangeException.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Esto se muestra en el ejemplo siguiente.The following example provides an illustration. Intenta dar formato a una fecha que está fuera del intervalo de la clase HijriCalendar cuando la referencia cultural actual es árabe (Siria).It attempts to format a date that is outside the range of the HijriCalendar class when the current culture is Arabic (Syria).

[! code-CSharpSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 2] [! code-VBSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 2][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#2] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#2]

ToString(IFormatProvider)

Convierte el valor del objeto DateTimeOffset actual en su representación de cadena equivalente usando la información de formato específica de la referencia cultural especificada.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified culture-specific formatting information.

public:
 System::String ^ ToString(IFormatProvider ^ formatProvider);
public string ToString (IFormatProvider formatProvider);
override this.ToString : IFormatProvider -> string
Public Function ToString (formatProvider As IFormatProvider) As String

Parámetros

formatProvider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.An object that supplies culture-specific formatting information.

Devoluciones

Representación de cadena del valor del objeto DateTimeOffset actual, tal como especifica formatProvider.A string representation of the value of the current DateTimeOffset object, as specified by formatProvider.

Excepciones

La fecha y hora se encuentra fuera del intervalo de fechas admitido por el calendario usado por formatProvider.The date and time is outside the range of dates supported by the calendar used by formatProvider.

Ejemplos

En el ejemplo siguiente se muestra un objeto DateTimeOffset mediante CultureInfo objetos que representan la referencia cultural de todos los idiomas, así como otras cuatro referencias culturales.The following example displays a DateTimeOffset object using CultureInfo objects that represent the invariant culture, as well as four other cultures.

     CultureInfo[] cultures = new CultureInfo[] {CultureInfo.InvariantCulture, 
                                                new CultureInfo("en-us"), 
                                                new CultureInfo("fr-fr"), 
                                                new CultureInfo("de-DE"), 
                                                new CultureInfo("es-ES")};

     DateTimeOffset thisDate = new DateTimeOffset(2007, 5, 1, 9, 0, 0, 
                                                  TimeSpan.Zero);                                            

     foreach (CultureInfo culture in cultures)
     {
        string cultureName; 
        if (string.IsNullOrEmpty(culture.Name))
           cultureName = culture.NativeName;
        else
           cultureName = culture.Name;

        Console.WriteLine("In {0}, {1}", 
                          cultureName, thisDate.ToString(culture));
     }                                            
     // The example produces the following output:
     //    In Invariant Language (Invariant Country), 05/01/2007 09:00:00 +00:00
     //    In en-US, 5/1/2007 9:00:00 AM +00:00
     //    In fr-FR, 01/05/2007 09:00:00 +00:00
     //    In de-DE, 01.05.2007 09:00:00 +00:00
     //    In es-ES, 01/05/2007 9:00:00 +00:00
     Dim cultures() As CultureInfo = {CultureInfo.InvariantCulture, _
                                      New CultureInfo("en-us"), _
                                      New CultureInfo("fr-fr"), _
                                      New CultureInfo("de-DE"), _
                                      New CultureInfo("es-ES")}

     Dim thisDate As New DateTimeOffset(#5/1/2007 9:00AM#, TimeSpan.Zero)                                            

     For Each culture As CultureInfo In cultures
        Dim cultureName As String 
        If String.IsNullOrEmpty(culture.Name) Then
           cultureName = culture.NativeName
        Else
           cultureName = culture.Name
        End If
        Console.WriteLine("In {0}, {1}", _
                          cultureName, thisDate.ToString(culture))
     Next                                            
     ' The example produces the following output:
     '    In Invariant Language (Invariant Country), 05/01/2007 09:00:00 +00:00
     '    In en-US, 5/1/2007 9:00:00 AM +00:00
     '    In fr-FR, 01/05/2007 09:00:00 +00:00
     '    In de-DE, 01.05.2007 09:00:00 +00:00
     '    In es-ES, 01/05/2007 9:00:00 +00:00

Comentarios

El valor devuelto de este método es idéntico al de su sobrecarga equivalente del método DateTime.ToString, salvo que incluye un espacio seguido del desplazamiento anexado al final de la cadena.The return value of this method is identical to that of its equivalent overload of the DateTime.ToString method, except that it includes a space followed by the offset appended at the end of the string. En otras palabras, da formato a los resultados mediante el patrón de fecha corta, el patrón de hora larga y el zzz cadena de formato personalizado, con cada elemento separado del elemento anterior por un espacio.In other words, it formats output using the short date pattern, the long time pattern, and the zzz custom format string, with each element separated from the previous element by a space.

El formato de estos tres elementos se define mediante el parámetro formatProvider.The format of these three elements is defined by the formatProvider parameter. El parámetro formatProvider puede ser cualquiera de los siguientes:The formatProvider parameter can be either of the following:

Si formatProvider es null, se utiliza el objeto DateTimeFormatInfo asociado a la referencia cultural actual (vea CurrentCulture).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Notas a los autores de las llamadas

El método ToString(IFormatProvider) devuelve la representación de cadena de la fecha y hora en el calendario utilizado por la referencia cultural representada por el parámetro formatProvider.The ToString(IFormatProvider) method returns the string representation of the date and time in the calendar used by the culture represented by the formatProvider parameter. Su calendario se define mediante la propiedad Calendar.Its calendar is defined by the Calendar property. Si el valor de la instancia de DateTimeOffset actual es anterior a MinSupportedDateTime o posterior a MaxSupportedDateTime, el método produce una ArgumentOutOfRangeException.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Esto se muestra en el ejemplo siguiente.The following example provides an illustration. Intenta dar formato a una fecha que está fuera del intervalo de la clase JapaneseCalendar.It attempts to format a date that is outside the range of the JapaneseCalendar class.

[! code-CSharpSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 1] [! code-VBSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 1][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#1] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#1]

ToString(String)

Convierte el valor del objeto DateTimeOffset actual en su representación de cadena equivalente usando el formato especificado.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parámetros

format
String

Cadena de formato.A format string.

Devoluciones

Representación de cadena del valor del objeto DateTimeOffset actual, tal como especifica format.A string representation of the value of the current DateTimeOffset object, as specified by format.

Excepciones

La longitud de format es 1 y no es uno de los caracteres del especificador de formato estándar definidos para DateTimeFormatInfo.The length of format is one, and it is not one of the standard format specifier characters defined for DateTimeFormatInfo.

O bien,-or- format no contiene un patrón de formato personalizado válido.format does not contain a valid custom format pattern.

La fecha y hora se encuentra fuera del intervalo de fechas admitido por el calendario usado por la cultura actual.The date and time is outside the range of dates supported by the calendar used by the current culture.

Ejemplos

En el ejemplo siguiente se muestra un objeto DateTimeOffset en la consola con cada uno de los especificadores de formato de fecha y hora estándar.The following example displays a DateTimeOffset object to the console using each of the standard date and time format specifiers. El formato de la salida se aplica mediante la referencia cultural en-US.The output is formatted by using the en-us culture.

DateTimeOffset outputDate = new DateTimeOffset(2007, 10, 31, 21, 0, 0, 
                                     new TimeSpan(-8, 0, 0));
string specifier; 
      
// Output date using each standard date/time format specifier
specifier = "d";
// Displays   d: 10/31/2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "D";
// Displays   D: Wednesday, October 31, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "t";
// Displays   t: 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "T";
// Displays   T: 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "f";
// Displays   f: Wednesday, October 31, 2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "F";
// Displays   F: Wednesday, October 31, 2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "g";
// Displays   g: 10/31/2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "G";
// Displays   G: 10/31/2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "M";           // 'm' is identical
// Displays   M: October 31
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "R";           // 'r' is identical
// Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "s";
// Displays   s: 2007-10-31T21:00:00
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

specifier = "u";
// Displays   u: 2007-11-01 05:00:00Z
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 

// Specifier is not supported
specifier = "U";
try
{
   Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));
}    
catch (FormatException)
{
   Console.WriteLine("{0}: Not supported.", specifier);   
}

specifier = "Y";         // 'y' is identical
// Displays   Y: October, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)); 
Dim outputDate As New DateTimeOffset(#10/31/2007 9:00PM#, _
                                     New TimeSpan(-8, 0, 0))
Dim specifier As String 
      
' Output date using each standard date/time format specifier
specifier = "d"
' Displays   d: 10/31/2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "D"
' Displays   D: Wednesday, October 31, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "t"
' Displays   t: 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "T"
' Displays   T: 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "f"
' Displays   f: Wednesday, October 31, 2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "F"
' Displays   F: Wednesday, October 31, 2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "g"
' Displays   g: 10/31/2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "G"
' Displays   G: 10/31/2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "M"           ' 'm' is identical
' Displays   M: October 31
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "R"           ' 'r' is identical
' Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "s"
' Displays   s: 2007-10-31T21:00:00
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "u"
' Displays   u: 2007-11-01 05:00:00Z
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

' Specifier is not supported
specifier = "U"
Try
   Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 
Catch e As FormatException
   Console.WriteLine("{0}: Not supported.", specifier)   
End Try

specifier = "Y"         ' 'y' is identical
' Displays   Y: October, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

Comentarios

El parámetro format debe contener un único carácter especificador de formato (vea cadenas con formato de fecha y hora estándar) o un patrón de formato personalizado (vea cadenas con formato de fecha y hora personalizado) que define el formato de la cadena devuelta.The format parameter should contain either a single format specifier character (see Standard Date and Time Format Strings) or a custom format pattern (see Custom Date and Time Format Strings) that defines the format of the returned string. Si format es una cadena nula o vacía (""), el valor de DateTimeOffset se genera mediante el formato predeterminado.If format is a null or empty string (""), the DateTimeOffset value is output using the default format.

En la tabla siguiente se muestra la operación exacta de determinados especificadores de formato cuando se usa con DateTimeOffset, que difiere de su comportamiento cuando se usa con DateTime.The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

Especificador de formato existenteExisting format specifier Comportamiento nuevoNew behavior
"K""K" Diseñado para realizar un recorrido de ida y vuelta a una fecha y hora.Designed to round-trip a date and time. Con DateTimeOffset, se asigna a "Zzz" (el desplazamiento siempre se muestra con horas y minutos).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Tenga en cuenta que "K" es un especificador de formato personalizado; no puede aparecer como el carácter único en format.Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" No se admite.Not supported.
"r""r" Convierte el objeto de DateTimeOffset en hora universal coordinada (UTC) y lo envía mediante la cadena de formato personalizado ddd, dd MMM yyyy HH:mm:ss GMT.Converts the DateTimeOffset object to Coordinated Universal Time (UTC) and outputs it using the custom format string ddd, dd MMM yyyy HH:mm:ss GMT.
"u""u" Convierte el objeto de DateTimeOffset en UTC y lo envía con el formato yyyy-MM-dd HH:mm:ssZ.Converts the DateTimeOffset object to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Los especificadores de formato de fecha y hora estándar restantes se comportan igual con el método ToString(String) que con el método ToString.The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

Este método usa la información de formato derivada de la referencia cultural actual.This method uses formatting information derived from the current culture. Para obtener más información, vea CurrentCulture.For more information, see CurrentCulture.

Notas a los autores de las llamadas

El método ToString(String) devuelve la representación de cadena de la fecha y hora en el calendario utilizado por la referencia cultural actual.The ToString(String) method returns the string representation of the date and time in the calendar used by the current culture. Si el valor de la instancia de DateTimeOffset actual es anterior a MinSupportedDateTime o posterior a MaxSupportedDateTime, el método produce una ArgumentOutOfRangeException.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Esto se muestra en el ejemplo siguiente.The following example provides an illustration. Intenta dar formato a una fecha que está fuera del intervalo de la clase HebrewCalendar cuando la referencia cultural actual es hebreo (Israel).It attempts to format a date that is outside the range of the HebrewCalendar class when the current culture is Hebrew (Israel).

[! code-CSharpSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 3] [! code-VBSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 3][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#3]

Consulte también:

ToString(String, IFormatProvider)

Convierte el valor del objeto DateTimeOffset actual en la representación de cadena equivalente usando el formato y la información de formato específica de la referencia cultural especificados.Converts the value of the current DateTimeOffset object to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ formatProvider);
public string ToString (string format, IFormatProvider formatProvider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, formatProvider As IFormatProvider) As String

Parámetros

format
String

Cadena de formato.A format string.

formatProvider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.An object that supplies culture-specific formatting information.

Devoluciones

Representación de cadena del valor del objeto DateTimeOffset actual, tal como especifican format y provider.A string representation of the value of the current DateTimeOffset object, as specified by format and provider.

Implementaciones

Excepciones

La longitud de format es 1 y no es uno de los caracteres del especificador de formato estándar definidos para DateTimeFormatInfo.The length of format is one, and it is not one of the standard format specifier characters defined for DateTimeFormatInfo.

O bien,-or- format no contiene un patrón de formato personalizado válido.format does not contain a valid custom format pattern.

La fecha y hora se encuentra fuera del intervalo de fechas admitido por el calendario usado por formatProvider.The date and time is outside the range of dates supported by the calendar used by formatProvider.

Ejemplos

En el ejemplo siguiente se usa el método ToString(String, IFormatProvider) para mostrar un objeto DateTimeOffset mediante una cadena de formato personalizado para varias referencias culturales diferentes.The following example uses the ToString(String, IFormatProvider) method to display a DateTimeOffset object using a custom format string for several different cultures.

DateTimeOffset outputDate = new DateTimeOffset(2007, 11, 1, 9, 0, 0, 
                                     new TimeSpan(-7, 0, 0)); 
string format = "dddd, MMM dd yyyy HH:mm:ss zzz";

// Output date and time using custom format specification
Console.WriteLine(outputDate.ToString(format, null as DateTimeFormatInfo));
Console.WriteLine(outputDate.ToString(format, CultureInfo.InvariantCulture));
Console.WriteLine(outputDate.ToString(format, 
                                      new CultureInfo("fr-FR")));
Console.WriteLine(outputDate.ToString(format, 
                                      new CultureInfo("es-ES")));
// The example displays the following output to the console:
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    jeudi, nov. 01 2007 09:00:00 -07:00
//    jueves, nov 01 2007 09:00:00 -07:00
Dim outputDate As New DateTimeOffset(#11/1/2007 9:00AM#, _
                                     New TimeSpan(-7, 0, 0)) 
Dim format As String = "dddd, MMM dd yyyy HH:mm:ss zzz"

' Output date and time using custom format specification
Console.WriteLine(outputDate.ToString(format, Nothing))
Console.WriteLine(outputDate.ToString(format, CultureInfo.InvariantCulture))
Console.WriteLine(outputDate.ToString(format, _
                                      New CultureInfo("fr-FR")))
Console.WriteLine(outputDate.ToString(format, _
                                      New CultureInfo("es-ES")))
' The example displays the following output to the console:
'    Thursday, Nov 01 2007 09:00:00 -07:00
'    Thursday, Nov 01 2007 09:00:00 -07:00
'    jeudi, nov. 01 2007 09:00:00 -07:00
'    jueves, nov 01 2007 09:00:00 -07:00

Comentarios

El parámetro format debe contener un único carácter especificador de formato (vea cadenas con formato de fecha y hora estándar) o un modelo de formato personalizado (vea cadenas con formato de fecha y hora personalizado).The format parameter should contain either a single format specifier character (see Standard Date and Time Format Strings) or a custom format pattern (see Custom Date and Time Format Strings). Si format es una cadena nula o vacía (""), el objeto de DateTimeOffset se genera mediante el formato predeterminado.If format is a null or empty string (""), the DateTimeOffset object is output using the default format.

En la tabla siguiente se muestra la operación exacta de determinados especificadores de formato cuando se usa con DateTimeOffset, que difiere de su comportamiento cuando se usa con DateTime.The following table shows the exact operation of certain format specifiers when used with DateTimeOffset, which differs from their behavior when used with DateTime.

Especificador de formato existenteExisting format specifier Comportamiento nuevoNew behavior
"K""K" Diseñado para realizar un recorrido de ida y vuelta a una fecha y hora.Designed to round-trip a date and time. Con DateTimeOffset, se asigna a "Zzz" (el desplazamiento siempre se muestra con horas y minutos).With DateTimeOffset, maps to "zzz" (the offset is always displayed with hours and minutes). Tenga en cuenta que "K" es un especificador de formato personalizado; no puede aparecer como el carácter único en format.Note that "K" is a custom format specifier; it cannot appear as the single character in format.
"U""U" No se admite.Not supported.
"r""r" Convierte el objeto de DateTimeOffset en hora universal coordinada (UTC) y lo envía mediante la cadena de formato personalizado ddd, dd MMM yyyy HH:mm:ss GMT.Converts the DateTimeOffset object to Coordinated Universal Time (UTC) and outputs it using the custom format string ddd, dd MMM yyyy HH:mm:ss GMT.
"u""u" Convierte el valor de DateTimeOffset en UTC y lo envía con el formato yyyy-MM-dd HH:mm:ssZ.Converts the DateTimeOffset value to UTC and outputs it using the format yyyy-MM-dd HH:mm:ssZ.

Los especificadores de formato de fecha y hora estándar restantes se comportan igual con el método ToString(String) que con el método ToString.The remaining standard date and time format specifiers behave the same with the ToString(String) method as they do with the ToString method.

El patrón que se corresponde con los especificadores de formato estándar, así como los símbolos y los nombres de los componentes de fecha y hora, se define mediante el parámetro formatProvider.The pattern that corresponds to standard format specifiers, as well as the symbols and names of date and time components, is defined by the formatProvider parameter. El parámetro formatProvider puede ser cualquiera de los siguientes:The formatProvider parameter can be either of the following:

Si formatProvider es null, se utiliza el objeto DateTimeFormatInfo asociado a la referencia cultural actual (vea CurrentCulture).If formatProvider is null, the DateTimeFormatInfo object associated with the current culture is used (see CurrentCulture).

Notas a los autores de las llamadas

El método ToString(String, IFormatProvider) devuelve la representación de cadena de la fecha y hora en el calendario utilizado por el parámetro formatProvider.The ToString(String, IFormatProvider) method returns the string representation of the date and time in the calendar used by the formatProvider parameter. Su calendario se define mediante la propiedad Calendar.Its calendar is defined by the Calendar property. Si el valor de la instancia de DateTimeOffset actual es anterior a MinSupportedDateTime o posterior a MaxSupportedDateTime, el método produce una ArgumentOutOfRangeException.If the value of the current DateTimeOffset instance is earlier than MinSupportedDateTime or later than MaxSupportedDateTime, the method throws an ArgumentOutOfRangeException. Esto se muestra en el ejemplo siguiente.The following example provides an illustration. Intenta dar formato a una fecha que está fuera del intervalo de la clase UmAlQuraCalendar.It attempts to format a date that is outside the range of the UmAlQuraCalendar class.

[! code-CSharpSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 4] [! code-VBSystem. DateTimeOffset. ToString. ArgumentOutOfRangeException # 4][!code-csharpSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4] [!code-vbSystem.DateTimeOffset.ToString.ArgumentOutOfRangeException#4]

Consulte también:

Se aplica a