Richard/IBKRTrader
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

L1b/1: Betriebszeitzone statt Rechnerzeit - EU- und US-Instanzen sauber trennen

Browse Source 
Wir betreiben Instanzen in zwei Regionen. Bisher hing jede Ortszeit an der
Zeitzone des Rechners (DateTime.Now, DateTimeKind.Local): derselbe Code
haette auf einem Windows-Desktop mit Europe/Berlin und in einem
Linux-Container mit UTC lautlos unterschiedliche Werte geliefert - ohne
Fehler, nur um Stunden verschoben, mitten in Buchungszeitstempeln.

AppTimeZone (Core/Time): Betriebszeitzone der Instanz, einmalig aus
Trading.ApplicationTimeZoneId gesetzt, IANA- und Windows-Schreibweise tragen
beide, unbekannter Wert weicht auf die Systemzone aus und warnt. Wird laut
Festlegung vor den ersten Trades gesetzt und danach nie gewechselt - ein
Wechsel verschoebe rueckwirkend alle Tagesgrenzen. Persistenz bleibt UTC,
damit die Daten beider Instanzen vergleichbar sind.

IbkrMapping.ParseExecutionTime verwirft die von TWS gemeldete Zeitzone nicht
mehr, sondern rechnet gegen sie nach UTC; ohne Zonenangabe gilt die
Betriebszeitzone. Das ist der Kern: eine NYSE-Ausfuehrung darf nicht mit
demselben nackten Zeitwert in die Buecher wie eine an der Eurex.
Rueckgabe ist jetzt immer Kind=Utc.

DailyReportService.NextRun -> NextRunUtc(nowUtc, hour, zone): der Bericht
laeuft zu einer festen ORTSZEIT. Sommerzeitumstellung wird behandelt - bei
der uebersprungenen Stunde weicht er aus, statt den Tag ausfallen zu lassen.

LoggingService fuehrt Anzeigezeit und UTC getrennt: Dateinamen und Anzeige in
Ortszeit (Tagesgrenzen gehoeren zur Instanz, der Supervisor liest die
JSONL-Dateien ueber diese Namen), das ts-Feld im JSONL in UTC. Beides musste
getrennt werden, weil die umgerechnete Ortszeit Kind=Unspecified traegt und
ein ToUniversalTime() darauf sie als Zeit des HOSTS gedeutet haette.

Verbleibende DateTime.Now in Worker-Zeitplaenen und Statuszeilen ebenfalls
auf AppTimeZone.Now umgestellt.

