Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

TimeSpan, structure

Représente un intervalle de temps.

Espace de noms :  System
Assembly :  mscorlib (dans mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public struct TimeSpan : IComparable, IComparable<TimeSpan>, 
	IEquatable<TimeSpan>, IFormattable

Le type TimeSpan expose les membres suivants.

  NomDescription
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTimeSpan(Int64)Initialise une nouvelle instance de la structure TimeSpan avec le nombre de graduations spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTimeSpan(Int32, Int32, Int32)Initialise une nouvelle instance de la structure TimeSpan par rapport à un nombre d'heures, de minutes et de secondes spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTimeSpan(Int32, Int32, Int32, Int32)Initialise une nouvelle instance de la structure TimeSpan par rapport à un nombre de jours, d'heures, de minutes et de secondes spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTimeSpan(Int32, Int32, Int32, Int32, Int32)Initialise une nouvelle instance de la structure d'un TimeSpan à un nombre de jours spécifié, des heures, les minutes, des secondes, et aux millisecondes.
Début

  NomDescription
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDaysObtient le composant « jours » de l'intervalle de temps représenté par la structure TimeSpan actuelle.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreHoursObtient le composant « heures » de l'intervalle de temps représenté par la structure TimeSpan actuelle.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMillisecondsObtient le composant « millisecondes » de l'intervalle de temps représenté par la structure TimeSpan actuelle.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMinutesObtient le composant « minutes » de l'intervalle de temps représenté par la structure TimeSpan actuelle.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSecondsObtient le composant « secondes » de l'intervalle de temps représenté par la structure TimeSpan actuelle.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTicksObtient le nombre de graduations représentant la valeur de la structure TimeSpan en cours.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTotalDaysObtient la valeur de la structure TimeSpan exprimée en jours entiers et fractionnaires.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTotalHoursObtient la valeur de la structure TimeSpan exprimée en heures entières et fractionnaires.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTotalMillisecondsObtient la valeur de la structure TimeSpan exprimée en millisecondes entières et fractionnaires.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTotalMinutesObtient la valeur de la structure TimeSpan exprimée en minutes entières et fractionnaires.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTotalSecondsObtient la valeur de la structure TimeSpan exprimée en secondes entières et fractionnaires.
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAddRetourne un nouvel objet TimeSpan dont la valeur est la somme de l'objet TimeSpan spécifié et de cette instance.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCompareCompare deux valeurs TimeSpan et retourne un entier qui indique si la première valeur est plus courte, identique, ou plus longue que la deuxième valeur.
Méthode publiquePris en charge par XNA FrameworkCompareTo(Object)Compare cette instance à un objet spécifié et retourne un entier qui indique si cette instance est plus courte, de même longueur ou plus longue que l'objet spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCompareTo(TimeSpan)Compare cette instance à un objet TimeSpan spécifié et retourne un entier qui indique si cette instance est plus courte, de même longueur ou plus longue que l'objet TimeSpan.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDurationRetourne un nouvel objet TimeSpan dont la valeur représente la valeur absolue de l'objet TimeSpan en cours.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(Object)Renvoie une valeur indiquant si cette instance équivaut à un objet spécifié. (Substitue ValueType.Equals(Object).)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(TimeSpan)Retourne une valeur indiquant si cette instance équivaut à un objet TimeSpan spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(TimeSpan, TimeSpan)Retourne une valeur qui indique si deux instances spécifiées de TimeSpan sont égales.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFromDaysRetourne un TimeSpan représentant un nombre de jours spécifié, où la spécification est précise à la milliseconde près.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFromHoursRetourne un TimeSpan représentant un nombre d'heures spécifié, où la spécification est précise à la milliseconde près.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFromMillisecondsRetourne un TimeSpan représentant un nombre spécifié de millisecondes.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFromMinutesRetourne un TimeSpan représentant un nombre de minutes spécifié, où la spécification est précise à la milliseconde près.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFromSecondsRetourne un TimeSpan représentant un nombre de secondes spécifié, où la spécification est précise à la milliseconde près.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFromTicksRetourne un TimeSpan représentant une durée spécifiée, où la spécification est en unités de graduations.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetHashCodeRetourne un code de hachage pour cette instance. (Substitue ValueType.GetHashCode().)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNegateRetourne un nouvel objet TimeSpan dont la valeur correspond à la valeur négative de cette instance.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParse(String)Convertit la représentation sous forme de chaîne d'un intervalle de temps en TimeSpan équivalent.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParse(String, IFormatProvider)Convertit la représentation sous forme de chaîne d'un intervalle de temps en son équivalent TimeSpan à l'aide des informations de format spécifiques à la culture spécifiées.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParseExact(String, String, IFormatProvider)Convertit la représentation sous forme de chaîne d'un intervalle de temps en son équivalent TimeSpan à l'aide des informations de format spécifiques à la culture spécifiées. Le format de la chaîne doit correspondre exactement au format spécifié.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParseExact(String, String[], IFormatProvider)Convertit la représentation sous forme de chaîne d'un intervalle de temps en son équivalent TimeSpan à l'aide du tableau de chaînes de format et des informations de format spécifiques à la culture spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à l'un des formats spécifiés.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParseExact(String, String, IFormatProvider, TimeSpanStyles)Convertit la représentation sous forme de chaîne d'un intervalle de temps en son équivalent TimeSpan à l'aide des styles et des informations de format spécifiques à la culture spécifiés. Le format de la chaîne doit correspondre exactement au format spécifié.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParseExact(String, String[], IFormatProvider, TimeSpanStyles)Convertit la représentation sous forme de chaîne d'un intervalle de temps en son équivalent TimeSpan à l'aide des formats, des informations de format spécifiques à la culture et des styles spécifiés. Le format de la représentation sous forme de chaîne doit correspondre exactement à l'un des formats spécifiés.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSubtractRetourne un nouvel objet TimeSpan dont la valeur est la différence entre l'objet TimeSpan spécifié et cette instance.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToString()Convertit la valeur de l'objet TimeSpan actif en sa représentation équivalente sous forme de chaîne. (Substitue ValueType.ToString().)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToString(String)Convertit la valeur de l'objet TimeSpan actuel en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToString(String, IFormatProvider)Convertit la valeur de l'objet TimeSpan actif en sa représentation sous forme de chaîne équivalente à l'aide du format et des informations de mise en forme spécifiques à la culture spécifiés.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParse(String, TimeSpan)Convertit la représentation sous forme de chaîne d'un intervalle de temps en son équivalent TimeSpan et retourne une valeur qui indique si la conversion a réussi.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParse(String, IFormatProvider, TimeSpan)Convertit la représentation sous forme de chaîne spécifiée d'un intervalle de temps en son équivalent TimeSpan à l'aide des informations de mise en forme spécifiques à la culture et retourne une valeur qui indique si la conversion a réussi.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParseExact(String, String, IFormatProvider, TimeSpan)Convertit la représentation sous forme de chaîne d'un intervalle de temps en son équivalent TimeSpan à l'aide du format et des informations de format spécifiques à la culture spécifiés, et retourne une valeur qui indique si la conversion a réussi. Le format de la chaîne doit correspondre exactement au format spécifié.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParseExact(String, String[], IFormatProvider, TimeSpan)Convertit la représentation sous forme de chaîne spécifiée d'un intervalle de temps en son équivalent TimeSpan à l'aide des formats et des informations de format spécifiques à la culture spécifiés, et retourne une valeur qui indique si la conversion a réussi. Le format de la représentation sous forme de chaîne doit correspondre exactement à l'un des formats spécifiés.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParseExact(String, String, IFormatProvider, TimeSpanStyles, TimeSpan)Convertit la représentation sous forme de chaîne spécifiée d'un intervalle de temps en son équivalent TimeSpan à l'aide du format, des informations de format spécifiques à la culture et des styles spécifiés, et retourne une valeur qui indique si la conversion a réussi. Le format de la chaîne doit correspondre exactement au format spécifié.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParseExact(String, String[], IFormatProvider, TimeSpanStyles, TimeSpan)Convertit la représentation sous forme de chaîne spécifiée d'un intervalle de temps en son équivalent TimeSpan à l'aide des formats, des informations de format spécifiques à la culture et des styles spécifiés, et retourne une valeur qui indique si la conversion a réussi. Le format de la représentation sous forme de chaîne doit correspondre exactement à l'un des formats spécifiés.
Début

  NomDescription
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAdditionAjoute les deux instances de TimeSpan spécifiées.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEqualityIndique si deux instances de TimeSpan sont égales.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGreaterThanIndique si un TimeSpan spécifié est supérieur à un autre TimeSpan spécifié.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGreaterThanOrEqualIndique si un TimeSpan spécifié est supérieur ou égal à un autre TimeSpan spécifié.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreInequalityIndique si deux instances de TimeSpan ne sont pas égales.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLessThanIndique si un TimeSpan spécifié est inférieur à un autre TimeSpan spécifié.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLessThanOrEqualIndique si un TimeSpan spécifié est inférieur ou égal à un autre TimeSpan spécifié.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSubtractionSoustrait un TimeSpan spécifié d'un autre TimeSpan spécifié.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreUnaryNegationRetourne un TimeSpan dont la valeur correspond à la valeur négative de l'instance spécifiée.
Opérateur publicMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreUnaryPlusRetourne l'instance spécifiée de TimeSpan.
Début

  NomDescription
Champ publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMaxValueReprésente la valeur TimeSpan maximale. Ce champ est en lecture seule.
Champ publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMinValueReprésente la valeur TimeSpan minimale. Ce champ est en lecture seule.
Champ publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTicksPerDayReprésente le nombre de graduations en 1 jour. Ce champ est constant.
Champ publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTicksPerHourReprésente le nombre de graduations en 1 heure. Ce champ est constant.
Champ publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTicksPerMillisecondReprésente le nombre de graduations en 1 milliseconde. Ce champ est constant.
Champ publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTicksPerMinuteReprésente le nombre de graduations en 1 minute. Ce champ est constant.
Champ publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTicksPerSecondReprésente le nombre de graduations en 1 seconde.
Champ publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreZeroReprésente la valeur zéro de TimeSpan. Ce champ est en lecture seule.
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIComparable.CompareToCompare l'instance actuelle avec un autre objet du même type et retourne un entier qui indique si l'instance actuelle précède ou suit un autre objet ou se trouve à la même position dans l'ordre de tri.
Début

Un objet TimeSpan représente un intervalle de temps (durée ou temps écoulé) qui est mesuré en nombre positif ou négatif de jours, heures, minutes, secondes et fractions de seconde. La structure TimeSpan peut également être utilisée pour représenter l'heure de la journée, mais uniquement si l'heure n'est pas liée à une date particulière. Dans le cas contraire, la structure DateTime ou DateTimeOffset doit être utilisée à la place. (Pour plus d'informations sur l'utilisation de la structure TimeSpan pour refléter l'heure de jour, consultez Choix entre DateTime, DateTimeOffset et TimeZoneInfo.)

