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.Parse, méthode (String)

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.

ExceptionCondition
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 « jours », « heures », « minutes » ou « secondes » est en dehors de sa plage valide.

Le paramètre s contient une spécification d'intervalle de temps qui se présente comme suit :

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

Les éléments entre crochets ([ et ]) sont facultatifs. Une sélection dans la liste d'alternatives entre accolades ({et}) et séparées par des barres verticales (|) est requise. Le tableau suivant décrit les différents éléments.

Élément

Description

ws

Espace blanc facultatif.

-

Signe moins facultatif, qui indique un TimeSpannégatif.

d

Jours, de 0 à 10675199.

.

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

hh

Heures, de 0 à 23.

:

Symbole de séparateur d'heure dépendant de la culture. Le format invariant utilise un signe deux-points (":").

mm

Minutes, de 0 à 59.

ss

Secondes (facultatives), de 0 à 59.

.

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

ff

Fractions de seconde facultatives, composées d'un à sept chiffres décimaux.

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

La méthode Parse(String) essaie d'analyser s en utilisant 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, les 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, les opération d'analyse qui réussissent dans .NET Framework 3.5 et les versions antérieures peuvent échouer et lever une OverflowException dans le .NET Framework 4. Dans d'autres cas, les opérations d'analyse qui lèvent une FormatException dans le .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 la méthode Parse pour convertir chaque élément d'un tableau de chaînes en une valeur TimeSpan. Il remplace la culture système actuelle par la culture Croate - Croatie (« hr-HR ») et Anglais - États-Unis (« en-US ») pour illustrer la manière dont 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


.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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft