TimeSpan.TryParse Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Convertit la représentation sous forme de chaîne spécifiée d’un intervalle de temps en son équivalent TimeSpan et retourne une valeur qui indique si la conversion a réussi.

Surcharges

TryParse(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.
TryParse(ReadOnlySpan<Char>, IFormatProvider, TimeSpan)	Convertit la représentation d’étendue d’un intervalle de temps en son équivalent TimeSpan en utilisant les informations de mise en forme spécifiques à la culture spécifiées et retourne une valeur qui indique si la conversion a réussi.
TryParse(ReadOnlySpan<Char>, TimeSpan)	Convertit la représentation de l’étendue d’un intervalle de temps en son équivalent TimeSpan et retourne une valeur qui indique si la conversion a réussi.
TryParse(String, IFormatProvider, TimeSpan)	Convertit la représentation sous forme de chaîne d’un intervalle de temps en son équivalent TimeSpan en utilisant les informations de mise en forme spécifiques à la culture spécifiées et retourne une valeur qui indique si la conversion a réussi.

TryParse(String, TimeSpan)

Source:

TimeSpan.cs

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.

C#

public static bool TryParse(string? s, out TimeSpan result);

Paramètres

s

String

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

result

TimeSpan

Lorsque cette méthode est retournée, contient un objet qui représente l’intervalle de temps spécifié par s, ou Zero si la conversion a échoué. Ce paramètre est passé non initialisé.

Retours

Boolean

true si s a été convertie avec succès ; sinon, false. Cette opération retourne false si le paramètre s est null ou Empty, a un format non valide, représente un intervalle de temps inférieur à TimeSpan.MinValue ou supérieur à TimeSpan.MaxValue, ou a au moins un jour, des heures, des minutes ou des secondes en dehors de sa plage valide.

Exemples

L’exemple suivant utilise la méthode TryParse pour créer des objets TimeSpan à partir de chaînes de TimeSpan valides et pour indiquer quand l’opération d’analyse a échoué, car la chaîne d’intervalle de temps n’est pas valide.

C#

using System;

public class TryParse
{
   private static void ParseTimeSpan(string intervalStr)
   {
      // Write the first part of the output line.
      Console.Write( "{0,20}   ", intervalStr );

      // Parse the parameter, and then convert it back to a string.
      TimeSpan intervalVal; 
      if (TimeSpan.TryParse(intervalStr, out intervalVal)) 
      {
         string intervalToStr = intervalVal.ToString();
  
         // Pad the end of the TimeSpan string with spaces if it 
         // does not contain milliseconds.
         int pIndex = intervalToStr.IndexOf(':');
         pIndex = intervalToStr.IndexOf('.', pIndex);
         if (pIndex < 0)
            intervalToStr += "        ";
   
         Console.WriteLine("{0,21}", intervalToStr);
         // Handle failure of TryParse method.
      }
      else
      {
         Console.WriteLine("Parse operation failed.");
      }
   } 
   
   public static void Main()
   {
        Console.WriteLine( "{0,20}   {1,21}", 
            "String to Parse", "TimeSpan" );    
        Console.WriteLine( "{0,20}   {1,21}", 
            "---------------", "---------------------" );    

        ParseTimeSpan("0");
        ParseTimeSpan("14");
        ParseTimeSpan("1:2:3");
        ParseTimeSpan("0:0:0.250");
        ParseTimeSpan("10.20:30:40.50");
        ParseTimeSpan("99.23:59:59.9999999");
        ParseTimeSpan("0023:0059:0059.0099");
        ParseTimeSpan("23:0:0");
        ParseTimeSpan("24:0:0");
        ParseTimeSpan("0:59:0");
        ParseTimeSpan("0:60:0");
        ParseTimeSpan("0:0:59");
        ParseTimeSpan("0:0:60");
        ParseTimeSpan("10:");
        ParseTimeSpan("10:0");
        ParseTimeSpan(":10");
        ParseTimeSpan("0:10");
        ParseTimeSpan("10:20:");
        ParseTimeSpan("10:20:0");
        ParseTimeSpan(".123");
        ParseTimeSpan("0.12:00");
        ParseTimeSpan("10.");
        ParseTimeSpan("10.12");
        ParseTimeSpan("10.12:00");
   }
}
//            String to Parse                TimeSpan
//            ---------------   ---------------------
//                          0        00:00:00
//                         14     14.00:00:00
//                      1:2:3        01:02:03
//                  0:0:0.250        00:00:00.2500000
//             10.20:30:40.50     10.20:30:40.5000000
//        99.23:59:59.9999999     99.23:59:59.9999999
//        0023:0059:0059.0099        23:59:59.0099000
//                     23:0:0        23:00:00
//                     24:0:0   Parse operation failed.
//                     0:59:0        00:59:00
//                     0:60:0   Parse operation failed.
//                     0:0:59        00:00:59
//                     0:0:60   Parse operation failed.
//                        10:   Parse operation failed.
//                       10:0        10:00:00
//                        :10   Parse operation failed.
//                       0:10        00:10:00
//                     10:20:   Parse operation failed.
//                    10:20:0        10:20:00
//                       .123   Parse operation failed.
//                    0.12:00        12:00:00
//                        10.   Parse operation failed.
//                      10.12   Parse operation failed.
//                   10.12:00     10.12:00:00

Remarques

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

TryParse(ReadOnlySpan<Char>, IFormatProvider, TimeSpan)

Source:

TimeSpan.cs

Convertit la représentation d’étendue d’un intervalle de temps en son équivalent TimeSpan en utilisant les informations de mise en forme spécifiques à la culture spécifiées et retourne une valeur qui indique si la conversion a réussi.

C#

public static bool TryParse(ReadOnlySpan<char> input, IFormatProvider? formatProvider, out TimeSpan result);

Paramètres

input

ReadOnlySpan<Char>

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

formatProvider

IFormatProvider

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

result

TimeSpan

Lorsque cette méthode est retournée, contient un objet qui représente l’intervalle de temps spécifié par input, ou Zero si la conversion a échoué. Ce paramètre est passé non initialisé.

Retours

Boolean

true si input a été convertie avec succès ; sinon, false. Cette opération retourne false si le paramètre input est null ou Empty, a un format non valide, représente un intervalle de temps inférieur à TimeSpan.MinValue ou supérieur à TimeSpan.MaxValue, ou a au moins un jour, des heures, des minutes ou des secondes en dehors de sa plage valide.

TryParse(ReadOnlySpan<Char>, TimeSpan)

Source:

TimeSpan.cs

Convertit la représentation de l’étendue d’un intervalle de temps en son équivalent TimeSpan et retourne une valeur qui indique si la conversion a réussi.

C#

public static bool TryParse(ReadOnlySpan<char> s, out TimeSpan result);

Paramètres

s

ReadOnlySpan<Char>

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

result

TimeSpan

Lorsque cette méthode est retournée, contient un objet qui représente l’intervalle de temps spécifié par s, ou Zero si la conversion a échoué. Ce paramètre est passé non initialisé.

Retours

Boolean

true si s a été convertie avec succès ; sinon, false. Cette opération retourne false si le paramètre s est null ou Empty, a un format non valide, représente un intervalle de temps inférieur à TimeSpan.MinValue ou supérieur à TimeSpan.MaxValue, ou a au moins un jour, des heures, des minutes ou des secondes en dehors de sa plage valide.

TryParse(String, IFormatProvider, TimeSpan)

Source:

TimeSpan.cs

Convertit la représentation sous forme de chaîne d’un intervalle de temps en son équivalent TimeSpan en utilisant les informations de mise en forme spécifiques à la culture spécifiées et retourne une valeur qui indique si la conversion a réussi.

C#

public static bool TryParse(string? input, IFormatProvider? formatProvider, out TimeSpan result);

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.

result

TimeSpan

Lorsque cette méthode est retournée, contient un objet qui représente l’intervalle de temps spécifié par input, ou Zero si la conversion a échoué. Ce paramètre est passé non initialisé.

Retours

Boolean

true si input a été convertie avec succès ; sinon, false. Cette opération retourne false si le paramètre input est null ou Empty, a un format non valide, représente un intervalle de temps inférieur à TimeSpan.MinValue ou supérieur à TimeSpan.MaxValue, ou a au moins un jour, des heures, des minutes ou des secondes 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 TryParse(String, IFormatProvider, TimeSpan) 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;

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)
         {
            TimeSpan interval = new TimeSpan();
            if (TimeSpan.TryParse(value, culture, out interval))
               Console.Write("{0,20}", interval.ToString("c"));
            else
               Console.Write("{0,20}", "Unable to Parse");
         }
         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     Unable to Parse  6.12:14:45.3448000
//    6:12:14:45,3448       Unable to Parse  6.12:14:45.3448000     Unable to Parse
//    6:34:14:45            Unable to Parse     Unable to Parse     Unable to Parse

Remarques

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