이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본
이 항목은 아직 평가되지 않았습니다.- 이 항목 평가

DateTimeOffset.ParseExact 메서드 (String, String, IFormatProvider)

지정된 형식 및 문화권별 형식 정보를 사용하여 날짜 및 시간의 지정된 문자열 표현을 해당 DateTimeOffset으로 변환합니다. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.

네임스페이스:  System
어셈블리:  mscorlib(mscorlib.dll)
public static DateTimeOffset ParseExact(
	string input,
	string format,
	IFormatProvider formatProvider
)

매개 변수

input
형식: System.String
변환할 날짜 및 시간이 포함된 문자열입니다.
format
형식: System.String
input의 예상 형식을 정의하는 형식 지정자입니다.
formatProvider
형식: System.IFormatProvider
input에 대한 문화권별 서식 지정 정보를 제공하는 개체입니다.

반환 값

형식: System.DateTimeOffset
formatformatProvider에 의해 지정된 대로 input에 들어 있는 날짜 및 시간과 같은 개체입니다.
예외조건
ArgumentException

오프셋이 14시간보다 크거나 -14시간보다 작은 경우

ArgumentNullException

inputnull인 경우

-또는-

formatnull인 경우

FormatException

input이 빈 문자열("")인 경우

또는

input에 날짜 및 시간의 올바른 문자열 표현이 들어 있지 않은 경우

또는

format이 빈 문자열인 경우

또는

input에서의 AM/PM 지정자와 시간 구성 요소가 일치하지 않습니다.

ParseExact(String, String, IFormatProvider) 메서드는 날짜의 문자열 표현을 구문 분석하며, 이 문자열은 format 매개 변수에 정의된 형식이어야 합니다. 또한 날짜 및 시간의 문자열 표현에서 <Date>, <Time> 및 <Offset> 요소가 format에 지정된 순서대로 나타나야 합니다. input 문자열이 이 format 매개 변수와 일치하지 않으면 이 메서드는 FormatException을 throw합니다. 반면 DateTimeOffset.Parse(String, IFormatProvider) 메서드는 형식 공급자의 DateTimeFormatInfo 개체에서 인식하는 모든 형식 중 하나로 날짜의 문자열 표현을 구문 분석합니다. 또한 날짜 및 시간의 문자열 표현에서 <날짜>, <시간> 및 <오프셋> 요소가 Parse에 지정된 순서대로 나타나야 합니다.

format 매개 변수는 input 매개 변수의 필수 형식을 정의하는 하나 이상의 사용자 지정 형식 지정자 또는 단일 표준 형식 지정자가 들어 있는 문자열입니다. 유효한 형식 지정 코드에 대한 자세한 내용은 표준 날짜 및 시간 서식 문자열사용자 지정 날짜 및 시간 형식 문자열을 참조하십시오. input에 오프셋이 있어야 함을 나타내는 z, zz 또는 zzz 사용자 지정 형식 지정자가 format에 포함된 경우 해당 오프셋에는 음수 부호나 양수 부호가 포함되어야 합니다. 부호가 없으면 이 메서드에서 FormatException이 throw됩니다.

format에 따라 input에 시간이 아닌 날짜가 들어 있어야 하는 경우 결과 DateTimeOffset 개체의 시간이 자정(0:00:00)으로 할당됩니다. format에 따라 input에 날짜가 아닌 시간이 들어 있어야 하는 경우 결과 DateTimeOffset 개체의 날짜가 로컬 시스템의 현재 날짜로 할당됩니다. format의 요구 조건에서 input에 오프셋을 포함하도록 규정하지 않은 경우 결과 DateTimeOffset 개체에는 로컬 시스템의 시간대 오프셋이 할당됩니다.

input에 사용되는 특정 날짜 및 시간 기호와 문자열은 formatProvider 매개 변수를 통해 정의됩니다. 이는 format이 표준 형식 지정자 문자열인 경우 input의 정확한 형식을 정의할 때와 같습니다. formatProvider 매개 변수는 다음 중 하나가 될 수 있습니다.

formatprovidernull이면 현재 문화권에 해당하는 CultureInfo 개체가 사용됩니다.

호출자 참고 사항

.NET Framework 4에서는, 구문 분석할 문자열이 서로 일치하지 않는 시간 구성 요소와 AM/PM 지정자를 포함할 경우 ParseExact 메서드가 FormatException를 throw합니다. .NET Framework 3.5 및 이전 버전에서는 AM/PM 지정자가 무시됩니다.

다음 예제에서는 표준 및 사용자 지정 형식 지정자 및 고정 문화권과 함께 DateTimeOffset.ParseExact(String, String, IFormatProvider) 메서드를 사용하여 여러 가지 날짜 및 시간 문자열을 구문 분석합니다.


string dateString, format;  
DateTimeOffset result;
CultureInfo provider = CultureInfo.InvariantCulture;

// Parse date-only value with invariant culture.
dateString = "06/15/2008";
format = "d";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider);
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}   
catch (FormatException)
{
   Console.WriteLine("{0} is not in the correct format.", dateString);
} 

// Parse date-only value without leading zero in month using "d" format.
// Should throw a FormatException because standard short date pattern of 
// invariant culture requires two-digit month.
dateString = "6/15/2008";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider);
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException)
{
   Console.WriteLine("{0} is not in the correct format.", dateString);
} 

// Parse date and time with custom specifier.
dateString = "Sun 15 Jun 2008 8:30 AM -06:00";
format = "ddd dd MMM yyyy h:mm tt zzz";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider);
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException)
{
   Console.WriteLine("{0} is not in the correct format.", dateString);
} 

// Parse date and time with offset without offset//s minutes.
// Should throw a FormatException because "zzz" specifier requires leading  
// zero in hours.
dateString = "Sun 15 Jun 2008 8:30 AM -06";
try
{
   result = DateTimeOffset.ParseExact(dateString, format, provider);
   Console.WriteLine("{0} converts to {1}.", dateString, result.ToString());
}
catch (FormatException)
{
   Console.WriteLine("{0} is not in the correct format.", dateString);
} 
// The example displays the following output:
//    06/15/2008 converts to 6/15/2008 12:00:00 AM -07:00.
//    6/15/2008 is not in the correct format.
//    Sun 15 Jun 2008 8:30 AM -06:00 converts to 6/15/2008 8:30:00 AM -06:00.
//    Sun 15 Jun 2008 8:30 AM -06 is not in the correct format.                     


.NET Framework

4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

이식 가능한 클래스 라이브러리

이식 가능한 클래스 라이브러리에서 지원

Windows 스토어 앱용 .NET

Windows 8에서 지원

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.
이 정보가 도움이 되었습니까?
(1500자 남음)

커뮤니티 추가 항목

추가
Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
© 2013 Microsoft. All rights reserved.