TimeZoneInfo.IsAmbiguousTime Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Détermine si une valeur de date et heure particulière pour un fuseau horaire particulier est ambiguë et s'il est possible de la mapper à deux heures ou plus du temps universel coordonné (UTC, Universal Time Coordinated).

Surcharges

IsAmbiguousTime(DateTime)	Détermine si une valeur de date et heure particulière pour un fuseau horaire particulier est ambiguë et s'il est possible de la mapper à deux heures ou plus du temps universel coordonné (UTC, Universal Time Coordinated).
IsAmbiguousTime(DateTimeOffset)	Détermine si une valeur de date et heure particulière pour un fuseau horaire particulier est ambiguë et s'il est possible de la mapper à deux heures ou plus du temps universel coordonné (UTC, Universal Time Coordinated).

IsAmbiguousTime(DateTime)

Source:

TimeZoneInfo.cs

Détermine si une valeur de date et heure particulière pour un fuseau horaire particulier est ambiguë et s'il est possible de la mapper à deux heures ou plus du temps universel coordonné (UTC, Universal Time Coordinated).

public:
 bool IsAmbiguousTime(DateTime dateTime);

public bool IsAmbiguousTime (DateTime dateTime);

member this.IsAmbiguousTime : DateTime -> bool

Public Function IsAmbiguousTime (dateTime As DateTime) As Boolean

Paramètres

dateTime

DateTime

Valeur de date et heure.

Retours

Boolean

true si le paramètre dateTime est ambigu ; sinon, false.

Exceptions

ArgumentException

La propriété Kind de la valeur dateTime est Local et dateTime est une date/heure non valide.

Exemples

Dans le fuseau horaire du Pacifique, l’heure d’été se termine à 2 h 00 le 4 novembre 2007. L’exemple suivant passe l’heure à intervalles d’une minute, de 12 h 59 le 4 novembre 2007 à 2 h 01 le 4 novembre 2007, à la IsAmbiguousTime(DateTime) méthode d’un TimeZoneInfo objet qui représente le fuseau horaire pacifique. La sortie de la console indique que toutes les heures comprises entre 1 h 00 le 4 novembre 2007 et 13 h 59 le 4 novembre 2007 sont ambiguës.

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

Remarques

Une heure ambiguë se situe dans une plage d’heures pour le fuseau horaire actuel. Cela signifie qu’il peut s’agir d’une heure standard ou d’une heure résultant de l’application d’une règle d’ajustement. En règle générale, les heures ambiguës se traduisent lorsque l’horloge est définie pour revenir à l’heure standard à partir de l’heure d’été. Pour obtenir une illustration, consultez la section Exemple.

Le temps universel coordonné (UTC) n’a pas d’heures ambiguës; ni les fuseaux horaires qui ne prennent pas en charge l’heure d’été. Par conséquent, ces fuseaux horaires n’ont pas de règles d’ajustement et les appels à la IsAmbiguousTime méthode retournent falsetoujours .

Pour les fuseaux horaires qui observent l’heure d’été, le comportement précis de cette méthode dépend de la relation entre la Kind propriété et l’objet TimeZoneInfo , comme le montre le tableau suivant.

Type d’objet TimeZoneInfo	Valeur de la propriété kind	Comportement
TimeZoneInfo.Local	DateTimeKind.Local ou DateTimeKind.Unspecified	Détermine si le dateTime paramètre est ambigu.
TimeZoneInfo.Local	DateTimeKind.Utc	dateTime Convertit en heure locale, puis détermine si cette heure est ambiguë.
TimeZoneInfo.Utc	DateTimeKind.Utc ou DateTimeKind.Unspecified	Retourne false.
TimeZoneInfo.Utc	DateTimeKind.Local	Si dateTime est ambigu, suppose qu’il s’agit d’une heure standard, la convertit en UTC et retourne false.
Tout autre fuseau horaire.	DateTimeKind.Local ou DateTimeKind.Utc	dateTime Convertit en heure dans le fuseau horaire spécifié, puis détermine si cette heure est ambiguë.
Tout autre fuseau horaire.	DateTimeKind.Unspecified	Détermine si dateTime est ambigu.

Voir aussi

• IsInvalidTime(DateTime)

IsAmbiguousTime(DateTimeOffset)

Source:

TimeZoneInfo.cs

Détermine si une valeur de date et heure particulière pour un fuseau horaire particulier est ambiguë et s'il est possible de la mapper à deux heures ou plus du temps universel coordonné (UTC, Universal Time Coordinated).

public:
 bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);

public bool IsAmbiguousTime (DateTimeOffset dateTimeOffset);

member this.IsAmbiguousTime : DateTimeOffset -> bool

Public Function IsAmbiguousTime (dateTimeOffset As DateTimeOffset) As Boolean

Paramètres

dateTimeOffset

DateTimeOffset

Date et heure.

Retours

Boolean

true si le paramètre dateTimeOffset est ambigu dans le fuseau horaire actuel ; sinon, false.

Remarques

Une heure ambiguë se situe dans une plage d’heures pour le fuseau horaire actuel. Cela signifie qu’il peut s’agir d’une heure standard ou d’une heure résultant de l’application d’une règle d’ajustement. En règle générale, les heures ambiguës se traduisent lorsque l’horloge est définie pour revenir à l’heure standard à partir de l’heure d’été. Le temps universel coordonné (UTC) n’a pas d’heures ambiguës; ni les fuseaux horaires qui ne prennent pas en charge l’heure d’été.

Le comportement précis de la méthode dépend de la relation entre la Offset propriété du dateTimeOffset paramètre et le fuseau horaire actuel. Si la valeur de la Offset propriété est un décalage possible par rapport à l’UTC du fuseau horaire actuel, la méthode détermine si cette date et cette heure sont ambiguës. Sinon, il convertit dateTimeOffset en heure dans le fuseau horaire actuel, puis détermine si cette date et cette heure sont ambiguës.