TimeZone.GetUtcOffset(DateTime) 메서드

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

Source:

TimeZone.cs

지정된 현지 시간에 대한 UTC(협정 세계시) 오프셋을 반환합니다.

public:
 abstract TimeSpan GetUtcOffset(DateTime time);

public abstract TimeSpan GetUtcOffset (DateTime time);

abstract member GetUtcOffset : DateTime -> TimeSpan

Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

매개 변수

time

DateTime

날짜 및 시간 값입니다.

반환

TimeSpan

time의 UTC(협정 세계시) 오프셋입니다.

설명

이 메서드는 매개 변수와 UTC(협정 세계시) 간의 time 오프셋 또는 차이를 반환합니다. 구체적인 요건은 다음과 같습니다.

time = UTC + 오프셋

메서드는 해당 속성을 기반으로 의 time 표준 시간대를 Kind 해석합니다. 속성 값 Kind 이 또는 DateTimeKind.Unspecified이 DateTimeKind.Local 면 메서드는 로컬 표준 시간대의 오프셋을 반환합니다. 속성 값이 Kind 이면 메서드는 DateTimeKind.Utc와 동일한 오프셋을 반환합니다 TimeSpan.Zero.

현지 표준 시간대가 일광 절약 시간을 GetUtcOffset 관찰하는 경우 는 현지 표준 시간대의 오프셋을 결정할 때 현재 조정 규칙을 time 에 적용합니다. 즉, 에서 반환되는 GetUtcOffset 오프셋은 표준 시간대의 표준 시간대 또는 일광 절약 시간에 속하는지 여부를 time 반영합니다.

참고

메서드는 GetUtcOffset 로컬 표준 시간대에 대한 현재 일광 절약 시간 조정 규칙만 인식합니다. 따라서 최신 조정 규칙이 적용되는 기간 동안에만 현지 시간의 UTC 오프셋을 정확하게 반환하도록 보장됩니다. 가 이전 조정 규칙의 적용을 받는 기록 날짜 및 시간 값인 경우 time 부정확한 결과를 반환할 수 있습니다.

메서드는 GetUtcOffset 메서드에 TimeZoneInfo.GetUtcOffset 해당합니다. 가능하면 메서드를 TimeZoneInfo.GetUtcOffset 사용합니다.

로 표시되는 time 날짜 및 시간 값과 UTC의 이 값의 오프셋이 밀접하게 결합되지 않으므로 로컬 또는 지정되지 않은 날짜 및 시간 값은 다른 컴퓨터에서 실행하거나 다른 표준 시간대에서 동일한 컴퓨터에서 실행할 때 다른 오프셋 값을 반환할 수 있습니다. 이 동작이 바람직하지 않은 경우 대신 값을 사용합니다 DateTimeOffset . 데이터 형식은 DateTimeOffset 날짜 및 시간 값을 UTC의 오프셋과 긴밀하게 결합합니다.

추가 정보

• GetUtcOffset(DateTime)