Bagikan melalui

Mengonversi antara DateTime dan DateTimeOffset

Meskipun struktur DateTimeOffset memberikan tingkat kesadaran zona waktu yang lebih besar daripada struktur DateTime, parameter DateTime digunakan lebih umum dalam panggilan metode. Karena pendekatan ini, kemampuan untuk mengonversi nilai DateTimeOffset menjadi nilai DateTime dan sebaliknya penting. Artikel ini menunjukkan cara melakukan konversi ini dengan cara yang mempertahankan informasi zona waktu sebanyak mungkin.

Nota

Jenis DateTime dan DateTimeOffset memiliki beberapa batasan saat mewakili waktu di zona waktu. Dengan properti Kind, DateTime hanya dapat mencerminkan Waktu Universal Terkoordinasi (UTC) dan zona waktu lokal sistem. DateTimeOffset mencerminkan offset waktu dari UTC, tetapi tidak mencerminkan zona waktu aktual tempat offset tersebut berada. Untuk informasi selengkapnya tentang nilai waktu dan dukungan untuk zona waktu, lihat Memilih Antara DateTime, DateTimeOffset, TimeSpan, dan TimeZoneInfo.

Konversi dari DateTime ke DateTimeOffset

Struktur DateTimeOffset menyediakan dua cara yang setara untuk melakukan DateTime ke konversi DateTimeOffset yang cocok untuk sebagian besar konversi:

Untuk nilai UTC dan DateTime lokal, properti Offset dari nilai DateTimeOffset yang dihasilkan secara akurat mencerminkan offset UTC atau zona waktu lokal. Misalnya, kode berikut mengonversi waktu UTC ke nilai DateTimeOffset yang setara:

DateTime utcTime1 = new DateTime(2008, 6, 19, 7, 0, 0);
utcTime1 = DateTime.SpecifyKind(utcTime1, DateTimeKind.Utc);
DateTimeOffset utcTime2 = utcTime1;
Console.WriteLine($"Converted {utcTime1} {utcTime1.Kind} to a DateTimeOffset value of {utcTime2}");
// This example displays the following output to the console:
//    Converted 6/19/2008 7:00:00 AM Utc to a DateTimeOffset value of 6/19/2008 7:00:00 AM +00:00

Dim utcTime1 As Date = Date.SpecifyKind(#06/19/2008 7:00AM#, _
                                        DateTimeKind.Utc)
Dim utcTime2 As DateTimeOffset = utcTime1
Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", _
                  utcTime1, _
                  utcTime1.Kind.ToString(), _
                  utcTime2)
' This example displays the following output to the console:
'    Converted 6/19/2008 7:00:00 AM Utc to a DateTimeOffset value of 6/19/2008 7:00:00 AM +00:00

Dalam hal ini, offset variabel utcTime2 adalah 00:00. Demikian pula, kode berikut mengonversi waktu lokal ke nilai DateTimeOffset yang setara:

DateTime localTime1 = new DateTime(2008, 6, 19, 7, 0, 0);
localTime1 = DateTime.SpecifyKind(localTime1, DateTimeKind.Local);
DateTimeOffset localTime2 = localTime1;
Console.WriteLine($"Converted {localTime1} {localTime1.Kind} to a DateTimeOffset value of {localTime2}");
// This example displays the following output to the console:
//    Converted 6/19/2008 7:00:00 AM Local to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00

Dim localTime1 As Date = Date.SpecifyKind(#06/19/2008 7:00AM#, DateTimeKind.Local)
Dim localTime2 As DateTimeOffset = localTime1
Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", _
                  localTime1, _
                  localTime1.Kind.ToString(), _
                  localTime2)
' This example displays the following output to the console:
'    Converted 6/19/2008 7:00:00 AM Local to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00

Namun, untuk nilai DateTime yang properti Kind-nya DateTimeKind.Unspecified, kedua metode konversi ini menghasilkan nilai DateTimeOffset yang offset-nya adalah dari zona waktu lokal. Konversi ditampilkan dalam contoh berikut, yang dijalankan di zona Waktu Standar Pasifik A.S. :

DateTime time1 = new DateTime(2008, 6, 19, 7, 0, 0);  // Kind is DateTimeKind.Unspecified
DateTimeOffset time2 = time1;
Console.WriteLine($"Converted {time1} {time1.Kind} to a DateTimeOffset value of {time2}");
// This example displays the following output to the console:
//    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00

Dim time1 As Date = #06/19/2008 7:00AM#      ' Kind is DateTimeKind.Unspecified
Dim time2 As DateTimeOffset = time1
Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", _
                  time1, _
                  time1.Kind.ToString(), _
                  time2)
' This example displays the following output to the console:
'    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00

Jika nilai DateTime mencerminkan tanggal dan waktu dalam sesuatu selain zona waktu lokal atau UTC, Anda dapat mengonversinya menjadi nilai DateTimeOffset dan mempertahankan informasi zona waktunya dengan memanggil konstruktor DateTimeOffset yang kelebihan beban. Misalnya, contoh berikut membuat instans objek DateTimeOffset yang mencerminkan Waktu Standar Pusat:

DateTime time1 = new DateTime(2008, 6, 19, 7, 0, 0);     // Kind is DateTimeKind.Unspecified
try
{
   DateTimeOffset time2 = new DateTimeOffset(time1,
                  TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(time1));
   Console.WriteLine($"Converted {time1} {time1.Kind} to a DateTime value of {time2}");
}
// Handle exception if time zone is not defined in registry
catch (TimeZoneNotFoundException)
{
   Console.WriteLine("Unable to identify target time zone for conversion.");
}
// This example displays the following output to the console:
//    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTime value of 6/19/2008 7:00:00 AM -05:00

Dim time1 As Date = #06/19/2008 7:00AM#      ' Kind is DateTimeKind.Unspecified
Try
    Dim time2 As New DateTimeOffset(time1, _
                     TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(time1))
    Console.WriteLine("Converted {0} {1} to a DateTime value of {2}", _
                      time1, _
                      time1.Kind.ToString(), _
                      time2)
    ' Handle exception if time zone is not defined in registry
Catch e As TimeZoneNotFoundException
    Console.WriteLine("Unable to identify target time zone for conversion.")
End Try
' This example displays the following output to the console:
'    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTime value of 6/19/2008 7:00:00 AM -05:00

Parameter kedua untuk overload konstruktor ini adalah objek TimeSpan yang mewakili offset waktu dari UTC. Ambil dengan memanggil metode TimeZoneInfo.GetUtcOffset(DateTime) dari zona waktu yang sesuai dengan waktu tersebut. Parameter tunggal metode adalah nilai DateTime yang mewakili tanggal dan waktu untuk dikonversi. Jika zona waktu mendukung waktu musim panas, parameter ini memungkinkan metode untuk menentukan offset yang sesuai untuk tanggal dan waktu tertentu.

Konversi dari DateTimeOffset ke DateTime

Properti DateTime paling umum digunakan untuk mengubah DateTimeOffset menjadi DateTime. Namun, ini mengembalikan nilai DateTime yang properti Kind-nya Unspecified, seperti yang diilustrasikan contoh berikut:

DateTime baseTime = new DateTime(2008, 6, 19, 7, 0, 0);
DateTimeOffset sourceTime;
DateTime targetTime;

// Convert UTC to DateTime value
sourceTime = new DateTimeOffset(baseTime, TimeSpan.Zero);
targetTime = sourceTime.DateTime;
Console.WriteLine($"{sourceTime} converts to {targetTime} {targetTime.Kind}");

// Convert local time to DateTime value
sourceTime = new DateTimeOffset(baseTime,
                                TimeZoneInfo.Local.GetUtcOffset(baseTime));
targetTime = sourceTime.DateTime;
Console.WriteLine($"{sourceTime} converts to {targetTime} {targetTime.Kind}");

