From fb7a015b4219a450abc1835e7c59eaf0891177e2 Mon Sep 17 00:00:00 2001
From: Baddi86 <s.hedtrich@live.de>
Date: Tue, 1 Sep 2026 20:09:08 +0200
Subject: [PATCH] CalendarDatePicker: DateTimeOffset<->DateTime-Konvertierung
 per Converter

CalendarDatePicker.SelectedDate ist (WPF-Toolkit-Ursprung) DateTime?,
nicht DateTimeOffset? wie beim eingebauten DatePicker - Avalonia bietet
dafuer keine automatische Konvertierung. Ohne Converter blieb das Feld
leer und ein Klick auf einen Kalendertag warf eine InvalidCastException.
Betraf auch die schon bestehenden Bindings in WithdrawStudentDialog und
CreateLetterDialog, nur bislang unbemerkt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 .../DateTimeOffsetToDateTimeConverter.cs      | 22 ++++++++++++++++
 .../ClassTeacherAbsencesView.axaml            |  5 ++--
 .../ClassTeacherRegisterView.axaml            |  5 ++--
 ...ebUntisLessonAbsenceComparisonDialog.axaml |  5 ++--
 .../Views/Groups/WithdrawStudentDialog.axaml  |  5 ++--
 .../WebUntisTimetableImportDialog.axaml       |  3 ++-
 .../Views/Students/CreateLetterDialog.axaml   |  3 ++-
 ...ebUntisDocumentationComparisonDialog.axaml |  5 ++--
 TODO.md                                       | 26 ++++++++++++-------
 9 files changed, 58 insertions(+), 21 deletions(-)
 create mode 100644 LehrerApp.Desktop/Converters/DateTimeOffsetToDateTimeConverter.cs

diff --git a/LehrerApp.Desktop/Converters/DateTimeOffsetToDateTimeConverter.cs b/LehrerApp.Desktop/Converters/DateTimeOffsetToDateTimeConverter.cs
new file mode 100644
index 0000000..8d546a2
--- /dev/null
+++ b/LehrerApp.Desktop/Converters/DateTimeOffsetToDateTimeConverter.cs
@@ -0,0 +1,22 @@
+using System;
+using System.Globalization;
+using Avalonia.Data.Converters;
+
+namespace LehrerApp.Desktop.Converters;
+
+/// <summary>`CalendarDatePicker.SelectedDate` ist (anders als der eingebaute `DatePicker`) vom
+/// WPF-Toolkit übernommenes `DateTime?`, während Datumsfelder in dieser Codebasis durchgängig
+/// `DateTimeOffset`(?) sind. Avalonia bietet dafür keine automatische Konvertierung
+/// (`TypeUtilities.TryConvert`/`TryConvertImplicit` unterstützen `DateTime`↔`DateTimeOffset`
+/// nicht) — ohne diesen Converter bleibt die Bindung beim Anzeigen stumm leer und wirft beim
+/// Zurückschreiben eine `InvalidCastException`.</summary>
+public sealed class DateTimeOffsetToDateTimeConverter : IValueConverter
+{
+    public static readonly DateTimeOffsetToDateTimeConverter Instance = new();
+
+    public object? Convert(object? value, Type targetType, object? parameter, CultureInfo culture) =>
+        value is DateTimeOffset offset ? offset.DateTime : null;
+
+    public object? ConvertBack(object? value, Type targetType, object? parameter, CultureInfo culture) =>
+        value is DateTime dateTime ? new DateTimeOffset(DateTime.SpecifyKind(dateTime, DateTimeKind.Local)) : null;
+}
diff --git a/LehrerApp.Desktop/Views/ClassTeacher/ClassTeacherAbsencesView.axaml b/LehrerApp.Desktop/Views/ClassTeacher/ClassTeacherAbsencesView.axaml
index 2271a53..3e1badf 100644
--- a/LehrerApp.Desktop/Views/ClassTeacher/ClassTeacherAbsencesView.axaml
+++ b/LehrerApp.Desktop/Views/ClassTeacher/ClassTeacherAbsencesView.axaml
@@ -1,6 +1,7 @@
 <UserControl xmlns="https://github.com/avaloniaui"
              xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
              xmlns:vm="clr-namespace:LehrerApp.Desktop.ViewModels.ClassTeacher"
