TimeZone.GetUtcOffset(DateTime) Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

TimeZone.cs

Mengembalikan offset Waktu Universal Terkoordinasi (UTC) untuk waktu lokal yang ditentukan.

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

Parameter

time

DateTime

Nilai tanggal dan waktu.

Mengembalikan

TimeSpan

Offset Waktu Universal Terkoordinasi (UTC) dari time.

Keterangan

Metode ini mengembalikan offset, atau perbedaan, antara time parameter dan Waktu Universal Terkoordinasi (UTC). Yaitu:

time = UTC + offset

Metode ini menginterpretasikan zona time waktu berdasarkan propertinya Kind . Jika nilai Kind properti adalah DateTimeKind.Local atau DateTimeKind.Unspecified, metode mengembalikan offset zona waktu lokal. Jika nilai Kind properti adalah DateTimeKind.Utc, metode mengembalikan offset yang sama dengan TimeSpan.Zero.

Jika zona waktu lokal mengamati waktu musim panas, GetUtcOffset menerapkan aturan penyesuaian saat ini saat time menentukan offset zona waktu lokal. Artinya, offset yang dikembalikan oleh GetUtcOffset mencerminkan apakah time jatuh dalam waktu standar zona waktu atau waktu musim panasnya.

Catatan

Metode ini GetUtcOffset hanya mengenali aturan penyesuaian waktu musim panas saat ini untuk zona waktu lokal. Akibatnya, dijamin untuk secara akurat mengembalikan offset UTC dari waktu lokal hanya selama periode di mana aturan penyesuaian terbaru berlaku. Ini dapat mengembalikan hasil yang tidak akurat jika time merupakan nilai tanggal dan waktu historis yang tunduk pada aturan penyesuaian sebelumnya.

Metode GetUtcOffset ini sesuai dengan TimeZoneInfo.GetUtcOffset metode . Jika memungkinkan, gunakan metode .TimeZoneInfo.GetUtcOffset

Karena nilai tanggal dan waktu yang diwakili oleh time dan offset nilai ini dari UTC tidak digabungkan erat, nilai tanggal dan waktu lokal atau tidak ditentukan dapat mengembalikan nilai offset yang berbeda saat dijalankan pada komputer yang berbeda atau saat dijalankan pada komputer yang sama di bawah zona waktu yang berbeda. Jika perilaku ini tidak diinginkan, gunakan DateTimeOffset nilai sebagai gantinya. Jenis DateTimeOffset data menggabungkan nilai tanggal dan waktu dengan offset dari UTC dengan erat.

Lihat juga

• GetUtcOffset(DateTime)