@fundamental-ngx/core 0.63.0-rc.2 → 0.63.0-rc.21

package/fesm2022/fundamental-ngx-core-datetime.mjs

@@ -1,10 +1,8 @@
-import { Subject } from 'rxjs';
 import * as i0 from '@angular/core';
-import { InjectionToken, Optional, Inject, Pipe, inject, LOCALE_ID, Injectable, NgModule } from '@angular/core';
+import { signal, InjectionToken, inject, Pipe, LOCALE_ID, Injectable, NgModule } from '@angular/core';
 import { TranslationResolver, FD_LANGUAGE_SIGNAL } from '@fundamental-ngx/i18n';
 import { INVALID_DATE_ERROR, range, LETTERS_UNICODE_RANGE } from '@fundamental-ngx/cdk/utils';
-import * as i1 from '@angular/cdk/platform';
-import { PlatformModule } from '@angular/cdk/platform';
+import { Platform, PlatformModule } from '@angular/cdk/platform';
 
 /**
  * Datetime Adapter is an abstract class that must be implemented by each adapter.
@@ -15,16 +13,15 @@ import { PlatformModule } from '@angular/cdk/platform';
 class DatetimeAdapter {
     constructor() {
         /** @hidden */
-        this._localeChanges = new Subject();
-        this.localeChanges = this._localeChanges.asObservable();
+        this._locale = signal('', ...(ngDevMode ? [{ debugName: "_locale" }] : []));
+        this.locale = this._locale.asReadonly();
     }
     /**
      * Sets the locale used for all dates.
      * @param locale The new locale.
      */
     setLocale(locale) {
-        this.locale = locale;
-        this._localeChanges.next();
+        this._locale.set(locale);
     }
     /**
      * Set hours, minutes and seconds at once.
@@ -44,12 +41,14 @@ class DatetimeAdapter {
      * Get Amount of weeks in given month/year
      * @param year The year of the date
      * @param month The month of the date
-     * @param firstDayOfWeek The first day of week. 1 - Sunday, 2 - Monday...
+     * @param firstDayOfWeek The first day of week. 1 - Sunday, 2 - Monday, ..., 7 - Saturday
      * @returns Number of weeks in the given month
      */
     getAmountOfWeeks(year, month, firstDayOfWeek) {
         const firstOfMonth = new Date(year, month - 1, 1);
         const lastOfMonth = new Date(year, month, 0);
+        // firstDayOfWeek is 1-based (1=Sunday, …, 7=Saturday); getDay() is 0-based —
+        // `+ 8` normalizes both into the 0–6 mod-7 space.
         const dayOffset = (firstOfMonth.getDay() - firstDayOfWeek + 8) % 7;
         const used = dayOffset + lastOfMonth.getDate();
         return Math.ceil(used / 7);
@@ -77,10 +76,11 @@ class DatetimeAdapter {
 const DATE_TIME_FORMATS = new InjectionToken('date-formats');
 
 class DateFormatPipe {
-    /** @hidden */
-    constructor(_dateTimeAdapter, _dateTimeFormats) {
-        this._dateTimeAdapter = _dateTimeAdapter;
-        this._dateTimeFormats = _dateTimeFormats;
+    constructor() {
+        /** @hidden */
+        this._dateTimeAdapter = inject(DatetimeAdapter);
+        /** @hidden */
+        this._dateTimeFormats = inject(DATE_TIME_FORMATS);
     }
     /** Format date object */
     transform(date, noDateMessage = '') {
@@ -91,26 +91,21 @@ class DateFormatPipe {
             return noDateMessage;
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DateFormatPipe, deps: [{ token: DatetimeAdapter }, { token: DATE_TIME_FORMATS, optional: true }], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DateFormatPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
     static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.0", ngImport: i0, type: DateFormatPipe, isStandalone: true, name: "dateFormat" }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DateFormatPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'dateFormat',
-                    standalone: true
+                    name: 'dateFormat'
                 }]
-        }], ctorParameters: () => [{ type: DatetimeAdapter }, { type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [DATE_TIME_FORMATS]
-                }] }] });
+        }] });
 class DateTimeFormatPipe {
-    /** @hidden */
-    constructor(_dateTimeAdapter, _dateTimeFormats) {
-        this._dateTimeAdapter = _dateTimeAdapter;
-        this._dateTimeFormats = _dateTimeFormats;
+    constructor() {
+        /** @hidden */
+        this._dateTimeAdapter = inject(DatetimeAdapter);
+        /** @hidden */
+        this._dateTimeFormats = inject(DATE_TIME_FORMATS);
     }
     /** Format date object */
     transform(date, noDateMessage = '') {
@@ -121,25 +116,19 @@ class DateTimeFormatPipe {
             return noDateMessage;
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DateTimeFormatPipe, deps: [{ token: DatetimeAdapter }, { token: DATE_TIME_FORMATS, optional: true }], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DateTimeFormatPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
     static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.0", ngImport: i0, type: DateTimeFormatPipe, isStandalone: true, name: "dateTimeFormat" }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DateTimeFormatPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'dateTimeFormat',
-                    standalone: true
+                    name: 'dateTimeFormat'
                 }]
-        }], ctorParameters: () => [{ type: DatetimeAdapter }, { type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [DATE_TIME_FORMATS]
-                }] }] });
+        }] });
 class DateFromNowPipe {
-    /** @hidden */
-    constructor(_dateTimeAdapter) {
-        this._dateTimeAdapter = _dateTimeAdapter;
+    constructor() {
+        /** @hidden */
+        this._dateTimeAdapter = inject(DatetimeAdapter);
     }
     /** Format date object */
     transform(date, noDateMessage = '') {
@@ -156,21 +145,19 @@ class DateFromNowPipe {
             return '';
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DateFromNowPipe, deps: [{ token: DatetimeAdapter }], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DateFromNowPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
     static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.0", ngImport: i0, type: DateFromNowPipe, isStandalone: true, name: "dateFromNow" }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DateFromNowPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'dateFromNow',
-                    standalone: true
+                    name: 'dateFromNow'
                 }]
-        }], ctorParameters: () => [{ type: DatetimeAdapter }] });
+        }] });
 class DayPeriodFormatPipe {
-    /** @hidden */
-    constructor(_dateTimeAdapter, _dateTimeFormats) {
-        this._dateTimeAdapter = _dateTimeAdapter;
-        this._dateTimeFormats = _dateTimeFormats;
+    constructor() {
+        /** @hidden */
+        this._dateTimeAdapter = inject(DatetimeAdapter);
     }
     /** Format date object for day period */
     transform(date, customFormat = {}, noDateMessage = '') {
@@ -179,21 +166,15 @@ class DayPeriodFormatPipe {
         }
         return this._dateTimeAdapter.format(date, customFormat);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DayPeriodFormatPipe, deps: [{ token: DatetimeAdapter }, { token: DATE_TIME_FORMATS, optional: true }], target: i0.ɵɵFactoryTarget.Pipe }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DayPeriodFormatPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe }); }
     static { this.ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.1.0", ngImport: i0, type: DayPeriodFormatPipe, isStandalone: true, name: "dayPeriodFormat" }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: DayPeriodFormatPipe, decorators: [{
             type: Pipe,
             args: [{
-                    name: 'dayPeriodFormat',
-                    standalone: true
+                    name: 'dayPeriodFormat'
                 }]
-        }], ctorParameters: () => [{ type: DatetimeAdapter }, { type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [DATE_TIME_FORMATS]
-                }] }] });
+        }] });
 class TranslateDayPeriodPipe {
     constructor() {
         /** @hidden */
@@ -223,7 +204,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImpor
             type: Pipe,
             args: [{
                     name: 'translateDayPeriod',
-                    standalone: true,
                     pure: false // required to update the value when the observable is resolved
                 }]
         }] });
