intelicoreact 1.5.38 → 1.5.41

package/dist/Functions/dateTime.js

@@ -1,138 +1,185 @@
 "use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
-    value: true
+  value: true
 });
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    DATETIME_FORMATS: function() {
-        return DATETIME_FORMATS;
-    },
-    DATE_UNITS: function() {
-        return DATE_UNITS;
-    },
-    parseAndFormatDate: function() {
-        return parseAndFormatDate;
-    }
-});
-const _moment = /*#__PURE__*/ _interop_require_default(require("moment"));
-function _interop_require_default(obj) {
-    return obj && obj.__esModule ? obj : {
-        default: obj
-    };
-}
-const DATETIME_FORMATS = Object.freeze({
-    // Основные форматы
-    DATE_FORMAT: "YYYY-MM-DD",
-    DATE_WITHOUT_SEPARATORS: "MMDDYYYY",
-    VALIDATION_DATE_FORMAT: "MM/DD/YYYY",
-    INPUT_DATE_FORMAT: "MM.DD.YYYY",
-    INPUT_TIME_FORMAT: "YYYY-MM-DD HH:mm:SS",
-    TIME_FORMAT_WSPACE: "YYYY-MM-DD HH:mm:SS",
-    TIME_FORMAT: "YYYY-MM-DDTHH:mm:SS",
-    DATE_FORMAT_WITH_SLASH: "MM/DD/YYYY",
-    // Дополнительные форматы
-    DATE_WITH_DASHES: "MM-DD-YYYY",
-    DATE_WITH_DOTS: "DD.MM.YYYY",
-    DATE_WITH_COMMA: "DD,MM,YYYY",
-    FULL_DATE_TIME: "YYYY-MM-DD HH:mm:ss",
-    ISO_DATE_TIME: "YYYY-MM-DDTHH:mm:ss.SSSZ",
-    LOCALIZED_DATE: "MMMM DD, YYYY",
-    SHORT_DATE: "MM/DD/YY",
-    SHORT_DATE_WITH_TIME: "MM/DD/YY HH:mm",
-    TIME_24H: "HH:mm",
-    TIME_12H: "hh:mm A",
-    TIME_12H_WITH_SECONDS: "hh:mm:ss A",
-    TIME_24H_WITH_SECONDS: "HH:mm:ss",
-    MONTH_DAY: "MM/DD",
-    YEAR_MONTH_DAY: "YYYY/MM/DD"
+exports.DATE_UNITS = exports.DATETIME_FORMATS = void 0;
+exports.parseAndFormatDate = parseAndFormatDate;
+var _moment = _interopRequireDefault(require("moment"));
+/**
+ * @constant {Object} DATETIME_FORMATS
+ * @description Все доступные форматы дат и времени.
+ */
+const DATETIME_FORMATS = exports.DATETIME_FORMATS = Object.freeze({
+  // Основные форматы
+  DATE_FORMAT: "YYYY-MM-DD",
+  // Стандартный формат даты
+  DATE_WITHOUT_SEPARATORS: "MMDDYYYY",
+  // Без разделителей
+  VALIDATION_DATE_FORMAT: "MM/DD/YYYY",
+  // Для валидации
+  INPUT_DATE_FORMAT: "MM.DD.YYYY",
+  // Формат для ввода
+  INPUT_TIME_FORMAT: "YYYY-MM-DD HH:mm:SS",
+  // Ввод времени
+  TIME_FORMAT_WSPACE: "YYYY-MM-DD HH:mm:SS",
+  // Время с пробелом
+  TIME_FORMAT: "YYYY-MM-DDTHH:mm:SS",
+  // Время с T (ISO формат)
+  DATE_FORMAT_WITH_SLASH: "MM/DD/YYYY",
+  // Дата с разделителем /
+
+  // Дополнительные форматы
+  DATE_WITH_DASHES: "MM-DD-YYYY",
+  // Дата с дефисами
+  DATE_WITH_DOTS: "DD.MM.YYYY",
+  // Дата с точками
+  DATE_WITH_COMMA: "DD,MM,YYYY",
+  // Дата с запятыми
+  FULL_DATE_TIME: "YYYY-MM-DD HH:mm:ss",
+  // Полная дата и время
+  ISO_DATE_TIME: "YYYY-MM-DDTHH:mm:ss.SSSZ",
+  // ISO стандарт с миллисекундами
+  LOCALIZED_DATE: "MMMM DD, YYYY",
+  // Локализованный формат с полным названием месяца
+  SHORT_DATE: "MM/DD/YY",
+  // Краткая дата
+  SHORT_DATE_WITH_TIME: "MM/DD/YY HH:mm",
+  // Краткая дата с временем
+  TIME_24H: "HH:mm",
+  // Время в 24-часовом формате
+  TIME_12H: "hh:mm A",
+  // Время в 12-часовом формате
+  TIME_12H_WITH_SECONDS: "hh:mm:ss A",
+  // Время в 12-часовом формате с секундами
+  TIME_24H_WITH_SECONDS: "HH:mm:ss",
+  // Время в 24-часовом формате с секундами
+  MONTH_DAY: "MM/DD",
+  // Только месяц и день
+  YEAR_MONTH_DAY: "YYYY/MM/DD" // Год/Месяц/День
 });
 const formatMap = Object.freeze({
-    [DATETIME_FORMATS.DATE_FORMAT]: "YYYY-MM-DD",
-    [DATETIME_FORMATS.DATE_WITHOUT_SEPARATORS]: "MMDDYYYY",
-    [DATETIME_FORMATS.VALIDATION_DATE_FORMAT]: "MM/DD/YYYY",
-    [DATETIME_FORMATS.INPUT_DATE_FORMAT]: "MM.DD.YYYY",
-    [DATETIME_FORMATS.INPUT_TIME_FORMAT]: "YYYY-MM-DD HH:mm:SS",
-    [DATETIME_FORMATS.TIME_FORMAT_WSPACE]: "YYYY-MM-DD HH:mm:SS",
-    [DATETIME_FORMATS.TIME_FORMAT]: "YYYY-MM-DDTHH:mm:SS",
-    [DATETIME_FORMATS.DATE_FORMAT_WITH_SLASH]: "MM/DD/YYYY",
-    [DATETIME_FORMATS.DATE_WITH_DASHES]: "MM-DD-YYYY",
-    [DATETIME_FORMATS.DATE_WITH_DOTS]: "DD.MM.YYYY",
-    [DATETIME_FORMATS.DATE_WITH_COMMA]: "DD,MM,YYYY",
-    [DATETIME_FORMATS.FULL_DATE_TIME]: "YYYY-MM-DD HH:mm:ss",
-    [DATETIME_FORMATS.ISO_DATE_TIME]: "YYYY-MM-DDTHH:mm:ss.SSSZ",
-    [DATETIME_FORMATS.LOCALIZED_DATE]: "MMMM DD, YYYY",
-    [DATETIME_FORMATS.SHORT_DATE]: "MM/DD/YY",
-    [DATETIME_FORMATS.SHORT_DATE_WITH_TIME]: "MM/DD/YY HH:mm",
-    [DATETIME_FORMATS.TIME_24H]: "HH:mm",
-    [DATETIME_FORMATS.TIME_12H]: "hh:mm A",
-    [DATETIME_FORMATS.TIME_12H_WITH_SECONDS]: "hh:mm:ss A",
-    [DATETIME_FORMATS.TIME_24H_WITH_SECONDS]: "HH:mm:ss",
-    [DATETIME_FORMATS.MONTH_DAY]: "MM/DD",
-    [DATETIME_FORMATS.YEAR_MONTH_DAY]: "YYYY/MM/DD"
+  [DATETIME_FORMATS.DATE_FORMAT]: "YYYY-MM-DD",
+  // Стандартный формат даты
+  [DATETIME_FORMATS.DATE_WITHOUT_SEPARATORS]: "MMDDYYYY",
+  // Без разделителей
+  [DATETIME_FORMATS.VALIDATION_DATE_FORMAT]: "MM/DD/YYYY",
+  // Для валидации
+  [DATETIME_FORMATS.INPUT_DATE_FORMAT]: "MM.DD.YYYY",
+  // Формат для ввода
+  [DATETIME_FORMATS.INPUT_TIME_FORMAT]: "YYYY-MM-DD HH:mm:SS",
+  // Ввод времени
+  [DATETIME_FORMATS.TIME_FORMAT_WSPACE]: "YYYY-MM-DD HH:mm:SS",
+  // Время с пробелом
+  [DATETIME_FORMATS.TIME_FORMAT]: "YYYY-MM-DDTHH:mm:SS",
+  // Время с T (ISO формат)
+  [DATETIME_FORMATS.DATE_FORMAT_WITH_SLASH]: "MM/DD/YYYY",
+  // Дата с разделителем /
+  [DATETIME_FORMATS.DATE_WITH_DASHES]: "MM-DD-YYYY",
+  // Дата с дефисами
+  [DATETIME_FORMATS.DATE_WITH_DOTS]: "DD.MM.YYYY",
+  // Дата с точками
+  [DATETIME_FORMATS.DATE_WITH_COMMA]: "DD,MM,YYYY",
+  // Дата с запятыми
+  [DATETIME_FORMATS.FULL_DATE_TIME]: "YYYY-MM-DD HH:mm:ss",
+  // Полная дата и время
+  [DATETIME_FORMATS.ISO_DATE_TIME]: "YYYY-MM-DDTHH:mm:ss.SSSZ",
+  // ISO стандарт с миллисекундами
+  [DATETIME_FORMATS.LOCALIZED_DATE]: "MMMM DD, YYYY",
+  // Локализованный формат с полным названием месяца
+  [DATETIME_FORMATS.SHORT_DATE]: "MM/DD/YY",
+  // Краткая дата
+  [DATETIME_FORMATS.SHORT_DATE_WITH_TIME]: "MM/DD/YY HH:mm",
+  // Краткая дата с временем
+  [DATETIME_FORMATS.TIME_24H]: "HH:mm",
+  // Время в 24-часовом формате
+  [DATETIME_FORMATS.TIME_12H]: "hh:mm A",
+  // Время в 12-часовом формате
+  [DATETIME_FORMATS.TIME_12H_WITH_SECONDS]: "hh:mm:ss A",
+  // Время в 12-часовом формате с секундами
+  [DATETIME_FORMATS.TIME_24H_WITH_SECONDS]: "HH:mm:ss",
+  // Время в 24-часовом формате с секундами
+  [DATETIME_FORMATS.MONTH_DAY]: "MM/DD",
+  // Только месяц и день
+  [DATETIME_FORMATS.YEAR_MONTH_DAY]: "YYYY/MM/DD" // Год/Месяц/День
 });
-const DATE_UNITS = Object.freeze({
-    YEARS: Object.freeze({
-        YEARS: "years",
-        YEAR: "year",
-        Y: "y",
-        TEMPLATE: "YYYY"
-    }),
-    MONTHS: Object.freeze({
-        MONTHS: "months",
-        MONTH: "month",
-        MON: "M",
-        TEMPLATE: "MM"
-    }),
-    DAYS: Object.freeze({
-        DAYS: "days",
-        DAY: "day",
-        D: "d",
-        TEMPLATE: "DD"
-    }),
-    HOURS: Object.freeze({
-        HOURS: "hours",
-        HOUR: "hour",
-        H: "h",
-        TEMPLATE: "HH"
-    }),
-    WEEKS: Object.freeze({
-        WEEKS: "weeks",
-        WEEK: "week",
-        W: "w"
-    }),
-    QUARTERS: Object.freeze({
-        QUARTERS: "quarters",
-        QUARTER: "quarter",
-        Q: "Q"
-    }),
-    MINUTES: Object.freeze({
-        MINUTES: "minutes",
-        MINUTE: "minute",
-        MIN: "m"
-    }),
-    SECONDS: Object.freeze({
-        SECONDS: "seconds",
-        SECOND: "second",
-        S: "s"
-    }),
-    MILLISECONDS: Object.freeze({
-        MILLISECONDS: "milliseconds",
-        MILLISECOND: "millisecond",
-        MS: "ms"
-    })
+
+/**
+ * @constant {Object} DATE_UNITS
+ * @description Единицы времени, которые могут быть использованы для работы с датами.
+ */
+const DATE_UNITS = exports.DATE_UNITS = Object.freeze({
+  YEARS: Object.freeze({
+    YEARS: "years",
+    YEAR: "year",
+    Y: "y",
+    TEMPLATE: "YYYY"
+  }),
+  MONTHS: Object.freeze({
+    MONTHS: "months",
+    MONTH: "month",
+    MON: "M",
+    TEMPLATE: "MM"
+  }),
+  DAYS: Object.freeze({
+    DAYS: "days",
+    DAY: "day",
+    D: "d",
+    TEMPLATE: "DD"
+  }),
+  HOURS: Object.freeze({
+    HOURS: "hours",
+    HOUR: "hour",
+    H: "h",
+    TEMPLATE: "HH"
+  }),
+  WEEKS: Object.freeze({
+    WEEKS: "weeks",
+    WEEK: "week",
+    W: "w"
+  }),
+  QUARTERS: Object.freeze({
+    QUARTERS: "quarters",
+    QUARTER: "quarter",
+    Q: "Q"
+  }),
+  MINUTES: Object.freeze({
+    MINUTES: "minutes",
+    MINUTE: "minute",
+    MIN: "m"
+  }),
+  SECONDS: Object.freeze({
+    SECONDS: "seconds",
+    SECOND: "second",
+    S: "s"
+  }),
+  MILLISECONDS: Object.freeze({
+    MILLISECONDS: "milliseconds",
+    MILLISECOND: "millisecond",
+    MS: "ms"
+  })
 });
-function parseAndFormatDate(value, outputFormat = DATETIME_FORMATS.INPUT_DATE_FORMAT) {
-    if (!value || typeof value !== "string") return value;
-    for(let format in formatMap){
-        const parsedDate = (0, _moment.default)(value, formatMap[format], true);
-        if (parsedDate.isValid()) {
-            return parsedDate.format(outputFormat);
-        }
+
+/**
+ * Функция для парсинга и форматирования строки с датой в указанный формат.
+ *
+ * @param {string} value - Строка с датой, которую необходимо распарсить и отформатировать.
+ * @param {string} [outputFormat=DATETIME_FORMATS.INPUT_DATE_FORMAT] - Формат, в который будет преобразована дата.
+ * Если не указан, используется формат по умолчанию `MM.DD.YYYY`.
+ *
+ * @returns {string} - Отформатированная дата в строковом виде, или исходная строка, если дата не распознана.
+ *
+ * @throws {Error} - Если значение даты некорректно (не строка или пустое).
+ */
+function parseAndFormatDate(value) {
+  let outputFormat = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : DATETIME_FORMATS.INPUT_DATE_FORMAT;
+  if (!value || typeof value !== "string") return value;
+  for (let format in formatMap) {
+    const parsedDate = (0, _moment.default)(value, formatMap[format], true);
+    if (parsedDate.isValid()) {
+      return parsedDate.format(outputFormat);
     }
-    return value;
-}
+  }
+  return value;
+}