Lizenzablauf in der richtigen Zeitzone anzeigen
Eine Lizenz läuft zu einem einzigen Zeitpunkt auf der Zeitachse ab, aber „30. November" ist ein bürgerliches Datum, das davon abhängt, wo man steht. Verwechselt man beides, sieht ein Kunde in Auckland „abgelaufen" bei einem Schlüssel, den ein Kunde in Los Angeles noch als gültig anzeigt. Dieser Beitrag baut die korrekte Ablaufanzeige in .NET: den Ablauf als UTC-Zeitpunkt speichern, ihn mit DateTimeOffset und TimeZoneInfo in die Zeitzone des Betrachters projizieren, die Zone kennzeichnen und die „verbleibenden Tage" so berechnen, dass Sommerzeitwechsel einen Tag nie 23 oder 25 Stunden lang machen.
Ein Support-Ticket trifft ein: Ein Kunde in Auckland meldet, Ihre Anwendung melde seine Lizenz als heute abgelaufen, obwohl seine Verlängerungsquittung eindeutig besagt, dass sie bis zum Monatsende läuft. Sie prüfen den Schlüssel. Er ist signiert, er gehört ihm, und der Ablaufzeitpunkt liegt bequem in der Zukunft. Dann meldet ein zweiter Kunde, in Los Angeles, mit demselben Ablauf auf seinem Schlüssel, überhaupt kein Problem: Seine Kopie sagt „läuft morgen ab”. Mit keiner der beiden Lizenzen stimmt etwas nicht. Ihre Oberfläche hat einen Zeitpunkt auf zwei verschiedene Kalender projiziert.
Das ist nicht das Problem des Uhrenversatzes, bei dem zwei Maschinen ehrlich uneins sind, wie spät es ist, und es ist kein Angreifer, der die Uhr zurückdreht. Hier sind beide Uhren richtig. Der Fehler liegt darin, wie der Ablauf von Keyright — ein UTC-Zeitpunkt — in ein für Menschen lesbares Datum verwandelt wird. Dieser Beitrag baut diese Umwandlung richtig.
Ein Zeitpunkt ist kein Datum
Eine Keyright-Lizenz speichert ihren Ablauf als einen einzigen Punkt auf der globalen Zeitachse, in UTC:
public sealed class LicenseInfo
{
public DateTimeOffset ExpiryUtc { get; } // one instant, e.g. 2026-11-30T07:59:59+00:00
// ...
}
DateTimeOffset ist der richtige Typ: Er fixiert einen Zeitpunkt und merkt sich, dass sein Versatz null ist (UTC). Der Ärger beginnt in dem Moment, in dem Sie ihn einem Menschen anzeigen wollen, denn „wann läuft das ab” hat zwei verschiedene ehrliche Antworten. Als Zeitpunkt ist er ein einziger Wert für alle auf der Erde. Als bürgerliches Datum — das, was ein Mensch auf einem Kalender liest — hängt er völlig davon ab, wo der Leser steht.
// The bug. Renders the UTC instant as a bare date.
var label = info.ExpiryUtc.ToString("D"); // "Monday, 30 November 2026" — in UTC
Diese Beschriftung ist nur für einen Betrachter korrekt, der zufällig auf dem UTC-Meridian wohnt. Für den Kunden in Los Angeles ist der Zeitpunkt 2026-11-30T07:59:59Z lokal 2026-11-29T23:59:59 — bei ihm ist es noch der 29. November. Für den Kunden in Auckland ist derselbe Zeitpunkt lokal 2026-11-30T20:59:59, längst der 30. November. Formatieren Sie den Zeitpunkt als nacktes Datum, und Sie haben einem der beiden den falschen Tag genannt.
Projizieren Sie den Zeitpunkt in die Zone des Betrachters
Die Lösung besteht darin, den Zeitpunkt in die Zone desjenigen umzurechnen, der ihn liest, und dann zu formatieren. TimeZoneInfo.ConvertTime nimmt einen DateTimeOffset und gibt einen neuen DateTimeOffset zurück, der den Versatz dieser Zone zu diesem Zeitpunkt trägt:
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)"
}
Zwei Dinge machen das korrekt. Erstens ist ConvertTime auf einem DateTimeOffset immer wohldefiniert: einen Zeitpunkt in eine Zone zu projizieren kann nie mehrdeutig sein, weil ein Zeitpunkt ein einziger Punkt ist und jede Zone genau eine lokale Darstellung davon hat. (Die Mehrdeutigkeit der Sommerzeit beißt nur in die andere Richtung, wenn man eine eingetippte Uhrzeit wieder in einen Zeitpunkt umwandelt — eine Falle für die Admin-Oberfläche, die einen Ablauf setzt, nicht für den Client, der ihn anzeigt.) Zweitens sorgt das Kennzeichnen der Zone dafür, dass keiner der beiden Kunden das Datum falsch lesen kann: „29. November (America/Los_Angeles)” und „30. November (Pacific/Auckland)” sind beide wahr und beschreiben jetzt sichtbar denselben Moment.
Seit .NET 6 akzeptiert FindSystemTimeZoneById IANA-IDs wie America/Los_Angeles unter Windows ebenso wie unter Linux und macOS, weil die Laufzeit ICU verwendet und die IANA-zu-Windows-Zuordnung mitliefert. Speichern Sie eine kanonische IANA-ID pro Benutzer — es ist genau das, was ein Browser über Intl.DateTimeFormat().resolvedOptions().timeZone meldet — und lösen Sie sie identisch auf, wo auch immer Ihr Code läuft. Speichern Sie nie einen nackten numerischen Versatz: Ein Versatz weiß nicht, wann die Sommerzeit beginnt, also ist ein im Winter gespeicherter Wert von -08:00 für einen Kunden in Los Angeles den ganzen Sommer über schlicht falsch.
„Verbleibende Tage” sind zwei verschiedene Fragen
Das Ablauf-Banner nennt meist auch, wie viel Zeit bleibt, und hier ist eine zweite Stelle, an der die naive Antwort abdriftet. Entscheiden Sie, welche Frage Sie beantworten, denn über einen Sommerzeitübergang hinweg ergeben sie verschiedene Zahlen.
Eine Dauer — „noch 4 Tage und 3 Stunden” — ist der tatsächliche Abstand zwischen zwei Zeitpunkten. Subtrahieren Sie die DateTimeOffset-Werte direkt:
TimeSpan remaining = info.ExpiryUtc - DateTimeOffset.UtcNow; // exact elapsed time
Eine Kalenderzählung — „läuft am 30. ab, also in 3 Tagen” — betrifft bürgerliche Datumswerte in der Zone des Betrachters und muss auf den Datumswerten berechnet werden, nicht auf einer rohen Dauer:
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
}
Die verlockende Abkürzung — (int)(remaining.TotalDays) oder remaining.Days — ist genau an den Tagen falsch, die zählen, denen rund um eine Uhrumstellung. Am Tag der Frühjahrsumstellung dauert ein lokaler Kalendertag nur 23 Stunden, und im Herbst bei der Rückstellung 25. Teilen Sie einen TimeSpan über einen dieser Tage hinweg durch flache 24 Stunden, und Sie landen einen Tag zu früh oder einen Tag zu spät. Beide Zeitpunkte zuerst auf ihr lokales .Date zu kürzen umgeht das Problem vollständig: Die Datumssubtraktion von Mitternacht zu Mitternacht zählt Kalendertage, egal wie viele Stunden jeder Tag tatsächlich hatte.
Wann es bricht, und worauf man achten sollte
Drei ehrliche Vorbehalte. Erstens bewegt sich die Zonendatenbank: Regierungen ändern die Sommerzeitregeln, und ein künftiger Ablauf, den Sie heute anzeigen, kann sich um eine Stunde verschieben, sobald die tzdata des Hosts aktualisiert wird — ein weiterer Grund, warum der Zeitpunkt die Quelle der Wahrheit ist und die lokale Projektion nur eine Ansicht. Zweitens lösen Sie die Zone des Betrachters bewusst auf: Bevorzugen Sie die im Profil gespeicherte Zone des Benutzers, weichen Sie auf das aus, was der Browser meldet, und verwenden Sie nie stillschweigend die Zone des Servers — das ist der ursprüngliche Fehler in anderer Verkleidung. Drittens machen Sie keinen Umweg über eine lokale Zeichenkette: Wenn Sie je local.DateTime mit Kind == Unspecified persistieren und wieder einlesen, haben Sie den Zeitpunkt verloren, und keine spätere Umwandlung kann rekonstruieren, welcher Versatz in Kraft war.
Das Fazit
Ein Lizenzablauf ist ein Zeitpunkt auf der Zeitachse; das Datum, das ein Mensch liest, ist dieser Zeitpunkt von irgendwo aus betrachtet. Halten Sie den signierten Wert in UTC als DateTimeOffset, wandeln Sie ihn mit TimeZoneInfo nur zum Renderzeitpunkt in die IANA-Zone des Betrachters um, und drucken Sie die Zone immer neben das Datum, damit zwei durch einen Ozean getrennte Kunden sehen, dass „der 29. hier” und „der 30. dort” derselbe Moment sind. Berechnen Sie einen Countdown aus der Zeitpunktdifferenz, aber berechnen Sie die „verbleibenden Tage” aus der Subtraktion lokaler .Date-Werte, damit ein Sommerzeittag von 23 oder 25 Stunden Ihr Banner nie um eins verschiebt. Bekommen Sie diese beiden Umwandlungen richtig hin, und das Auckland-Ticket geht nie auf.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.