エクスポート (0) 印刷
すべて展開

TimeSpan.ToString メソッド

更新 : 2008 年 7 月

このインスタンスの値の文字列形式を返します。

名前空間 :  System
アセンブリ :  mscorlib (mscorlib.dll 内)

public override string ToString()
public String ToString()
public override function ToString() : String

戻り値

型 : System.String
このインスタンスの値を表す文字列。戻り値の書式は次のとおりです。
[-][d.]hh:mm:ss[.fffffff]
返される文字列には、角かっこ ([ および ]) で囲まれている要素が含まれないことがあります。コロンとピリオド (: および .) はリテラル文字です。非リテラル要素の一覧を次の表に示します。

項目

説明

"-"

負の時間間隔を示すマイナス記号。正の時間間隔には、符号は含まれません。

"d"

時間間隔の日数。時間間隔が 1 日未満の場合、この要素は省略されます。

"hh"

時間間隔の時間数 (0 ~ 23)。

"mm"

時間間隔の分数 (0 ~ 59)。

"ss"

時間間隔の秒数 (0 ~ 59)。

"fffffff"

時間間隔の秒の端数。時間間隔に秒の端数が含まれない場合、この要素は省略されます。含まれる場合、秒の端数は常に小数点以下 7 桁で表されます。

1ecy8h51.alert_note(ja-jp,VS.90).gifメモ :

TimeSpan の文字列形式と Oracle データ型を比較する方法の詳細については、http://support.microsoft.com にある Microsoft サポート技術情報の文書 Q324577 (「System.TimeSpan Does Not Match Oracle 9i INTERVAL DAY TO SECOND Data Type」) を参照してください。

このメソッドの戻り値は、Parse で使用できます。

書式指定子を持っており、返される文字列が厳密に制御されるオーバーロードは、ToString メソッドに含まれないことに注意してください。返される文字列の書式を厳密に定義する場合は、次の例に示すように TimeSpan オブジェクトの個々のプロパティ値を書式設定できます。詳細については、「数値書式指定文字列」を参照してください。

using System;

public class ToString
{
   public static void Main()
   {
      TimeSpan span;

      // Initialize a time span to zero.
      span = TimeSpan.Zero;
      Console.WriteLine(FormatTimeSpan(span, true));

      // Initialize a time span to 14 days.
      span = new TimeSpan(-14, 0, 0, 0, 0);
      Console.WriteLine(FormatTimeSpan(span, true));

      // Initialize a time span to 1:02:03.
      span = new TimeSpan(1, 2, 3);
      Console.WriteLine(FormatTimeSpan(span, false));


      // Initialize a time span to 250 milliseconds.
      span = new TimeSpan(0, 0, 0, 0, 250);
      Console.WriteLine(FormatTimeSpan(span, true));

      // Initalize a time span to 99 days, 23 hours, 59 minutes, and 59.9999999 seconds.
      span = new TimeSpan(99, 23, 59, 59, 999);
      Console.WriteLine(FormatTimeSpan(span, false));

      // Initalize a timespan to 25 milliseconds.
      span = new TimeSpan(0, 0, 0, 0, 25);
      Console.WriteLine(FormatTimeSpan(span, false));
   }

   private static string FormatTimeSpan(TimeSpan span, bool showSign)
   {
      string sign = String.Empty;
      if (showSign && (span > TimeSpan.Zero)) 
         sign = "+";  

      return sign + span.Days.ToString("00") + "." + 
             span.Hours.ToString("00") + ":" + 
             span.Minutes.ToString("00") + ":" + 
             span.Seconds.ToString("00") + "." + 
             span.Milliseconds.ToString("000");
   }
}
// This example displays the following output:
//       00.00:00:00.000
//       -14.00:00:00.000
//       00.01:02:03.000
//       +00.00:00:00.250
//       99.23:59:59.999
//       00.00:00:00.025


TimeSpan 値の数値を使用して ToString メソッドを呼び出し、返される文字列を表示する例を次に示します。

Module ToString
   Public Sub Main()
      Dim span As TimeSpan

      ' Initialize a time span to zero.
      span = TimeSpan.Zero
      Console.WriteLine(FormatTimeSpan(span, True))

      ' Initialize a time span to 14 days.
      span = New TimeSpan(-14, 0, 0, 0, 0)
      Console.WriteLine(FormatTimeSpan(span, True))

      ' Initialize a time span to 1:02:03.
      span = New TimeSpan(1, 2, 3)
      Console.WriteLine(FormatTimeSpan(span, False))


      ' Initialize a time span to 250 milliseconds.
      span = New TimeSpan(0, 0, 0, 0, 250)
      Console.WriteLine(FormatTimeSpan(span, True))

      ' Initalize a time span to 99 days, 23 hours, 59 minutes, and 59.9999999 seconds.
      span = New TimeSpan(99, 23, 59, 59, 999)
      Console.WriteLine(FormatTimeSpan(span, False))

      ' Initalize a timespan to 25 milliseconds.
      span = New TimeSpan(0, 0, 0, 0, 25)
      Console.WriteLine(FormatTimeSpan(span, False))
   End Sub

   Private Function FormatTimeSpan(span As TimeSpan, showSign As Boolean) As String
      Dim sign As String = String.Empty
      If showSign And (span > TimeSpan.Zero) Then sign = "+"  

      Return sign & span.Days.ToString("00") & "." & _
             span.Hours.ToString("00") & ":" & _
             span.Minutes.ToString("00") & ":" & _
             span.Seconds.ToString("00") & "." & _
             span.Milliseconds.ToString("000")
   End Function
End Module
' The example displays the following output:
'       00.00:00:00.000
'       -14.00:00:00.000
'       00.01:02:03.000
'       +00.00:00:00.250
'       99.23:59:59.999
'       00.00:00:00.025


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


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

.NET Framework

サポート対象 : 3.5、3.0、2.0、1.1、1.0

.NET Compact Framework

サポート対象 : 3.5、2.0、1.0

XNA Framework

サポート対象 : 2.0、1.0

参照

[M:System.TimeSpan.Parse(System.String) | M:System.TimeSpan.TryParse(System.String,System.TimeSpan@)]

日付

履歴

理由

2008 年 7 月

返される文字列の書式の説明を変更し、例を追加。

カスタマ フィードバック

コミュニティの追加

追加
表示:
© 2014 Microsoft