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

メソッドのタイム ゾーンは解釈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.

適用対象

こちらもご覧ください