TimeSpan.ToString TimeSpan.ToString TimeSpan.ToString TimeSpan.ToString Method

定義

現在の TimeSpan オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current TimeSpan object to its equivalent string representation.

オーバーロード

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

指定した書式とカルチャ固有の書式情報を使用して、現在の TimeSpan オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format and culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

指定した書式を使用して、現在の TimeSpan オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format.

ToString() ToString() ToString() ToString()

現在の TimeSpan オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current TimeSpan object to its equivalent string representation.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

指定した書式とカルチャ固有の書式情報を使用して、現在の TimeSpan オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format and culture-specific formatting information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ formatProvider);
public string ToString (string format, IFormatProvider formatProvider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, formatProvider As IFormatProvider) As String

パラメーター

format
String String String String

標準またはカスタムの TimeSpan 書式指定文字列。A standard or custom TimeSpan format string.

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

カルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information.

戻り値

format および formatProvider の指定に従って表現された、現在の TimeSpan 値の文字列形式。The string representation of the current TimeSpan value, as specified by format and formatProvider.

実装

例外

format パラメーターは、認識できないか、サポートされていません。The format parameter is not recognized or is not supported.

次の例ではToString(String, IFormatProvider) 、メソッドを呼び出して、2つの時間間隔を書式設定しています。The following example calls the ToString(String, IFormatProvider) method to format two time intervals. この例では、書式指定文字列ごとにメソッドを2回呼び出します。最初に、en-us カルチャの規則を使用してそれを表示し、次に fr-fr カルチャの規則を使用して表示します。The example calls the method twice for each format string, first to display it using the conventions of the en-US culture and then to display it using the conventions of the fr-FR culture.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      TimeSpan[] intervals = { new TimeSpan(38, 30, 15), 
                               new TimeSpan(16, 14, 30) }; 
      CultureInfo[] cultures = { new CultureInfo("en-US"), 
                                 new CultureInfo("fr-FR") };
      string[] formats = {"c", "g", "G", @"hh\:mm\:ss" };
      Console.WriteLine("{0,12}      Format  {1,22}  {2,22}\n", 
                        "Interval", cultures[0].Name, cultures[1].Name);

      foreach (var interval in intervals) {
         foreach (var fmt in formats)
            Console.WriteLine("{0,12}  {1,10}  {2,22}  {3,22}", 
                              interval, fmt, 
                              interval.ToString(fmt, cultures[0]), 
                              interval.ToString(fmt, cultures[1]));
         Console.WriteLine();
      }  
   }
}
// The example displays the following output:
//        Interval      Format                   en-US                   fr-FR
//    
//      1.14:30:15           c              1.14:30:15              1.14:30:15
//      1.14:30:15           g              1:14:30:15              1:14:30:15
//      1.14:30:15           G      1:14:30:15.0000000      1:14:30:15,0000000
//      1.14:30:15  hh\:mm\:ss                14:30:15                14:30:15
//    
//        16:14:30           c                16:14:30                16:14:30
//        16:14:30           g                16:14:30                16:14:30
//        16:14:30           G      0:16:14:30.0000000      0:16:14:30,0000000
//        16:14:30  hh\:mm\:ss                16:14:30                16:14:30
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim intervals() As TimeSpan = { New TimeSpan(38, 30, 15), 
                                      New TimeSpan(16, 14, 30) } 
      Dim cultures() As CultureInfo = { New CultureInfo("en-US"), 
                                        New CultureInfo("fr-FR") }
      Dim formats() As String = {"c", "g", "G", "hh\:mm\:ss" }
      Console.WriteLine("{0,12}      Format  {1,22}  {2,22}", 
                        "Interval", cultures(0).Name, cultures(1).Name)
      Console.WriteLine()
      For Each interval In intervals
         For Each fmt In formats
            Console.WriteLine("{0,12}  {1,10}  {2,22}  {3,22}", 
                              interval, fmt, 
                              interval.ToString(fmt, cultures(0)), 
                              interval.ToString(fmt, cultures(1)))
         Next
         Console.WriteLine()
      Next                                                                                                                                            
   End Sub