Verifiziert: 183 Tests gruen (+20), darunter EU/US-Versatz, Winter-/Sommerzeit,
unbekannte Zone und die uebersprungene Stunde bei der Zeitumstellung.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Richard
2026-08-06 22:52:23 +02:00
co-authored by Claude Opus 5
parent 123f38ab6f
commit d8273c3a1e
19 changed files with 475 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tests/IBKRTrader.Tests/Modules/Supervisor/DailyReportScheduleTests.cs
+79
View File
@@ -0,0 +1,79 @@
using FluentAssertions;
using IBKRTrader.Modules.Supervisor.Services;
namespace IBKRTrader.Tests.Modules.Supervisor;
/// <summary>
/// Der Tagesbericht soll um eine feste ORTSZEIT laufen – unabhängig davon, in welcher Zeitzone der
/// Rechner steht. Vorher rechnete er gegen <c>DateTimeKind.Local</c>: eine US-Instanz auf einem
/// UTC-Container hätte den „18-Uhr-Bericht" um 13 Uhr Ortszeit erzeugt, über eine Zeitgrenze
/// hinweg, die im Bericht selbst nicht sichtbar ist.
/// </summary>
[Trait("cat", "unit")]
public class DailyReportScheduleTests
{
private static readonly TimeZoneInfo Berlin = TimeZoneInfo.FindSystemTimeZoneById("Europe/Berlin");
private static readonly TimeZoneInfo NewYork = TimeZoneInfo.FindSystemTimeZoneById("America/New_York");
[Fact]
public void NaechsterLauf_LiegtHeute_WennDieStundeNochBevorsteht()
{
// 08:00 UTC = 10:00 Berliner Sommerzeit. 18 Uhr Berlin steht heute noch bevor = 16:00 UTC.
var now = new DateTime(2026, 7, 15, 8, 0, 0, DateTimeKind.Utc);
DailyReportService.NextRunUtc(now, 18, Berlin)
.Should().Be(new DateTime(2026, 7, 15, 16, 0, 0, DateTimeKind.Utc));
}
[Fact]
public void NaechsterLauf_RutschtAufMorgen_WennDieStundeVorbeiIst()
{
// 20:00 UTC = 22:00 Berlin. 18 Uhr ist durch, also morgen 18 Uhr Berlin = 16:00 UTC.
var now = new DateTime(2026, 7, 15, 20, 0, 0, DateTimeKind.Utc);
DailyReportService.NextRunUtc(now, 18, Berlin)
.Should().Be(new DateTime(2026, 7, 16, 16, 0, 0, DateTimeKind.Utc));
}
[Fact]
public void DieselbeStunde_ErgibtJeZoneEinenAnderenUtcZeitpunkt()
{
var now = new DateTime(2026, 7, 15, 6, 0, 0, DateTimeKind.Utc);
// 18 Uhr Ortszeit: Berlin (UTC+2) = 16:00 UTC, New York (UTC-4) = 22:00 UTC.
DailyReportService.NextRunUtc(now, 18, Berlin).Hour.Should().Be(16);
DailyReportService.NextRunUtc(now, 18, NewYork).Hour.Should().Be(22);
}
[Fact]
public void Winterzeit_NutztDenRichtigenVersatz()
{
// Januar: Berlin ist UTC+1, 18 Uhr Ortszeit = 17:00 UTC.
var now = new DateTime(2026, 1, 15, 8, 0, 0, DateTimeKind.Utc);
DailyReportService.NextRunUtc(now, 18, Berlin)
.Should().Be(new DateTime(2026, 1, 15, 17, 0, 0, DateTimeKind.Utc));
}
[Fact]
public void Zeitumstellung_LaesstDenBerichtNichtAusfallen()
{
// 29.03.2026: Berlin stellt um 02:00 auf 03:00 vor – die Stunde 02:00 existiert nicht.
// Der Bericht muss trotzdem laufen (auf die naechste gueltige Stunde ausweichen),
// statt den Tag zu ueberspringen.
var now = new DateTime(2026, 3, 28, 12, 0, 0, DateTimeKind.Utc);
var next = DailyReportService.NextRunUtc(now, 2, Berlin);
next.Should().BeAfter(now);
next.Should().BeBefore(now.AddDays(2), "der Bericht darf hoechstens einen Tag spaeter kommen");
}
[Fact]
public void Ergebnis_IstImmerUtc()
{
var now = new DateTime(2026, 7, 15, 8, 0, 0, DateTimeKind.Utc);
DailyReportService.NextRunUtc(now, 18, Berlin).Kind.Should().Be(DateTimeKind.Utc);
}
}
tests/IBKRTrader.Tests/Time/AppTimeZoneTests.cs
+87
View File
@@ -0,0 +1,87 @@
using FluentAssertions;
using IBKRTrader.Core.Time;
namespace IBKRTrader.Tests.Time;
/// <summary>
/// Sicherheitsnetz für die Betriebszeitzone. Wir betreiben Instanzen in EU und US; die Zeitzone
/// darf deshalb nicht mehr an der Zeitzone des Rechners hängen. Diese Tests halten fest, dass
/// beide Schreibweisen tragen (Windows-IDs unter Linux, IANA-IDs unter Windows) und dass ein
/// unbekannter Wert niemals fatal ist, sondern gemeldet wird.
/// </summary>
[Trait("cat", "unit")]
public class AppTimeZoneTests : IDisposable
{
public void Dispose() => AppTimeZone.Reset();
[Theory]
[InlineData("Europe/Berlin")] // IANA – Empfehlung, trägt auf beiden Plattformen
[InlineData("W. Europe Standard Time")] // Windows – eine Altkonfiguration muss weiter tragen
public void BekannteIds_ErgebenDieselbeZone(string id)
{
AppTimeZone.Configure(id);
// Der Bezeichner unterscheidet sich je Plattform; entscheidend ist der Versatz.
AppTimeZone.Current.GetUtcOffset(new DateTime(2026, 1, 15, 12, 0, 0, DateTimeKind.Utc))
.Should().Be(TimeSpan.FromHours(1));
AppTimeZone.Current.GetUtcOffset(new DateTime(2026, 7, 15, 12, 0, 0, DateTimeKind.Utc))
.Should().Be(TimeSpan.FromHours(2));
}
[Theory]
[InlineData("America/New_York")]
[InlineData("Eastern Standard Time")]
public void UsZone_TraegtEbenfallsInBeidenSchreibweisen(string id)
{
AppTimeZone.Configure(id);
AppTimeZone.Current.GetUtcOffset(new DateTime(2026, 1, 15, 12, 0, 0, DateTimeKind.Utc))
.Should().Be(TimeSpan.FromHours(-5));
AppTimeZone.Current.GetUtcOffset(new DateTime(2026, 7, 15, 12, 0, 0, DateTimeKind.Utc))
.Should().Be(TimeSpan.FromHours(-4));
}
[Fact]
public void UnbekannteId_WeichtAufDieSystemzoneAus_UndWarnt()
{
string? warning = null;
AppTimeZone.Configure("Gibt/EsNicht", w => warning = w);
AppTimeZone.Current.Id.Should().Be(TimeZoneInfo.Local.Id);
warning.Should().NotBeNull().And.Contain("Gibt/EsNicht");
}
[Theory]
[InlineData(null)]
[InlineData("")]
[InlineData(" ")]
public void LeereAngabe_BedeutetSystemzone_UndWarnt(string? id)
{
string? warning = null;
AppTimeZone.Configure(id, w => warning = w);
AppTimeZone.Current.Id.Should().Be(TimeZoneInfo.Local.Id);
warning.Should().NotBeNull("eine unbestimmte Betriebszeitzone ist ein Betriebsrisiko");
}
[Fact]
public void ToDisplay_RechnetUtcInDieKonfigurierteZone()
{
AppTimeZone.Configure("Europe/Berlin");
// 12:00 UTC im Januar = 13:00 Berliner Zeit (MEZ).
AppTimeZone.ToDisplay(new DateTime(2026, 1, 15, 12, 0, 0, DateTimeKind.Utc)).Hour.Should().Be(13);
}
[Fact]
public void ToDisplay_TrenntEuUndUs()
{
var utc = new DateTime(2026, 7, 15, 16, 0, 0, DateTimeKind.Utc);
AppTimeZone.Configure("Europe/Berlin");
AppTimeZone.ToDisplay(utc).Hour.Should().Be(18); // UTC+2
AppTimeZone.Configure("America/New_York");
AppTimeZone.ToDisplay(utc).Hour.Should().Be(12); // UTC-4
}
}
tests/IBKRTrader.Tests/Trading/IbkrMappingTests.cs
+50 -8
View File
@@ -161,19 +161,61 @@ public class IbkrMappingTests
public void ParseSide_MapsTwsExecutionSides(string raw, TradeSide expected) =>
IbkrMapping.ParseSide(raw).Should().Be(expected);
// Die beiden Zonen, in denen wir Instanzen betreiben.
private static readonly TimeZoneInfo Berlin = TimeZoneInfo.FindSystemTimeZoneById("Europe/Berlin");
private static readonly TimeZoneInfo NewYork = TimeZoneInfo.FindSystemTimeZoneById("America/New_York");
[Fact]
public void ParseExecutionTime_HandlesDoubleSpaceFormat()
public void ParseExecutionTime_OhneZone_RechnetGegenDieBetriebszeitzone()
{
// So liefert TWS es bei execDetails.
IbkrMapping.ParseExecutionTime("20260804 17:39:18")
.Should().Be(new DateTime(2026, 8, 4, 17, 39, 18));
// So liefert TWS es bei execDetails (doppeltes Leerzeichen, keine Zonenangabe).
// 17:39:18 Berliner Sommerzeit (UTC+2) = 15:39:18 UTC.
var parsed = IbkrMapping.ParseExecutionTime("20260804 17:39:18", Berlin);
parsed.Should().Be(new DateTime(2026, 8, 4, 15, 39, 18, DateTimeKind.Utc));
parsed!.Value.Kind.Should().Be(DateTimeKind.Utc);
}
[Fact]
public void ParseExecutionTime_IgnoresTrailingTimeZone()
public void ParseExecutionTime_NutztDieGemeldeteZone_StattSieZuVerwerfen()
{
IbkrMapping.ParseExecutionTime("20260804 17:52:56 Europe/Berlin")
.Should().Be(new DateTime(2026, 8, 4, 17, 52, 56));
// Der Kern der Sache: eine US-Instanz darf eine NYSE-Ausfuehrung nicht als Berliner Zeit
// buchen. Gemeldet wird Europe/Berlin, also gilt die - unabhaengig von der Instanzzone.
var parsed = IbkrMapping.ParseExecutionTime("20260804 17:52:56 Europe/Berlin", NewYork);
parsed.Should().Be(new DateTime(2026, 8, 4, 15, 52, 56, DateTimeKind.Utc));
}
[Fact]
public void ParseExecutionTime_UsBoerse_LiefertKorrektesUtc()
{
// 09:30 New Yorker Sommerzeit (UTC-4) = 13:30 UTC - Handelsbeginn NYSE.
IbkrMapping.ParseExecutionTime("20260804 09:30:00 America/New_York", Berlin)
.Should().Be(new DateTime(2026, 8, 4, 13, 30, 0, DateTimeKind.Utc));
}
[Fact]
public void ParseExecutionTime_UnbekannteZone_WeichtAufDieBetriebszeitzoneAus()
{
// Lieber die Instanzzone als gar kein Zeitstempel - die Ausfuehrung darf nicht verlorengehen.
IbkrMapping.ParseExecutionTime("20260804 17:39:18 Gibt/EsNicht", Berlin)
.Should().Be(new DateTime(2026, 8, 4, 15, 39, 18, DateTimeKind.Utc));
}
[Fact]
public void ParseExecutionTime_AkzeptiertAuchDasBindestrichFormat()
{
// Dasselbe Format, das FormatExecutionFilterTime erzeugt.
IbkrMapping.ParseExecutionTime("20260804-17:39:18", Berlin)
.Should().Be(new DateTime(2026, 8, 4, 15, 39, 18, DateTimeKind.Utc));
}
[Fact]
public void ParseExecutionTime_Winterzeit_NutztDenRichtigenVersatz()
{
// Januar: Berlin ist UTC+1, nicht UTC+2. Faengt ein fest verdrahtetes Offset ab.
IbkrMapping.ParseExecutionTime("20260115 17:39:18", Berlin)
.Should().Be(new DateTime(2026, 1, 15, 16, 39, 18, DateTimeKind.Utc));
}
[Theory]
@@ -182,7 +224,7 @@ public class IbkrMappingTests
[InlineData("20260804")]
[InlineData("Unsinn")]
public void ParseExecutionTime_ReturnsNullForUnusableInput(string raw) =>
IbkrMapping.ParseExecutionTime(raw).Should().BeNull();
IbkrMapping.ParseExecutionTime(raw, Berlin).Should().BeNull();
[Fact]
public void FormatExecutionFilterTime_UsesUtcWithExplicitFormat()