이 페이지가 유용했습니까?
이 콘텐츠에 대한 여러분의 의견은 중요합니다. 의견을 알려주십시오.
추가 의견
1500자 남음
내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

DateTimeOffset.Parse 메서드 (String, IFormatProvider, DateTimeStyles)

2013-12-13

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

Namespace:  System
어셈블리:  mscorlib(mscorlib.dll)

public static DateTimeOffset Parse(
	string input,
	IFormatProvider formatProvider,
	DateTimeStyles styles
)

매개 변수

input
형식: System.String
변환할 날짜 및 시간이 포함된 문자열입니다.
formatProvider
형식: System.IFormatProvider
input에 대한 문화권별 서식 정보를 제공하는 개체입니다.
styles
형식: System.Globalization.DateTimeStyles
input에 사용할 수 있는 형식을 나타내는 열거형 값의 비트 조합입니다. 지정할 일반적인 값은 None입니다.

반환 값

형식: System.DateTimeOffset
formatProviderstyles에 의해 지정된 대로, input에 들어 있는 날짜 및 시간에 해당하는 개체입니다.

예외조건
ArgumentException

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

-또는-

styles가 유효한 DateTimeStyles 값이 아닌 경우

-또는-

styles에 지원되지 않는 DateTimeStyles 값이 포함된 경우

-또는-

styles에 함께 사용할 수 없는 DateTimeStyles 값이 포함된 경우

ArgumentNullException

inputnull인 경우

FormatException

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

-또는-

input에 날짜 또는 시간이 없는 오프셋 값의 문자열 표현이 들어 있는 경우

이 메서드는 순서에 관계없이 공백을 사용하여 구분된 요소 세 개가 있는 문자열을 구문 분석합니다. 다음 표에서는 이러한 세 요소를 보여 줍니다.

요소

예제

<날짜>

"2/10/2007"

<시간>

"1:02:03 PM"

<Offset>

"-7:30:15"

이러한 각 요소는 선택적 요소지만 <Offset>이 단독으로 나타날 수는 없습니다. 즉, <Date> 또는 <Time>이 함께 제공되어야 합니다. <Date>가 없으면 기본값은 현재 날짜입니다. <Time>이 없으면 기본값은 12:00:00 AM입니다. <Offset>이 없으면 기본값은 현지 표준 시간대의 오프셋입니다. 또는, styles 매개 변수에 DateTimeStyles.AdjustToUniversal 또는 DateTimeStyles.AssumeUniversal 값을 지정하는 경우에는 기본값이 TimeSpan.Zero입니다. <Offset>이 있는 경우 이는 UTC(협정 세계시)를 기준으로 한 음수 또는 양수 오프셋을 나타낼 수 있습니다. 두 경우 모두 <Offset>에 부호가 포함되어야 합니다.

이러한 세 요소의 형식은 formatProvider 매개 변수를 통해 정의되며, 이는 다음 중 하나가 될 수 있습니다.

각 요소를 선행 또는 후행 공백으로 묶을 수도 있고, 다음과 같이 <Date> 및 <Time> 요소에 내부 공백이 포함될 수도 있습니다(6: 00:00). <Offset> 구성 요소만 내부 공백을 포함할 수 없습니다.

formatprovidernull인 경우 날짜 및 시간 요소의 특정 유효 형식을 결정하는 데 현재 문화권에 해당하는 CultureInfo 개체가 사용됩니다.

<Offset>에 사용되는 양수 또는 음수 부호는 + 또는 -여야 합니다. 이는 formatProvider 매개 변수에서 반환하는 NumberFormatInfo 개체의 PositiveSign 또는 NegativeSign 속성으로 정의되지 않습니다.

다음 표에서는 지원되는 System.Globalization.DateTimeStyles 열거형 멤버를 보여 줍니다.

DateTimeStyles 멤버

설명

AdjustToUniversal

input이 나타내는 문자열을 구문 분석하고 필요한 경우 UTC로 변환합니다. 이는 문자열을 구문 분석한 다음 반환된 DateTimeOffset 개체의 DateTimeOffset.ToUniversalTime 메서드를 호출하는 것과 같습니다.

AllowInnerWhite

이 값은 유효하더라도 무시됩니다. 내부 공백은 <Date> 및 <Time> 요소에 허용됩니다.

AllowLeadingWhite

이 값은 유효하더라도 무시됩니다. 선행 공백은 구문 분석된 문자열의 각 구성 요소 앞에 허용됩니다.

AllowTrailingWhite

이 값은 유효하더라도 무시됩니다. 후행 공백은 구문 분석된 문자열의 각 구성 요소 앞에 허용됩니다.

AllowWhiteSpaces

이것은 기본적인 동작입니다. DateTimeStyles.None 같은 더 제한적인 DateTimeStyles 열거형 값을 제공하여 이를 재정의할 수 없습니다.

AssumeLocal

input 매개 변수에 <Offset> 요소가 없는 경우 현지 표준 시간대의 오프셋을 제공하도록 지시합니다. 이는 Parse 메서드의 기본 동작입니다.

AssumeUniversal

input 매개 변수에 <Offset> 요소가 없는 경우 UTC 오프셋(00:00)을 제공하도록 지시합니다.

None

이 값은 유효하지만 무시되며 효과가 없습니다.

RoundtripKind

DateTimeOffset 구조체에 Kind 속성이 포함되지 않으므로 이 값은 효과가 없습니다.

DateTimeStyles.NoCurrentDateDefault 값만 지원되지 않습니다. 이 값이 styles 매개 변수에 포함된 경우 ArgumentException이 발생합니다.

다음 예제에서는 DateTimeStyles.AssumeLocal, DateTimeStyles.AssumeUniversalDateTimeStyles.AdjustToUniversal 값을 Parse(String, IFormatProvider, DateTimeStyles) 메서드의 styles 매개 변수로 구문 분석한 결과를 보여 줍니다.


string dateString;
DateTimeOffset offsetDate;

dateString = "05/01/2008 6:00:00";
// Assume time is local 
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeLocal);
outputBlock.Text += offsetDate.ToString() + "\n";   // Displays 5/1/2008 6:00:00 AM -07:00

// Assume time is UTC
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeUniversal);
outputBlock.Text += offsetDate.ToString() + "\n";   // Displays 5/1/2008 6:00:00 AM +00:00

// Parse and convert to UTC 
dateString = "05/01/2008 6:00:00AM +5:00";
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AdjustToUniversal);
outputBlock.Text += offsetDate.ToString() + "\n";   // Displays 5/1/2008 1:00:00 AM +00:00


Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

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

참여하시겠습니까?
표시:
© 2015 Microsoft