TimeSpan.ToString Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Convierte el valor del objeto TimeSpan actual en su representación de cadena equivalente.
Sobrecargas
| ToString(String, IFormatProvider) |
Convierte el valor del objeto TimeSpan actual en la representación de cadena equivalente usando el formato especificado y la información de formato específica de la referencia cultural. |
| ToString(String) |
Convierte el valor del objeto TimeSpan actual en su representación de cadena equivalente usando el formato especificado. |
| ToString() |
Convierte el valor del objeto TimeSpan actual en su representación de cadena equivalente. |
ToString(String, IFormatProvider)
Convierte el valor del objeto TimeSpan actual en la representación de cadena equivalente usando el formato especificado y la información de formato específica de la referencia cultural.
public:
virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ formatProvider);public string ToString (string format, IFormatProvider formatProvider);public string ToString (string? format, IFormatProvider? formatProvider);override this.ToString : string * IFormatProvider -> stringPublic Function ToString (format As String, formatProvider As IFormatProvider) As StringParámetros
- formatProvider
- IFormatProvider
Objeto que proporciona información de formato específica de la referencia cultural.
Devoluciones
Representación de cadena del valor del objeto TimeSpan actual, con el formato especificado por format y formatProvider.
Implementaciones
Excepciones
El parámetro format no se reconoce o no es compatible.
Ejemplos
En el ejemplo siguiente se llama al ToString(String, IFormatProvider) método para dar formato a dos intervalos de tiempo. En el ejemplo se llama al método dos veces para cada cadena de formato, primero para mostrarlo mediante las convenciones de la referencia cultural en-US y, a continuación, para mostrarlo mediante las convenciones de la referencia cultural fr-FR.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
TimeSpan[] intervals = { new TimeSpan(38, 30, 15),
new TimeSpan(16, 14, 30) };
CultureInfo[] cultures = { new CultureInfo("en-US"),
new CultureInfo("fr-FR") };
string[] formats = {"c", "g", "G", @"hh\:mm\:ss" };
Console.WriteLine("{0,12} Format {1,22} {2,22}\n",
"Interval", cultures[0].Name, cultures[1].Name);
foreach (var interval in intervals) {
foreach (var fmt in formats)
Console.WriteLine("{0,12} {1,10} {2,22} {3,22}",
interval, fmt,
interval.ToString(fmt, cultures[0]),
interval.ToString(fmt, cultures[1]));
Console.WriteLine();
}
}
}
// The example displays the following output:
// Interval Format en-US fr-FR
//
// 1.14:30:15 c 1.14:30:15 1.14:30:15
// 1.14:30:15 g 1:14:30:15 1:14:30:15
// 1.14:30:15 G 1:14:30:15.0000000 1:14:30:15,0000000
// 1.14:30:15 hh\:mm\:ss 14:30:15 14:30:15
//
// 16:14:30 c 16:14:30 16:14:30
// 16:14:30 g 16:14:30 16:14:30
// 16:14:30 G 0:16:14:30.0000000 0:16:14:30,0000000
// 16:14:30 hh\:mm\:ss 16:14:30 16:14:30
open System
open System.Globalization
let intervals =
[| TimeSpan(38, 30, 15)
TimeSpan(16, 14, 30) |]
let cultures =
[| CultureInfo "en-US"
CultureInfo "fr-FR" |]
let formats = [| "c"; "g"; "G"; @"hh\:mm\:ss" |]
printfn $"""{"Interval",12} Format {cultures[0].Name,22} {cultures[1].Name,22}\n"""
for interval in intervals do
for fmt in formats do
printfn $"{interval,12} {fmt,10} {interval.ToString(fmt, cultures[0]),22} {interval.ToString(fmt, cultures[1]),22}"
printfn ""
// The example displays the following output:
// Interval Format en-US fr-FR
//
// 1.14:30:15 c 1.14:30:15 1.14:30:15
// 1.14:30:15 g 1:14:30:15 1:14:30:15
// 1.14:30:15 G 1:14:30:15.0000000 1:14:30:15,0000000
// 1.14:30:15 hh\:mm\:ss 14:30:15 14:30:15
//
// 16:14:30 c 16:14:30 16:14:30
// 16:14:30 g 16:14:30 16:14:30
// 16:14:30 G 0:16:14:30.0000000 0:16:14:30,0000000
// 16:14:30 hh\:mm\:ss 16:14:30 16:14:30
Imports System.Globalization
Module Example
Public Sub Main()
Dim intervals() As TimeSpan = { New TimeSpan(38, 30, 15),
New TimeSpan(16, 14, 30) }
Dim cultures() As CultureInfo = { New CultureInfo("en-US"),
New CultureInfo("fr-FR") }
Dim formats() As String = {"c", "g", "G", "hh\:mm\:ss" }
Console.WriteLine("{0,12} Format {1,22} {2,22}",
"Interval", cultures(0).Name, cultures(1).Name)
Console.WriteLine()
For Each interval In intervals
For Each fmt In formats
Console.WriteLine("{0,12} {1,10} {2,22} {3,22}",
interval, fmt,
interval.ToString(fmt, cultures(0)),
interval.ToString(fmt, cultures(1)))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' Interval Format en-US fr-FR
'
' 1.14:30:15 c 1.14:30:15 1.14:30:15
' 1.14:30:15 g 1:14:30:15 1:14:30:15
' 1.14:30:15 G 1:14:30:15.0000000 1:14:30:15,0000000
' 1.14:30:15 hh\:mm\:ss 14:30:15 14:30:15
'
' 16:14:30 c 16:14:30 16:14:30
' 16:14:30 g 16:14:30 16:14:30
' 16:14:30 G 0:16:14:30.0000000 0:16:14:30,0000000
' 16:14:30 hh\:mm\:ss 16:14:30 16:14:30
Comentarios
El format parámetro puede ser cualquier especificador de formato estándar o personalizado válido para los TimeSpan valores. Si format es igual a String.Empty o es null, el valor devuelto del objeto actual TimeSpan tiene el formato del especificador de formato común ("c"). Si el formato es cualquier otro valor, el método produce un FormatException.
Importante
Las cadenas de formato personalizado para TimeSpan los valores no incluyen un separador de fecha u hora. Si desea incluir estos elementos en la cadena de formato, debe tratarlos como literales de caracteres. Vea el ejemplo para obtener una ilustración y vea el tema Cadenas de formato TimeSpan personalizados para obtener más información.
.NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre las cadenas de formato para TimeSpan los valores, vea Cadenas de formato TimeSpan estándar y Cadenas de formato TimeSpan personalizados.
Para obtener más información sobre la compatibilidad con el formato en .NET, vea Formato de tipos.
El formatProvider parámetro es una IFormatProvider implementación que proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta. El formatProvider parámetro puede ser cualquiera de los siguientes:
Objeto CultureInfo que representa la referencia cultural cuyas convenciones de formato se van a reflejar en la cadena devuelta. El DateTimeFormatInfo objeto devuelto por la CultureInfo.DateTimeFormat propiedad define el formato de la cadena devuelta.
Objeto DateTimeFormatInfo que define el formato de la cadena devuelta.
Objeto personalizado que implementa la IFormatProvider interfaz . Su IFormatProvider.GetFormat método devuelve un DateTimeFormatInfo objeto que proporciona información de formato.
Si formatProvider es null, se usa el DateTimeFormatInfo objeto asociado a la referencia cultural actual. Si format es una cadena de formato personalizado, se omite el formatProvider parámetro .
Consulte también
Se aplica a
ToString(String)
Convierte el valor del objeto TimeSpan actual en su representación de cadena equivalente usando el formato especificado.
public:
System::String ^ ToString(System::String ^ format);public string ToString (string format);public string ToString (string? format);override this.ToString : string -> stringPublic Function ToString (format As String) As StringParámetros
Devoluciones
Representación de cadena del valor TimeSpan actual en el formato especificado por el parámetro format.
Excepciones
El parámetro format no se reconoce o no es compatible.
Ejemplos
En el ejemplo siguiente se usan cadenas de formato estándar y personalizado TimeSpan para mostrar la representación de cadena de cada elemento en una matriz de valores.TimeSpan
TimeSpan[] spans = {
TimeSpan.Zero,
new TimeSpan(-14, 0, 0, 0, 0),
new TimeSpan(1, 2, 3),
new TimeSpan(0, 0, 0, 0, 250),
new TimeSpan(99, 23, 59, 59, 999),
new TimeSpan(3, 0, 0),
new TimeSpan(0, 0, 0, 0, 25)
};
string[] fmts = { "c", "g", "G", @"hh\:mm\:ss", "%m' min.'" };
foreach (TimeSpan span in spans)
{
foreach (string fmt in fmts)
Console.WriteLine("{0}: {1}", fmt, span.ToString(fmt));
Console.WriteLine();
}
// The example displays the following output:
// c: 00:00:00
// g: 0:00:00
// G: 0:00:00:00.0000000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: -14.00:00:00
// g: -14:0:00:00
// G: -14:00:00:00.0000000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: 01:02:03
// g: 1:02:03
// G: 0:01:02:03.0000000
// hh\:mm\:ss: 01:02:03
// %m' min.': 2 min.
//
// c: 00:00:00.2500000
// g: 0:00:00.25
// G: 0:00:00:00.2500000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: 99.23:59:59.9990000
// g: 99:23:59:59.999
// G: 99:23:59:59.9990000
// hh\:mm\:ss: 23:59:59
// %m' min.': 59 min.
//
// c: 03:00:00
// g: 3:00:00
// G: 0:03:00:00.0000000
// hh\:mm\:ss: 03:00:00
// %m' min.': 0 min.
//
// c: 00:00:00.0250000
// g: 0:00:00.025
// G: 0:00:00:00.0250000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
let spans =
[| TimeSpan.Zero
TimeSpan(-14, 0, 0, 0, 0)
TimeSpan(1, 2, 3)
TimeSpan(0, 0, 0, 0, 250)
TimeSpan(99, 23, 59, 59, 999)
TimeSpan(3, 0, 0)
TimeSpan(0, 0, 0, 0, 25) |]
let fmts = [| "c"; "g"; "G"; @"hh\:mm\:ss"; "%m' min.'" |]
for span in spans do
for fmt in fmts do
printfn $"{fmt}: {span.ToString fmt}"
printfn ""
// The example displays the following output:
// c: 00:00:00
// g: 0:00:00
// G: 0:00:00:00.0000000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: -14.00:00:00
// g: -14:0:00:00
// G: -14:00:00:00.0000000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: 01:02:03
// g: 1:02:03
// G: 0:01:02:03.0000000
// hh\:mm\:ss: 01:02:03
// %m' min.': 2 min.
//
// c: 00:00:00.2500000
// g: 0:00:00.25
// G: 0:00:00:00.2500000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
//
// c: 99.23:59:59.9990000
// g: 99:23:59:59.999
// G: 99:23:59:59.9990000
// hh\:mm\:ss: 23:59:59
// %m' min.': 59 min.
//
// c: 03:00:00
// g: 3:00:00
// G: 0:03:00:00.0000000
// hh\:mm\:ss: 03:00:00
// %m' min.': 0 min.
//
// c: 00:00:00.0250000
// g: 0:00:00.025
// G: 0:00:00:00.0250000
// hh\:mm\:ss: 00:00:00
// %m' min.': 0 min.
Module Example
Public Sub Main()
Dim spans() As TimeSpan = { TimeSpan.Zero, New TimeSpan(-14, 0, 0, 0, 0),
New TimeSpan(1, 2, 3),
New TimeSpan(0, 0, 0, 0, 250),
New TimeSpan(99, 23, 59, 59, 999),
New TimeSpan(3, 0, 0),
New TimeSpan(0, 0, 0, 0, 25) }
Dim fmts() As String = { "c", "g", "G", "hh\:mm\:ss", "%m' min.'" }
For Each span As TimeSpan In spans
For Each fmt As String In fmts
Console.WriteLine("{0}: {1}", fmt, span.ToString(fmt))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' c: 00:00:00
' g: 0:00:00
' G: 0:00:00:00.0000000
' hh\:mm\:ss: 00:00:00
' %m' min.': 0 min.
'
' c: -14.00:00:00
' g: -14:0:00:00
' G: -14:00:00:00.0000000
' hh\:mm\:ss: 00:00:00
' %m' min.': 0 min.
'
' c: 01:02:03
' g: 1:02:03
' G: 0:01:02:03.0000000
' hh\:mm\:ss: 01:02:03
' %m' min.': 2 min.
'
' c: 00:00:00.2500000
' g: 0:00:00.25
' G: 0:00:00:00.2500000
' hh\:mm\:ss: 00:00:00
' %m' min.': 0 min.
'
' c: 99.23:59:59.9990000
' g: 99:23:59:59.999
' G: 99:23:59:59.9990000
' hh\:mm\:ss: 23:59:59
' %m' min.': 59 min.
'
' c: 03:00:00
' g: 3:00:00
' G: 0:03:00:00.0000000
' hh\:mm\:ss: 03:00:00
' %m' min.': 0 min.
'
' c: 00:00:00.0250000
' g: 0:00:00.025
' G: 0:00:00:00.0250000
' hh\:mm\:ss: 00:00:00
' %m' min.': 0 min.
Comentarios
El format parámetro puede ser cualquier especificador de formato estándar o personalizado válido para los TimeSpan valores. Si format es igual a String.Empty o es null, el valor devuelto del objeto actual TimeSpan tiene el formato del especificador de formato común ("c"). Si format es cualquier otro valor, el método produce un FormatException.
Si format es una cadena de formato estándar, el formato de la cadena devuelta se define mediante las convenciones de formato de la referencia cultural actual.
Importante
Las cadenas de formato personalizado para TimeSpan los valores no incluyen un separador de fecha u hora. Si desea incluir estos elementos en la cadena de formato, debe tratarlos como literales de caracteres. Vea el ejemplo para obtener una ilustración y vea el tema Cadenas de formato TimeSpan personalizados para obtener más información.
.NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre las cadenas de formato para TimeSpan los valores, vea Cadenas de formato TimeSpan estándar y Cadenas de formato TimeSpan personalizados.
Para obtener más información sobre la compatibilidad con el formato en .NET, vea Formato de tipos.
Consulte también
Se aplica a
ToString()
Convierte el valor del objeto TimeSpan actual en su representación de cadena equivalente.
public:
override System::String ^ ToString();public override string ToString ();override this.ToString : unit -> stringPublic Overrides Function ToString () As StringDevoluciones
Representación de cadena del valor TimeSpan actual.
Ejemplos
En el ejemplo siguiente se muestran las cadenas devueltas llamando al ToString método con una serie de TimeSpan valores. Tenga en cuenta que aunque el ejemplo no llama directamente al ToString método , lo llama el Console.WriteLine método cuando intenta convertir un TimeSpan valor en su representación de cadena.
TimeSpan span;
// Initialize a time span to zero.
span = TimeSpan.Zero;
Console.WriteLine(span);
// Initialize a time span to 14 days.
span = new TimeSpan(-14, 0, 0, 0, 0);
Console.WriteLine(span);
// Initialize a time span to 1:02:03.
span = new TimeSpan(1, 2, 3);
Console.WriteLine(span);
// Initialize a time span to 250 milliseconds.
span = new TimeSpan(0, 0, 0, 0, 250);
Console.WriteLine(span);
// Initialize a time span to 99 days, 23 hours, 59 minutes, and 59.999 seconds.
span = new TimeSpan(99, 23, 59, 59, 999);
Console.WriteLine(span);
// Initialize a time span to 3 hours.
span = new TimeSpan(3, 0, 0);
Console.WriteLine(span);
// Initialize a timespan to 25 milliseconds.
span = new TimeSpan(0, 0, 0, 0, 25);
Console.WriteLine(span);
// The example displays the following output:
// 00:00:00
// -14.00:00:00
// 01:02:03
// 00:00:00.2500000
// 99.23:59:59.9990000
// 03:00:00
// 00:00:00.0250000
// Initialize a time span to zero.
let span = TimeSpan.Zero
printfn $"{span}"
// Initialize a time span to 14 days.
let span = TimeSpan(-14, 0, 0, 0, 0)
printfn $"{span}"
// Initialize a time span to 1:02:03.
let span = TimeSpan(1, 2, 3)
printfn $"{span}"
// Initialize a time span to 250 milliseconds.
let span = TimeSpan(0, 0, 0, 0, 250)
printfn $"{span}"
// Initialize a time span to 99 days, 23 hours, 59 minutes, and 59.999 seconds.
let span = TimeSpan(99, 23, 59, 59, 999)
printfn $"{span}"
// Initialize a time span to 3 hours.
let span = TimeSpan(3, 0, 0)
printfn $"{span}"
// Initialize a timespan to 25 milliseconds.
let span = TimeSpan(0, 0, 0, 0, 25)
printfn $"{span}"
// The example displays the following output:
// 00:00:00
// -14.00:00:00
// 01:02:03
// 00:00:00.2500000
// 99.23:59:59.9990000
// 03:00:00
// 00:00:00.0250000
Module ToString
Public Sub Main()
Dim span As TimeSpan
' Initialize a time span to zero.
span = TimeSpan.Zero
Console.WriteLine(span)
' Initialize a time span to 14 days.
span = New TimeSpan(-14, 0, 0, 0, 0)
Console.WriteLine(span)
' Initialize a time span to 1:02:03.
span = New TimeSpan(1, 2, 3)
Console.WriteLine(span)
' Initialize a time span to 250 milliseconds.
span = New TimeSpan(0, 0, 0, 0, 250)
Console.WriteLine(span)
' Initialize a time span to 99 days, 23 hours, 59 minutes, and 59.9999999 seconds.
span = New TimeSpan(99, 23, 59, 59, 999)
Console.WriteLine(span)
' Initialize a time span to 3 hours.
span = New TimeSpan(3, 0, 0)
Console.WriteLine(span)
' Initialize a timespan to 25 milliseconds.
span = New TimeSpan(0, 0, 0, 0, 25)
Console.WriteLine(span)
End Sub
End Module
' The example displays the following output:
' 00:00:00
' -14.00:00:00
' 01:02:03
' 00:00:00.2500000
' 99.23:59:59.9990000
' 03:00:00
' 00:00:00.0250000
Comentarios
La cadena devuelta tiene formato con el especificador de formato "c" y tiene el formato siguiente:
[-][d.]hh:mm:ss[.fffffff]
Es posible que los elementos entre corchetes ([ y ]) no se incluyan en la cadena devuelta. Los dos puntos y puntos (: y).) son caracteres literales. Los elementos no literales se muestran en la tabla siguiente. Tenga en cuenta que la cadena devuelta por el ToString() método no distingue la referencia cultural.
| Elemento | Descripción |
|---|---|
| "-" | Signo menos, que indica un intervalo de tiempo negativo. No se incluye ningún signo para un intervalo de tiempo positivo. |
| "d" | Número de días en el intervalo de tiempo. Este elemento se omite si el intervalo de tiempo es menor que un día. |
| "hh" | Número de horas en el intervalo de tiempo, comprendido entre 0 y 23. |
| "mm" | Número de minutos en el intervalo de tiempo, comprendido entre 0 y 59. |
| "ss" | Número de segundos en el intervalo de tiempo, comprendido entre 0 y 59. |
| "fffffff" | Fracciones de segundos en el intervalo de tiempo. Este elemento se omite si el intervalo de tiempo no incluye fracciones de segundos. Si está presente, las fracciones de segundo siempre se expresan con siete dígitos decimales. |
Notas a los autores de las llamadas
Se agregó compatibilidad con los valores de formato TimeSpan en .NET Framework 4. Sin embargo, la sobrecarga del ToString() método sigue sin distinguir la referencia cultural. Su comportamiento permanece sin cambios respecto a las versiones anteriores de .NET Framework. Para controlar el formato de un TimeSpan valor, llame a la ToString(String) sobrecarga o ToString(String, IFormatProvider) .
Consulte también
Se aplica a
Comentarios
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de