La plus grande unité de temps que la structure TimeSpan utilise pour mesurer la durée est un jour. Les intervalles de temps sont mesurés en jours pour des raisons de cohérence puisque le nombre de jours compris dans des unités de temps supérieures, telles que le mois et l'année, varie.

La valeur d'un objet TimeSpan est le nombre de graduations équivalant à l'intervalle de temps représenté. Une graduation représente 100 nanosecondes, ou un dix-millionième de seconde. La valeur d'un objet TimeSpan peut varier de TimeSpan.MinValue à TimeSpan.MaxValue.

Instanciation d'une valeur TimeSpan

Vous pouvez instancier une valeur TimeSpan de plusieurs façons :

  • En appelant son constructeur par défaut implicite. Cela crée un objet dont la valeur est TimeSpan.Zero, comme le montre l'exemple suivant.

    
    TimeSpan interval = new TimeSpan();
    Console.WriteLine(interval.Equals(TimeSpan.Zero));    // Displays "True".
    
    
    
  • En appelant l'un de ses constructeurs explicites. L'exemple suivant initialise une valeur TimeSpan selon un nombre spécifié d'heures, de minutes et de secondes.

    
    TimeSpan interval = new TimeSpan(2, 14, 18);
    Console.WriteLine(interval.ToString());              // Displays "02:14:18".
    
    
    
  • En appelant une méthode ou en exécutant une opération qui retourne une valeur TimeSpan. Par exemple, vous pouvez instancier une valeur TimeSpan qui représente l'intervalle entre deux valeurs de date et d'heure, comme l'exemple suivant affiche.

    
    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
    
    
    

    Vous pouvez également initialiser un objet TimeSpan à une heure zéro de cette manière, comme indiqué dans l'exemple suivant.

    
    using System;
    
    public class Example
    {
       static Random rnd = new Random();
    
       public static void Main()
       {
          TimeSpan timeSpent = TimeSpan.Zero;
    
          timeSpent += GetTimeBeforeLunch();
          timeSpent += GetTimeAfterLunch();
    
          Console.WriteLine("Total time: {0}", timeSpent);
       }
    
       private static TimeSpan GetTimeBeforeLunch()
       {
          return new TimeSpan(rnd.Next(3, 6), 0, 0);
       }
    
       private static TimeSpan GetTimeAfterLunch()
       {
          return new TimeSpan(rnd.Next(3, 6), 0, 0);
       }
    }
    // The example displays output like the following:
    //        Total time: 08:00:00
    
    
    

    Les valeurs TimeSpan sont retournées par des opérateurs arithmétiques et des méthodes du DateTime, DateTimeOffset et des structures TimeSpan.

  • En analysant la représentation sous forme de chaîne d'une valeur TimeSpan. Vous pouvez utiliser les méthodes Parse et TryParse pour convertir des chaînes qui contiennent des intervalles de temps aux valeurs TimeSpan. L'exemple suivant utilise la méthode Parse pour convertir un tableau de chaînes en valeurs TimeSpan.

    
    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'  
    
    
    

    De plus, vous pouvez définir le format précis de la chaîne d'entrée à analyser et convertir en valeur TimeSpan en appelant la méthode ParseExact ou TryParseExact.

