TimeSpan.ToString メソッド
このインスタンスの値の文字列形式を返します。
名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文
戻り値
このインスタンスの値を表す文字列。戻り値の書式は次のとおりです。 [-][d.]hh:mm:ss[.ff] 角かっこ ("[" および "]") で囲まれている項目は省略可能です。コロンとピリオド (":" および ".") はリテラル文字です。その他の項目は次のとおりです。
解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: mscorlib (mscorlib.dll 内)
構文Dim instance As TimeSpan Dim returnValue As String returnValue = instance.ToString
このインスタンスの値を表す文字列。戻り値の書式は次のとおりです。 [-][d.]hh:mm:ss[.ff] 角かっこ ("[" および "]") で囲まれている項目は省略可能です。コロンとピリオド (":" および ".") はリテラル文字です。その他の項目は次のとおりです。
.gif)
解説使用例ToString メソッドを使用して、TimeSpan オブジェクトから TimeSpan 文字列を作成するコード例を次に示します。
' 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. */
プラットフォームWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- TimeSpan.ToString メソッドのページへのリンク
