DateTime vs DateTimeOffset

Saat ini, kami memiliki cara standar untuk berurusan dengan .NET DateTimedalam cara sadar TimeZone: Setiap kali kami memproduksi, DateTimekami melakukannya di UTC (mis. Menggunakan DateTime.UtcNow), dan setiap kali kami menampilkannya, kami mengonversi kembali dari UTC ke waktu setempat pengguna. .

Itu bekerja dengan baik, tapi saya sudah membaca tentang DateTimeOffsetdan bagaimana ia menangkap waktu lokal dan UTC di objek itu sendiri. Jadi pertanyaannya adalah, apa manfaat menggunakan DateTimeOffsetdibandingkan dengan apa yang telah kita lakukan?

DateTimeOffsetadalah representasi waktu sesaat (juga dikenal sebagai waktu absolut ). Maksud saya adalah momen dalam waktu yang bersifat universal untuk semua orang (tidak memperhitungkan detik kabisat , atau efek relativistik dari pelebaran waktu ). Cara lain untuk mewakili waktu sesaat adalah dengan DateTimemana .Kindadalah DateTimeKind.Utc.

Ini berbeda dari waktu kalender (juga dikenal sebagai waktu sipil ), yang merupakan posisi pada kalender seseorang, dan ada banyak kalender berbeda di seluruh dunia. Kami menyebut zona waktu kalender ini . Waktu kalender diwakili oleh DateTimemana .Kindadalah DateTimeKind.Unspecified, atau DateTimeKind.Local. Dan .Localhanya bermakna dalam skenario di mana Anda memiliki pemahaman tersirat di mana komputer yang menggunakan hasil diposisikan. (Misalnya, stasiun kerja pengguna)

Jadi, mengapa DateTimeOffsetbukan UTC DateTime? Ini semua tentang perspektif. Mari kita gunakan analogi - kita akan berpura-pura menjadi fotografer.

Bayangkan Anda berdiri di garis waktu kalender, mengarahkan kamera ke seseorang di garis waktu sesaat yang diletakkan di depan Anda. Anda mengatur kamera berdasarkan aturan zona waktu Anda - yang berubah secara berkala karena waktu musim panas, atau karena perubahan lain pada definisi hukum zona waktu Anda. (Anda tidak memiliki tangan yang mantap, jadi kamera Anda goyah.)

Orang yang berdiri di foto akan melihat dari sudut mana kamera Anda berasal. Jika orang lain mengambil foto, mereka bisa dari sudut yang berbeda. Inilah yang diwakili oleh Offsetbagian itu DateTimeOffset.

Jadi jika Anda memberi label pada kamera "Waktu Timur", terkadang Anda menunjuk dari -5, dan kadang-kadang Anda menunjuk dari -4. Ada kamera di seluruh dunia, semuanya berlabel hal yang berbeda, dan semua menunjuk pada garis waktu instan yang sama dari sudut yang berbeda. Beberapa dari mereka tepat di sebelah (atau di atas) satu sama lain, jadi hanya mengetahui offset tidak cukup untuk menentukan zona waktu yang terkait dengan waktu.

Dan bagaimana dengan UTC? Nah, itu satu-satunya kamera di luar sana yang dijamin memiliki tangan mantap. Ada di atas tripod, dengan kuat berlabuh ke tanah. Itu tidak ke mana-mana. Kami menyebut sudut pandangnya sebagai titik nol.

Jadi - apa yang dikatakan analogi ini kepada kita? Ini memberikan beberapa panduan intuitif-

• Jika Anda merepresentasikan waktu relatif terhadap tempat tertentu, wakili waktu kalender dengan a DateTime. Pastikan Anda tidak pernah mengacaukan satu kalender dengan yang lain. Unspecifiedharus menjadi asumsi Anda. Localhanya bermanfaat dari DateTime.Now. Sebagai contoh, saya mungkin mendapatkan DateTime.Nowdan menyimpannya dalam database - tetapi ketika saya mengambilnya, saya harus berasumsi bahwa itu adalah database Unspecified. Saya tidak dapat mengandalkan bahwa kalender lokal saya adalah kalender yang sama dengan aslinya.

• Jika Anda harus selalu yakin akan momen tersebut, pastikan Anda mewakili waktu instan. Gunakan DateTimeOffsetuntuk menegakkannya, atau menggunakan UTC DateTimedengan konvensi.

• Jika Anda perlu melacak waktu sesaat, tetapi Anda juga ingin tahu "Jam berapa pengguna pikir itu ada di kalender lokal mereka?" - maka Anda harus menggunakan a DateTimeOffset. Ini sangat penting untuk sistem ketepatan waktu, misalnya - baik untuk masalah teknis dan hukum.

• Jika Anda perlu memodifikasi rekaman sebelumnya DateTimeOffset- Anda tidak memiliki informasi yang cukup di offset saja untuk memastikan bahwa offset baru masih relevan bagi pengguna. Anda juga harus menyimpan pengenal zona waktu (pikirkan - Saya perlu nama kamera itu sehingga saya dapat mengambil gambar baru meskipun posisinya telah berubah).

  Juga harus ditunjukkan bahwa Noda Time memiliki representasi yang disebut ZonedDateTimeuntuk ini, sedangkan perpustakaan kelas .Net tidak memiliki hal yang serupa. Anda harus menyimpan nilai DateTimeOffsetdan TimeZoneInfo.Idnilai.

• Kadang-kadang, Anda ingin mewakili waktu kalender yang bersifat lokal untuk "siapa pun yang melihatnya". Misalnya, ketika mendefinisikan apa artinya hari ini . Hari ini selalu tengah malam hingga tengah malam, tetapi ini mewakili jumlah tumpang tindih yang hampir tak terbatas pada garis waktu sesaat. (Dalam praktiknya kami memiliki sejumlah zona waktu yang terbatas, tetapi Anda dapat mengimbangi hingga tanda centang). Jadi dalam situasi ini, pastikan Anda memahami cara membatasi "siapa yang bertanya?" pertanyaan ke zona waktu tunggal, atau berurusan dengan menerjemahkannya kembali ke waktu sesaat yang sesuai.

Berikut adalah beberapa bagian lain tentang hal DateTimeOffsetitu yang mendukung analogi ini, dan beberapa tips untuk menjaganya agar tetap lurus:

• Jika Anda membandingkan dua DateTimeOffsetnilai, mereka pertama dinormalisasi ke nol offset sebelum membandingkan. Dengan kata lain, 2012-01-01T00:00:00+00:00dan 2012-01-01T02:00:00+02:00merujuk pada momen instan yang sama, dan karenanya setara.

• Jika Anda melakukan setiap pengujian unit dan kebutuhan untuk menjadi tertentu dari offset, tes kedua yang DateTimeOffsetnilai, dan .Offsetproperti secara terpisah.

• Ada konversi implisit satu arah yang dibangun ke dalam kerangka .Net yang memungkinkan Anda mengirimkan a DateTimeke DateTimeOffsetparameter atau variabel apa pun . Ketika melakukannya, yang .Kindpenting . Jika Anda melewati jenis UTC, itu akan dibawa dengan nol offset, tetapi jika Anda melewati salah satu .Localatau .Unspecified, itu akan dianggap sebagai lokal . Kerangka kerja ini pada dasarnya mengatakan, "Ya, Anda meminta saya untuk mengubah waktu kalender menjadi waktu instan, tetapi saya tidak tahu dari mana ini berasal, jadi saya hanya akan menggunakan kalender lokal." Ini adalah masalah besar jika Anda memuat yang tidak ditentukan DateTimepada komputer dengan zona waktu yang berbeda. (IMHO - yang seharusnya melempar pengecualian - tetapi tidak.)

Plug tak tahu malu:

Banyak orang telah berbagi dengan saya bahwa mereka menganggap analogi ini sangat berharga, jadi saya memasukkannya ke dalam kursus Pluralsight saya, Fundamental Date and Time . Anda akan menemukan langkah demi langkah langkah-langkah analogi kamera dalam modul kedua, "Konteks Konteks", dalam klip berjudul "Waktu Kalender vs. Waktu Instan".

Dari Microsoft:

Penggunaan ini untuk nilai DateTimeOffset jauh lebih umum daripada yang untuk nilai DateTime. Akibatnya, DateTimeOffset harus dianggap sebagai tanggal dan jenis waktu default untuk pengembangan aplikasi.

_{sumber: "Memilih Antara DateTime, DateTimeOffset, TimeSpan, dan TimeZoneInfo" , MSDN}

Kami menggunakan DateTimeOffsethampir semua hal karena aplikasi kami berhubungan dengan titik waktu tertentu (misalnya ketika catatan dibuat / diperbarui). Sebagai catatan, kami juga menggunakan DATETIMEOFFSETSQL Server 2008.

Saya melihat DateTimeberguna ketika Anda ingin berurusan dengan kencan saja, hanya kali, atau berurusan dengan baik dalam arti umum. Misalnya, jika Anda memiliki alarm yang Anda ingin pergi setiap hari pukul 7 pagi, Anda bisa menyimpan bahwa dalam DateTimememanfaatkan DateTimeKinddari Unspecifiedkarena Anda ingin pergi pada 7:00 terlepas dari DST. Tetapi jika Anda ingin merepresentasikan riwayat kejadian alarm, Anda akan menggunakannya DateTimeOffset.

Berhati-hatilah saat menggunakan campuran DateTimeOffsetdan DateTimeterutama saat menetapkan dan membandingkan antara jenis. Selain itu, hanya bandingkan DateTimeinstance yang sama DateTimeKindkarena DateTimemengabaikan offset zona waktu saat membandingkan.

DateTime hanya mampu menyimpan dua waktu berbeda, waktu lokal dan UTC. The Kind properti yang menunjukkan.