Exécution d'opérations sur les valeurs TimeSpan

Vous pouvez ajouter et soustraire des durées en utilisant les opérateurs Addition et Subtraction, ou en appelant les méthodes Add et Subtract. Vous pouvez également comparer deux durées en appelant les méthodes Compare, CompareTo et méthodes Equals. La classe TimeSpan inclut également les méthodes Duration et Negate, qui convertissent des intervalles de temps en valeurs positives et négatives,

La plage de valeurs TimeSpan est MinValue à MaxValue.

Mise en forme d'une valeur TimeSpan

Une valeur TimeSpan peut être représentée en tant que [-]j.hh:mm:ss.ff, où le signe moins facultatif indique un intervalle de temps négatif, le composant j correspond aux jours, hh correspond aux heures (comme sur une montre de 24 heures), mm correspond aux minutes, ss aux secondes et ff aux fractions d'une seconde. En d'autres termes, un intervalle de temps représente un nombre positif ou négatif de jours sans heure, un nombre de jours avec une heure, ou uniquement une heure du jour.

À partir du .NET Framework 4, la structure TimeSpan prend en charge la mise en forme dépendante de la culture via les surcharges de sa méthode ToString, qui convertit une valeur TimeSpan en sa représentation sous forme de chaîne. La méthode TimeSpan.ToString() par défaut retourne un intervalle de temps à l'aide d'un format invariant qui est identique à sa valeur de retour dans les versions antérieures du .NET Framework. La surcharge TimeSpan.ToString(String) vous permet de spécifier une chaîne de format qui définit la représentation sous forme de chaîne de l'intervalle de temps. La surcharge d' TimeSpan.ToString(String, IFormatProvider)vous permet de spécifier une chaîne de format et la culture dont les conventions de mise en forme sont utilisées pour créer la représentation sous forme de chaîne de l'intervalle de temps. TimeSpan prend en charge le standard et les chaînes de format personnalisées. (Pour plus d'informations, consultez Chaînes de format TimeSpan standard. et Chaînes de format TimeSpan personnalisées.) Toutefois, seules les chaînes de format standard sont dépendantes de la culture.

