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. 例では、EN-US カルチャの規則を使用してそれを表示するには、まず各書式指定文字列を 2 回のメソッドを呼び出すし、表示、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またはnull、現在の戻り値TimeSpanオブジェクトが共通の書式指定子 ("c") でフォーマットされました。If 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"). 形式はその他の値である場合、メソッドがスローされます、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:

formatProviderパラメーターは、IFormatProvider返される文字列の書式設定に関するカルチャに固有の情報を提供する実装。The 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:

場合formatProvidernullDateTimeFormatInfo現在のカルチャに関連付けられているオブジェクトを使用します。If 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.

次のコードの例は、standard、およびカスタムTimeSpan書式指定文字列の配列の各要素の文字列表現を表示するTimeSpanThe following example uses standard and custom TimeSpan format strings to display the string representation of each element in an array of TimeSpan values

using System;

public class Class1
{
   public static void Main()
   {
      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またはnull、現在の戻り値TimeSpanオブジェクトが共通の書式指定子 ("c") でフォーマットされました。If 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.

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
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.

注意

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

こちらもご覧ください

適用対象