Taal

TimeZoneInfo.IsAmbiguousTime Methode

Definitie

Bepaalt of een bepaalde datum en tijd in een bepaalde tijdzone dubbelzinnig is en kan worden toegewezen aan twee of meer UTC-tijden (Coordinated Universal Time).

Overloads

Name Description
IsAmbiguousTime(DateTime)

Bepaalt of een bepaalde datum en tijd in een bepaalde tijdzone dubbelzinnig is en kan worden toegewezen aan twee of meer UTC-tijden (Coordinated Universal Time).

IsAmbiguousTime(DateTimeOffset)

Bepaalt of een bepaalde datum en tijd in een bepaalde tijdzone dubbelzinnig is en kan worden toegewezen aan twee of meer UTC-tijden (Coordinated Universal Time).

IsAmbiguousTime(DateTime)

Bron:
TimeZoneInfo.cs
Bron:
TimeZoneInfo.cs
Bron:
TimeZoneInfo.cs
Bron:
TimeZoneInfo.cs
Bron:
TimeZoneInfo.cs

Bepaalt of een bepaalde datum en tijd in een bepaalde tijdzone dubbelzinnig is en kan worden toegewezen aan twee of meer UTC-tijden (Coordinated Universal Time).

public:
 bool IsAmbiguousTime(DateTime dateTime);
public bool IsAmbiguousTime(DateTime dateTime);
member this.IsAmbiguousTime : DateTime -> bool
Public Function IsAmbiguousTime (dateTime As DateTime) As Boolean

Parameters

dateTime
DateTime

Een datum- en tijdwaarde.

Retouren

trueals de dateTime parameter niet eenduidig is; anders. false

Uitzonderingen

De Kind eigenschap van de dateTime waarde is Local en dateTime is een ongeldig tijdstip.

Voorbeelden

In de Pacific Time-zone eindigt de zomertijd om 2:00 uur op 4 november 2007. In het volgende voorbeeld wordt de tijd met intervallen van 12:59 uur op 4 november 2007 doorgegeven aan 2:01 uur op 4 november 2007, aan de IsAmbiguousTime(DateTime) methode van een TimeZoneInfo object dat de Pacific Time-zone vertegenwoordigt. De console-uitvoer geeft aan dat alle tijden van 1:00 uur op 4 november 2007 tot 1:59 uur op 4 november 2007 dubbelzinnig zijn.

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

Opmerkingen

Een dubbelzinnige tijd valt binnen een tijdsbereik voor de huidige tijdzone. Dit betekent dat het een standaardtijd of een tijd kan zijn die het gevolg is van de toepassing van een aanpassingsregel. Meestal resulteren dubbelzinnige tijden wanneer de klok is ingesteld om terug te keren naar de standaardtijd van zomertijd. Zie de sectie Voorbeeld voor een afbeelding.

Coordinated Universal Time (UTC) heeft geen dubbelzinnige tijden; geen tijdzones die geen zomertijd ondersteunen. Daarom hebben deze tijdzones geen aanpassingsregels en worden aanroepen naar de IsAmbiguousTime methode altijd geretourneerd false.

Voor tijdzones die wel zomertijd observeren, is het precieze gedrag van deze methode afhankelijk van de relatie tussen de Kind eigenschap en het TimeZoneInfo object, zoals in de volgende tabel wordt weergegeven.

Objecttype TimeZoneInfo Waarde van type eigenschap Gedrag
TimeZoneInfo.Local DateTimeKind.Local of DateTimeKind.Unspecified Bepaalt of de dateTime parameter niet eenduidig is.
TimeZoneInfo.Local DateTimeKind.Utc Converteert dateTime naar de lokale tijd en bepaalt vervolgens of die tijd dubbelzinnig is.
TimeZoneInfo.Utc DateTimeKind.Utc of DateTimeKind.Unspecified Retourneert false.
TimeZoneInfo.Utc DateTimeKind.Local Als dateTime dubbelzinnig is, wordt ervan uitgegaan dat het een standaardtijd is, converteert naar UTC en retourneert false.
Elke andere tijdzone. DateTimeKind.Local of DateTimeKind.Utc Converteert dateTime naar de tijd in de opgegeven tijdzone en bepaalt vervolgens of die tijd dubbelzinnig is.
Elke andere tijdzone. DateTimeKind.Unspecified Bepaalt of dateTime dubbelzinnig is.

Zie ook

Van toepassing op

IsAmbiguousTime(DateTimeOffset)

Bron:
TimeZoneInfo.cs
Bron:
TimeZoneInfo.cs
Bron:
TimeZoneInfo.cs
Bron:
TimeZoneInfo.cs
Bron:
TimeZoneInfo.cs

Bepaalt of een bepaalde datum en tijd in een bepaalde tijdzone dubbelzinnig is en kan worden toegewezen aan twee of meer UTC-tijden (Coordinated Universal Time).

public:
 bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);
public bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);
member this.IsAmbiguousTime : DateTimeOffset -> bool
Public Function IsAmbiguousTime (dateTimeOffset As DateTimeOffset) As Boolean

Parameters

dateTimeOffset
DateTimeOffset

Een datum en tijd.

Retouren

true als de dateTimeOffset parameter niet eenduidig is in de huidige tijdzone; falseanders.

Opmerkingen

Een dubbelzinnige tijd valt binnen een tijdsbereik voor de huidige tijdzone. Dit betekent dat het een standaardtijd of een tijd kan zijn die het gevolg is van de toepassing van een aanpassingsregel. Meestal resulteren dubbelzinnige tijden wanneer de klok is ingesteld om terug te keren naar de standaardtijd van zomertijd. Coordinated Universal Time (UTC) heeft geen dubbelzinnige tijden; geen tijdzones die geen zomertijd ondersteunen.

Het precieze gedrag van de methode is afhankelijk van de relatie tussen de Offset eigenschap van de dateTimeOffset parameter en de huidige tijdzone. Als de waarde van de Offset eigenschap een mogelijke verschuiving is ten opzichte van de UTC van de huidige tijdzone, bepaalt de methode of die datum en tijd niet eenduidig zijn. Anders wordt deze geconverteerd dateTimeOffset naar de tijd in de huidige tijdzone en wordt vervolgens bepaald of die datum en tijd niet eenduidig zijn.

Van toepassing op