TimeZone.GetUtcOffset(DateTime) 메서드

정의

지정된 현지 시간에 대한 UTC(협정 세계시) 오프셋을 반환합니다.Returns the Coordinated Universal Time (UTC) offset for the specified local time.

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

날짜 및 시간 값입니다.A date and time value.

반환

TimeSpan

time의 UTC(협정 세계시) 오프셋입니다.The Coordinated Universal Time (UTC) offset from time.

설명

이 메서드는 time 매개 변수와 utc (협정 세계시) 사이의 오프셋 또는 차이를 반환 합니다.This method returns the offset, or difference, between the time parameter and Coordinated Universal Time (UTC). 구체적인 요건은 다음과 같습니다.That is:

time = UTC + 오프셋time = UTC + offset

메서드는 time 속성을 기반으로의 표준 시간대를 해석 합니다 Kind .The method interprets the time zone of time based on its Kind property. 속성의 값 KindDateTimeKind.Local 또는 이면 DateTimeKind.Unspecified 메서드는 현지 표준 시간대의 오프셋을 반환 합니다.If the value of the Kind property is DateTimeKind.Local or DateTimeKind.Unspecified, the method returns the offset of the local time zone. 속성의 값이 이면 KindDateTimeKind.Utc 메서드는와 같은 오프셋을 반환 합니다 TimeSpan.Zero .If the value of the Kind property is DateTimeKind.Utc, the method returns an offset equal to TimeSpan.Zero.

현지 표준 시간대가 일광 절약 시간을 준수 하는 경우는 GetUtcOffset time 현지 표준 시간대의 오프셋을 결정할 때 현재 조정 규칙을에 적용 합니다.If the local time zone observes daylight saving time, GetUtcOffset applies the current adjustment rule to time when determining the offset of the local time zone. 즉,에서 반환 하는 오프셋은가 표준 GetUtcOffset time 시간대의 표준 시간 또는 일광 절약 시간에 속하는지 여부를 반영 합니다.That is, the offset returned by GetUtcOffset reflects whether time falls in the time zone's standard time or its daylight saving time.

참고

GetUtcOffset메서드는 현지 표준 시간대에 대 한 현재 일광 절약 시간 조정 규칙만 인식 합니다.The GetUtcOffset method recognizes only the current daylight saving time adjustment rule for the local time zone. 따라서 최근 조정 규칙이 적용 되는 기간 동안에만 현지 시간의 UTC 오프셋을 정확 하 게 반환 하는 것이 보장 됩니다.As a result, it is guaranteed to accurately return the UTC offset of a local time only during the period in which the latest adjustment rule is in effect. time가 이전 조정 규칙이 적용 된 기록 날짜 및 시간 값인 경우 부정확 한 결과를 반환할 수 있습니다.It may return inaccurate results if time is a historic date and time value that was subject to a previous adjustment rule.

GetUtcOffset메서드는 TimeZoneInfo.GetUtcOffset 메서드에 해당 합니다.The GetUtcOffset method corresponds to the TimeZoneInfo.GetUtcOffset method. 가능 하면 메서드를 사용 TimeZoneInfo.GetUtcOffset 합니다.Whenever possible, use the TimeZoneInfo.GetUtcOffset method.

로 표시 되는 날짜 및 시간 값 time 과 UTC에서의이 값 오프셋은 밀접 하 게 연결 되어 있지 않기 때문에 다른 컴퓨터에서 실행 하거나 다른 표준 시간대의 동일한 컴퓨터에서 실행 하는 경우에는 로컬 또는 지정 되지 않은 날짜 및 시간 값이 다른 오프셋 값을 반환할 수 있습니다.Because the date and time value represented by time and this value's offset from UTC are not tightly coupled, a local or unspecified date and time value can return a different offset value when run on different computers or when run on the same computer under different time zones. 이 동작이 원치 않는 경우에는 DateTimeOffset 값을 대신 사용 합니다.If this behavior is undesirable, use a DateTimeOffset value instead. DateTimeOffset데이터 형식은 날짜 및 시간 값을 UTC에서의 오프셋과 긴밀 하 게 결합 합니다.The DateTimeOffset data type tightly couples a date and time value with its offset from UTC.

적용 대상

추가 정보