TimeSpan.ToString-Methode
Gibt die Zeichenfolgendarstellung des Werts dieser Instanz zurück.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Overrides Function ToString As String
'Usage
Dim instance As TimeSpan
Dim returnValue As String
returnValue = instance.ToString
public override string ToString ()
public:
virtual String^ ToString () override
public String ToString ()
public override function ToString () : String
Rückgabewert
Eine Zeichenfolge, die den Wert dieser Instanz darstellt. Der Rückgabewert weist folgende Form auf: [-][t.]hh:mm:ss[.bb] Elemente in eckigen Klammern ("[" und "]") sind optional. Doppelpunkte und Punkte (":" und ".") sind Literalzeichen. Die anderen Elemente lauten wie folgt:
Element |
Beschreibung |
|---|---|
"-" |
optionales Minuszeichen, das eine negative Zeit angibt |
"T" |
Tage (optional) |
"hh" |
Stunden, Werte zwischen 0 und 23 |
"mm" |
Minuten, Werte zwischen 0 und 59 |
"ss" |
Sekunden, Werte zwischen 0 und 59 |
"bb" |
Bruchteile von Sekunden, 1 bis 7 Dezimalstellen (optional) |
Hinweis
Weitere Informationen über das Vergleichen der Zeichenfolgendarstellung von TimeSpan und Oracle-Datentypen finden Sie in der Microsoft Knowledge Base unter http://support.microsoft. im Artikel Q324577, "System.TimeSpan Does Not Match Oracle 9i INTERVAL DAY TO SECOND Data Type".
Hinweise
Der Rückgabewert dieser Methode kann von Parse verwendet werden.
Beispiel
Im folgenden Codebeispiel werden aus TimeSpan-Objekten mithilfe der ToString-Methode TimeSpan-Zeichenfolgen erstellt.
' Example of the TimeSpan.Parse( String ) and TimeSpan.ToString( )
' methods.
Imports System
Imports Microsoft.VisualBasic
Module TSParseToStringDemo
Sub ParseNDisplayTimeSpan( intervalStr As String )
' Write the first part of the output line.
Console.Write( "{0,20} ", intervalStr )
' Parse the parameter, and then convert it back to a string.
Try
Dim intervalVal As TimeSpan = TimeSpan.Parse( intervalStr )
Dim intervalToStr As String = intervalVal.ToString( )
' Pad the end of the TimeSpan string with spaces if it
' does not contain milliseconds.
Dim pIndex As Integer = intervalToStr.IndexOf( ":"c )
pIndex = intervalToStr.IndexOf( "."c, pIndex )
If pIndex < 0 Then intervalToStr &= " "
Console.WriteLine( "{0,21}", intervalToStr )
' If Parse throws an exception, write the message.
Catch ex As Exception
Console.WriteLine( ex.Message )
End Try
End Sub
Sub Main( )
Console.WriteLine( _
"This example of TimeSpan.Parse( String ) and " & _
vbCrLf & "TimeSpan.ToString( ) " & _
"generates the following output." & vbCrLf )
Console.WriteLine( "{0,20} {1,21}", _
"String to Parse", "TimeSpan or Exception" )
Console.WriteLine( "{0,20} {1,21}", _
"---------------", "---------------------" )
ParseNDisplayTimeSpan( "0" )
ParseNDisplayTimeSpan( "14" )
ParseNDisplayTimeSpan( "1:2:3" )
ParseNDisplayTimeSpan( "0:0:0.250" )
ParseNDisplayTimeSpan( "10.20:30:40.50" )
ParseNDisplayTimeSpan( "99.23:59:59.9999999" )
ParseNDisplayTimeSpan( "0023:0059:0059.0099" )
ParseNDisplayTimeSpan( "24:0:0" )
ParseNDisplayTimeSpan( "0:60:0" )
ParseNDisplayTimeSpan( "0:0:60" )
ParseNDisplayTimeSpan( "10:" )
ParseNDisplayTimeSpan( ":10" )
ParseNDisplayTimeSpan( "10:20:" )
ParseNDisplayTimeSpan( ".123" )
ParseNDisplayTimeSpan( "10." )
ParseNDisplayTimeSpan( "10.12" )
End Sub
End Module
' This example of TimeSpan.Parse( String ) and
' TimeSpan.ToString( ) generates the following output.
'
' String to Parse TimeSpan or Exception
' --------------- ---------------------
' 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
' 24:0:0 TimeSpan overflowed because the duration is too long.
' 0:60:0 TimeSpan overflowed because the duration is too long.
' 0:0:60 TimeSpan overflowed because the duration is too long.
' 10: Input string was not in a correct format.
' :10 Input string was not in a correct format.
' 10:20: Input string was not in a correct format.
' .123 Input string was not in a correct format.
' 10. Input string was not in a correct format.
' 10.12 Input string was not in a correct format.
// Example of the TimeSpan.Parse( string ) and TimeSpan.ToString( )
// methods.
using System;
class TSParseToStringDemo
{
static void ParseNDisplayTimeSpan( 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.
try
{
TimeSpan intervalVal = TimeSpan.Parse( intervalStr );
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 );
}
catch( Exception ex )
{
// If Parse throws an exception, write the message.
Console.WriteLine( ex.Message );
}
}
static void Main( )
{
Console.WriteLine(
"This example of TimeSpan.Parse( string ) and \n" +
"TimeSpan.ToString( ) " +
"generates the following output.\n" );
Console.WriteLine( "{0,20} {1,21}",
"String to Parse", "TimeSpan or Exception" );
Console.WriteLine( "{0,20} {1,21}",
"---------------", "---------------------" );
ParseNDisplayTimeSpan( "0" );
ParseNDisplayTimeSpan( "14" );
ParseNDisplayTimeSpan( "1:2:3" );
ParseNDisplayTimeSpan( "0:0:0.250" );
ParseNDisplayTimeSpan( "10.20:30:40.50" );
ParseNDisplayTimeSpan( "99.23:59:59.9999999" );
ParseNDisplayTimeSpan( "0023:0059:0059.0099" );
ParseNDisplayTimeSpan( "24:0:0" );
ParseNDisplayTimeSpan( "0:60:0" );
ParseNDisplayTimeSpan( "0:0:60" );
ParseNDisplayTimeSpan( "10:" );
ParseNDisplayTimeSpan( ":10" );
ParseNDisplayTimeSpan( "10:20:" );
ParseNDisplayTimeSpan( ".123" );
ParseNDisplayTimeSpan( "10." );
ParseNDisplayTimeSpan( "10.12" );
}
}
/*
This example of TimeSpan.Parse( string ) and
TimeSpan.ToString( ) generates the following output.
String to Parse TimeSpan or Exception
--------------- ---------------------
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
24:0:0 TimeSpan overflowed because the duration is too long.
0:60:0 TimeSpan overflowed because the duration is too long.
0:0:60 TimeSpan overflowed because the duration is too long.
10: Input string was not in a correct format.
:10 Input string was not in a correct format.
10:20: Input string was not in a correct format.
.123 Input string was not in a correct format.
10. Input string was not in a correct format.
10.12 Input string was not in a correct format.
*/
// Example of the TimeSpan::Parse( String* ) and TimeSpan::ToString( )
// methods.
using namespace System;
void ParseNDisplayTimeSpan( 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.
try
{
TimeSpan intervalVal = TimeSpan::Parse( intervalStr );
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 = String::Concat( intervalToStr, " " );
Console::WriteLine( "{0,21}", intervalToStr );
}
catch ( Exception^ ex )
{
// If Parse throws an exception, write the message.
Console::WriteLine( ex->Message );
}
}
int main()
{
Console::WriteLine( "This example of TimeSpan::Parse( String* ) and \n"
"TimeSpan::ToString( ) "
"generates the following output.\n" );
Console::WriteLine( "{0,20} {1,21}", "String to Parse", "TimeSpan or Exception" );
Console::WriteLine( "{0,20} {1,21}", "---------------", "---------------------" );
ParseNDisplayTimeSpan( "0" );
ParseNDisplayTimeSpan( "14" );
ParseNDisplayTimeSpan( "1:2:3" );
ParseNDisplayTimeSpan( "0:0:0.250" );
ParseNDisplayTimeSpan( "10.20:30:40.50" );
ParseNDisplayTimeSpan( "99.23:59:59.9999999" );
ParseNDisplayTimeSpan( "0023:0059:0059.0099" );
ParseNDisplayTimeSpan( "24:0:0" );
ParseNDisplayTimeSpan( "0:60:0" );
ParseNDisplayTimeSpan( "0:0:60" );
ParseNDisplayTimeSpan( "10:" );
ParseNDisplayTimeSpan( ":10" );
ParseNDisplayTimeSpan( "10:20:" );
ParseNDisplayTimeSpan( ".123" );
ParseNDisplayTimeSpan( "10." );
ParseNDisplayTimeSpan( "10.12" );
}
/*
This example of TimeSpan::Parse( String* ) and
TimeSpan::ToString( ) generates the following output.
String to Parse TimeSpan or Exception
--------------- ---------------------
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
24:0:0 TimeSpan overflowed because the duration is too long.
0:60:0 TimeSpan overflowed because the duration is too long.
0:0:60 TimeSpan overflowed because the duration is too long.
10: Input string was not in a correct format.
:10 Input string was not in a correct format.
10:20: Input string was not in a correct format.
.123 Input string was not in a correct format.
10. Input string was not in a correct format.
10.12 Input string was not in a correct format.
*/
// Example of the TimeSpan.Parse( string ) and TimeSpan.ToString( )
// methods.
import System.*;
class TSParseToStringDemo
{
static void ParseNDisplayTimeSpan(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.
try {
TimeSpan intervalVal = TimeSpan.Parse(intervalStr);
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);
}
catch (System.Exception ex) {
// If Parse throws an exception, write the message.
Console.WriteLine(ex.get_Message());
}
} //ParseNDisplayTimeSpan
public static void main(String[] args)
{
Console.WriteLine(("This example of TimeSpan.Parse( string ) and \n"
+ "TimeSpan.ToString( ) " + "generates the following output.\n"));
Console.WriteLine("{0,20} {1,21}", "String to Parse",
"TimeSpan or Exception");
Console.WriteLine("{0,20} {1,21}", "---------------",
"---------------------");
ParseNDisplayTimeSpan("0");
ParseNDisplayTimeSpan("14");
ParseNDisplayTimeSpan("1:2:3");
ParseNDisplayTimeSpan("0:0:0.250");
ParseNDisplayTimeSpan("10.20:30:40.50");
ParseNDisplayTimeSpan("99.23:59:59.9999999");
ParseNDisplayTimeSpan("0023:0059:0059.0099");
ParseNDisplayTimeSpan("24:0:0");
ParseNDisplayTimeSpan("0:60:0");
ParseNDisplayTimeSpan("0:0:60");
ParseNDisplayTimeSpan("10:");
ParseNDisplayTimeSpan(":10");
ParseNDisplayTimeSpan("10:20:");
ParseNDisplayTimeSpan(".123");
ParseNDisplayTimeSpan("10.");
ParseNDisplayTimeSpan("10.12");
} //main
} //TSParseToStringDemo
/*
This example of TimeSpan.Parse( string ) and
TimeSpan.ToString( ) generates the following output.
String to Parse TimeSpan or Exception
--------------- ---------------------
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
24:0:0 TimeSpan overflowed because the duration is too long.
0:60:0 TimeSpan overflowed because the duration is too long.
0:0:60 TimeSpan overflowed because the duration is too long.
10: Input string was not in a correct format.
:10 Input string was not in a correct format.
10:20: Input string was not in a correct format.
.123 Input string was not in a correct format.
10. Input string was not in a correct format.
10.12 Input string was not in a correct format.
*/
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
TimeSpan-Struktur
TimeSpan-Member
System-Namespace
String-Klasse
Parse