다음을 통해 공유


System.TimeSpan.TryParse 메서드

이 문서에서는 이 API에 대한 참조 설명서에 대한 추가 설명서를 제공합니다.

TryParse(System.String,System.TimeSpan@) 메서드

TimeSpan.TryParse(String, TimeSpan) 변환이 TimeSpan.Parse(String) 실패할 경우 예외를 throw하지 않는다는 점을 제외하고 메서드는 메서드와 같습니다.

매개 변수에는 s 다음과 같은 형식의 시간 간격 사양이 포함됩니다.

[ws][-]{ d | d.hh:mm[:ss[.ff]] | hh:mm[:ss[.ff]] }[ws]

대괄호 ([ 및 ]) 안의 요소는 선택적 요소입니다. 중괄호({ 및 })로 묶고 세로 막대(|)로 구분된 대체 항목 목록에서 하나를 선택해야 합니다. 다음 표에서는 각 요소에 대해 설명합니다.

요소 설명
ws 선택적 공백입니다.
- TimeSpan수인 빼기 기호(선택 사항)입니다.
d 0에서 10675199 사이의 일 수입니다.
. 일과 시간을 구분하는 문화권 구분 기호입니다. 고정 형식은 마침표(".") 문자를 사용합니다.
hh 시간(0에서 23까지)입니다.
: 문화권 구분 시간 구분 기호입니다. 고정 형식은 콜론(":") 문자를 사용합니다.
mm 분( 0에서 59까지)
ss 0에서 59까지의 선택적 초입니다.
. 초의 분수와 초를 구분하는 문화권 구분 기호입니다. 고정 형식은 마침표(".") 문자를 사용합니다.
ff 1~7자리 소수 자릿수로 구성된 선택적 소수 자릿수 초입니다.

구성 요소는 s 보다 크거나 같고 보다 작거나 같은 TimeSpan.MaxValue시간 간격을 TimeSpan.MinValue 집합적으로 지정해야 합니다.

이 메서드는 Parse(String) 현재 문화권 s 에 대한 각 문화권별 형식을 사용하여 구문 분석을 시도합니다.

TryParse(String, IFormatProvider, TimeSpan) 메서드

변환 TryParse(String, IFormatProvider, TimeSpan)Parse(String, IFormatProvider) 실패할 경우 예외를 throw하지 않는다는 점을 제외하고 메서드는 메서드와 같습니다.

매개 변수에는 input 다음과 같은 형식의 시간 간격 사양이 포함됩니다.

[ws][-]{ d | d.hh:mm[:ss[.ff]] | hh:mm[:ss[.ff]] }[ws]

대괄호 ([ 및 ]) 안의 요소는 선택적 요소입니다. 중괄호({ 및 })로 묶고 세로 막대(|)로 구분된 대체 항목 목록에서 하나를 선택해야 합니다. 다음 표에서는 각 요소에 대해 설명합니다.

요소 설명
ws 선택적 공백입니다.
- TimeSpan수인 빼기 기호(선택 사항)입니다.
d 0에서 10675199 사이의 일 수입니다.
. 일과 시간을 구분하는 문화권 구분 기호입니다. 고정 형식은 마침표(".") 문자를 사용합니다.
hh 시간(0에서 23까지)입니다.
: 문화권 구분 시간 구분 기호입니다. 고정 형식은 콜론(":") 문자를 사용합니다.
mm 분( 0에서 59까지)
ss 0에서 59까지의 선택적 초입니다.
. 초의 분수와 초를 구분하는 문화권 구분 기호입니다. 고정 형식은 마침표(".") 문자를 사용합니다.
ff 1~7자리 소수 자릿수로 구성된 선택적 소수 자릿수 초입니다.

구성 요소는 input 보다 크거나 같고 같거나 같은 시간 간격을 TimeSpan.MinValueTimeSpan.MaxValue집합적으로 지정해야 합니다.

메서드는 TryParse(String, IFormatProvider, TimeSpan) 지정한 문화formatProviderinput 에 대해 각 문화권별 형식을 사용하여 구문 분석을 시도합니다.

formatProvider 매개 변수는 반환된 IFormatProvider 문자열의 형식에 대한 문화권별 정보를 제공하는 구현입니다. 매개 변수는 formatProvider 다음 중 어느 것일 수 있습니다.

nullDateTimeFormatInfo 경우 formatProvider 현재 문화권과 연결된 개체가 사용됩니다.

호출자에 대한 참고 사항

구문 분석할 문자열의 시간 간격 구성 요소에 7자리 이상의 숫자가 포함된 경우 .NET Framework 3.5 및 이전 버전에서 성공하고 반환 true 된 구문 분석 작업이 실패하고 .NET Framework 4 이상 버전에서 반환 false 될 수 있습니다. 다음 예제에서는 이 시나리오를 보여 줍니다.

string value = "000000006";
TimeSpan interval;
if (TimeSpan.TryParse(value, out interval))
   Console.WriteLine("{0} --> {1}", value, interval);
else
   Console.WriteLine("Unable to parse '{0}'", value);
   
// Output from .NET Framework 3.5 and earlier versions:
//       000000006 --> 6.00:00:00
// Output from .NET Framework 4:
//       Unable to parse //000000006//
let value = "000000006"
match TimeSpan.TryParse value with
| true, interval ->
    printfn $"{value} --> {interval}"
| _ ->
    printfn $"Unable to parse '{value}'"
    
// Output from .NET Framework 3.5 and earlier versions:
//       000000006 --> 6.00:00:00
// Output from .NET Framework 4:
//       Unable to parse //000000006//
Dim value As String = "000000006"
Dim interval As TimeSpan
If TimeSpan.TryParse(value, interval) Then
   Console.WriteLine("{0} --> {1}", value, interval)
Else
   Console.WriteLine("Unable to parse '{0}'", value)
End If
' Output from .NET Framework 3.5 and earlier versions:
'       000000006 --> 6.00:00:00
' Output from .NET Framework 4:
'       Unable to parse '000000006'