+             xmlns:conv="clr-namespace:LehrerApp.Desktop.Converters"
              x:Class="LehrerApp.Desktop.Views.ClassTeacher.ClassTeacherAbsencesView"
              x:DataType="vm:ClassTeacherDetailsViewModel">
 
@@ -45,9 +46,9 @@
             <ComboBoxItem Content="Heute"/><ComboBoxItem Content="Letzte 7 Tage"/><ComboBoxItem Content="Letzte 30 Tage"/>
           </ComboBox>
           <TextBlock Grid.Column="1" Text="von" VerticalAlignment="Center" Opacity="0.6"/>
-          <CalendarDatePicker Grid.Column="2" SelectedDate="{Binding StartDate}" HorizontalAlignment="Stretch"/>
+          <CalendarDatePicker Grid.Column="2" SelectedDate="{Binding StartDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}" HorizontalAlignment="Stretch"/>
           <TextBlock Grid.Column="3" Text="bis" VerticalAlignment="Center" Opacity="0.6"/>
-          <CalendarDatePicker Grid.Column="4" SelectedDate="{Binding EndDate}" HorizontalAlignment="Stretch"/>
+          <CalendarDatePicker Grid.Column="4" SelectedDate="{Binding EndDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}" HorizontalAlignment="Stretch"/>
         </Grid>
         <Grid Grid.Row="1" ColumnDefinitions="*,Auto,Auto" ColumnSpacing="8">
           <TextBox Grid.Column="0" Text="{Binding StudentFilter, Mode=TwoWay}" PlaceholderText="Schüler*in filtern…"/>
diff --git a/LehrerApp.Desktop/Views/ClassTeacher/ClassTeacherRegisterView.axaml b/LehrerApp.Desktop/Views/ClassTeacher/ClassTeacherRegisterView.axaml
index aa82eea..eaaeaf5 100644
--- a/LehrerApp.Desktop/Views/ClassTeacher/ClassTeacherRegisterView.axaml
+++ b/LehrerApp.Desktop/Views/ClassTeacher/ClassTeacherRegisterView.axaml
@@ -2,6 +2,7 @@
              xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
              xmlns:vm="clr-namespace:LehrerApp.Desktop.ViewModels.ClassTeacher"
              xmlns:svm="clr-namespace:LehrerApp.Desktop.ViewModels.Students"
+             xmlns:conv="clr-namespace:LehrerApp.Desktop.Converters"
              x:Class="LehrerApp.Desktop.Views.ClassTeacher.ClassTeacherRegisterView"
              x:DataType="vm:ClassTeacherDetailsViewModel">
 
@@ -104,9 +105,9 @@
             <ComboBoxItem Content="Heute"/><ComboBoxItem Content="Letzte 7 Tage"/><ComboBoxItem Content="Letzte 30 Tage"/>
           </ComboBox>
           <TextBlock Grid.Column="1" Text="von" VerticalAlignment="Center" Opacity="0.6"/>
-          <CalendarDatePicker Grid.Column="2" SelectedDate="{Binding StartDate}" HorizontalAlignment="Stretch"/>
+          <CalendarDatePicker Grid.Column="2" SelectedDate="{Binding StartDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}" HorizontalAlignment="Stretch"/>
           <TextBlock Grid.Column="3" Text="bis" VerticalAlignment="Center" Opacity="0.6"/>
-          <CalendarDatePicker Grid.Column="4" SelectedDate="{Binding EndDate}" HorizontalAlignment="Stretch"/>
+          <CalendarDatePicker Grid.Column="4" SelectedDate="{Binding EndDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}" HorizontalAlignment="Stretch"/>
         </Grid>
         <Grid Grid.Row="1" ColumnDefinitions="*,Auto,Auto" ColumnSpacing="8">
           <TextBox Grid.Column="0" Text="{Binding StudentFilter, Mode=TwoWay}" PlaceholderText="Schüler*in filtern…"/>
diff --git a/LehrerApp.Desktop/Views/Groups/WebUntisLessonAbsenceComparisonDialog.axaml b/LehrerApp.Desktop/Views/Groups/WebUntisLessonAbsenceComparisonDialog.axaml
index 43ac676..a37ff06 100644
--- a/LehrerApp.Desktop/Views/Groups/WebUntisLessonAbsenceComparisonDialog.axaml
+++ b/LehrerApp.Desktop/Views/Groups/WebUntisLessonAbsenceComparisonDialog.axaml
@@ -1,6 +1,7 @@
 <Window xmlns="https://github.com/avaloniaui"
         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
         xmlns:vm="clr-namespace:LehrerApp.Desktop.ViewModels.Groups"
+        xmlns:conv="clr-namespace:LehrerApp.Desktop.Converters"
         x:Class="LehrerApp.Desktop.Views.Groups.WebUntisLessonAbsenceComparisonDialog"
         x:DataType="vm:WebUntisLessonAbsenceComparisonViewModel"
         Title="Fehlzeiten je Unterricht mit WebUntis abgleichen" Width="1000" Height="640"
@@ -12,9 +13,9 @@
                  FontSize="12" Opacity="0.65" TextWrapping="Wrap"/>
     </StackPanel>
     <StackPanel Grid.Row="1" Orientation="Horizontal" Spacing="8">
-      <CalendarDatePicker SelectedDate="{Binding StartDate}"/>
+      <CalendarDatePicker SelectedDate="{Binding StartDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}"/>
       <TextBlock Text="bis" VerticalAlignment="Center"/>
-      <CalendarDatePicker SelectedDate="{Binding EndDate}"/>
+      <CalendarDatePicker SelectedDate="{Binding EndDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}"/>
       <Button Content="Fehlzeiten laden" Command="{Binding LoadCommand}" IsEnabled="{Binding !Busy}"/>
     </StackPanel>
     <Grid Grid.Row="2" ColumnDefinitions="Auto,1.2*,1.2*,80,80,1.1*,1.1*" ColumnSpacing="8" Margin="4,0">
diff --git a/LehrerApp.Desktop/Views/Groups/WithdrawStudentDialog.axaml b/LehrerApp.Desktop/Views/Groups/WithdrawStudentDialog.axaml
index 1ac8abe..923cd26 100644
--- a/LehrerApp.Desktop/Views/Groups/WithdrawStudentDialog.axaml
+++ b/LehrerApp.Desktop/Views/Groups/WithdrawStudentDialog.axaml
@@ -1,6 +1,7 @@
 <Window xmlns="https://github.com/avaloniaui"
         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
         xmlns:vm="clr-namespace:LehrerApp.Desktop.ViewModels.Groups"
+        xmlns:conv="clr-namespace:LehrerApp.Desktop.Converters"
         x:Class="LehrerApp.Desktop.Views.Groups.WithdrawStudentDialog"
         x:DataType="vm:WithdrawStudentDialogViewModel"
         Title="Schüler austragen"
@@ -23,8 +24,8 @@
 
       <StackPanel Spacing="5">
         <TextBlock Text="Austrittsdatum" FontSize="12" Opacity="0.7"/>
-        <CalendarDatePicker SelectedDate="{Binding SelectedDate}"
-                            DisplayDateStart="{Binding EarliestDate}"
+        <CalendarDatePicker SelectedDate="{Binding SelectedDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}"
+                            DisplayDateStart="{Binding EarliestDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}"
                             HorizontalAlignment="Stretch"/>
         <TextBlock Text="{Binding DateError}" Foreground="Red" FontSize="12"
                    IsVisible="{Binding DateError, Converter={x:Static StringConverters.IsNotNullOrEmpty}}"/>
diff --git a/LehrerApp.Desktop/Views/Planning/WebUntisTimetableImportDialog.axaml b/LehrerApp.Desktop/Views/Planning/WebUntisTimetableImportDialog.axaml
index 42f5988..7a17452 100644
--- a/LehrerApp.Desktop/Views/Planning/WebUntisTimetableImportDialog.axaml
+++ b/LehrerApp.Desktop/Views/Planning/WebUntisTimetableImportDialog.axaml
@@ -2,6 +2,7 @@
         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
         xmlns:vm="clr-namespace:LehrerApp.Desktop.ViewModels.Planning"
         xmlns:svc="clr-namespace:LehrerApp.Desktop.Services"
+        xmlns:conv="clr-namespace:LehrerApp.Desktop.Converters"
         x:Class="LehrerApp.Desktop.Views.Planning.WebUntisTimetableImportDialog"
         x:DataType="vm:WebUntisTimetableImportViewModel"
         Title="Stundenplan aus WebUntis" Width="820" Height="650"
@@ -18,7 +19,7 @@
           <DataTemplate x:DataType="svc:UntisTeacherDto"><TextBlock Text="{Binding DisplayName}"/></DataTemplate>
         </ComboBox.ItemTemplate>
       </ComboBox>
-      <CalendarDatePicker Grid.Column="1" SelectedDate="{Binding WeekDate}"/>
+      <CalendarDatePicker Grid.Column="1" SelectedDate="{Binding WeekDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}"/>
       <Button Grid.Column="2" Content="Woche laden" Command="{Binding LoadCommand}" IsEnabled="{Binding !Busy}"/>
     </Grid>
     <ScrollViewer Grid.Row="2">
diff --git a/LehrerApp.Desktop/Views/Students/CreateLetterDialog.axaml b/LehrerApp.Desktop/Views/Students/CreateLetterDialog.axaml
index ca90bfe..78bcab4 100644
--- a/LehrerApp.Desktop/Views/Students/CreateLetterDialog.axaml
+++ b/LehrerApp.Desktop/Views/Students/CreateLetterDialog.axaml
@@ -1,6 +1,7 @@
 <Window xmlns="https://github.com/avaloniaui"
         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
         xmlns:vm="clr-namespace:LehrerApp.Desktop.ViewModels.Students"
+        xmlns:conv="clr-namespace:LehrerApp.Desktop.Converters"
         x:Class="LehrerApp.Desktop.Views.Students.CreateLetterDialog"
         x:DataType="vm:CreateLetterDialogViewModel"
         Title="PDF-Brief erstellen" Width="580" Height="760"
@@ -40,7 +41,7 @@
           </StackPanel>
           <StackPanel Grid.Column="2" Spacing="4">
             <TextBlock Text="Briefdatum *" FontSize="12" Opacity="0.7"/>
-            <CalendarDatePicker SelectedDate="{Binding LetterDate}" HorizontalAlignment="Stretch"/>
+            <CalendarDatePicker SelectedDate="{Binding LetterDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}" HorizontalAlignment="Stretch"/>
           </StackPanel>
         </Grid>
         <StackPanel Spacing="4">
diff --git a/LehrerApp.Desktop/Views/Students/WebUntisDocumentationComparisonDialog.axaml b/LehrerApp.Desktop/Views/Students/WebUntisDocumentationComparisonDialog.axaml
index 8078996..0ae831c 100644
--- a/LehrerApp.Desktop/Views/Students/WebUntisDocumentationComparisonDialog.axaml
+++ b/LehrerApp.Desktop/Views/Students/WebUntisDocumentationComparisonDialog.axaml
@@ -1,6 +1,7 @@
 <Window xmlns="https://github.com/avaloniaui"
         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
         xmlns:vm="clr-namespace:LehrerApp.Desktop.ViewModels.Students"
+        xmlns:conv="clr-namespace:LehrerApp.Desktop.Converters"
         x:Class="LehrerApp.Desktop.Views.Students.WebUntisDocumentationComparisonDialog"
         x:DataType="vm:WebUntisDocumentationComparisonViewModel"
         Title="Klassenbucheinträge mit WebUntis abgleichen" Width="1150" Height="720"
@@ -12,9 +13,9 @@
                  Text="Nur eigene WebUntis-Einträge (Benutzer = eigener Login). Zeilen ohne automatische Zuordnung bitte manuell einem/einer Schüler*in zuweisen. Bereits lokal vorhandene Einträge sind gesperrt."/>
     </StackPanel>
     <StackPanel Grid.Row="1" Orientation="Horizontal" Spacing="8">
-      <CalendarDatePicker SelectedDate="{Binding StartDate}"/>
+      <CalendarDatePicker SelectedDate="{Binding StartDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}"/>
       <TextBlock Text="bis" VerticalAlignment="Center"/>