End Module
' The example displays the following output:
'        Interval      Format                   en-US                   fr-FR
'    
'      1.14:30:15           c              1.14:30:15              1.14:30:15
'      1.14:30:15           g              1:14:30:15              1:14:30:15
'      1.14:30:15           G      1:14:30:15.0000000      1:14:30:15,0000000
'      1.14:30:15  hh\:mm\:ss                14:30:15                14:30:15
'    
'        16:14:30           c                16:14:30                16:14:30
'        16:14:30           g                16:14:30                16:14:30
'        16:14:30           G      0:16:14:30.0000000      0:16:14:30,0000000
'        16:14:30  hh\:mm\:ss                16:14:30                16:14:30

注釈

パラメーター formatには、値の有効な標準またはカスタムTimeSpanの書式指定子を指定できます。The format parameter can be any valid standard or custom format specifier for TimeSpan values. format String.EmptyまたはにTimeSpan等しい場合、現在のオブジェクトの戻り値は共通書式指定子 ("c") で書式設定されます。 nullIf format is equal to String.Empty or is null, the return value of the current TimeSpan object is formatted with the common format specifier ("c"). Format が他の値の場合、メソッドはをFormatExceptionスローします。If format is any other value, the method throws a FormatException.

重要

値のTimeSpanカスタム書式指定文字列には、日付または時刻の区切り記号は含まれません。The custom format strings for TimeSpan values do not include a date or time separator. これらの要素を書式指定文字列に含める場合は、それらを文字リテラルとして扱う必要があります。If you want to include these elements in your format string, you must treat them as character literals. 図の例を参照してください。詳細については、「カスタム TimeSpan 書式指定文字列」を参照してください。See the example for an illustration, and see the Custom TimeSpan Format Strings topic for more information.

.NET Framework では、さまざまな書式設定がサポートされています。詳細については、次の書式設定に関するトピックを参照してください。The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

パラメーターは、返される文字列の書式に関するカルチャ固有の情報を提供する実装です。IFormatProvider formatProviderThe formatProvider parameter is an IFormatProvider implementation that provides culture-specific information about the format of the returned string. パラメーター formatProviderには、次のいずれかを指定できます。The formatProvider parameter can be any of the following:

formatProvider DateTimeFormatInfoの場合は、現在のカルチャに関連付けられているオブジェクトが使用されます。 nullIf formatProvider is null, the DateTimeFormatInfo object that is associated with the current culture is used. formatカスタム書式指定文字列の場合formatProvider 、パラメーターは無視されます。If format is a custom format string, the formatProvider parameter is ignored.

こちらもご覧ください

ToString(String) ToString(String) ToString(String) ToString(String)

指定した書式を使用して、現在の TimeSpan オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

パラメーター

format
String String String String

標準またはカスタムの TimeSpan 書式指定文字列。A standard or custom TimeSpan format string.

戻り値

現在の TimeSpan 値の文字列形式を、format パラメーターで指定されている形式で表現した値。The string representation of the current TimeSpan value in the format specified by the format parameter.

例外

format パラメーターは、認識できないか、サポートされていません。The format parameter is not recognized or is not supported.

次の例では、標準TimeSpanの書式指定文字列とカスタム書式指定文字列を使用して、 TimeSpan値の配列内の各要素の文字列形式を表示します。The following example uses standard and custom TimeSpan format strings to display the string representation of each element in an array of TimeSpan values

TimeSpan[] spans = { 
   TimeSpan.Zero, 
   new TimeSpan(-14, 0, 0, 0, 0), 
   new TimeSpan(1, 2, 3), 
   new TimeSpan(0, 0, 0, 0, 250), 
   new TimeSpan(99, 23, 59, 59, 999),
   new TimeSpan(3, 0, 0), 
   new TimeSpan(0, 0, 0, 0, 25) 
};

