TimeSpan.ToString Method ()
Converts the value of the current TimeSpan object to its equivalent string representation.
Assembly: mscorlib (in mscorlib.dll)
The returned string is formatted with the "c" format specifier and has the following format:
[-][d.]hh:mm:ss[.fffffff]
Elements in square brackets ([ and ]) may not be included in the returned string. Colons and periods (: and.) are literal characters. The non-literal elements are listed in the following table. Note that the string returned by the ToString() method is not culture-sensitive.
Item | Description |
|---|---|
"-" | A minus sign, which indicates a negative time interval. No sign is included for a positive time span. |
"d" | The number of days in the time interval. This element is omitted if the time interval is less than one day. |
"hh" | The number of hours in the time interval, ranging from 0 to 23. |
"mm" | The number of minutes in the time interval, ranging from 0 to 59. |
"ss" | The number of seconds in the time interval, ranging from 0 to 59. |
"fffffff" | Fractional seconds in the time interval. This element is omitted if the time interval does not include fractional seconds. If present, fractional seconds are always expressed using seven decimal digits. |
Note |
|---|
For more information about comparing the string representation of TimeSpan and Oracle data types, see Knowledge Base article 324577: System.TimeSpan Does Not Match Oracle 9i INTERVAL DAY TO SECOND Data Type. |
Notes to Callers:
Support for formatting TimeSpan values was added in the .NET Framework 4. However, the ToString() method overload remains culture-insensitive. Its behavior remains unchanged from previous versions of the .NET Framework. To control the formatting of a TimeSpan value, call the ToString(String) or ToString(String, IFormatProvider) overload.
The following example displays the strings returned by calling the ToString method with a number of TimeSpan values. Note that although the example does not call the ToString method directly, it is called by the Console.WriteLine method when it attempts to convert a TimeSpan value to its string representation.
using System; public class ToString { public static void Main() { TimeSpan span; // Initialize a time span to zero. span = TimeSpan.Zero; Console.WriteLine(span); // Initialize a time span to 14 days. span = new TimeSpan(-14, 0, 0, 0, 0); Console.WriteLine(span); // Initialize a time span to 1:02:03. span = new TimeSpan(1, 2, 3); Console.WriteLine(span); // Initialize a time span to 250 milliseconds. span = new TimeSpan(0, 0, 0, 0, 250); Console.WriteLine(span); // Initalize a time span to 99 days, 23 hours, 59 minutes, and 59.999 seconds. span = new TimeSpan(99, 23, 59, 59, 999); Console.WriteLine(span); // Initalize a time span to 3 hours. span = new TimeSpan(3, 0, 0); Console.WriteLine(span); // Initalize a timespan to 25 milliseconds. span = new TimeSpan(0, 0, 0, 0, 25); Console.WriteLine(span); } } // The example displays the following output: // 00:00:00 // -14.00:00:00 // 01:02:03 // 00:00:00.2500000 // 99.23:59:59.9990000 // 03:00:00 // 00:00:00.0250000
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
