TimeZone.ToUniversalTime(DateTime) Metode

Definisi

Ruang nama:

System

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

TimeZone.cs

Mengembalikan Waktu Universal Terkoordinasi (UTC) yang sesuai dengan waktu yang ditentukan.

public:
 virtual DateTime ToUniversalTime(DateTime time);

public virtual DateTime ToUniversalTime(DateTime time);

abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTime

Public Overridable Function ToUniversalTime (time As DateTime) As DateTime

Parameter

time

DateTime

Tanggal dan waktu.

Mengembalikan

DateTime

Objek DateTime yang nilainya adalah Waktu Universal Terkoordinasi (UTC) yang sesuai dengan time.

Keterangan

Jika zona waktu lokal mengamati waktu musim panas, ToUniversalTime menerapkan aturan penyesuaian saat ini ke time parameter saat melakukan konversi.

Nota

Metode ini ToUniversalTime hanya mengenali aturan penyesuaian waktu musim panas saat ini untuk zona waktu lokal. Akibatnya, dijamin untuk secara akurat mengembalikan Waktu Universal Terkoordinasi (UTC) yang sesuai dengan waktu lokal tertentu 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.

time Jika parameter adalah waktu yang ambigu, metode mengasumsikan bahwa itu adalah waktu standar. (Waktu ambigu adalah waktu yang dapat memetakan baik ke waktu standar atau ke waktu musim panas di zona waktu lokal.) Jika time adalah waktu yang tidak valid, metode hanya mengurangi waktu lokal dari offset UTC zona waktu lokal untuk mengembalikan UTC. (Waktu yang tidak valid adalah waktu yang tidak ada karena penerapan aturan penyesuaian waktu musim panas.)

Karena time ditafsirkan dalam kaitannya dengan zona waktu saat ini pada sistem saat ini, tanggal dan waktu yang dikembalikan oleh metode ini dapat berbeda jika aplikasi dijalankan pada komputer yang berbeda atau pada komputer yang sama dengan zona waktu yang berbeda. Untuk kasus di mana nilai tanggal dan waktu harus mewakili satu titik waktu yang tidak ambigu, gunakan DateTimeOffset nilai untuk mewakili waktu lokal.

Metode ToUniversalTime ini sesuai dengan TimeZoneInfo.ConvertTimeToUtc(DateTime) metode kelebihan beban dengan DateTime parameter yang propertinya Kind tidak sama dengan DateTimeKind.Utc. Jika memungkinkan, gunakan metode kelebihan TimeZoneInfo.ConvertTimeToUtc(DateTime) beban.

Lihat juga

• ConvertTimeToUtc(DateTime)