Partager via

Méthodes System.TimeSpan.TryParse

Cet article fournit des remarques supplémentaires à la documentation de référence de cette API.

Méthode TryParse(System.String,System.TimeSpan@)

La TimeSpan.TryParse(String, TimeSpan) méthode est semblable à la TimeSpan.Parse(String) méthode, sauf qu’elle ne lève pas d’exception si la conversion échoue.

Le s paramètre contient une spécification d’intervalle de temps dans le formulaire :

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

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

Élément Descriptif
Ws Espace blanc facultatif.
- Un signe moins facultatif, qui indique que TimeSpan est négatif.
d Jours, allant de 0 à 10675199.
. Symbole sensible à la culture qui sépare les jours des heures. Le format invariant utilise un caractère de point (« . »).
Hh Heures, de 0 à 23.
: Symbole de séparation temporelle adapté à la culture. Le format invariant utilise un caractère deux-points (« : »).
mm Minutes, allant de 0 à 59.
ß Secondes facultatives, allant de 0 à 59.
. Symbole sensible à la culture qui sépare les secondes des fractions d’une seconde. Le format invariant utilise un caractère de point (« . »).
Ff Fractions de seconde facultatives, composées d’un à sept chiffres décimaux.

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

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

méthode TryParse(String, IFormatProvider, TimeSpan)

La TryParse(String, IFormatProvider, TimeSpan) méthode est semblable à la Parse(String, IFormatProvider) méthode, sauf qu’elle ne lève pas d’exception si la conversion échoue.

Le input paramètre contient une spécification d’intervalle de temps dans le formulaire :

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

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

Élément Descriptif
Ws Espace blanc facultatif.
- Un signe moins facultatif, qui indique que TimeSpan est négatif.
d Jours, allant de 0 à 10675199.
. Symbole sensible à la culture qui sépare les jours des heures. Le format invariant utilise un caractère de point (« . »).
Hh Heures, de 0 à 23.
: Symbole de séparation temporelle adapté à la culture. Le format invariant utilise un caractère deux-points (« : »).
mm Minutes, allant de 0 à 59.
ß Secondes facultatives, allant de 0 à 59.
. Symbole sensible à la culture qui sépare les secondes des fractions d’une seconde. Le format invariant utilise un caractère de point (« . »).
Ff Fractions de seconde facultatives, composées d’un à sept chiffres décimaux.

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

La TryParse(String, IFormatProvider, TimeSpan) méthode tente d’analyser input en utilisant chacun des formats spécifiques à la culture pour la culture spécifiée par formatProvider.

Le paramètre formatProvider est une IFormatProvider implémentation qui fournit des informations spécifiques à la culture sur le format de la chaîne retournée. Le formatProvider paramètre peut être l’un des éléments suivants :

Si formatProvidernull est le cas, l’objet DateTimeFormatInfo associé à la culture actuelle est utilisé.

Remarques pour les appelants

Dans certains cas, lorsqu’un composant d’intervalle de temps de la chaîne à analyser contient plus de sept chiffres, les opérations d’analyse qui ont réussi et retourné true dans .NET Framework 3.5 et les versions antérieures peuvent échouer et retourner false dans .NET Framework 4 et versions ultérieures. L’exemple suivant illustre ce scénario :

string value = "000000006";
TimeSpan interval;
if (TimeSpan.TryParse(value, out interval))
   Console.WriteLine($"{value} --> {interval}");
else
   Console.WriteLine($"Unable to parse '{value}'");
   
// Output from .NET Framework 3.5 and earlier versions:
//       000000006 --> 6.00:00:00
// Output from .NET Framework 4:
//       Unable to parse //000000006//

let value = "000000006"
match TimeSpan.TryParse value with
| true, interval ->
    printfn $"{value} --> {interval}"
| _ ->
    printfn $"Unable to parse '{value}'"
    
// Output from .NET Framework 3.5 and earlier versions:
//       000000006 --> 6.00:00:00
// Output from .NET Framework 4:
//       Unable to parse //000000006//

Dim value As String = "000000006"
Dim interval As TimeSpan
If TimeSpan.TryParse(value, interval) Then
   Console.WriteLine("{0} --> {1}", value, interval)
Else
   Console.WriteLine("Unable to parse '{0}'", value)
End If
' Output from .NET Framework 3.5 and earlier versions:
'       000000006 --> 6.00:00:00
' Output from .NET Framework 4:
'       Unable to parse '000000006'
  • Last updated on