// Convert Central Standard Time to a DateTime value
try
{
   TimeSpan offset = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(baseTime);
   sourceTime = new DateTimeOffset(baseTime, offset);
   targetTime = sourceTime.DateTime;
   Console.WriteLine($"{sourceTime} converts to {targetTime} {targetTime.Kind}");
}
catch (TimeZoneNotFoundException)
{
   Console.WriteLine("Unable to create DateTimeOffset based on U.S. Central Standard Time.");
}
// This example displays the following output to the console:
//    6/19/2008 7:00:00 AM +00:00 converts to 6/19/2008 7:00:00 AM Unspecified
//    6/19/2008 7:00:00 AM -07:00 converts to 6/19/2008 7:00:00 AM Unspecified
//    6/19/2008 7:00:00 AM -05:00 converts to 6/19/2008 7:00:00 AM Unspecified

Const baseTime As Date = #06/19/2008 7:00AM#
Dim sourceTime As DateTimeOffset
Dim targetTime As Date

' Convert UTC to DateTime value
sourceTime = New DateTimeOffset(baseTime, TimeSpan.Zero)
targetTime = sourceTime.DateTime
Console.WriteLine("{0} converts to {1} {2}", _
                  sourceTime, _
                  targetTime, _
                  targetTime.Kind.ToString())

' Convert local time to DateTime value
sourceTime = New DateTimeOffset(baseTime, _
                                TimeZoneInfo.Local.GetUtcOffset(baseTime))
targetTime = sourceTime.DateTime
Console.WriteLine("{0} converts to {1} {2}", _
                  sourceTime, _
                  targetTime, _
                  targetTime.Kind.ToString())

' Convert Central Standard Time to a DateTime value
Try
    Dim offset As TimeSpan = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(baseTime)
    sourceTime = New DateTimeOffset(baseTime, offset)
    targetTime = sourceTime.DateTime
    Console.WriteLine("{0} converts to {1} {2}", _
                      sourceTime, _
                      targetTime, _
                      targetTime.Kind.ToString())
Catch e As TimeZoneNotFoundException
    Console.WriteLine("Unable to create DateTimeOffset based on U.S. Central Standard Time.")
End Try
' This example displays the following output to the console:
'    6/19/2008 7:00:00 AM +00:00 converts to 6/19/2008 7:00:00 AM Unspecified
'    6/19/2008 7:00:00 AM -07:00 converts to 6/19/2008 7:00:00 AM Unspecified
'    6/19/2008 7:00:00 AM -05:00 converts to 6/19/2008 7:00:00 AM Unspecified

Contoh sebelumnya menunjukkan bahwa informasi apa pun tentang hubungan nilai DateTimeOffset dengan UTC hilang oleh konversi saat properti DateTime digunakan. Perilaku ini juga memengaruhi nilai DateTimeOffset yang sesuai dengan waktu UTC atau waktu lokal sistem karena struktur DateTime hanya mencerminkan dua zona waktu tersebut dalam properti Kind.

Untuk mempertahankan informasi zona waktu sebanyak mungkin saat mengonversi DateTimeOffset ke nilai DateTime, Anda dapat menggunakan properti DateTimeOffset.UtcDateTime dan DateTimeOffset.LocalDateTime.

Mengonversi waktu UTC

Untuk menunjukkan bahwa nilai DateTime yang dikonversi adalah waktu UTC, Anda dapat mengambil nilai properti DateTimeOffset.UtcDateTime. Ini berbeda dari properti DateTime dengan dua cara:

Nota

Jika aplikasi Anda mengharuskan nilai DateTime yang dikonversi dengan jelas mengidentifikasi suatu titik waktu, Anda harus mempertimbangkan untuk menggunakan properti DateTimeOffset.UtcDateTime untuk menangani semua konversi dari DateTimeOffset ke DateTime.

Kode berikut menggunakan properti UtcDateTime untuk mengonversi nilai DateTimeOffset yang offsetnya sama dengan TimeSpan.Zero dengan nilai DateTime:

DateTimeOffset utcTime1 = new DateTimeOffset(2008, 6, 19, 7, 0, 0, TimeSpan.Zero);
DateTime utcTime2 = utcTime1.UtcDateTime;
Console.WriteLine($"{utcTime1} converted to {utcTime2} {utcTime2.Kind}");
// The example displays the following output to the console:
//   6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc

Dim utcTime1 As New DateTimeOffset(#06/19/2008 7:00AM#, TimeSpan.Zero)
Dim utcTime2 As Date = utcTime1.UtcDateTime
Console.WriteLine("{0} converted to {1} {2}", _
                  utcTime1, _
                  utcTime2, _
                  utcTime2.Kind.ToString())
' The example displays the following output to the console:
'   6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc

Kode berikut menggunakan properti UtcDateTime untuk melakukan konversi zona waktu dan konversi jenis pada nilai DateTimeOffset:

DateTimeOffset originalTime = new DateTimeOffset(2008, 6, 19, 7, 0, 0, new TimeSpan(5, 0, 0));
DateTime utcTime = originalTime.UtcDateTime;
Console.WriteLine($"{originalTime} converted to {utcTime} {utcTime.Kind}");
// The example displays the following output to the console:
//       6/19/2008 7:00:00 AM +05:00 converted to 6/19/2008 2:00:00 AM Utc

Dim originalTime As New DateTimeOffset(#6/19/2008 7:00AM#, _
                                       New TimeSpan(5, 0, 0))
Dim utcTime As Date = originalTime.UtcDateTime
Console.WriteLine("{0} converted to {1} {2}", _
                  originalTime, _
                  utcTime, _
                  utcTime.Kind.ToString())
' The example displays the following output to the console:
'       6/19/2008 7:00:00 AM +05:00 converted to 6/19/2008 2:00:00 AM Utc

Mengubah waktu lokal

Untuk menunjukkan bahwa nilai DateTimeOffset mewakili waktu lokal, Anda dapat meneruskan nilai DateTime yang dikembalikan oleh properti DateTimeOffset.DateTime ke metode SpecifyKindstatic (Shared di Visual Basic). Metode ini mengembalikan tanggal dan waktu yang diteruskan kepadanya sebagai parameter pertama dan mengatur properti Kind ke nilai yang ditentukan oleh parameter kedua. Kode berikut menggunakan metode SpecifyKind saat mengonversi nilai DateTimeOffset yang offsetnya sesuai dengan zona waktu lokal:

DateTime sourceDate = new DateTime(2008, 6, 19, 7, 0, 0);
DateTimeOffset utcTime1 = new DateTimeOffset(sourceDate,
                          TimeZoneInfo.Local.GetUtcOffset(sourceDate));
DateTime utcTime2 = utcTime1.DateTime;
if (utcTime1.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(utcTime1.DateTime)))
   utcTime2 = DateTime.SpecifyKind(utcTime2, DateTimeKind.Local);

Console.WriteLine($"{utcTime1} converted to {utcTime2} {utcTime2.Kind}");
// The example displays the following output to the console:
//   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local

Dim sourceDate As Date = #06/19/2008 7:00AM#
Dim utcTime1 As New DateTimeOffset(sourceDate, _
                                   TimeZoneInfo.Local.GetUtcOffset(sourceDate))
Dim utcTime2 As Date = utcTime1.DateTime
If utcTime1.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(utcTime1.DateTime)) Then
    utcTime2 = DateTime.SpecifyKind(utcTime2, DateTimeKind.Local)
End If
Console.WriteLine("{0} converted to {1} {2}", _
                  utcTime1, _
                  utcTime2, _
                  utcTime2.Kind.ToString())
' The example displays the following output to the console:
'   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local

Anda juga dapat menggunakan properti DateTimeOffset.LocalDateTime untuk mengonversi nilai DateTimeOffset menjadi nilai DateTime lokal. Properti Kind dari nilai DateTime yang dikembalikan adalah Local. Kode berikut menggunakan properti DateTimeOffset.LocalDateTime saat mengonversi nilai DateTimeOffset yang offsetnya sesuai dengan zona waktu lokal:

DateTime sourceDate = new DateTime(2008, 6, 19, 7, 0, 0);
DateTimeOffset localTime1 = new DateTimeOffset(sourceDate,
                          TimeZoneInfo.Local.GetUtcOffset(sourceDate));
DateTime localTime2 = localTime1.LocalDateTime;

Console.WriteLine($"{localTime1} converted to {localTime2} {localTime2.Kind}");
// The example displays the following output to the console:
//   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local

Dim sourceDate As Date = #06/19/2008 7:00AM#
Dim localTime1 As New DateTimeOffset(sourceDate, _
                                   TimeZoneInfo.Local.GetUtcOffset(sourceDate))
