TimeZoneInfo.BaseUtcOffset Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan perbedaan waktu antara waktu standar zona waktu saat ini dan Waktu Universal Terkoordinasi (UTC).
public:
property TimeSpan BaseUtcOffset { TimeSpan get(); };
public TimeSpan BaseUtcOffset { get; }
member this.BaseUtcOffset : TimeSpan
Public ReadOnly Property BaseUtcOffset As TimeSpan
Nilai Properti
Objek yang menunjukkan perbedaan waktu antara waktu standar zona waktu saat ini dan Waktu Universal Terkoordinasi (UTC).
Contoh
Contoh berikut menggunakan BaseUtcOffset properti untuk menampilkan perbedaan antara waktu lokal dan Waktu Universal Terkoordinasi (UTC).
TimeZoneInfo localZone = TimeZoneInfo.Local;
Console.WriteLine("The {0} time zone is {1}:{2} {3} than Coordinated Universal Time.",
localZone.DisplayName,
Math.Abs(localZone.BaseUtcOffset.Hours),
Math.Abs(localZone.BaseUtcOffset.Minutes),
(localZone.BaseUtcOffset >= TimeSpan.Zero) ? "later" : "earlier");
let localZone = TimeZoneInfo.Local
printfn $"""The {localZone.DisplayName} time zone is {abs localZone.BaseUtcOffset.Hours}:{abs localZone.BaseUtcOffset.Minutes} {if localZone.BaseUtcOffset >= TimeSpan.Zero then "later" else "earlier"} than Coordinated Universal Time."""
Dim localZone As TimeZoneInfo = TimeZoneInfo.Local
Console.WriteLine("The {0} time zone is {1}:{2} {3} than Coordinated Universal Time.", _
localZone.StandardName, _
Math.Abs(localZone.BaseUtcOffset.Hours), _
Math.Abs(localZone.BaseUtcOffset.Minutes), _
IIf(localZone.BaseUtcOffset >= TimeSpan.Zero, "later", "earlier"))
Keterangan
Rentang waktu yang dikembalikan oleh BaseUtcOffset properti dapat berkisar dari 14 jam (untuk zona waktu 14 jam lebih awal dari Waktu Universal Terkoordinasi (UTC)) hingga -14 jam (untuk zona waktu yang 14 jam di belakang UTC). Zona waktu yang berada di depan UTC memiliki offset positif; zona waktu yang berada di belakang UTC memiliki offset negatif.
Nilai BaseUtcOffset dinyatakan sebagai jumlah menit keseluruhan. Ini tidak dapat menyertakan jumlah menit pecahan.
Nota
Karena BaseUtcOffset merupakan properti TimeZoneInfo objek daripada TimeZoneInfo.AdjustmentRule objek, TimeZoneInfo kelas menerapkan offset tunggal dari UTC ke semua penyesuaian zona waktu. Untuk mencerminkan zona waktu yang telah memodifikasi offsetnya dari UTC, Anda harus membuat zona waktu baru menggunakan CreateCustomTimeZone metode .
Properti BaseUtcOffset berbeda dari GetUtcOffset metode dengan cara berikut:
Properti BaseUtcOffset mengembalikan perbedaan antara UTC dan waktu standar zona waktu; GetUtcOffset metode mengembalikan perbedaan antara UTC dan waktu zona waktu pada titik waktu tertentu.
Metode ini GetUtcOffset mencerminkan penerapan aturan penyesuaian apa pun ke zona waktu; BaseUtcOffset properti tidak.