Files
IBKRTrader/tests/IBKRTrader.Tests/Time/AppTimeZoneTests.cs
T
RichardandClaude Opus 5 d8273c3a1e L1b/1: Betriebszeitzone statt Rechnerzeit - EU- und US-Instanzen sauber trennen
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>
2026-08-06 22:52:23 +02:00

88 lines
3.2 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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
}
}