TimeZoneInfo.IsAmbiguousTime Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Určuje, zda je určité datum a čas v určitém časovém pásmu nejednoznačné a může být namapováno na dva nebo více časů koordinovaného univerzálního času (UTC).

Přetížení

Name	Description
IsAmbiguousTime(DateTime)	Určuje, zda je určité datum a čas v určitém časovém pásmu nejednoznačné a může být namapováno na dva nebo více časů koordinovaného univerzálního času (UTC).
IsAmbiguousTime(DateTimeOffset)	Určuje, zda je určité datum a čas v určitém časovém pásmu nejednoznačné a může být namapováno na dva nebo více časů koordinovaného univerzálního času (UTC).

IsAmbiguousTime(DateTime)

Zdroj:

TimeZoneInfo.cs

Určuje, zda je určité datum a čas v určitém časovém pásmu nejednoznačné a může být namapováno na dva nebo více časů koordinovaného univerzálního času (UTC).

public:
 bool IsAmbiguousTime(DateTime dateTime);

public bool IsAmbiguousTime(DateTime dateTime);

member this.IsAmbiguousTime : DateTime -> bool

Public Function IsAmbiguousTime (dateTime As DateTime) As Boolean

Parametry

dateTime

DateTime

Hodnota data a času.

Návraty

Boolean

true dateTime pokud je parametr nejednoznačný; v opačném případě false.

Výjimky

ArgumentException

Vlastnost KinddateTime hodnoty je Local a dateTime je neplatná doba.

Příklady

V tichomořském časovém pásmu končí letní čas v 2:00 4. listopadu 2007. Následující příklad předává čas v minutových intervalech od 12:59 do 4. listopadu 2007 do 2:01.01. listopadu 2007 do IsAmbiguousTime(DateTime) metody TimeZoneInfo objektu, který představuje tichomoří časové pásmo. Výstup konzoly označuje, že 4. listopadu 2007 do 1:59 do 4. listopadu 2007 jsou nejednoznačné časy od 1:00 do 4. listopadu 2007.

   // 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

Poznámky

Nejednoznačný čas spadá do časového rozsahu aktuálního časového pásma. To znamená, že může být buď standardní čas, nebo čas, který je výsledkem použití pravidla úpravy. Obvykle je výsledkem nejednoznačných časů, kdy se hodiny nastaví tak, aby se vrátily na standardní čas z letního času. Obrázek najdete v části Příklad.

Koordinovaný univerzální čas (UTC) nemá nejednoznačný čas; ani časová pásma, která nepodporují letní čas. Proto tato časová pásma nemají žádná pravidla úpravy a volání IsAmbiguousTime metody vždy vrátit false.

U časových pásem, které sledují letní čas, přesné chování této metody závisí na relaci mezi Kind vlastností a TimeZoneInfo objektem, jak ukazuje následující tabulka.

Typ objektu TimeZoneInfo	Hodnota vlastnosti Kind	Chování
TimeZoneInfo.Local	DateTimeKind.Local nebo DateTimeKind.Unspecified	Určuje, zda dateTime je parametr nejednoznačný.
TimeZoneInfo.Local	DateTimeKind.Utc	dateTime Převede na místní čas a pak určí, zda je tento čas nejednoznačný.
TimeZoneInfo.Utc	DateTimeKind.Utc nebo DateTimeKind.Unspecified	Vrátí false.
TimeZoneInfo.Utc	DateTimeKind.Local	Pokud dateTime je nejednoznačný, předpokládá se, že se jedná o standardní čas, převede ho na UTC a vrátí false.
Jakékoli jiné časové pásmo.	DateTimeKind.Local nebo DateTimeKind.Utc	dateTime Převede na čas v zadaném časovém pásmu a pak určí, jestli je tento čas nejednoznačný.
Jakékoli jiné časové pásmo.	DateTimeKind.Unspecified	Určuje, zda dateTime je nejednoznačný.

Viz také

• IsInvalidTime(DateTime)

IsAmbiguousTime(DateTimeOffset)

Zdroj:

TimeZoneInfo.cs

Určuje, zda je určité datum a čas v určitém časovém pásmu nejednoznačné a může být namapováno na dva nebo více časů koordinovaného univerzálního času (UTC).

public:
 bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);

public bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);

member this.IsAmbiguousTime : DateTimeOffset -> bool

Public Function IsAmbiguousTime (dateTimeOffset As DateTimeOffset) As Boolean

Parametry

dateTimeOffset

DateTimeOffset

Datum a čas.

Návraty

Boolean

true dateTimeOffset pokud je parametr nejednoznačný v aktuálním časovém pásmu; v opačném případě false.

Poznámky

Nejednoznačný čas spadá do časového rozsahu aktuálního časového pásma. To znamená, že může být buď standardní čas, nebo čas, který je výsledkem použití pravidla úpravy. Obvykle je výsledkem nejednoznačných časů, kdy se hodiny nastaví tak, aby se vrátily na standardní čas z letního času. Koordinovaný univerzální čas (UTC) nemá nejednoznačný čas; ani časová pásma, která nepodporují letní čas.

Přesné chování metody závisí na vztahu mezi Offset vlastností parametru dateTimeOffset a aktuálním časovým pásmem. Pokud je hodnota Offset vlastnosti možnou posunem od času UTC aktuálního časového pásma, metoda určuje, zda je toto datum a čas nejednoznačné. V opačném případě se převede dateTimeOffset na čas v aktuálním časovém pásmu a pak určí, zda je toto datum a čas nejednoznačné.