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.

반환

formatformatProvider에서 지정한 현재 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) 두 시간 간격의 서식을 지정 하는 방법입니다.The following example calls the ToString(String, IFormatProvider) method to format two time intervals. 이 예제에서는 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 아니거나 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"). 형식이 다른 값 이면 메서드에서 throw 한 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:

하는 경우 formatProvider 됩니다 null, DateTimeFormatInfo 현재 문화권과 연결 된 개체를 사용 합니다.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.

반환

format 매개 변수로 지정된 서식에 따른 현재 TimeSpan 값의 문자열 표현입니다.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 형식 문자열의 배열에서 각 요소의 문자열 표현을 표시할 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 다른 값을 메서드가 throw를 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. 콜론과 마침표 (: and.)는 리터럴 문자.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. 있는 경우 소수 자릿수 초는 항상 일곱 개의 10 진수 표시 됩니다.If present, fractional seconds are always expressed using seven decimal digits.

참고

TimeSpan 및 Oracle 데이터 형식의 문자열 표현을 비교 하는 방법에 대 한 자세한 내용은 기술 자료 문서 324577: System.object가 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.

추가 정보

적용 대상