TimeSpan.Parse Method

Definition

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Converts the string representation of a time interval to its TimeSpan equivalent.

Overloads

Parse(ReadOnlySpan<Char>, IFormatProvider)	Converts the span representation of a time interval to its TimeSpan equivalent by using the specified culture-specific format information.
Parse(String, IFormatProvider)	Converts the string representation of a time interval to its TimeSpan equivalent by using the specified culture-specific format information.
Parse(String)	Converts the string representation of a time interval to its TimeSpan equivalent.

Parse(ReadOnlySpan<Char>, IFormatProvider)

Source:

TimeSpan.cs

Converts the span representation of a time interval to its TimeSpan equivalent by using the specified culture-specific format information.

C#

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

Parameters

input

ReadOnlySpan<Char>

A span containing the characters that represent the time interval to convert.

formatProvider

IFormatProvider

An object that supplies culture-specific formatting information.

Returns

TimeSpan

A time interval that corresponds to input, as specified by formatProvider.

Implements

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parse(String, IFormatProvider)

Source:

TimeSpan.cs

Converts the string representation of a time interval to its TimeSpan equivalent by using the specified culture-specific format information.

C#

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

Parameters

input

String

A string that specifies the time interval to convert.

formatProvider

IFormatProvider

An object that supplies culture-specific formatting information.

Returns

TimeSpan

A time interval that corresponds to input, as specified by formatProvider.

Implements

Parse(String, IFormatProvider)

Exceptions

ArgumentNullException

input is null.

FormatException

input has an invalid format.

OverflowException

input represents a number that is less than TimeSpan.MinValue or greater than TimeSpan.MaxValue.

-or-

At least one of the days, hours, minutes, or seconds components in input is outside its valid range.

Examples

The following example defines an array of CultureInfo objects, and uses each object in calls to the Parse(String, IFormatProvider) method to parse the elements in a string array. The example illustrates how the conventions of a specific culture influence the formatting operation.

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

Remarks

This method tries to parse input by using each of the culture-specific formats for the culture specified by formatProvider.

The formatProvider parameter is an IFormatProvider implementation that provides culture-specific information about the format of the returned string. The formatProvider parameter can be any of the following:

• A CultureInfo object that represents the culture whose formatting conventions are to be reflected in the returned string. The DateTimeFormatInfo object returned by the CultureInfo.DateTimeFormat property defines the formatting of the returned string.
• A DateTimeFormatInfo object that defines the formatting of the returned string.
• A custom object that implements the IFormatProvider interface. Its IFormatProvider.GetFormat method returns a DateTimeFormatInfo object that provides formatting information.

If formatProvider is null, the DateTimeFormatInfo object that is associated with the current culture is used.

For more information about this API, see Supplemental API remarks for System.TimeSpan.Parse.

Parse(String)

Source:

TimeSpan.cs

Converts the string representation of a time interval to its TimeSpan equivalent.

C#

public static TimeSpan Parse(string s);

Parameters

s

String

A string that specifies the time interval to convert.

Returns

TimeSpan

A time interval that corresponds to s.

Exceptions

ArgumentNullException

s is null.

FormatException

s has an invalid format.

OverflowException

s represents a number that is less than TimeSpan.MinValue or greater than TimeSpan.MaxValue.

-or-

At least one of the days, hours, minutes, or seconds components is outside its valid range.

Examples

The following example uses the Parse method to convert each element in a string array to a TimeSpan value. It changes the current system culture to Croatian - Croatia ("hr-HR") and English - United States ("en-US") to illustrate how the current system culture affects the parsing operation.

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

Remarks

For more information about this API, see Supplemental API remarks for TimeSpan.Parse.