TimeZone.ToLocalTime(DateTime) Metode

Definisi

Ruang nama:

System

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

TimeZone.cs

Mengembalikan waktu lokal yang sesuai dengan nilai tanggal dan waktu tertentu.

public:
 virtual DateTime ToLocalTime(DateTime time);

public virtual DateTime ToLocalTime(DateTime time);

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

Public Overridable Function ToLocalTime (time As DateTime) As DateTime

Parameter

time

DateTime

Waktu Universal Terkoordinasi (UTC).

Mengembalikan

DateTime

Objek DateTime yang nilainya adalah waktu lokal yang sesuai dengan time.

Keterangan

Tabel berikut menunjukkan hubungan antara time parameter dan nilai yang DateTime dikembalikan oleh metode ini.

time parameter	Perilaku	Mengembalikan nilai
Waktu Universal Terkoordinasi (UTC) (DateTimeKind.Utc).	Mengonversi waktu dari UTC ke waktu lokal.	Objek DateTime yang nilainya adalah waktu lokal yang sesuai dengan time.
Waktu lokal (DateTimeKind.Local).	Tidak perlu konversi.	Nilai yang sama DateTime diwakili oleh time parameter .
Waktu yang tidak ditentukan (DateTimeKind.Unspecified).	Mengasumsikan bahwa waktunya adalah UTC dan mengonversinya dari UTC ke waktu lokal.	Objek DateTime yang nilainya adalah waktu lokal yang sesuai dengan time.

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

Note

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

Metode ToLocalTime ini sesuai TimeZoneInfo.ConvertTimeFromUtc dengan metode dengan parameternya destinationTimeZone diatur ke TimeZoneInfo.Local. Jika memungkinkan, gunakan metode .TimeZoneInfo.ConvertTimeFromUtc

Catatan Bagi Inheritor

Meskipun tidak diperlukan, dalam banyak kasus kelas turunan harus mengambil alih implementasi default metode ini. Perilaku implementasi default tergantung pada Kind properti time parameter. Jika nilainya adalah Local, metode ini mengembalikan time tidak berubah. Jika nilainya adalah Utc atau Unspecified, metode ini mengasumsikan time adalah UTC dan mengonversinya ke waktu sistem lokal tanpa memanggil GetUtcOffset(DateTime) metode .

Lihat juga

• ConvertTimeFromUtc(DateTime, TimeZoneInfo)