string[] fmts = { "c", "g", "G", @"hh\:mm\:ss", "%m' min.'" };
foreach (TimeSpan span in spans)
{
   foreach (string fmt in fmts)
      Console.WriteLine("{0}: {1}", fmt, span.ToString(fmt));

   Console.WriteLine();
}
// The example displays the following output:
//       c: 00:00:00
//       g: 0:00:00
//       G: 0:00:00:00.0000000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: -14.00:00:00
//       g: -14:0:00:00
//       G: -14:00:00:00.0000000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: 01:02:03
//       g: 1:02:03
//       G: 0:01:02:03.0000000
//       hh\:mm\:ss: 01:02:03
//       %m' min.': 2 min.
//       
//       c: 00:00:00.2500000
//       g: 0:00:00.25
//       G: 0:00:00:00.2500000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: 99.23:59:59.9990000
//       g: 99:23:59:59.999
//       G: 99:23:59:59.9990000
//       hh\:mm\:ss: 23:59:59
//       %m' min.': 59 min.
//       
//       c: 03:00:00
//       g: 3:00:00
//       G: 0:03:00:00.0000000
//       hh\:mm\:ss: 03:00:00
//       %m' min.': 0 min.
//       
//       c: 00:00:00.0250000
//       g: 0:00:00.025
//       G: 0:00:00:00.0250000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
Module Example
   Public Sub Main()
      Dim spans() As TimeSpan = { TimeSpan.Zero, New TimeSpan(-14, 0, 0, 0, 0), 
                                  New TimeSpan(1, 2, 3), 
                                  New TimeSpan(0, 0, 0, 0, 250), 
                                  New TimeSpan(99, 23, 59, 59, 999),
                                  New TimeSpan(3, 0, 0), 
                                  New TimeSpan(0, 0, 0, 0, 25) }
      Dim fmts() As String = { "c", "g", "G", "hh\:mm\:ss", "%m' min.'" }
      For Each span As TimeSpan In spans
         For Each fmt As String In fmts
            Console.WriteLine("{0}: {1}", fmt, span.ToString(fmt))
         Next
         Console.WriteLine()         
      Next
   End Sub
End Module
' The example displays the following output:
'       c: 00:00:00
'       g: 0:00:00
'       G: 0:00:00:00.0000000
'       hh\:mm\:ss: 00:00:00
'       %m' min.': 0 min.
'       
'       c: -14.00:00:00
'       g: -14:0:00:00
'       G: -14:00:00:00.0000000
'       hh\:mm\:ss: 00:00:00
'       %m' min.': 0 min.
'       
'       c: 01:02:03
'       g: 1:02:03
'       G: 0:01:02:03.0000000
'       hh\:mm\:ss: 01:02:03
'       %m' min.': 2 min.
'       
'       c: 00:00:00.2500000
'       g: 0:00:00.25
'       G: 0:00:00:00.2500000
'       hh\:mm\:ss: 00:00:00
'       %m' min.': 0 min.
'       
'       c: 99.23:59:59.9990000
'       g: 99:23:59:59.999
'       G: 99:23:59:59.9990000
'       hh\:mm\:ss: 23:59:59
'       %m' min.': 59 min.
'       
'       c: 03:00:00
'       g: 3:00:00
'       G: 0:03:00:00.0000000
'       hh\:mm\:ss: 03:00:00
'       %m' min.': 0 min.
'       
'       c: 00:00:00.0250000
'       g: 0:00:00.025
'       G: 0:00:00:00.0250000
'       hh\:mm\:ss: 00:00:00
'       %m' min.': 0 min.

注釈

パラメーター formatには、値の有効な標準またはカスタムTimeSpanの書式指定子を指定できます。The format parameter can be any valid standard or custom format specifier for TimeSpan values. format String.EmptyまたはにTimeSpan等しい場合、現在のオブジェクトの戻り値は共通書式指定子 ("c") で書式設定されます。 nullIf format is equal to String.Empty or is null, the return value of the current TimeSpan object is formatted with the common format specifier ("c"). formatその他の値の場合、メソッドはFormatExceptionをスローします。If format is any other value, the method throws a FormatException.

