TimeZoneInfo.IsAmbiguousTime Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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
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.