Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Meskipun struktur DateTime dan DateTimeOffset menyediakan anggota yang melakukan operasi aritmatika pada nilai mereka, hasil operasi aritmatika sangat berbeda. Artikel ini memeriksa perbedaan tersebut, menghubungkannya dengan tingkat kesadaran zona waktu dalam data tanggal dan waktu, dan membahas cara melakukan operasi sadar zona waktu sepenuhnya menggunakan data tanggal dan waktu.
Perbandingan dan operasi aritmatika dengan nilai DateTime
Properti DateTime.Kind memungkinkan nilai DateTimeKind ditetapkan ke tanggal dan waktu untuk menunjukkan apakah properti mewakili waktu lokal, Waktu Universal Terkoordinasi (UTC), atau waktu dalam zona waktu yang tidak ditentukan. Namun, informasi zona waktu terbatas ini diabaikan saat membandingkan atau melakukan aritmatika tanggal dan waktu pada nilai DateTimeKind. Contoh berikut, yang membandingkan waktu lokal saat ini dengan waktu UTC saat ini, menggambarkan bagaimana informasi zona waktu diabaikan.
using System;
public enum TimeComparison2
{
EarlierThan = -1,
TheSameAs = 0,
LaterThan = 1
}
public class DateManipulation
{
public static void Main()
{
DateTime localTime = DateTime.Now;
DateTime utcTime = DateTime.UtcNow;
Console.WriteLine("Difference between {0} and {1} time: {2}:{3} hours",
localTime.Kind,
utcTime.Kind,
(localTime - utcTime).Hours,
(localTime - utcTime).Minutes);
Console.WriteLine("The {0} time is {1} the {2} time.",
localTime.Kind,
Enum.GetName(typeof(TimeComparison2), localTime.CompareTo(utcTime)),
utcTime.Kind);
}
}
// If run in the U.S. Pacific Standard Time zone, the example displays
// the following output to the console:
// Difference between Local and Utc time: -7:0 hours
// The Local time is EarlierThan the Utc time.
Public Enum TimeComparison As Integer
EarlierThan = -1
TheSameAs = 0
LaterThan = 1
End Enum
Module DateManipulation
Public Sub Main()
Dim localTime As Date = Date.Now
Dim utcTime As Date = Date.UtcNow
Console.WriteLine("Difference between {0} and {1} time: {2}:{3} hours", _
localTime.Kind.ToString(), _
utcTime.Kind.ToString(), _
(localTime - utcTime).Hours, _
(localTime - utcTime).Minutes)
Console.WriteLine("The {0} time is {1} the {2} time.", _
localTime.Kind.ToString(), _
[Enum].GetName(GetType(TimeComparison), localTime.CompareTo(utcTime)), _
utcTime.Kind.ToString())
' If run in the U.S. Pacific Standard Time zone, the example displays
' the following output to the console:
' Difference between Local and Utc time: -7:0 hours
' The Local time is EarlierThan the Utc time.
End Sub
End Module
Metode CompareTo(DateTime) melaporkan bahwa waktu lokal lebih awal dari (atau kurang dari) waktu UTC, dan operasi pengurangan menunjukkan bahwa perbedaan antara UTC dan waktu lokal untuk sistem di zona Waktu Standar Pasifik AS adalah tujuh jam. Tetapi karena kedua nilai ini memberikan representasi yang berbeda dari satu titik waktu, jelas dalam hal ini bahwa interval waktu sepenuhnya dapat diatributkan ke perbedaan zona waktu lokal dari UTC.
Lebih umum lagi, properti DateTime.Kind tidak memengaruhi hasil yang dikembalikan oleh metode perbandingan dan aritmatika Kind (seperti yang ditunjukkan oleh perbandingan dua titik waktu yang identik), meskipun dapat memengaruhi interpretasi hasil tersebut. Contohnya:
Hasil operasi aritmatika apa pun yang dilakukan pada dua nilai tanggal dan waktu yang properti DateTime.Kind keduanya sama DateTimeKind mencerminkan interval waktu aktual antara dua nilai. Demikian pula, perbandingan dua nilai tanggal dan waktu tersebut secara akurat mencerminkan hubungan antara waktu.
Hasil dari setiap operasi aritmetika atau perbandingan yang dilakukan pada dua nilai tanggal dan waktu yang properti DateTime.Kind sama DateTimeKind atau pada dua nilai tanggal dan waktu dengan nilai properti DateTime.Kind yang berbeda mencerminkan perbedaan waktu jam antara kedua nilai.
Operasi aritmatika atau perbandingan pada nilai tanggal dan waktu lokal tidak mempertimbangkan apakah nilai tertentu ambigu atau tidak valid, juga tidak memperhitungkan efek dari aturan penyesuaian apa pun yang dihasilkan dari transisi zona waktu lokal ke atau dari waktu musim panas.
Setiap operasi yang membandingkan atau menghitung perbedaan antara UTC dan waktu lokal mencakup interval waktu yang sama dengan offset zona waktu lokal dari UTC dalam hasilnya.
Setiap operasi yang membandingkan atau menghitung perbedaan antara waktu yang tidak ditentukan dan UTC atau waktu lokal mencerminkan waktu jam sederhana. Perbedaan zona waktu tidak dipertimbangkan, dan hasilnya tidak mencerminkan penerapan aturan penyesuaian zona waktu.
Setiap operasi yang membandingkan atau menghitung perbedaan antara dua waktu yang tidak ditentukan dapat mencakup interval yang tidak diketahui yang mencerminkan perbedaan antara waktu di dua zona waktu yang berbeda.
Ada banyak skenario di mana perbedaan zona waktu tidak memengaruhi perhitungan tanggal dan waktu (untuk diskusi beberapa skenario ini, lihat Memilih antara DateTime, DateTimeOffset, TimeSpan, dan TimeZoneInfo) atau di mana konteks data tanggal dan waktu menentukan arti operasi perbandingan atau aritmatika.
Perbandingan dan operasi aritmatika dengan nilai DateTimeOffset
Nilai DateTimeOffset tidak hanya mencakup tanggal dan waktu, tetapi juga offset yang secara tidak ambigu menentukan tanggal dan waktu tersebut relatif terhadap UTC. Offset ini memungkinkan untuk menentukan kesamaan dengan cara yang berbeda dibandingkan dengan nilai DateTime. Sedangkan nilai DateTime sama jika memiliki nilai tanggal dan waktu yang sama, nilai DateTimeOffset sama jika keduanya merujuk ke titik waktu yang sama. Ketika digunakan dalam perbandingan dan di sebagian besar operasi aritmatika yang menentukan interval antara dua tanggal dan waktu, nilai DateTimeOffset lebih akurat dan kurang membutuhkan interpretasi. Contoh berikut, yang merupakan DateTimeOffset setara dengan contoh sebelumnya yang membandingkan nilai DateTimeOffset lokal dan UTC, menggambarkan perbedaan perilaku ini.
using System;
public enum TimeComparison
{
EarlierThan = -1,
TheSameAs = 0,
LaterThan = 1
}
public class DateTimeOffsetManipulation
{
public static void Main()
{
DateTimeOffset localTime = DateTimeOffset.Now;
DateTimeOffset utcTime = DateTimeOffset.UtcNow;
Console.WriteLine($"Difference between local time and UTC: {(localTime - utcTime).Hours}:{(localTime - utcTime).Minutes:D2} hours");
Console.WriteLine($"The local time is {Enum.GetName(typeof(TimeComparison), localTime.CompareTo(utcTime))} UTC.");
}
}
// Regardless of the local time zone, the example displays
// the following output to the console:
// Difference between local time and UTC: 0:00 hours.
// The local time is TheSameAs UTC.
Public Enum TimeComparison As Integer
EarlierThan = -1
TheSameAs = 0
LaterThan = 1
End Enum
Module DateTimeOffsetManipulation
Public Sub Main()
Dim localTime As DateTimeOffset = DateTimeOffset.Now
Dim utcTime As DateTimeOffset = DateTimeOffset.UtcNow
Console.WriteLine("Difference between local time and UTC: {0}:{1:D2} hours.", _
(localTime - utcTime).Hours, _
(localTime - utcTime).Minutes)
Console.WriteLine("The local time is {0} UTC.", _
[Enum].GetName(GetType(TimeComparison), localTime.CompareTo(utcTime)))
End Sub
End Module
' Regardless of the local time zone, the example displays
' the following output to the console:
' Difference between local time and UTC: 0:00 hours.
' The local time is TheSameAs UTC.
' Console.WriteLine(e.GetType().Name)
Dalam contoh ini, metode CompareTo memperlihatkan bahwa waktu lokal saat ini dan waktu UTC saat ini sama, dan pengurangan nilai CompareTo(DateTimeOffset) menunjukkan bahwa perbedaan antara dua waktu tersebut adalah TimeSpan.Zero.
Batasan utama penggunaan nilai DateTimeOffset dalam aritmatika tanggal dan waktu adalah bahwa meskipun nilai DateTimeOffset memiliki beberapa kesadaran zona waktu, nilai tersebut tidak sepenuhnya sadar zona waktu. Meskipun offset nilai DateTimeOffset mencerminkan offset zona waktu dari UTC ketika variabel DateTimeOffset pertama kali diberi nilai, variabel tersebut menjadi tidak terkait lagi dengan zona waktu setelahnya. Karena tidak lagi terkait langsung dengan waktu yang dapat diidentifikasi, penambahan dan pengurangan interval tanggal dan waktu tidak mempertimbangkan aturan penyesuaian zona waktu.
Untuk menggambarkan, transisi ke waktu musim panas di zona Waktu Standar Tengah AS terjadi pada pukul 2:00 A.M. pada 9 Maret 2008. Dengan mengingat itu, menambahkan interval dua setengah jam ke waktu Standar Pusat 1:30 A.M. pada 9 Maret 2008, harus menghasilkan tanggal dan waktu 5:00 A.M. pada 9 Maret 2008. Namun, seperti yang ditunjukkan oleh contoh berikut, hasil penambahan adalah 4:00 A.M. pada 9 Maret 2008. Hasil dari operasi ini mewakili titik waktu yang benar, meskipun bukan waktu di zona waktu di mana kita tertarik (artinya, itu tidak memiliki offset zona waktu yang diharapkan).
using System;
public class IntervalArithmetic
{
public static void Main()
{
DateTime generalTime = new DateTime(2008, 3, 9, 1, 30, 0);
const string tzName = "Central Standard Time";
TimeSpan twoAndAHalfHours = new TimeSpan(2, 30, 0);
// Instantiate DateTimeOffset value to have correct CST offset
try
{
DateTimeOffset centralTime1 = new DateTimeOffset(generalTime,
TimeZoneInfo.FindSystemTimeZoneById(tzName).GetUtcOffset(generalTime));
// Add two and a half hours
DateTimeOffset centralTime2 = centralTime1.Add(twoAndAHalfHours);
// Display result
Console.WriteLine($"{centralTime1} + {twoAndAHalfHours.ToString()} hours = {centralTime2}");
}
catch (TimeZoneNotFoundException)
{
Console.WriteLine("Unable to retrieve Central Standard Time zone information.");
}
}
}
// The example displays the following output to the console:
// 3/9/2008 1:30:00 AM -06:00 + 02:30:00 hours = 3/9/2008 4:00:00 AM -06:00
Module IntervalArithmetic
Public Sub Main()
Dim generalTime As Date = #03/09/2008 1:30AM#
Const tzName As String = "Central Standard Time"
Dim twoAndAHalfHours As New TimeSpan(2, 30, 0)
' Instantiate DateTimeOffset value to have correct CST offset
Try
Dim centralTime1 As New DateTimeOffset(generalTime, _
TimeZoneInfo.FindSystemTimeZoneById(tzName).GetUtcOffset(generalTime))
' Add two and a half hours
Dim centralTime2 As DateTimeOffset = centralTime1.Add(twoAndAHalfHours)
' Display result
Console.WriteLine("{0} + {1} hours = {2}", centralTime1, _
twoAndAHalfHours.ToString(), _
centralTime2)
Catch e As TimeZoneNotFoundException
Console.WriteLine("Unable to retrieve Central Standard Time zone information.")
End Try
End Sub
End Module
' The example displays the following output to the console:
' 3/9/2008 1:30:00 AM -06:00 + 02:30:00 hours = 3/9/2008 4:00:00 AM -06:00
Operasi aritmatika pada zona waktu
Kelas TimeZoneInfo mencakup metode konversi yang secara otomatis menerapkan penyesuaian saat mengonversi waktu dari satu zona waktu ke zona waktu lainnya. Metode konversi ini meliputi:
Metode ConvertTime dan ConvertTimeBySystemTimeZoneId, yang mengonversi waktu antara dua zona waktu.
Metode ConvertTimeFromUtc dan ConvertTimeToUtc, yang mengonversi waktu di zona waktu tertentu ke UTC, atau mengonversi UTC ke waktu di zona waktu tertentu.
Untuk detailnya, lihat Waktu konversi antara zona waktu.
Kelas TimeZoneInfo tidak menyediakan metode apa pun yang secara otomatis menerapkan aturan penyesuaian saat Anda melakukan aritmatika tanggal dan waktu. Namun, Anda dapat menerapkan aturan penyesuaian dengan mengonversi waktu dalam zona waktu ke UTC, melakukan operasi aritmatika, lalu mengonversi dari UTC kembali ke waktu di zona waktu. Untuk detailnya, lihat Cara: Menggunakan zona waktu dalamaritmatika tanggal dan waktu .
Misalnya, kode berikut mirip dengan kode sebelumnya yang menambahkan dua setengah jam menjadi 2:00 A.M. pada 9 Maret 2008. Namun, karena mengonversi waktu Standar Pusat ke UTC sebelum melakukan aritmatika tanggal dan waktu, lalu mengonversi hasil dari UTC kembali ke waktu Standar Pusat, waktu yang dihasilkan mencerminkan transisi Zona Waktu Standar Pusat ke waktu musim panas.
using System;
public class TimeZoneAwareArithmetic
{
public static void Main()
{
const string tzName = "Central Standard Time";
DateTime generalTime = new DateTime(2008, 3, 9, 1, 30, 0);
TimeZoneInfo cst = TimeZoneInfo.FindSystemTimeZoneById(tzName);
TimeSpan twoAndAHalfHours = new TimeSpan(2, 30, 0);
// Instantiate DateTimeOffset value to have correct CST offset
try
{
DateTimeOffset centralTime1 = new DateTimeOffset(generalTime,
cst.GetUtcOffset(generalTime));
// Add two and a half hours
DateTimeOffset utcTime = centralTime1.ToUniversalTime();
utcTime += twoAndAHalfHours;
DateTimeOffset centralTime2 = TimeZoneInfo.ConvertTime(utcTime, cst);
// Display result
Console.WriteLine($"{centralTime1} + {twoAndAHalfHours.ToString()} hours = {centralTime2}");
}
catch (TimeZoneNotFoundException)
{
Console.WriteLine("Unable to retrieve Central Standard Time zone information.");
}
}
}
// The example displays the following output to the console:
// 3/9/2008 1:30:00 AM -06:00 + 02:30:00 hours = 3/9/2008 5:00:00 AM -05:00
Module TimeZoneAwareArithmetic
Public Sub Main()
Const tzName As String = "Central Standard Time"
Dim generalTime As Date = #03/09/2008 1:30AM#
Dim cst As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById(tzName)
Dim twoAndAHalfHours As New TimeSpan(2, 30, 0)
' Instantiate DateTimeOffset value to have correct CST offset
Try
Dim centralTime1 As New DateTimeOffset(generalTime, _
cst.GetUtcOffset(generalTime))
' Add two and a half hours
Dim utcTime As DateTimeOffset = centralTime1.ToUniversalTime()
utcTime += twoAndAHalfHours
Dim centralTime2 As DateTimeOffset = TimeZoneInfo.ConvertTime(utcTime, cst)
' Display result
Console.WriteLine("{0} + {1} hours = {2}", centralTime1, _
twoAndAHalfHours.ToString(), _
centralTime2)
Catch e As TimeZoneNotFoundException
Console.WriteLine("Unable to retrieve Central Standard Time zone information.")
End Try
End Sub
End Module
' The example displays the following output to the console:
' 3/9/2008 1:30:00 AM -06:00 + 02:30:00 hours = 3/9/2008 5:00:00 AM -05:00
Lihat juga
- Tanggal, waktu, dan zona waktu
- Panduan: Menggunakan zona waktu dalam penghitungan tanggal dan waktu
Berkolaborasi dengan kami di GitHub
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