format標準書式指定文字列の場合、返される文字列の形式は、現在のカルチャの書式指定規則によって定義されます。If format is a standard format string, the format of the returned string is defined by the formatting conventions of the current culture.

重要

値のTimeSpanカスタム書式指定文字列には、日付または時刻の区切り記号は含まれません。The custom format strings for TimeSpan values do not include a date or time separator. これらの要素を書式指定文字列に含める場合は、それらを文字リテラルとして扱う必要があります。If you want to include these elements in your format string, you must treat them as character literals. 図の例を参照してください。詳細については、「カスタム TimeSpan 書式指定文字列」を参照してください。See the example for an illustration, and see the Custom TimeSpan Format Strings topic for more information.

.NET Framework では、さまざまな書式設定がサポートされています。詳細については、次の書式設定に関するトピックを参照してください。The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

こちらもご覧ください

ToString() ToString() ToString() ToString()

現在の TimeSpan オブジェクトの値を等価の文字列形式に変換します。Converts the value of the current TimeSpan object to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

戻り値

現在の TimeSpan 値の文字列形式。The string representation of the current TimeSpan value.

次の例では、複数のToString TimeSpan値を指定してメソッドを呼び出すことによって返される文字列を表示します。The following example displays the strings returned by calling the ToString method with a number of TimeSpan values. この例ではToStringメソッドを直接呼び出すことはできませんが、値をConsole.WriteLine TimeSpan文字列形式に変換しようとすると、メソッドによって呼び出されます。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.

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
Module ToString
   Public Sub Main()
      Dim span As TimeSpan
      
      ' 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.9999999 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)
   End Sub
End Module
' 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

注釈

返される文字列は、"c" 書式指定子を使用して書式設定され、次の形式になります。The returned string is formatted with the "c" format specifier and has the following format:

[-][d.]hh:mm:ss[.fffffff][-][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. ToString()メソッドによって返される文字列は、カルチャに依存しないことに注意してください。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""d" 時間間隔の日数。The number of days in the time interval. 時間間隔が1日未満の場合、この要素は省略されます。This element is omitted if the time interval is less than one day.
"hh""hh" 時間間隔の時間数を0から23までの範囲で指定します。The number of hours in the time interval, ranging from 0 to 23.
"mm""mm" 時間間隔の分数を 0 ~ 59 の範囲で指定します。The number of minutes in the time interval, ranging from 0 to 59.
"ss""ss" 時間間隔の秒数。 0 ~ 59 の範囲で指定します。The number of seconds in the time interval, ranging from 0 to 59.
"fffffff""fffffff" 時間間隔の秒の小数部。Fractional seconds in the time interval. 時間間隔に秒の小数部が含まれていない場合、この要素は省略されます。This element is omitted if the time interval does not include fractional seconds. 秒の小数部がある場合は、常に7桁の10進数を使用して表されます。If present, fractional seconds are always expressed using seven decimal digits.

注意

文字列形式と Oracle データ型のTimeSpan比較の詳細については、サポート技術情報の記事324577 を参照してください。TimeSpan は、Oracle 9i INTERVAL DAY を SECOND データ型に一致させません。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.

注意 (呼び出し元)

値の書式TimeSpan設定のサポートが.NET Framework 4.NET Framework 4に追加されました。Support for formatting TimeSpan values was added in the .NET Framework 4.NET Framework 4. ただし、メソッドToString()のオーバーロードはカルチャに依存しません。However, the ToString() method overload remains culture-insensitive. その動作は、以前のバージョンの .NET Framework から変更されていません。Its behavior remains unchanged from previous versions of the .NET Framework. TimeSpan値の書式設定を制御するには、 ToString(String)またToString(String, IFormatProvider)はのオーバーロードを呼び出します。To control the formatting of a TimeSpan value, call the ToString(String) or ToString(String, IFormatProvider) overload.

こちらもご覧ください

適用対象