DateTimeOffset memperluas ini dengan bisa menyimpan waktu lokal dari mana saja di dunia. Itu juga menyimpan offset antara waktu setempat dan UTC. Perhatikan bagaimana DateTime tidak dapat melakukan ini kecuali Anda menambahkan anggota tambahan ke kelas Anda untuk menyimpan offset UTC itu. Atau hanya pernah bekerja dengan UTC. Yang dengan sendirinya adalah ide yang bagus btw.

Ada beberapa tempat yang DateTimeOffsetmasuk akal. Salah satunya adalah ketika Anda berurusan dengan acara berulang dan waktu musim panas. Katakanlah saya ingin mengatur alarm untuk berbunyi jam 9 pagi setiap hari. Jika saya menggunakan aturan "store as UTC, display as time time", maka alarm akan berbunyi pada waktu yang berbeda ketika waktu musim panas berlaku.

Mungkin ada yang lain, tetapi contoh di atas sebenarnya adalah salah satu yang pernah saya temui sebelumnya (ini sebelum penambahan DateTimeOffsetBCL - solusi saya pada saat itu adalah secara eksplisit menyimpan waktu di zona waktu lokal, dan menyimpan informasi zona waktu di sampingnya: pada dasarnya apa yang DateTimeOffsetdilakukan secara internal).

Perbedaan paling penting adalah bahwa DateTime tidak menyimpan informasi zona waktu, sedangkan DateTimeOffset tidak.

Meskipun DateTime membedakan antara UTC dan Lokal, sama sekali tidak ada offset zona waktu eksplisit yang terkait dengannya. Jika Anda melakukan serialisasi atau konversi apa pun, zona waktu server akan digunakan. Bahkan jika Anda secara manual membuat waktu lokal dengan menambahkan menit untuk mengimbangi waktu UTC, Anda masih bisa mendapatkan sedikit dalam langkah serialisasi, karena (karena kurangnya offset eksplisit di DateTime) itu akan menggunakan zona waktu server offset.

Misalnya, jika Anda membuat serialisasi nilai DateTime dengan Kind = Lokal menggunakan Json.Net dan format tanggal ISO, Anda akan mendapatkan string seperti 2015-08-05T07:00:00-04. Perhatikan bahwa bagian terakhir (-04) tidak ada hubungannya dengan DateTime Anda atau offset apa pun yang Anda gunakan untuk menghitungnya ... itu hanya murni zona waktu server offset.

Sementara itu, DateTimeOffset secara eksplisit menyertakan offset. Ini mungkin tidak termasuk nama zona waktu, tetapi setidaknya itu termasuk offset, dan jika Anda membuat serial, Anda akan mendapatkan offset yang dimasukkan secara eksplisit dalam nilai Anda alih-alih apa pun waktu lokal server yang terjadi.

Sepotong kode dari Microsoft ini menjelaskan semuanya:

// Find difference between Date.Now and Date.UtcNow
  date1 = DateTime.Now;
  date2 = DateTime.UtcNow;
  difference = date1 - date2;
  Console.WriteLine("{0} - {1} = {2}", date1, date2, difference);

  // Find difference between Now and UtcNow using DateTimeOffset
  dateOffset1 = DateTimeOffset.Now;
  dateOffset2 = DateTimeOffset.UtcNow;
  difference = dateOffset1 - dateOffset2;
  Console.WriteLine("{0} - {1} = {2}", 
                    dateOffset1, dateOffset2, difference);
  // If run in the Pacific Standard time zone on 4/2/2007, the example
  // displays the following output to the console:
  //    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
  //    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00

Sebagian besar jawabannya baik, tetapi saya berpikir untuk menambahkan beberapa tautan MSDN untuk informasi lebih lanjut

• Sejarah singkat DateTime - Oleh Anthony Moore oleh tim BCL
• Memilih antara Offset Datetime dan DateTime - oleh MSDN
• Jangan lupa SQL server 2008 dan seterusnya memiliki Datatype baru sebagai DateTimeOffset
• NET Framework. Termasuk tipe DateTime , DateTimeOffset , dan TimeZoneInfo , yang semuanya dapat digunakan untuk membangun aplikasi yang bekerja dengan tanggal dan waktu.
• Melakukan Operasi Aritmatika dengan Tanggal dan Times-MSDN

Perbedaan utama adalah bahwa DateTimeOffsetdapat digunakan bersamaan dengan TimeZoneInfountuk mengkonversi ke waktu lokal di zona waktu selain yang saat ini.

Ini berguna pada aplikasi server (misalnya ASP.NET) yang diakses oleh pengguna di zona waktu yang berbeda.

Satu-satunya sisi negatif dari DateTimeOffset yang saya lihat adalah Microsoft "lupa" (sesuai desain) untuk mendukungnya di kelas XmlSerializer mereka. Tetapi sejak itu telah ditambahkan ke kelas utilitas XmlConvert.

XmlConvert.ToDateTimeOffset

XmlConvert.ToString

Saya katakan maju dan gunakan DateTimeOffset dan TimeZoneInfo karena semua manfaatnya, berhati-hatilah saat membuat entitas yang akan atau mungkin diserialisasi ke atau dari XML (semua objek bisnis).