Restauration de la mise en forme TimeSpan héritée

Dans certains cas, le code qui met correctement en forme des valeurs d'TimeSpan dans .NET Framework 3.5 et les versions antérieures échoue dans .NET Framework 4. C'est le plus courant dans le code qui appelle une méthode mise en forme composite  pour mettre en forme une valeur d'TimeSpan avec une chaîne de format. L'exemple suivant met en forme avec succès une valeur TimeSpan dans le .NET Framework 3.5 et les versions antérieures, mais lève une exception dans .NET Framework 4 et les versions ultérieures. Notez qu'il essaie de mettre en forme une valeur TimeSpan à l'aide d'un spécificateur de format non pris en charge, qui est ignoré dans .NET Framework 3.5 et les versions antérieures.


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 vous ne pouvez pas modifier le code, vous pouvez restaurer la mise en forme héritée de valeurs TimeSpan de l'une des façons suivantes :

  • En créant un fichier de configuration qui contient l'élément <TimeSpan_LegacyFormatMode>. L'affectation à l'attribut enabled de cet élément de la valeur true restaure la mise en forme TimeSpan héritée pour chaque application.

  • En définissant le commutateur de compatibilité « NetFx40_TimeSpanLegacyFormatMode » lorsque vous créez un domaine d'application. Cela permet la mise en forme TimeSpan héritée pour chaque domaine d'application. L'exemple suivant crée un domaine d'application qui utilise la mise en forme TimeSpan héritée.

    
    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");
       }
    }
    
    
    

    Lorsque le code suivant s'exécute dans le nouveau domaine d'application, il rétablit le comportement de mise en forme TimeSpan hérité (legacy).

    
    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.
    
    
    

