TimeSpan.Parse Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

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

Surcharges

Parse(String, IFormatProvider)	Convertit la représentation sous forme de chaîne d’un intervalle de temps en son TimeSpan équivalent à l’aide des informations de format spécifiques à la culture spécifiées.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Convertit la représentation d’étendue d’un intervalle de temps en son équivalent TimeSpan en utilisant les informations de format spécifiques à la culture spécifiées.
Parse(String)	Convertit la représentation sous forme de chaîne d’un intervalle de temps en son équivalent TimeSpan.

Parse(String, IFormatProvider)

Source:

TimeSpan.cs

Convertit la représentation sous forme de chaîne d’un intervalle de temps en son TimeSpan équivalent à l’aide des informations de format spécifiques à la culture spécifiées.

C#

public static TimeSpan Parse (string input, IFormatProvider? formatProvider);

Paramètres

input

String

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

formatProvider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

TimeSpan

Intervalle de temps qui correspond à input, tel que spécifié par formatProvider.

Implémente

Parse(String, IFormatProvider)

Exceptions

ArgumentNullException

input est null.

FormatException

input a un format non valide.

OverflowException

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

-ou-

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

Exemples

L’exemple suivant définit un tableau d’objets CultureInfo et utilise chaque objet dans les appels à la méthode Parse(String, IFormatProvider) pour analyser les éléments d’un tableau de chaînes. L’exemple montre comment les conventions d’une culture spécifique influencent l’opération de mise en forme.

C#

using System;
using System.Globalization;
using System.Text.RegularExpressions;

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" };
      CultureInfo[] cultures = { new CultureInfo("en-US"), 
                                 new CultureInfo("ru-RU"),
                                 CultureInfo.InvariantCulture };
      
      string header = String.Format("{0,-17}", "String");
      foreach (CultureInfo culture in cultures)
         header += culture.Equals(CultureInfo.InvariantCulture) ? 
                      String.Format("{0,20}", "Invariant") :
                      String.Format("{0,20}", culture.Name);
      Console.WriteLine(header);
      Console.WriteLine();
      
      foreach (string value in values)
      {
         Console.Write("{0,-17}", value);
         foreach (CultureInfo culture in cultures)
         {
            try {
               TimeSpan ts = TimeSpan.Parse(value, culture);
               Console.Write("{0,20}", ts.ToString("c"));
            }
            catch (FormatException) {
               Console.Write("{0,20}", "Bad Format");
            }   
            catch (OverflowException) {
               Console.Write("{0,20}", "Overflow");
            }      
         }
         Console.WriteLine();                                
      }
   }
}
// The example displays the following output:
//    String                          en-US               ru-RU           Invariant
//    
//    6                          6.00:00:00          6.00:00:00          6.00:00:00
//    6:12                         06:12:00            06:12:00            06:12:00
//    6:12:14                      06:12:14            06: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                 6.12:14:45          6.12:14:45          6.12:14:45
//    6:12:14:45.3448    6.12:14:45.3448000          Bad Format  6.12:14:45.3448000
//    6:12:14:45,3448            Bad Format  6.12:14:45.3448000          Bad Format
//    6:34:14:45                   Overflow            Overflow            Overflow

Remarques

Cette méthode tente d’analyser input à l’aide de chacun des formats propres à la culture pour la culture spécifiée par formatProvider.

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

• Objet CultureInfo qui représente la culture dont les conventions de mise en forme doivent être reflétées dans la chaîne retournée. L’objet DateTimeFormatInfo retourné par la propriété CultureInfo.DateTimeFormat définit la mise en forme de la chaîne retournée.
• Objet DateTimeFormatInfo qui définit la mise en forme de la chaîne retournée.
• Objet personnalisé qui implémente l’interface IFormatProvider. Sa méthode IFormatProvider.GetFormat retourne un objet DateTimeFormatInfo qui fournit des informations de mise en forme.

Si formatProvider est null, l’objet DateTimeFormatInfo associé à la culture actuelle est utilisé.

Pour plus d’informations sur cette API, consultez remarques sur l’API supplémentaire pour System.TimeSpan.Parse.

Parse(ReadOnlySpan<Char>, IFormatProvider)

Source:

TimeSpan.cs

Convertit la représentation d’étendue d’un intervalle de temps en son équivalent TimeSpan en utilisant les informations de format spécifiques à la culture spécifiées.

C#

public static TimeSpan Parse (ReadOnlySpan<char> input, IFormatProvider? formatProvider = default);

Paramètres

input

ReadOnlySpan<Char>

Étendue contenant les caractères qui représentent l’intervalle de temps à convertir.

formatProvider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

TimeSpan

Intervalle de temps qui correspond à input, tel que spécifié par formatProvider.

Implémente

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parse(String)

Source:

TimeSpan.cs

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

C#

public static TimeSpan Parse (string s);

Paramètres

s

String

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

Retours

TimeSpan

Intervalle de temps qui correspond à s.

Exceptions

ArgumentNullException

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

Exemples

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

C#

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

Remarques

Pour plus d’informations sur cette API, consultez remarques d’API supplémentaires pour TimeSpan.Parse.