Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

TimeSpan.Parse méthode (String)

 

Date de publication : novembre 2016

Convertit la représentation sous forme de chaîne d'un intervalle de temps en TimeSpan équivalent.

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

public static TimeSpan Parse(
	string s
)

Paramètres

s
Type: System.String

Chaîne qui spécifie l'intervalle de temps à convertir.

Valeur de retour

Type: System.TimeSpan

Intervalle de temps qui correspond à s.

Exception Condition
ArgumentNullException

s a la valeur null.

FormatException

s a un format non valide.

OverflowException

s représente un nombre inférieur à TimeSpan.MinValue ou supérieur à TimeSpan.MaxValue.

ou

Au moins un des composants des jours, heures, minutes ou secondes est en dehors de sa plage valide.

Le s paramètre contient une spécification d’intervalle de temps sous la forme :

[ws][-]{ d | [d.] hh:mm[:ss[. ff]] }[ws]

Les éléments entre crochets ([ et ]) sont facultatifs. Une sélection dans la liste d’alternatives entourés accolades ({et}) et séparés par des barres verticales (|) est requis. Le tableau suivant décrit chaque élément.

Élément

Description

ws

Espace blanc facultatif.

-

Un signe moins facultatif, qui indique une valeur négative TimeSpan.

d

Jours, allant de 0 à 10675199.

.

Symbole dépendante de la culture qui sépare les jours des heures. Le format invariant utilise un point («. ») .

hh

Heures, allant de 0 à 23.

:

Le symbole de séparateur d’heure dépendant de la culture. Le format invariant utilise un signe deux-points (« : ») caractères.

mm

Minutes, entre 0 et 59.

ss

Facultatif secondes, entre 0 et 59.

.

Symbole dépendante de la culture qui sépare les secondes des fractions de seconde. Le format invariant utilise un point («. ») .

ff

Facultatif en fractions de seconde, constitué de chiffres décimaux d’un à sept.

Les composants de s doivent collectivement spécifier un intervalle de temps qui est supérieur ou égal à TimeSpan.MinValue et inférieure ou égale à TimeSpan.MaxValue.

Le Parse(String) méthode essaie d’analyser s à l’aide de chacun des formats spécifiques à la culture pour la culture actuelle.

Remarques à l’attention des appelants :

Lorsqu’un composant d’intervalle de temps dans la chaîne à analyser contient plus de sept chiffres, l’opération d’analyse dans le .NET Framework 3.5 et les versions antérieures peuvent se comporter différemment des opérations d’analyse dans le .NET Framework 4. Dans certains cas, opérations d’analyse qui réussissent dans le .NET Framework 3.5 et les versions antérieures peuvent échouer et lever une OverflowException dans le .NET Framework 4. Dans d’autres cas, opérations d’analyse qui lèvent une FormatException dans les .NET Framework 3.5 et les versions antérieures peuvent échouer et lever une OverflowException dans le .NET Framework 4. L’exemple suivant illustre les deux scénarios.

string[] values = { "000000006", "12.12:12:12.12345678" };
foreach (string value in values)
{
   try {
      TimeSpan interval = TimeSpan.Parse(value);
      Console.WriteLine("{0} --> {1}", value, interval);
   }   
   catch (FormatException) {
      Console.WriteLine("{0}: Bad Format", value);
   }   
   catch (OverflowException) {
      Console.WriteLine("{0}: Overflow", value);
   }
}
// Output from .NET Framework 3.5 and earlier versions:
//       000000006 --> 6.00:00:00
//       12.12:12:12.12345678: Bad Format      
// Output from .NET Framework 4:
//       000000006: Overflow
//       12.12:12:12.12345678: Overflow

L’exemple suivant utilise le Parse méthode pour convertir chaque élément dans un tableau de chaînes à un TimeSpan valeur. Il modifie la culture système actuelle croate - Croatie (« hr-HR ») et anglais - États-Unis (« en-US ») pour montrer comment la culture système actuelle affecte l’opération d’analyse.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      string[] values = { "6", "6:12", "6:12:14", "6:12:14:45", 
                          "6.12:14:45", "6:12:14:45.3448", 
                          "6:12:14:45,3448", "6:34:14:45" };
      string[] cultureNames = { "hr-HR", "en-US"};

      // Change the current culture.
      foreach (string cultureName in cultureNames)
      {
         Thread.CurrentThread.CurrentCulture = new CultureInfo(cultureName);
         Console.WriteLine("Current Culture: {0}", 
                           Thread.CurrentThread.CurrentCulture.Name);
         foreach (string value in values)
         {
            try {
               TimeSpan ts = TimeSpan.Parse(value);
               Console.WriteLine("{0} --> {1}", value, ts.ToString("c"));
            }
            catch (FormatException) {
               Console.WriteLine("{0}: Bad Format", value);
            }   
            catch (OverflowException) {
               Console.WriteLine("{0}: Overflow", value);
            }
         } 
         Console.WriteLine();                                
      }
   }
}
// The example displays the following output:
//    Current Culture: hr-HR
//    6 --> 6.00:00:00
//    6:12 --> 06:12:00
//    6:12:14 --> 06:12:14
//    6:12:14:45 --> 6.12:14:45
//    6.12:14:45 --> 6.12:14:45
//    6:12:14:45.3448: Bad Format
//    6:12:14:45,3448 --> 6.12:14:45.3448000
//    6:34:14:45: Overflow
//    
//    Current Culture: en-US
//    6 --> 6.00:00:00
//    6:12 --> 06:12:00
//    6:12:14 --> 06:12:14
//    6:12:14:45 --> 6.12:14:45
//    6.12:14:45 --> 6.12:14:45
//    6:12:14:45.3448 --> 6.12:14:45.3448000
//    6:12:14:45,3448: Bad Format
//    6:34:14:45: Overflow

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: