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

定義

指定した現地時間の世界協定時刻 (UTC : Coordinated Universal Time) オフセットを返します。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

メソッドは、 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.

注意

メソッド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.

適用対象

こちらもご覧ください