TimeZoneInfo.IsAmbiguousTime Méthode

Source:

TimeZoneInfo.cs

Source:

TimeZoneInfo.cs

Source:

TimeZoneInfo.cs

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

Retours

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

Exceptions

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.

Voir aussi

• IsInvalidTime(DateTime)

Source:

TimeZoneInfo.cs

Source:

TimeZoneInfo.cs

Source:

TimeZoneInfo.cs

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

Retours

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.