@@ -286,14 +266,14 @@ function convertToDesiredFormat(inputStr) {
     return inputStr.replace(/\bat\b/i, '').trim();
 }
 
-/** Adds 0 if number is less then 10 */
-function _leftPad(n) {
-    return n === n % 10 ? `0${n}` : `${n}`;
+/** Pads a number to at least 2 digits. Years are padded to at least 4 digits. */
+function _leftPad(n, minLength = 2) {
+    return String(n).padStart(minLength, '0');
 }
-/** Converts date to ISO8601 */
+/** Converts date to ISO 8601 date-time string without timezone designator (`YYYY-MM-DDTHH:mm:ss`). */
 function toIso8601(fdDate) {
     return [
-        [fdDate.year, _leftPad(fdDate.month), _leftPad(fdDate.day)].join('-'),
+        [_leftPad(fdDate.year, 4), _leftPad(fdDate.month), _leftPad(fdDate.day)].join('-'),
         'T',
         [_leftPad(fdDate.hour), _leftPad(fdDate.minute), _leftPad(fdDate.second)].join(':')
     ].join('');
@@ -523,11 +503,70 @@ const PM_DAY_PERIOD_DEFAULT = 'PM';
  */
 class FdDatetimeAdapter extends DatetimeAdapter {
     /** @hidden */
-    constructor(localeId, platform) {
+    constructor() {
         super();
-        super.setLocale(localeId);
+        /** Cached Intl.RelativeTimeFormat instance, invalidated on locale change. */
+        this._relativeTimeFormatter = null;
+        /** Cached result of _isFormatDayFirst(), invalidated on locale change. */
+        this._dayFirstCache = null;
+        const localeId = inject(LOCALE_ID, { optional: true });
+        const platform = inject(Platform);
+        this.setLocale(localeId || 'en-US');
         this._fixYearsRangeIssue = platform.TRIDENT || platform.EDGE;
     }
+    /** @hidden */
+    setLocale(locale) {
+        super.setLocale(locale);
+        this._relativeTimeFormatter = null;
+        this._dayFirstCache = null;
+    }
+    /** @hidden */
+    fromNow(date) {
+        if (!this.isValid(date)) {
+            return INVALID_DATE_ERROR;
+        }
+        const now = new Date();
+        const target = this._createDateInstanceByFdDate(date);
+        const diffMs = target.getTime() - now.getTime();
+        const absDiffSec = Math.abs(diffMs / 1000);
+        let value;
+        let unit;
+        if (absDiffSec < 60) {
+            value = Math.round(diffMs / 1000);
+            unit = 'second';
+        }
+        else if (absDiffSec < 3600) {
+            value = Math.round(diffMs / 60000);
+            unit = 'minute';
+        }
+        else if (absDiffSec < 86400) {
+            value = Math.round(diffMs / 3600000);
+            unit = 'hour';
+        }
+        else if (absDiffSec < 2592000) {
+            value = Math.round(diffMs / 86400000);
+            unit = 'day';
+        }
+        else if (absDiffSec < 31536000) {
+            value = Math.round(diffMs / 2592000000);
+            unit = 'month';
+        }
+        else {
+            value = Math.round(diffMs / 31536000000);
+            unit = 'year';
+        }
+        try {
+            if (!this._relativeTimeFormatter) {
+                this._relativeTimeFormatter = new Intl.RelativeTimeFormat(this.locale(), { numeric: 'auto' });
+            }
+            return this._relativeTimeFormatter.format(value, unit);
+        }
+        catch {
+            const absValue = Math.abs(value);
+            const suffix = value < 0 ? 'ago' : 'from now';
+            return `${absValue} ${unit}${absValue !== 1 ? 's' : ''} ${suffix}`;
+        }
+    }
     /** Get year */
     getYear(date) {
         return date.year;
@@ -567,29 +606,29 @@ class FdDatetimeAdapter extends DatetimeAdapter {
     }
     /** Get month names */
     getMonthNames(style) {
-        const dateTimeFormat = new Intl.DateTimeFormat(this.locale, { month: style, timeZone: 'utc' });
+        const dateTimeFormat = new Intl.DateTimeFormat(this.locale(), { month: style, timeZone: 'utc' });
         return range(12, (i) => this._stripDirectionalityCharacters(this._format(dateTimeFormat, new Date(2017, i, 1))));
     }
     /** Get date names */
     getDateNames() {
-        const dateTimeFormat = new Intl.DateTimeFormat(this.locale, { day: 'numeric', timeZone: 'utc' });
+        const dateTimeFormat = new Intl.DateTimeFormat(this.locale(), { day: 'numeric', timeZone: 'utc' });
         return range(31, (i) => this._stripDirectionalityCharacters(this._format(dateTimeFormat, new Date(2017, 0, i + 1))));
     }
     /** Get day of week names */
     getDayOfWeekNames(style) {
-        const dateTimeFormat = new Intl.DateTimeFormat(this.locale, { weekday: style, timeZone: 'utc' });
+        const dateTimeFormat = new Intl.DateTimeFormat(this.locale(), { weekday: style, timeZone: 'utc' });
         return range(7, (i) => this._stripDirectionalityCharacters(this._format(dateTimeFormat, new Date(2017, 0, i + 1))));
     }
     /** Get year name */
     getYearName(date) {
-        const dateTimeFormat = new Intl.DateTimeFormat(this.locale, { year: 'numeric', timeZone: 'utc' });
+        const dateTimeFormat = new Intl.DateTimeFormat(this.locale(), { year: 'numeric', timeZone: 'utc' });
         const dateInstance = this._createDateInstanceByFdDate(date);
         return this._stripDirectionalityCharacters(this._format(dateTimeFormat, dateInstance));
     }
     /** Get week name */
     getWeekName(date) {
         const weekNumber = this.getWeekNumber(date);
-        return weekNumber.toLocaleString(this.locale);
+        return weekNumber.toLocaleString(this.locale());
     }
     /** Get hour names */
     getHourNames({ meridian, twoDigit }) {
@@ -597,7 +636,7 @@ class FdDatetimeAdapter extends DatetimeAdapter {
             if (meridian) {
                 hour = hour === 0 || hour === 12 ? 12 : hour % 12;
             }
-            return hour.toLocaleString(this.locale, { minimumIntegerDigits: twoDigit ? 2 : 1 });
+            return hour.toLocaleString(this.locale(), { minimumIntegerDigits: twoDigit ? 2 : 1 });
         });
     }
     /** Get minute names */
@@ -605,17 +644,17 @@ class FdDatetimeAdapter extends DatetimeAdapter {
         const length = Math.ceil(60 / minuteStep);
         return range(length, (index) => {
             const minute = index * minuteStep;
-            return minute.toLocaleString(this.locale, { minimumIntegerDigits: twoDigit ? 2 : 1 });
+            return minute.toLocaleString(this.locale(), { minimumIntegerDigits: twoDigit ? 2 : 1 });
         });
     }
     /** Get second names */
     getSecondNames({ twoDigit }) {
-        return range(60, (second) => second.toLocaleString(this.locale, { minimumIntegerDigits: twoDigit ? 2 : 1 }));
+        return range(60, (second) => second.toLocaleString(this.locale(), { minimumIntegerDigits: twoDigit ? 2 : 1 }));
     }
     /** Get day period names */
     getDayPeriodNames() {
         const DEFAULT_PERIODS = [AM_DAY_PERIOD_DEFAULT, PM_DAY_PERIOD_DEFAULT];
-        const formatter = new Intl.DateTimeFormat(this.locale, {
+        const formatter = new Intl.DateTimeFormat(this.locale(), {
             hour: 'numeric',
             minute: 'numeric',
             hour12: true
@@ -643,20 +682,31 @@ class FdDatetimeAdapter extends DatetimeAdapter {
         return this._createFdDateFromDateInstance(dateInstance);
     }
     /** Set minutes */
-    setMinutes(date, hours) {
+    setMinutes(date, minutes) {
         const dateInstance = this._createDateInstanceByFdDate(date);
-        dateInstance.setMinutes(hours);
+        dateInstance.setMinutes(minutes);
         return this._createFdDateFromDateInstance(dateInstance);
     }
     /** Set seconds */
-    setSeconds(date, hours) {
+    setSeconds(date, seconds) {
         const dateInstance = this._createDateInstanceByFdDate(date);
-        dateInstance.setSeconds(hours);
+        dateInstance.setSeconds(seconds);
         return this._createFdDateFromDateInstance(dateInstance);
     }
     /** Get first day of week */
     getFirstDayOfWeek() {
-        // can't retrieve this info from Intl object or Date object, default to Sunday.
+        try {
+            const locale = new Intl.Locale(this.locale());
+            const weekInfo = locale.weekInfo ?? locale.getWeekInfo?.();
+            if (weekInfo) {
+                // Intl.Locale weekInfo uses 1=Monday..7=Sunday
+                // Adapter convention is 0=Sunday..6=Saturday
+                return weekInfo.firstDay === 7 ? 0 : weekInfo.firstDay;
+            }
+        }
+        catch {
+            // Fallback for environments without Intl.Locale.weekInfo
+        }
         return 0;
     }
     /** Get number of days in a month */
@@ -703,6 +753,13 @@ class FdDatetimeAdapter extends DatetimeAdapter {
             parseFormat.hour) {
             date = this._parseTimeString(value);
         }
+        // Fallback: try locale-aware date parsing when Date.parse() fails
+        if (Number.isNaN(date.valueOf()) && typeof value === 'string') {
+            const parsed = this._parseDateString(value) ?? this._parseDateTimeString(value);
+            if (parsed) {
+                date = parsed;
+            }
+        }
         return this._createFdDateFromDateInstance(date);
     }
     /** Format date object to string */
@@ -744,6 +801,9 @@ class FdDatetimeAdapter extends DatetimeAdapter {
     }
     /** Clone a date object */
     clone(date) {
+        if (!date) {
+            throw new Error('FdDatetimeAdapter: Cannot clone a null/undefined date.');
+        }
         return new FdDate(date.year, date.month, date.day, date.hour, date.minute, date.second);
     }
     /** Check if date object is valid */
@@ -755,6 +815,9 @@ class FdDatetimeAdapter extends DatetimeAdapter {
     }
     /** Check if date between given dates */
     isBetween(dateToCheck, startDate, endDate) {
+        if (!dateToCheck || !startDate || !endDate) {
+            return false;
+        }
         const date = this._createDateInstanceByFdDate(dateToCheck);
         const start = this._createDateInstanceByFdDate(startDate);
         const end = this._createDateInstanceByFdDate(endDate);
@@ -777,7 +840,7 @@ class FdDatetimeAdapter extends DatetimeAdapter {
         }
         return this.toIso8601(date1) === this.toIso8601(date2);
     }
-    /** Format date object to ISO8601 string */
+    /** {@inheritDoc DatetimeAdapter.toIso8601} */
     toIso8601(fdDate) {
         return toIso8601(fdDate);
     }
@@ -837,7 +900,7 @@ class FdDatetimeAdapter extends DatetimeAdapter {
     }
     /** Format date using Intl.DateTimeFormat */
     _formatWithIntl(date, displayFormat) {
-        const formatter = new Intl.DateTimeFormat(this.locale, displayFormat);
+        const formatter = new Intl.DateTimeFormat(this.locale(), displayFormat);
         const dateInstance = this._createDateInstanceByFdDate(date);
         return this._stripDirectionalityCharacters(this._format(formatter, dateInstance));
     }
@@ -888,7 +951,7 @@ class FdDatetimeAdapter extends DatetimeAdapter {
      * @param hours The hours as a number between 0 - 24
      * @param minutes The minutes as a number between 0 - 59
      * @param seconds The seconds as a number between 0 - 59
-     * @param milliseconds The milliseconds as a number between 0 - 59
+     * @param milliseconds The milliseconds as a number between 0 - 999
      */
     _createUTCDateInstance(year, month, day, hours = 0, minutes = 0, seconds = 0, milliseconds = 0) {
         const utcDate = new Date();
@@ -903,34 +966,166 @@ class FdDatetimeAdapter extends DatetimeAdapter {
     /**
      * @hidden
      *
-     * Since FdDatetimeAdapter can parse only "en-US" locale
-     * there is no reason to create comprehensive time parse
-     * that can understand plenty of locales.
-     *
-     * @param timeStr Time string to parse (E.g. '10:30 PM')
-     * @returns date Native date instance
+     * Parse a time string into hours, minutes, seconds and apply to today's date.
+     * Supports: "14:30", "14:30:45", "10:30 PM", "10:30PM", "14.30" (dot separator).
      *
+     * @param timeStr Time string to parse
+     * @returns date Native date instance (Invalid Date if parsing fails)
      */
     _parseTimeString(timeStr) {
-        /**
-         * Date.parse('10:30 AM') doesn't work so we need do a trick
-         * and prepend it by a date string.
-         */
-        const dateStr = new Intl.DateTimeFormat('en-US').format(new Date());
-        const dateTimeString = `${dateStr} ${timeStr}`;
-        return new Date(Date.parse(dateTimeString));
+        const match = timeStr.trim().match(/^(\d{1,2})[:.](\d{2})(?:[:.](\d{2}))?\s*([AaPp][Mm])?$/);
+        if (!match) {
+            return new Date(NaN);
+        }
+        let hours = parseInt(match[1], 10);
+        const minutes = parseInt(match[2], 10);
+        const seconds = match[3] ? parseInt(match[3], 10) : 0;
+        const period = match[4]?.toUpperCase();
+        if (period) {
+            // 12-hour format: hours must be 1-12
+            if (hours < 1 || hours > 12) {
+                return new Date(NaN);
+            }
+            if (period === 'AM') {
+                hours = hours === 12 ? 0 : hours;
+            }
+            else {
+                hours = hours === 12 ? 12 : hours + 12;
+            }
+        }
+        if (hours < 0 || hours > 23 || minutes < 0 || minutes > 59 || seconds < 0 || seconds > 59) {
+            return new Date(NaN);
+        }
+        const now = new Date();
+        now.setHours(hours, minutes, seconds, 0);
+        return now;
+    }
+    /**
+     * @hidden
+     *
+     * Try to parse a date string with common separators (/, -, .)
+     * using locale awareness for day/month ordering.
+     *
+     * @param value Date string (e.g. "12.03.2026", "03/12/2026", "2026-03-12")
+     * @returns Native Date instance or null if parsing fails
+     */
+    _parseDateString(value) {
+        const match = value.trim().match(/^(\d{1,4})([/\-.])(\d{1,2})\2(\d{1,4})$/);
+        if (!match) {
+            return null;
+        }
+        const g1 = parseInt(match[1], 10);
+        const g2 = parseInt(match[3], 10);
+        const g3 = parseInt(match[4], 10);
+        let year;
+        let month;
+        let day;
+        if (match[1].length === 4) {
+            // YYYY-MM-DD
+            year = g1;
+            month = g2;
+            day = g3;
+        }
+        else if (match[4].length === 4) {
+            // DD/MM/YYYY or MM/DD/YYYY — use locale to disambiguate
+            year = g3;
+            if (this._isFormatDayFirst()) {
+                day = g1;
+                month = g2;
+            }
+            else {
+                month = g1;
+                day = g2;
+            }
+        }
+        else {
+            // Two-digit years are ambiguous — reject
+            return null;
+        }
+        // Validate ranges
+        if (month < 1 || month > 12 || day < 1) {
+            return null;
+        }
+        // Validate day for the given month/year (catches Feb 30, etc.)
+        const maxDay = new Date(year, month, 0).getDate();
+        if (day > maxDay) {
+            return null;
+        }
+        const date = new Date();
+        date.setFullYear(year, month - 1, day);
+        date.setHours(0, 0, 0, 0);
+        return date;
+    }
+    /**
+     * @hidden
+     *
+     * Parse a locale-native datetime string that contains both a date and a time
+     * component (e.g. "20/05/2026 16:33" fr-FR, "20.5.2026, 16:33" de-DE).
+     *
+     * Strategy: split on the first 4-digit year boundary (everything before+including
+     * the year is the date part; everything after the optional ", " separator is the
+     * time part), delegate each half to the existing helpers, then combine.
+     *
+     * @param value Datetime string to parse
+     * @returns Native Date instance or null if parsing fails
+     */
+    _parseDateTimeString(value) {
+        // Match: <date-with-4-digit-year> <optional-comma> <whitespace> <time>
+        // Captures: [1] = date portion, [2] = time portion
+        const m = value.trim().match(/^(.*?\d{4}),?\s+(.+)$/);
+        if (!m) {
+            return null;
+        }
+        const datePart = m[1].trim();
+        const timePart = m[2].trim();
+        const dateOnly = this._parseDateString(datePart);
+        if (!dateOnly) {
+            return null;
+        }
+        const timeParsed = this._parseTimeString(timePart);
+        if (Number.isNaN(timeParsed.valueOf())) {
+            return null;
+        }
+        dateOnly.setHours(timeParsed.getHours(), timeParsed.getMinutes(), timeParsed.getSeconds(), 0);
+        return dateOnly;
+    }
+    /**
+     * @hidden
+     *
+     * Detect whether the current locale formats dates with day before month.
+     * Uses Intl.DateTimeFormat.formatToParts to inspect the locale's ordering.
+     *
+     * @returns true if locale puts day before month (e.g. de-DE, en-GB)
+     */
+    _isFormatDayFirst() {
+        if (this._dayFirstCache !== null) {
+            return this._dayFirstCache;
+        }
+        try {
+            const parts = new Intl.DateTimeFormat(this.locale()).formatToParts(new Date(2020, 0, 2));
+            for (const part of parts) {
+                if (part.type === 'day') {
+                    this._dayFirstCache = true;
+                    return true;
+                }
+                if (part.type === 'month') {
+                    this._dayFirstCache = false;
+                    return false;
+                }
+            }
+        }
+        catch {
+            // Fallback: month-first (US convention)
+        }
+        this._dayFirstCache = false;
+        return false;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: FdDatetimeAdapter, deps: [{ token: LOCALE_ID, optional: true }, { token: i1.Platform }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: FdDatetimeAdapter, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: FdDatetimeAdapter }); }
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.0", ngImport: i0, type: FdDatetimeAdapter, decorators: [{
             type: Injectable
-        }], ctorParameters: () => [{ type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [LOCALE_ID]
-                }] }, { type: i1.Platform }] });
+        }], ctorParameters: () => [] });
 
 const PIPES = [
     DateFormatPipe,