Skip to content
← Tous les articles
· Delta1 Labs Time ZonesKeyright

Afficher l'expiration de licence dans le bon fuseau

Une licence expire à un instant unique sur la ligne du temps, mais « 30 novembre » est une date civile qui dépend de l'endroit où l'on se trouve. Confondez les deux et un client à Auckland verra « expirée » sur une clé qu'un client à Los Angeles affiche encore comme valide. Cet article construit l'affichage correct de l'expiration en .NET : stocker l'expiration comme un instant UTC, le projeter dans le fuseau horaire du lecteur avec DateTimeOffset et TimeZoneInfo, étiqueter le fuseau, et calculer les « jours restants » pour que les changements d'heure d'été ne fassent jamais durer un jour 23 ou 25 heures.

Un ticket de support arrive : un client à Auckland dit que votre application signale sa licence comme expirée aujourd”hui, mais son reçu de renouvellement indique clairement qu”elle court jusqu”à la fin du mois. Vous vérifiez la clé. Elle est signée, elle est bien la sienne, et l”instant d”expiration est confortablement dans le futur. Puis un deuxième client, à Los Angeles, avec la même expiration sur sa clé, ne signale aucun problème : sa copie dit « expire demain ». Aucune des deux licences n”a de défaut. Votre interface a projeté un instant sur deux calendriers différents.

Ce n”est pas le problème du décalage d”horloge, où deux machines sont honnêtement en désaccord sur l”heure qu”il est, et ce n”est pas un attaquant qui recule l”horloge. Ici, les deux horloges sont correctes. Le bogue est dans la façon dont l”expiration de Keyright — un instant UTC — devient une date lisible par un humain. Cet article construit cette conversion comme il faut.

Un instant n”est pas une date

Une licence Keyright stocke son expiration comme un point unique sur la ligne du temps mondiale, en UTC :

public sealed class LicenseInfo
{
    public DateTimeOffset ExpiryUtc { get; }   // one instant, e.g. 2026-11-30T07:59:59+00:00
    // ...
}

DateTimeOffset est le bon type : il fixe un instant et retient que son décalage est nul (UTC). L”ennui commence dès que vous essayez de l”afficher à une personne, car « quand cela expire-t-il » a deux réponses honnêtes distinctes. En tant qu”instant, c”est une seule valeur pour tout le monde sur Terre. En tant que date civile — ce qu”un humain lit sur un calendrier — cela dépend entièrement de l”endroit où se trouve le lecteur.

// The bug. Renders the UTC instant as a bare date.
var label = info.ExpiryUtc.ToString("D");   // "Monday, 30 November 2026" — in UTC

Cette étiquette n”est correcte que pour un lecteur qui habiterait justement sur le méridien UTC. Pour le client de Los Angeles, l”instant 2026-11-30T07:59:59Z est 2026-11-29T23:59:59 en local : c”est encore le 29 novembre chez lui. Pour le client d”Auckland, le même instant est 2026-11-30T20:59:59 en local, bien entré dans le 30 novembre. Formatez l”instant comme une simple date et vous aurez annoncé à l”un d”eux le mauvais jour.

Un instant UTC, deux dates de calendrierexpiry = 2026-11-30 07:59:59ZAmerica/Los_Angeles (UTC−8)29 nov.30 nov.23:59 le 29 nov. — encore le 29Pacific/Auckland (UTC+13)29 nov.30 nov.20:59 le 30 nov. — déjà le 30
Les repères orange marquent minuit local. L''unique instant d''expiration se situe avant minuit à Los Angeles et après lui à Auckland, donc une simple date est en désaccord d''un jour.

Projetez l”instant dans le fuseau du lecteur

Le correctif consiste à convertir l”instant dans le fuseau de celui qui le lit, puis à le formater. TimeZoneInfo.ConvertTime prend un DateTimeOffset et renvoie un nouveau DateTimeOffset portant le décalage de ce fuseau à cet instant :

public static string FormatExpiry(DateTimeOffset expiryUtc, string viewerZoneId)
{
    // viewerZoneId is an IANA id such as "Pacific/Auckland" or "America/Los_Angeles".
    var zone  = TimeZoneInfo.FindSystemTimeZoneById(viewerZoneId);
    var local = TimeZoneInfo.ConvertTime(expiryUtc, zone);

    // Include the zone so the date is unambiguous to the reader.
    return $"{local:dddd, d MMMM yyyy 'at' h:mm tt} ({zone.Id})";
    // Auckland  -> "Monday, 30 November 2026 at 8:59 PM (Pacific/Auckland)"
    // Los Angeles -> "Sunday, 29 November 2026 at 11:59 PM (America/Los_Angeles)"
}

Deux choses rendent cela correct. D”abord, ConvertTime sur un DateTimeOffset est toujours bien défini : projeter un instant vers un fuseau ne peut jamais être ambigu, parce qu”un instant est un point unique et que tout fuseau en a exactement une représentation locale. (L”ambiguïté de l”heure d”été ne mord que dans l”autre sens, quand on reconvertit une heure d”horloge saisie en un instant — un piège pour l”interface d”administration qui fixe une expiration, pas pour le client qui l”affiche.) Ensuite, étiqueter le fuseau fait qu”aucun des deux clients ne peut mal lire la date : « 29 novembre (America/Los_Angeles) » et « 30 novembre (Pacific/Auckland) » sont toutes deux vraies, et décrivent maintenant visiblement le même moment.

Depuis .NET 6, FindSystemTimeZoneById accepte les identifiants IANA comme America/Los_Angeles sous Windows aussi bien que sous Linux et macOS, parce que le runtime utilise ICU et embarque la correspondance IANA-vers-Windows. Stockez un seul identifiant IANA canonique par utilisateur — c”est exactement ce qu”un navigateur signale via Intl.DateTimeFormat().resolvedOptions().timeZone — et résolvez-le à l”identique partout où votre code s”exécute. Ne stockez jamais un décalage numérique nu : un décalage ne sait pas quand commence l”heure d”été, donc une valeur de -08:00 enregistrée en hiver est tout simplement fausse pour un client de Los Angeles tout l”été.

Les « jours restants », ce sont deux questions distinctes

La bannière d”expiration indique en général aussi combien de temps il reste, et voici un deuxième endroit où la réponse naïve dérive. Décidez à quelle question vous répondez, car à travers une transition d”heure d”été elles donnent des nombres différents.

Une durée — « il reste 4 jours et 3 heures » — est l”écart réel entre deux instants. Soustrayez directement les valeurs DateTimeOffset :

TimeSpan remaining = info.ExpiryUtc - DateTimeOffset.UtcNow;   // exact elapsed time

Un décompte de calendrier — « expire le 30, soit dans 3 jours » — porte sur des dates civiles dans le fuseau du lecteur, et doit être calculé sur les dates, pas sur une durée brute :

static int CalendarDaysUntilExpiry(DateTimeOffset expiryUtc, TimeZoneInfo zone)
{
    var expiryLocalDate = TimeZoneInfo.ConvertTime(expiryUtc, zone).Date;
    var todayLocalDate  = TimeZoneInfo.ConvertTime(DateTimeOffset.UtcNow, zone).Date;
    return (expiryLocalDate - todayLocalDate).Days;   // whole calendar days in the viewer's zone
}

Le raccourci tentant — (int)(remaining.TotalDays) ou remaining.Days — est faux précisément les jours qui comptent, ceux qui entourent un changement d”horloge. Le jour de l”avance de printemps, un jour local de calendrier ne dure que 23 heures, et à l”automne, au recul, il en dure 25. Divisez un TimeSpan par 24 heures fixes à travers l”un de ces jours et vous tomberez un jour trop tôt ou un jour trop tard. Ramener d”abord les deux instants à leur .Date local esquive complètement le problème : la soustraction de dates de minuit à minuit compte les jours de calendrier quel que soit le nombre d”heures qu”a réellement eu chaque jour.

Quand cela casse, et ce qu”il faut surveiller

Trois réserves honnêtes. Premièrement, la base de données des fuseaux évolue : les gouvernements modifient les règles de l”heure d”été, et une expiration future que vous affichez aujourd”hui peut se décaler d”une heure dès que la tzdata de l”hôte est mise à jour — une raison de plus pour laquelle l”instant est la source de vérité et la projection locale n”est qu”une vue. Deuxièmement, résolvez le fuseau du lecteur délibérément : privilégiez le fuseau enregistré dans le profil de l”utilisateur, repliez-vous sur ce que signale le navigateur, et n”utilisez jamais en silence le fuseau du serveur, qui est le bogue d”origine sous un autre déguisement. Troisièmement, ne faites pas d”aller-retour via une chaîne locale : si jamais vous persistez local.DateTime avec Kind == Unspecified puis le relisez, vous avez perdu l”instant, et aucune conversion ultérieure ne pourra retrouver quel décalage était en vigueur.

À retenir

L”expiration d”une licence est un instant sur la ligne du temps ; la date qu”un humain lit est cet instant vu de quelque part. Gardez la valeur signée en UTC sous forme de DateTimeOffset, convertissez-la dans le fuseau IANA du lecteur avec TimeZoneInfo uniquement au moment du rendu, et imprimez toujours le fuseau à côté de la date pour que deux clients séparés par un océan voient que « le 29 ici » et « le 30 là-bas » sont le même moment. Calculez un compte à rebours à partir de la différence d”instants, mais calculez les « jours restants » à partir de la soustraction de .Date locaux pour qu”un jour d”heure d”été de 23 ou 25 heures ne décale jamais votre bannière d”un. Réussissez ces deux conversions et le ticket d”Auckland ne s”ouvre jamais.

Essayez Nebula.NET

Renforcez votre code .NET en quelques minutes — commencez avec l'édition gratuite.