Dim localTime2 As Date = localTime1.LocalDateTime
Console.WriteLine("{0} converted to {1} {2}", _
                  localTime1, _
                  localTime2, _
                  localTime2.Kind.ToString())
' The example displays the following output to the console:
'   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local

Saat Anda mengambil nilai DateTime menggunakan properti DateTimeOffset.LocalDateTime, aksesor get properti terlebih dahulu mengonversi nilai DateTimeOffset menjadi UTC, lalu mengonversinya ke waktu lokal dengan memanggil metode ToLocalTime. Perilaku ini berarti Anda dapat mengambil nilai dari properti DateTimeOffset.LocalDateTime untuk melakukan konversi zona waktu secara bersamaan saat Anda melakukan konversi jenis. Ini juga berarti bahwa aturan penyesuaian zona waktu lokal diterapkan dalam melakukan konversi. Kode berikut mengilustrasikan penggunaan properti DateTimeOffset.LocalDateTime untuk melakukan konversi jenis dan zona waktu. Output sampel adalah untuk komputer yang diatur ke Zona Waktu Pasifik (AS dan Kanada). Tanggal November adalah Waktu Standar Pasifik, yaitu UTC-8, sedangkan tanggal Juni adalah Daylight Savings Time, yaitu UTC-7.

DateTimeOffset originalDate;
DateTime localDate;

// Convert time originating in a different time zone
originalDate = new DateTimeOffset(2008, 6, 18, 7, 0, 0,
                                  new TimeSpan(-5, 0, 0));
localDate = originalDate.LocalDateTime;
Console.WriteLine($"{originalDate} converted to {localDate} {localDate.Kind}");
// Convert time originating in a different time zone
// so local time zone's adjustment rules are applied
originalDate = new DateTimeOffset(2007, 11, 4, 4, 0, 0,
                                  new TimeSpan(-5, 0, 0));
localDate = originalDate.LocalDateTime;
Console.WriteLine($"{originalDate} converted to {localDate} {localDate.Kind}");
// The example displays the following output to the console,
// when you run it on a machine that is set to Pacific Time (US & Canada):
//       6/18/2008 7:00:00 AM -05:00 converted to 6/18/2008 5:00:00 AM Local
//       11/4/2007 4:00:00 AM -05:00 converted to 11/4/2007 1:00:00 AM Local

Dim originalDate As DateTimeOffset
Dim localDate As Date

' Convert time originating in a different time zone
originalDate = New DateTimeOffset(#06/19/2008 7:00AM#, _
                                  New TimeSpan(-5, 0, 0))
localDate = originalDate.LocalDateTime
Console.WriteLine("{0} converted to {1} {2}", _
                  originalDate, _
                  localDate, _
                  localDate.Kind.ToString())
' Convert time originating in a different time zone 
' so local time zone's adjustment rules are applied
originalDate = New DateTimeOffset(#11/04/2007 4:00AM#, _
                                  New TimeSpan(-5, 0, 0))
localDate = originalDate.LocalDateTime
Console.WriteLine("{0} converted to {1} {2}", _
                  originalDate, _
                  localDate, _
                  localDate.Kind.ToString())
' The example displays the following output to the console,
' when you run it on a machine that is set to Pacific Time (US & Canada):
'       6/18/2008 7:00:00 AM -05:00 converted to 6/18/2008 5:00:00 AM Local
'       11/4/2007 4:00:00 AM -05:00 converted to 11/4/2007 1:00:00 AM Local

Metode konversi serbaguna

Contoh berikut menentukan metode bernama ConvertFromDateTimeOffset yang mengonversi nilai DateTimeOffset menjadi nilai DateTime. Berdasarkan offsetnya, ini menentukan apakah nilai DateTimeOffset adalah waktu UTC, waktu lokal, atau waktu lainnya dan menetapkan properti Kind dari nilai tanggal dan waktu yang dikembalikan sesuai dengan penentuannya.

static DateTime ConvertFromDateTimeOffset(DateTimeOffset dateTime)
{
   if (dateTime.Offset.Equals(TimeSpan.Zero))
      return dateTime.UtcDateTime;
   else if (dateTime.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(dateTime.DateTime)))
      return DateTime.SpecifyKind(dateTime.DateTime, DateTimeKind.Local);
   else
      return dateTime.DateTime;
}

Function ConvertFromDateTimeOffset(dateTime As DateTimeOffset) As Date
    If dateTime.Offset.Equals(TimeSpan.Zero) Then
        Return dateTime.UtcDateTime
    ElseIf dateTime.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(dateTime.DateTime))
        Return Date.SpecifyKind(dateTime.DateTime, DateTimeKind.Local)
    Else
        Return dateTime.DateTime
    End If
End Function

Contoh berikut memanggil metode ConvertFromDateTimeOffset untuk mengonversi nilai DateTimeOffset yang mewakili waktu UTC, waktu lokal, dan waktu di zona Waktu Standar Pusat AS.

DateTime timeComponent = new DateTime(2008, 6, 19, 7, 0, 0);
DateTime returnedDate;

// Convert UTC time
DateTimeOffset utcTime = new DateTimeOffset(timeComponent, TimeSpan.Zero);
returnedDate = ConvertFromDateTimeOffset(utcTime);
Console.WriteLine($"{utcTime} converted to {returnedDate} {returnedDate.Kind}");

// Convert local time
DateTimeOffset localTime = new DateTimeOffset(timeComponent,
                           TimeZoneInfo.Local.GetUtcOffset(timeComponent));
returnedDate = ConvertFromDateTimeOffset(localTime);
Console.WriteLine($"{localTime} converted to {returnedDate} {returnedDate.Kind}");

// Convert Central Standard Time
DateTimeOffset cstTime = new DateTimeOffset(timeComponent,
               TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(timeComponent));
returnedDate = ConvertFromDateTimeOffset(cstTime);
Console.WriteLine($"{cstTime} converted to {returnedDate} {returnedDate.Kind}");
// The example displays the following output to the console:
//    6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc
//    6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local
//    6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 7:00:00 AM Unspecified

Dim timeComponent As Date = #06/19/2008 7:00AM#
Dim returnedDate As Date

' Convert UTC time
Dim utcTime As New DateTimeOffset(timeComponent, TimeSpan.Zero)
returnedDate = ConvertFromDateTimeOffset(utcTime)
Console.WriteLine("{0} converted to {1} {2}", _
                  utcTime, _
                  returnedDate, _
                  returnedDate.Kind.ToString())

' Convert local time
Dim localTime As New DateTimeOffset(timeComponent, _
                                    TimeZoneInfo.Local.GetUtcOffset(timeComponent))
returnedDate = ConvertFromDateTimeOffset(localTime)
Console.WriteLine("{0} converted to {1} {2}", _
                  localTime, _
                  returnedDate, _
                  returnedDate.Kind.ToString())

' Convert Central Standard Time
Dim cstTime As New DateTimeOffset(timeComponent, _
               TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(timeComponent))
returnedDate = ConvertFromDateTimeOffset(cstTime)
Console.WriteLine("{0} converted to {1} {2}", _
                  cstTime, _
                  returnedDate, _
                  returnedDate.Kind.ToString())
' The example displays the following output to the console:
'    6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc
'    6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local
'    6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 7:00:00 AM Unspecified

Nota

Kode membuat dua asumsi berikut, tergantung pada aplikasi dan sumber nilai tanggal dan waktunya, mungkin tidak selalu valid:

  • Ini mengasumsikan bahwa nilai tanggal dan waktu yang offsetnya TimeSpan.Zero mewakili UTC. Faktanya, UTC bukan waktu di zona waktu tertentu, tetapi waktu yang menjadi acuan bagi standar waktu di zona waktu dunia. Zona waktu juga dapat memiliki offset Zero.

  • Ini mengasumsikan bahwa tanggal dan waktu yang offsetnya sama dengan zona waktu lokal mewakili zona waktu lokal. Karena nilai tanggal dan waktu tidak terhubung dengan zona waktu aslinya, hal ini mungkin tidak terjadi; tanggal dan waktu mungkin berasal dari zona waktu lain dengan perbedaan waktu yang sama.

Lihat juga

  • Last updated on