TimeSpan (Estructura)

Puede crear instancias de un valor TimeSpan de varias formas:

• Mediante una llamada a su constructor predeterminado implícito. Esto crea un objeto cuyo valor es TimeSpan.Zero, como se muestra en el ejemplo siguiente.

  C#

  VB

  Copiar

  
  TimeSpan interval = new TimeSpan();
  Console.WriteLine(interval.Equals(TimeSpan.Zero));    // Displays "True".
  
  
  

• Llamando a uno de sus constructores explícitos. En el siguiente ejemplo se inicializa un valor TimeSpan para un número de horas, minutos y segundos especificado.

  C#

  VB

  Copiar

  
  TimeSpan interval = new TimeSpan(2, 14, 18);
  Console.WriteLine(interval.ToString());              // Displays "02:14:18".
  
  
  

• Llamando a un método o realizando una operación que devuelve un valor TimeSpan. Por ejemplo, puede crear instancias de un valor TimeSpan que representa el intervalo entre dos valores de fecha y hora, como las siguientes presentaciones del ejemplo.

  C#

  VB

  Copiar

  
  DateTime departure = new DateTime(2010, 6, 12, 18, 32, 0);
  DateTime arrival = new DateTime(2010, 6, 13, 22, 47, 0);
  TimeSpan travelTime = arrival - departure;  
  Console.WriteLine("{0} - {1} = {2}", arrival, departure, travelTime);      
  // The example displays the following output:
  //       6/13/2010 10:47:00 PM - 6/12/2010 6:32:00 PM = 1.04:15:00
  
  
  

  Los valores TimeSpan se devuelven mediante operadores aritméticos y métodos de las estructuras DateTime, DateTimeOffset y TimeSpan.

• Mediante el análisis de la representación de cadena de un valor TimeSpan. Puede usar los métodos TryParse y Parse para convertir cadenas que contienen intervalos de tiempo para los valores TimeSpan. En el siguiente ejemplo, se utiliza el método Parse para convertir una matriz de cadenas en valores TimeSpan.

  C#

  VB

  Copiar

  
  string[] values = { "12", "31.", "5.8:32:16", "12:12:15.95", ".12"};
  foreach (string value in values)
  {
     try {
        TimeSpan ts = TimeSpan.Parse(value);
        Console.WriteLine("'{0}' --> {1}", value, ts);
     }
     catch (FormatException) {
        Console.WriteLine("Unable to parse '{0}'", value);
     }
     catch (OverflowException) {
        Console.WriteLine("'{0}' is outside the range of a TimeSpan.", value);
     }   
  }
  // The example displays the following output:
  //       '12' --> 12.00:00:00
  //       Unable to parse '31.'
  //       '5.8:32:16' --> 5.08:32:16
  //       '12:12:15.95' --> 12:12:15.9500000
  //       Unable to parse '.12'  
  
  
  

  Además, puede definir el formato preciso de la cadena de entrada que se va a analizar y convertir a un valor TimeSpan llamando al método TryParseExact u ParseExact.

Puede agregar y restar duraciones de tiempo usando los operadores Subtraction y Addition o llamando a los métodos Subtract y Add. También puede comparar dos duraciones de tiempo llamando a los métodos Compare, CompareTo y Equals. La clase TimeSpan también incluye los métodos Negate y Duration que convierten intervalos de tiempo en valores positivos y negativos,

El intervalo de valores TimeSpan va de MinValue a MaxValue.

Un valor TimeSpan se puede representar como [-]d.hh:mm:ss.ff, donde el signo menos opcional indica un intervalo de tiempo negativo, el componente d son los días, hh son las horas en formato de 24 horas, mm son los minutos, ss son los segundos y ff son fracciones de segundo. Es decir, un intervalo de tiempo está formado por un número positivo o negativo de días completos, un número de días con períodos de tiempo o sólo períodos de tiempo.

Comenzando con .NET Framework versión 4, la estructura TimeSpan admite el formato dependiente de la referencia cultural a través de las sobrecargas de su método ToString, que convierte un valor TimeSpan en su representación de cadena. El método TimeSpan.ToString() predeterminado devuelve un intervalo de tiempo usando un formato invariable que es idéntico a su valor devuelto en versiones anteriores de .NET Framework. La sobrecarga TimeSpan.ToString(String) permite especificar una cadena con formato que define la representación de cadena del intervalo de tiempo. La sobrecarga TimeSpan.ToString(String, IFormatProvider) permite especificar una cadena de formato y la referencia cultural cuyas convenciones de formato se usan para crear la representación de cadena del intervalo de tiempo. TimeSpan admite cadenas con formato personalizado y estándar. (Para obtener más información, vea Cadenas de formato TimeSpan estándar y Cadenas de formato TimeSpan personalizado). Sin embargo, solo las cadenas de formato estándar son dependientes de la referencia cultural.

En algunos casos, el código que da formato correctamente a los valores TimeSpan en .NET Framework 3.5 y versiones anteriores da error en .NET Framework 4. Esto es muy común en código que llama a un método de formato compuesto para dar formato a un valor TimeSpan con una cadena de formato. El siguiente ejemplo da formato correctamente a un valor TimeSpan en .NET Framework 3.5 y versiones anteriores, pero produce una excepción en .NET Framework 4 y versiones posteriores. Observe que intenta dar formato a un valor TimeSpan usando un especificador de formato no compatible, que se omite en .NET Framework 3.5 y en versiones anteriores.

TimeSpan interval = new TimeSpan(12, 30, 45);
string output;
try {
   output = String.Format("{0:r}", interval);
}
catch (FormatException) {
   output = "Invalid Format";
}
Console.WriteLine(output);
// Output from .NET Framework 3.5 and earlier versions:
//       12:30:45
// Output from .NET Framework 4:
//       Invalid Format

Si no puede modificar el código, puede restaurar el formato heredado de valores TimeSpan de una de las siguientes maneras:

• Creando un archivo de configuración que contiene el elemento <TimeSpan_LegacyFormatMode>. Al establecer el atributo enabled de este elemento en true, se restaura el formato TimeSpan heredado según la aplicación.

• Estableciendo el modificador de compatibilidad de "NetFx40_TimeSpanLegacyFormatMode" al crear un dominio de aplicación. Esto habilita el formato TimeSpan heredado según dominio de aplicación. En el ejemplo siguiente se crea un dominio de aplicación que usa el formato TimeSpan heredado.

  C#

  VB

  Copiar

  
  using System;
  
  public class Example
  {
     public static void Main()
     {
        AppDomainSetup appSetup = new AppDomainSetup();
        appSetup.SetCompatibilitySwitches( new string[] { "NetFx40_TimeSpanLegacyFormatMode" } );
        AppDomain legacyDomain = AppDomain.CreateDomain("legacyDomain", 
                                                        null, appSetup);
        legacyDomain.ExecuteAssembly("ShowTimeSpan.exe");
     }
  }
  
  
  

  Cuando el siguiente código se ejecuta en el nuevo dominio de aplicación, revierte al comportamiento de formato TimeSpan heredado.

  C#

  VB

  Copiar

  
  using System;
  
  public class Example
  {
     public static void Main()
     {
        TimeSpan interval = DateTime.Now - DateTime.Now.Date;
        string msg = String.Format("Elapsed Time Today: {0:d} hours.",
                                   interval);
        Console.WriteLine(msg);
     }
  }
  // The example displays the following output:
  //       Elapsed Time Today: 01:40:52.2524662 hours.