이 설명서는 보관되지만 유지 되지 않습니다.

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]
대괄호([ 및 ])로 묶인 요소는 반환된 문자열에 포함되지 않을 수 있습니다. 콜론과 마침표(: 및 .)는 리터럴 문자입니다. 다음 표에서는 리터럴이 아닌 요소를 나열합니다.

Item

설명

"-"

음의 시간 범위를 나타내는 빼기 기호입니다. 양의 시간 범위에는 기호가 포함되지 않습니다.

"d"

시간 범위의 날짜 수입니다. 시간 범위가 하루보다 작은 경우 이 요소가 생략됩니다.

"hh"

시간 범위의 시간 수로 0에서 23 사이의 값입니다.

"mm"

시간 범위의 분 수로 0에서 59 사이의 값입니다.

"ss"

시간 범위의 초 수로 0에서 59 사이의 값입니다.

"fffffff"

시간 범위의 소수로 나타낸 초 수입니다. 시간 범위에 소수로 나타낸 초가 없는 경우 이 요소가 생략됩니다. 있는 경우 소수로 나타낸 초는 항상 7자리 숫자로 표시됩니다.

1ecy8h51.alert_note(ko-kr,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월

반환된 문자열의 형식에 대한 설명이 수정되었고 예제가 추가되었습니다.

고객 의견

표시: