Eine um 09:30 auf einer Build-Maschine in Shanghai erzeugte Arbeitsmappe öffnet in Excel, und Datei > Info meldet, sie sei um 17:30 erstellt worden. Der Unit-Test, der die Datei erzeugt hat, bestand: Er wies 09:30 zu, speicherte, öffnete erneut und las 09:30 direkt zurück. Beide Angaben stammen aus denselben Bytes. Die Datei hält 09:30 als UTC markiert, Excel respektiert die Markierung und rechnet acht Stunden dazu, und der Test hat sich die Markierung nie angesehen. Dokument-Zeitstempel in Excel-Dateien sind auf der Platte UTC, der Wert, mit dem ein Programm arbeitet, ist lokale Zeit, und jede Umrechnung dazwischen muss die Sommerzeit-Regeln des eigenen Datums des Stempels verwenden
Der Tagesfehler, den ein Roundtrip nicht sehen kann
In einer .xls-Datei sind Erstellungs- und Speicherzeit FILETIME-Werte: ein 64-Bit-Zähler von 100-Nanosekunden-Ticks seit 1601-01-01 UTC ([MS-DTYP] §2.3.3). Ein Delphi-TDateTime zählt Tage ab dem 1899-12-30, derselbe Serial-Ursprung, der in Excel-Datumsserials in Delphi und die Systeme 1900 gegen 1904 behandelt wird. Die Umrechnung braucht eine Konstante, die Zahl der Tage zwischen den beiden Epochen, und die lautet 109205. Es gibt einen schnellen Weg, das ohne Kalender zu prüfen. Die Unix-Epoche ist als TDateTime der Wert 25569 und 134774 Tage nach der FILETIME-Epoche, und 25569 + 109205 = 134774
Zählt man die Tage von Hand und bezieht beide Enddaten ein, kommt 109206 heraus. Ein auf dieser Konstante gebauter Writer und Reader sind sich perfekt einig. Jeder Erstellungs- und Speicherstempel geht einen Tag zu spät in die Datei und kommt einen Tag zu früh zurück, ein Speichern-und-erneut-öffnen-Test sieht also exakt den Wert, den er zugewiesen hat, während Excel, oder jeder Reader mit der korrekten Epoche, morgen zeigt
const
// Tage von der FILETIME-Epoche (1601-01-01) zur TDateTime-Epoche (1899-12-30)
// Probe: 25569 + 109205 = 134774, die Unix-Epoche in FILETIME-Tagen
FileTimeDayBias = 109205;
function UtcDateTimeToFileTimeTicks(UtcStamp: TDateTime): Int64;
begin
// Erst auf ganze Millisekunden runden, dann auf 100-ns-Ticks skalieren.
// Das Double direkt auf Ticks zu skalieren macht aus 04:00 ein 03:59:59.9999
Result := Round((UtcStamp + FileTimeDayBias) * 86400000.0) * 10000;
end;
Der Rundungskommentar in diesem Gerüst zählt ebenfalls. Der Bruchteil eines TDateTime ist ein binäres Double, und es direkt mit 864.000.000.000 Ticks pro Tag zu multiplizieren schiebt den Darstellungsfehler in die unteren Stellen, ein Stempel von exakt 04:00 liest sich also als 03:59:59.9999 zurück und zeigt 03:59. HotXLS rundet erst auf ganze Millisekunden und skaliert erst dann auf Ticks. Werte zur vollen Stunde überleben. Das Gerüst nimmt absichtlich einen UTC-Input; der Zeitzonen-Schritt kommt später und ist die härtere Hälfte
Welche SummaryInformation-Property-IDs tragen die Datumswerte?
Das von [MS-OLEPS] definierte \005SummaryInformation-Property-Set hält die Erstellungszeit unter der Property-ID $0C (PIDSI_CREATE_DTM), die letzte Speicherzeit unter $0D (PIDSI_LASTSAVE_DTM) und die gesamte Bearbeitungszeit unter $0A (PIDSI_EDITTIME). Die ID direkt nach dem Speicherstempel, $0E, ist PIDSI_PAGECOUNT. Trägt man dort eine Speicherzeit ein, hat Excel kein Speicherdatum mehr anzuzeigen, dafür eine Seitenzahl-Property mit einer FILETIME. HotXLS schreibt den Speicherstempel unter $0D, und liest es eine Datei, in der $0D fehlt, aber $0E ein VT_FILETIME trägt, nimmt es diesen Wert als letzte Speicherzeit. Ein String oder jeder andere Typ unter einer dieser IDs in einer fehlerhaften Datei wird übersprungen, statt als Datum missdeutet zu werden. Wer die rohen Streams selbst sehen will: OLE2-Compound-Files in Delphi ohne COM IStorage lesen
PIDSI_EDITTIME ist der Sonderling. Es ist als VT_FILETIME typisiert, hält aber eine Dauer: die rohe Zahl vergangener 100-ns-Ticks, ohne addierte Epoche. Behandelt man es wie die anderen beiden, EditTimeMinutes / 1440 durch die Epochenumrechnung gejagt, werden aus 125 Bearbeitungsminuten ein Wert von rund 299 Jahren. HotXLS schreibt die nackte Tick-Zahl (Minuten × 600.000.000). Unter Windows fängt der Reader die datumsförmige Kodierung zudem an ihrer Größe, keine echte Bearbeitungssitzung spannt drei Jahrhunderte: Jede Edit-Time ab 109206 Tagen bekommt dieser Offset abgezogen, bevor EditTimeMinutes befüllt wird
.xls-Zeitstempel mit TXLSWorkbook setzen
TXLSWorkbook.CreatedDate und TXLSWorkbook.LastSavedDate nehmen lokale TDateTime-Werte, und HotXLS rechnet sie beim Speichern der Arbeitsmappe in UTC-FILETIMEs um. RevisionNumber und EditTimeMinutes sitzen im selben Stream. Ein Nullwert bedeutet „diese Property weglassen", so streicht man auch alle vier: leeren, und das nächste Speichern schreibt keine. HotXLS stempelt nicht eigenmächtig Now in LastSavedDate. Was man zuweist, kommt in die Datei, und das ist der richtige Default für eine Bibliothek. Ein Batch-Job, der die Berichte des letzten Jahres neu erzeugt, will meist die Daten des letzten Jahres, und ein automatischer Stempel würde sie still überschreiben
var
Book: TXLSWorkbook;
begin
Book := TXLSWorkbook.Create;
try
Book.Title := 'Q3 settlement';
// API-Werte sind lokale Zeit; die Datei speichert UTC-FILETIMEs
Book.CreatedDate := EncodeDate(2026, 1, 15) + EncodeTime(9, 30, 0, 0);
Book.LastSavedDate := Now; // geschrieben wie zugewiesen, nie automatisch gestempelt
Book.RevisionNumber := 7;
Book.EditTimeMinutes := 125; // eine Dauer, gespeichert als rohe Ticks
if Book.SaveAs('settlement.xls') <> 1 then
raise Exception.Create('Save failed');
finally
Book.Free;
end;
end;
Das Öffnen einer Datei füllt dieselben vier Properties zurück, umgerechnet in die lokale Zeit der lesenden Maschine. Ein Dienst in UTC und ein Desktop in Tokio melden für dieselbe Arbeitsmappe unterschiedliche CreatedDate-Werte, neun Stunden auseinander, und beide haben recht. Müssen zwei Systeme Stempel vergleichen, vor dem Vergleich auf der eigenen Seite nach UTC umrechnen oder den UTC-Wert daneben ablegen
Warum gehen XLSX-Daten genau um den Zeitzonen-Offset daneben?
XLSX-Daten gehen um den Zonen-Offset daneben, wenn ein Writer lokale Zeit stempelt und sie als UTC etikettiert. In docProps/core.xml sind dcterms:created und dcterms:modified W3CDTF-Werte unter dem Core-Properties-Modell von ECMA-376 Part 2, und die übliche Form endet auf Z. Now formatieren und ein Z anhängen ist der naheliegende Einzeiler. Auf einer UTC+8-Maschine macht er aus 09:30 ein 09:30:00Z, und Excel auf derselben Maschine zeigt 17:30 — exakt das Eingangsbeispiel. Als vt:filetime gespeicherte benutzerdefinierte Datumseigenschaften folgen derselben Regel, genauso wie die binären FILETIMEs in .xls. HotXLS rechnet auf allen drei Pfaden vor dem Schreiben um: TXLSXWorkbook.Created, TXLSXWorkbook.Modified und über CustomProperties.AddDate hinzugefügte Daten sind auf der API-Seite lokal und in der Datei UTC mit Z
Welche Windows-Funktion die Umrechnung erledigt, ist wichtiger, als man denkt. LocalFileTimeToFileTime wendet den Offset an, der gerade jetzt gilt. Konvertiert man einen Januar-Stempel im Juli in irgendeiner Zone mit Sommerzeit, landet er eine Stunde daneben. HotXLS ruft beim Schreiben TzSpecificLocalTimeToSystemTime und beim Lesen SystemTimeToTzSpecificLocalTime, und beide wählen Normal- oder Sommerzeit aus dem Datum, das konvertiert wird, nicht aus dem heutigen. Ein nicht gesetzter Wert von null geht in beide Richtungen unangetastet durch, aus einer leeren Property wird also nie ein 30. Dezember 1899, verschoben um ein paar Stunden
var
Book: TXLSXWorkbook;
begin
Book := TXLSXWorkbook.Create;
try
if Book.Open('report-template.xlsx') <> 1 then
raise Exception.Create('Template not available');
Book.Created := EncodeDate(2026, 7, 1) + EncodeTime(9, 30, 0, 0);
Book.Modified := Now;
Book.CustomProperties.AddDate('ApprovedOn',
EncodeDate(2026, 1, 20) + EncodeTime(17, 0, 0, 0));
if Book.SaveAs('report.xlsx') <> 1 then
raise Exception.Create('Save failed');
// Auf einer Maschine mit Mitteleuropäischer Zeit enthält core.xml jetzt
// <dcterms:created xsi:type="dcterms:W3CDTF">2026-07-01T07:30:00Z</dcterms:created>
// (UTC+2 im Juli), während ApprovedOn als 16:00Z geschrieben wird (UTC+1 im Januar)
finally
Book.Free;
end;
end;
Außerhalb von Windows läuft dieselbe Umrechnung über die Zeitzonen-Unterstützung der RTL. In Delphi ist das TTimeZone.Local, und die beiden unbequemen Stunden des Jahres bekommen dort eine feste Antwort: Eine lokale Zeit innerhalb der Frühjahrs-Lücke existiert nicht und wird unverändert geschrieben, eine Herbststunde, die zweimal vorkommt, gilt als der Normalzeit-Termin
W3CDTF-Stempel anderer Generatoren lesen
Excel schreibt Z, andere Generatoren nicht immer, und ein Reader, der nur an Zeichen 20 nach Z schaut, bekommt zwei verbreitete Formen falsch. 2026-07-01T01:30:00.5Z hat einen Bruchteil im Weg, und 2026-07-01T09:30:00+08:00 trägt einen expliziten Offset. Ein naiver Parser liest beide als lokale Zeit ohne Anpassung. Der HotXLS-Reader für Created, Modified und datenwertige Custom-Properties akzeptiert Sekundenbruchteile beliebiger Länge, Z und +hh:mm / -hh:mm-Offsets; er rechnet den Zeitpunkt vom angegebenen Offset nach UTC und dann in lokale Zeit um. Ein reiner Datumstempel wie 2026-07-01 liest sich als dieses Datum um Mitternacht, und ein Stempel, der sich gar nicht parsen lässt, kommt als null zurück
Der eine Fall, den die Spezifikationen offenlassen, ist eine Zeit ohne jeglichen Zonenmarker, etwa 2026-07-01T09:30:00. Das W3CDTF-Profil verlangt einen Zonenbezeichner, wann immer eine Zeit vorhanden ist, und ECMA-376 Part 2 nennt keine Regel für einen Stempel, der ihn weglässt. HotXLS liest so einen Wert als lokale Zeit, unverändert. Als UTC zu behandeln wäre auf dem Papier genauso vertretbar gewesen, aber die wahrscheinlichste Quelle eines zonelosen Stempels ist ein Werkzeug, das lokale Zeit geschrieben und die Markierung weggelassen hat, und diese Werte zu verschieben würde jeden Zeitstempel dieses Werkzeugs um den Zonen-Offset bewegen
Den umgekehrten Fehler kann kein Reader retten. Ein als lokale Zeit geschriebener Stempel mit einem Z sieht exakt wie ein korrekter aus, HotXLS, Excel und jeder andere Reader, der dem Format folgt, verschieben ihn also um den Zonen-Offset. Nur die Edit-Time-Kodierung und die $0E-Platzierung in .xls haben eine Signatur, die ein Reader erkennen kann
Testen gegen Bytes, die der eigene Code nicht geschrieben hat
Jede Falle oben passiert eine Speichern-und-erneut-öffnen-Prüfung, denn ein symmetrischer Fehler ist für einen symmetrischen Test unsichtbar. Die Referenz muss von anderswo kommen. Bei .xlsx die gespeicherte Datei entpacken und den literalen Text von dcterms:created prüfen; bei .xls liest Pythons olefile-Paket den SummaryInformation-Stream unabhängig mit get_metadata(), meldet die Edit-Time in Sekunden und behandelt $0E als Seitenzahl, womit beide .xls-Fallen auf einen Schlag sichtbar werden. Die andere Richtung ist eine von Excel selbst gespeicherte Arbeitsmappe, über die API gelesen und gegen das verglichen, was Datei > Info zeigt
uses
System.SysUtils, System.DateUtils;
procedure CheckExcelReference;
var
Book: TXLSXWorkbook;
Expected: TDateTime;
begin
// Der Wert, den Excels Datei > Info für diese Datei auf der Testmaschine zeigt
Expected := EncodeDate(2026, 1, 20) + EncodeTime(17, 0, 0, 0);
Book := TXLSXWorkbook.Create;
try
if Book.Open('excel-saved-reference.xlsx') <> 1 then
raise Exception.Create('Reference file missing');
// Eigene Prüfung, keine HotXLS-API: eine Sekunde für Rundung erlauben
if Abs(Book.Created - Expected) > OneSecond then
raise Exception.CreateFmt('Created reads as %s',
[DateTimeToStr(Book.Created)]);
finally
Book.Free;
end;
end;
Diese Suite auf einer Maschine laufen lassen, die auf eine Zone weit weg von UTC eingestellt ist, mit einem Testdatum auf jeder Seite einer Sommerzeit-Umstellung. Ein auf UTC gelassener Build-Agent versteckt den Zonen-Offset-Fehler vollständig, und ein einzelnes Sommer-Testdatum versteckt den LocalFileTimeToFileTime-Fehler; der 20. Januar und der 1. Juli in Mitteleuropäischer Zeit fangen beide
Recordsysteme, Suchindizes und Audit-Trails sortieren nach diesen Stempeln, und ein Datum, das um einen Tag oder acht Stunden danebenliegt, richtet mehr Schaden an als ein fehlendes, weil niemand es anzweifelt. Mit der HotXLS Delphi spreadsheet component sind die Epoch-Konstante, die Property-IDs und die sommerzeitbewusste UTC-Umrechnung für .xls und .xlsx erledigt, der Anwendungscode weist also gewöhnliche lokale TDateTime-Werte zu und liest sie. Für den Rest des Property-Sets, vom Titel über den Autor bis zu den Custom-Properties, behandelt der Begleitartikel zum Setzen von Excel-Dokumenteigenschaften in Delphi die übrigen Felder