L'exemple suivant instancie un objet TimeSpan qui représente la différence entre deux dates. Il affiche alors les propriétés de l'objet TimeSpan.


// Define two dates.
DateTime date1 = new DateTime(2010, 1, 1, 8, 0, 15);
DateTime date2 = new DateTime(2010, 8, 18, 13, 30, 30);
// Calculate the interval between the two dates.
TimeSpan interval = date2 - date1;
Console.WriteLine("{0} - {1} = {2}", date2, date1, interval.ToString());
// Display individual properties of the resulting TimeSpan object.
Console.WriteLine("   {0,-35} {1,20}", "Value of Days Component:", interval.Days);
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Days:", interval.TotalDays);
Console.WriteLine("   {0,-35} {1,20}", "Value of Hours Component:", interval.Hours);
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Hours:", interval.TotalHours);
Console.WriteLine("   {0,-35} {1,20}", "Value of Minutes Component:", interval.Minutes);
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Minutes:", interval.TotalMinutes);
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Seconds Component:", interval.Seconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Seconds:", interval.TotalSeconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Milliseconds Component:", interval.Milliseconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Milliseconds:", interval.TotalMilliseconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Ticks:", interval.Ticks);
// the example displays the following output:
//       8/18/2010 1:30:30 PM - 1/1/2010 8:00:15 AM = 229.05:30:15
//          Value of Days Component:                             229
//          Total Number of Days:                   229.229340277778
//          Value of Hours Component:                              5
//          Total Number of Hours:                  5501.50416666667
//          Value of Minutes Component:                           30
//          Total Number of Minutes:                       330090.25
//          Value of Seconds Component:                           15
//          Total Number of Seconds:                      19,805,415
//          Value of Milliseconds Component:                       0
//          Total Number of Milliseconds:             19,805,415,000
//          Ticks:                               198,054,150,000,000


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft