TimeZoneInfo.IsAmbiguousTime Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Menentukan apakah tanggal dan waktu tertentu dalam zona waktu tertentu ambigu dan dapat dipetakan ke dua atau lebih waktu Waktu Universal Terkoordinasi (UTC).

Overload

IsAmbiguousTime(DateTime)	Menentukan apakah tanggal dan waktu tertentu dalam zona waktu tertentu ambigu dan dapat dipetakan ke dua atau lebih waktu Waktu Universal Terkoordinasi (UTC).
IsAmbiguousTime(DateTimeOffset)	Menentukan apakah tanggal dan waktu tertentu dalam zona waktu tertentu ambigu dan dapat dipetakan ke dua atau lebih waktu Waktu Universal Terkoordinasi (UTC).

IsAmbiguousTime(DateTime)

Sumber:

TimeZoneInfo.cs

Menentukan apakah tanggal dan waktu tertentu dalam zona waktu tertentu ambigu dan dapat dipetakan ke dua atau lebih waktu Waktu Universal Terkoordinasi (UTC).

public:
 bool IsAmbiguousTime(DateTime dateTime);

public bool IsAmbiguousTime (DateTime dateTime);

member this.IsAmbiguousTime : DateTime -> bool

Public Function IsAmbiguousTime (dateTime As DateTime) As Boolean

Parameter

dateTime

DateTime

Nilai tanggal dan waktu.

Mengembalikan

Boolean

true dateTime jika parameter ambigu; jika tidak, false.

Pengecualian

ArgumentException

Properti Kind nilai dateTime adalah Local dan dateTime merupakan waktu yang tidak valid.

Contoh

Di zona Waktu Pasifik, waktu musim panas berakhir pada 02:00 pada 4 November 2007. Contoh berikut meneruskan waktu pada interval satu menit dari 12:59 A.M. pada 4 November 2007, hingga 02:01 A.M. pada 4 November 2007, ke IsAmbiguousTime(DateTime) metode TimeZoneInfo objek yang mewakili zona Waktu Pasifik. Output konsol menunjukkan bahwa sepanjang waktu dari 1:00 A.M. pada 4 November 2007, hingga 1:59 A.M. pada 4 November 2007, ambigu.

   // Specify DateTimeKind in Date constructor
   DateTime baseTime = new DateTime(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified);
   DateTime newTime;

   // Get Pacific Standard Time zone
   TimeZoneInfo pstZone = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time");

   // List possible ambiguous times for 63-minute interval, from 12:59 AM to 2:01 AM 
   for (int ctr = 0; ctr < 63; ctr++)
   {
      // Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
      newTime = baseTime.AddMinutes(ctr);   
      Console.WriteLine("{0} is ambiguous: {1}", newTime, pstZone.IsAmbiguousTime(newTime));
   }

// Specify DateTimeKind in Date constructor
let baseTime = DateTime(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified)

// Get Pacific Standard Time zone
let pstZone = TimeZoneInfo.FindSystemTimeZoneById "Pacific Standard Time"

// List possible ambiguous times for 63-minute interval, from 12:59 AM to 2:01 AM 
for i = 0 to 62 do
// Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
    let newTime = baseTime.AddMinutes i   
    printfn $"{newTime} is ambiguous: {pstZone.IsAmbiguousTime newTime}"

' Specify DateTimeKind in Date constructor
Dim baseTime As New Date(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified)
Dim newTime As Date

' Get Pacific Standard Time zone
Dim pstZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time")

' List possible ambiguous times for 63-minute interval, from 12:59 AM to 2:01 AM 
For ctr As Integer = 0 To 62
   ' Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
   newTime = baseTime.AddMinutes(ctr)   
   Console.WriteLine("{0} is ambiguous: {1}", newTime, pstZone.IsAmbiguousTime(newTime))
Next

Keterangan

Waktu yang ambigu berada dalam rentang waktu untuk zona waktu saat ini. Ini berarti dapat berupa waktu standar atau waktu yang dihasilkan dari penerapan aturan penyesuaian. Biasanya, waktu ambigu menghasilkan ketika jam diatur untuk kembali ke waktu standar dari waktu musim panas. Lihat bagian Contoh untuk ilustrasi.

Waktu Universal Terkoordinasi (UTC) tidak memiliki waktu ambigu; tidak melakukan zona waktu yang tidak mendukung waktu musim panas. Oleh karena itu, zona waktu ini tidak memiliki aturan penyesuaian dan panggilan ke IsAmbiguousTime metode selalu mengembalikan false.

Untuk zona waktu yang mengamati waktu musim panas, perilaku yang tepat dari metode ini tergantung pada hubungan antara Kind properti dan TimeZoneInfo objek , seperti yang ditunjukkan tabel berikut.

Jenis objek TimeZoneInfo	Jenis nilai properti	Aktivitas
TimeZoneInfo.Local	DateTimeKind.Local atau DateTimeKind.Unspecified	Menentukan apakah dateTime parameter ambigu.
TimeZoneInfo.Local	DateTimeKind.Utc	dateTime Mengonversi ke waktu lokal lalu menentukan apakah waktu tersebut ambigu.
TimeZoneInfo.Utc	DateTimeKind.Utc atau DateTimeKind.Unspecified	Menampilkan false.
TimeZoneInfo.Utc	DateTimeKind.Local	Jika dateTime ambigu, asumsikan itu adalah waktu standar, mengonversinya menjadi UTC, dan mengembalikan false.
Zona waktu lainnya.	DateTimeKind.Local atau DateTimeKind.Utc	dateTime Mengonversi ke waktu dalam zona waktu yang ditentukan lalu menentukan apakah waktu tersebut ambigu.
Zona waktu lainnya.	DateTimeKind.Unspecified	Menentukan apakah dateTime ambigu.

Lihat juga

• IsInvalidTime(DateTime)

IsAmbiguousTime(DateTimeOffset)

Sumber:

TimeZoneInfo.cs

Menentukan apakah tanggal dan waktu tertentu dalam zona waktu tertentu ambigu dan dapat dipetakan ke dua atau lebih waktu Waktu Universal Terkoordinasi (UTC).

public:
 bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);

public bool IsAmbiguousTime (DateTimeOffset dateTimeOffset);

member this.IsAmbiguousTime : DateTimeOffset -> bool

Public Function IsAmbiguousTime (dateTimeOffset As DateTimeOffset) As Boolean

Parameter

dateTimeOffset

DateTimeOffset

Tanggal dan waktu.

Mengembalikan

Boolean

true dateTimeOffset jika parameter ambigu di zona waktu saat ini; jika tidak, false.

Keterangan

Waktu yang ambigu berada dalam rentang waktu untuk zona waktu saat ini. Ini berarti bahwa itu bisa berupa waktu standar atau waktu yang dihasilkan dari penerapan aturan penyesuaian. Biasanya, waktu ambigu menghasilkan ketika jam diatur untuk kembali ke waktu standar dari waktu musim panas. Waktu Universal Terkoordinasi (UTC) tidak memiliki waktu ambigu; tidak melakukan zona waktu yang tidak mendukung waktu musim panas.

Perilaku yang tepat dari metode tergantung pada hubungan antara Offset properti dateTimeOffset parameter dan zona waktu saat ini. Jika nilai Offset properti adalah offset yang mungkin dari UTC zona waktu saat ini, metode menentukan apakah tanggal dan waktu tersebut ambigu. Jika tidak, itu mengonversi dateTimeOffset ke waktu di zona waktu saat ini, dan kemudian menentukan apakah tanggal dan waktu tersebut ambigu.