Release: v2.5.1

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [2.5.1] - 2026-03-13
+
+### Added
+
+- Added `toDate` function to the `DateFormatter` class
+
 ## [2.5.0] - 2026-02-12
 
 ### Added

package.json

@@ -10,7 +10,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.5.0",
+  "version": "2.5.1",
   "license": "MIT",
   "private": false,
   "engines": {

src/util/PatternCompiler/Plugin/DateFormatter.ts

@@ -1,4 +1,21 @@
 export class DateFormatter {
+  /**
+   * Safely converts date-like values into a valid Date object.
+   * Returns null when the input is empty or invalid.
+   */
+  static toDate(value: Date | string | null | undefined): Date | null {
+    if (!value) {
+      return null;
+    }
+
+    if (value instanceof Date) {
+      return Number.isNaN(value.getTime()) ? null : value;
+    }
+
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+
   /**
    * Formats a date with time in German format
    * @param date Date object or date string to format