-      <CalendarDatePicker SelectedDate="{Binding EndDate}"/>
+      <CalendarDatePicker SelectedDate="{Binding EndDate, Converter={x:Static conv:DateTimeOffsetToDateTimeConverter.Instance}}"/>
       <Button Content="Klassenbucheinträge laden" Command="{Binding LoadCommand}" IsEnabled="{Binding !Busy}"/>
     </StackPanel>
 
diff --git a/TODO.md b/TODO.md
index e092169..855ebfb 100644
--- a/TODO.md
+++ b/TODO.md
@@ -1406,15 +1406,23 @@ Bestätigungsschritt zu verlangen. Betroffen: [WebUntisLessonAbsenceComparisonDi
 und [WebUntisDocumentationComparisonDialog.axaml](LehrerApp.Desktop/Views/Students/WebUntisDocumentationComparisonDialog.axaml).
 
 **Nachtrag (September 2026, Nutzer-Feedback) — `CalendarDatePicker` blieb nach der Umstellung leer
-und warf beim Auswählen einen Konvertierungsfehler:** `CalendarDatePicker.SelectedDate` ist
-`DateTimeOffset?`, die fünf oben umgestellten ViewModel-Eigenschaften (`StartDate`/`EndDate` in
-`ClassTeacherDetailsViewModel`, `WebUntisLessonAbsenceComparisonViewModel`,
-`WebUntisDocumentationComparisonViewModel`, `WeekDate` in `WebUntisTimetableImportViewModel`)
-waren aber als nicht-nullbares `DateTimeOffset` deklariert — anders als `WithdrawStudentDialog`
-und `CreateLetterDialog`, deren Datumsfelder von Anfang an `DateTimeOffset?` sind. Der alte
-`DatePicker` toleriert diese Abweichung stillschweigend, `CalendarDatePicker`s Bindung nicht. Alle
-fünf Eigenschaften auf `DateTimeOffset?` umgestellt (Fallback `?? DateTimeOffset.Now` an den
-wenigen Leseseiten), damit sie exakt zum Steuerelement passen.
+und warf beim Auswählen eine `InvalidCastException`:** Der erste Erklärungsversuch (Nullability der
+ViewModel-Eigenschaften) war falsch und hat das Problem nicht behoben. Per Reflection gegen die
+tatsächliche Avalonia-12.0.4-DLL verifiziert: `CalendarDatePicker.SelectedDate` (und
+`DisplayDateStart`/`DisplayDateEnd`) sind — vom WPF-Toolkit-Ursprung dieses Controls geerbt —
+`DateTime?`, nicht `DateTimeOffset?` wie beim eingebauten `DatePicker`. Avalonias
+`TypeUtilities.TryConvert`/`TryConvertImplicit` unterstützen keine automatische Konvertierung
+zwischen `DateTime` und `DateTimeOffset` (in keiner Richtung, nullbar oder nicht) — mit einem
+`DateTimeOffset`-Feld direkt gebunden bleibt `CalendarDatePicker` beim Anzeigen stumm leer und
+wirft beim Zurückschreiben (Klick auf einen Kalendertag) eine `InvalidCastException`. Das betraf
+nicht nur die fünf oben umgestellten Zeitraum-Felder, sondern genauso die bereits bestehenden
+`CalendarDatePicker`-Bindungen in `WithdrawStudentDialog` (`SelectedDate`, `DisplayDateStart`) und
+`CreateLetterDialog` (`LetterDate`) — nur bislang unbemerkt, weil dort niemand konsequent ein Datum
+ausgewählt hatte. Behoben mit einem neuen [DateTimeOffsetToDateTimeConverter](LehrerApp.Desktop/Converters/DateTimeOffsetToDateTimeConverter.cs),
+an allen elf betroffenen Bindings in den sieben Dialogen/Views eingehängt (`Converter={x:Static
+conv:DateTimeOffsetToDateTimeConverter.Instance}`). End-to-End mit einer echten kompilierten
+Ansicht in einer Avalonia.Headless-Instanz gegengeprüft (Anzeige des Anfangswerts und
+Zurückschreiben nach Kalenderauswahl, beides ohne Exception).
 
 **Nachtrag zu 4.3, Fehlzeiten je Unterricht (August 2026):** Der ursprüngliche Fehlzeitenabgleich
 rief `getTimetableWithAbsences` ohne Element auf und bekam damit den kompletten Lehrer-Stundenplan