TimeZone.GetUtcOffset(DateTime) Method

Definition

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

Parameters

time
DateTime

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

Returns

TimeSpan

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

Remarks

이 메서드는 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

메서드는 Kind 속성을 기반으로 time의 표준 시간대를 해석 합니다.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.

Note

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.

Applies to

See also