devextreme/esm/__internal/core/localization/date.js

HTML5 JavaScript Component Suite for Responsive Web Development

/**
 * DevExtreme (esm/__internal/core/localization/date.js)
 * Version: 25.2.3
 * Build date: Fri Dec 12 2025
 *
 * Copyright (c) 2012 - 2025 Developer Express Inc. ALL RIGHTS RESERVED
 * Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
 */
import firstDayOfWeekData from "../../core/localization/cldr-data/first_day_of_week_data";
import localizationCore from "../../core/localization/core";
import defaultDateNames from "../../core/localization/default_date_names";
import intlDateLocalization from "../../core/localization/intl/date";
import {
    getFormat as getLDMLDateFormat
} from "../../core/localization/ldml/date.format";
import {
    getFormatter as getLDMLDateFormatter
} from "../../core/localization/ldml/date.formatter";
import {
    getParser as getLDMLDateParser
} from "../../core/localization/ldml/date.parser";
import numberLocalization from "../../core/localization/number";
import errors from "../../core/m_errors";
import {
    injector as dependencyInjector
} from "../../core/utils/m_dependency_injector";
import {
    each
} from "../../core/utils/m_iterator";
import {
    isString
} from "../../core/utils/m_type";
const DEFAULT_DAY_OF_WEEK_INDEX = 0;
const hasIntl = "undefined" !== typeof Intl;
const FORMATS_TO_PATTERN_MAP = {
    shortdate: "M/d/y",
    shorttime: "h:mm a",
    longdate: "EEEE, MMMM d, y",
    longtime: "h:mm:ss a",
    monthandday: "MMMM d",
    monthandyear: "MMMM y",
    quarterandyear: "QQQ y",
    day: "d",
    year: "y",
    shortdateshorttime: "M/d/y, h:mm a",
    longdatelongtime: "EEEE, MMMM d, y, h:mm:ss a",
    month: "LLLL",
    shortyear: "yy",
    dayofweek: "EEEE",
    quarter: "QQQ",
    hour: "HH",
    minute: "mm",
    second: "ss",
    millisecond: "SSS",
    "datetime-local": "yyyy-MM-ddTHH':'mm':'ss"
};
const possiblePartPatterns = {
    year: ["y", "yy", "yyyy"],
    day: ["d", "dd"],
    month: ["M", "MM", "MMM", "MMMM"],
    hours: ["H", "HH", "h", "hh", "ah"],
    minutes: ["m", "mm"],
    seconds: ["s", "ss"],
    milliseconds: ["S", "SS", "SSS"]
};
const dateLocalization = dependencyInjector({
    engine: () => "base",
    _getPatternByFormat: format => FORMATS_TO_PATTERN_MAP[format.toLowerCase()],
    _expandPattern(pattern) {
        return this._getPatternByFormat(pattern) || pattern
    },
    formatUsesMonthName(format) {
        return -1 !== this._expandPattern(format).indexOf("MMMM")
    },
    formatUsesDayName(format) {
        return -1 !== this._expandPattern(format).indexOf("EEEE")
    },
    getFormatParts(format) {
        const pattern = this._getPatternByFormat(format) || format;
        const result = [];
        each(pattern.split(/\W+/), ((_, formatPart) => {
            each(possiblePartPatterns, ((partName, possiblePatterns) => {
                if (possiblePatterns.includes(formatPart)) {
                    result.push(partName)
                }
            }))
        }));
        return result
    },
    getMonthNames: format => defaultDateNames.getMonthNames(format),
    getDayNames: format => defaultDateNames.getDayNames(format),
    getQuarterNames: format => defaultDateNames.getQuarterNames(format),
    getPeriodNames: format => defaultDateNames.getPeriodNames(format),
    getTimeSeparator: () => ":",
    is24HourFormat(format) {
        const amTime = new Date(2017, 0, 20, 11, 0, 0, 0);
        const pmTime = new Date(2017, 0, 20, 23, 0, 0, 0);
        const amTimeFormatted = this.format(amTime, format);
        const pmTimeFormatted = this.format(pmTime, format);
        for (let i = 0; i < amTimeFormatted.length; i += 1) {
            if (amTimeFormatted[i] !== pmTimeFormatted[i]) {
                return !isNaN(parseInt(amTimeFormatted[i], 10))
            }
        }
        return
    },
    format(date, format) {
        if (!date) {
            return
        }
        if (!format) {
            return date
        }
        let formatter;
        if ("function" === typeof format) {
            formatter = format
        } else if (format.formatter) {
            formatter = format.formatter
        } else {
            format = format.type ?? format;
            if (isString(format)) {
                format = FORMATS_TO_PATTERN_MAP[format.toLowerCase()] || format;
                return numberLocalization.convertDigits(getLDMLDateFormatter(format, this)(date))
            }
        }
        if (!formatter) {
            return
        }
        return formatter(date)
    },
    parse(text, format) {
        const that = this;
        let ldmlFormat;
        let formatter;
        if (!text) {
            return
        }
        if (!format) {
            return this.parse(text, "shortdate")
        }
        if ("object" === typeof format && format.parser) {
            return format.parser(text)
        }
        if ("string" === typeof format && !FORMATS_TO_PATTERN_MAP[format.toLowerCase()]) {
            ldmlFormat = format
        } else {
            formatter = value => {
                const text = that.format(value, format);
                return numberLocalization.convertDigits(text, true)
            };
            try {
                ldmlFormat = getLDMLDateFormat(formatter)
            } catch (e) {}
        }
        if (ldmlFormat) {
            text = numberLocalization.convertDigits(text, true);
            return getLDMLDateParser(ldmlFormat, this)(text)
        }
        errors.log("W0012");
        const result = new Date(text);
        if (!result || isNaN(result.getTime())) {
            return
        }
        return result
    },
    firstDayOfWeekIndex() {
        const index = localizationCore.getValueByClosestLocale((locale => firstDayOfWeekData[locale]));
        return index ?? 0
    }
});
if (hasIntl) {
    dateLocalization.inject(intlDateLocalization)
}
export default dateLocalization;