TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) Method

정의

지정된 현지 시간에 대한 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 DateTime DateTime DateTime

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

반환

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. 경우 값을 Kind 속성은 DateTimeKind.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. 경우 값을 Kind 속성은 DateTimeKind.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.

적용 대상

추가 정보