@qrvey/utils 1.10.0-0 → 1.10.0-10

package/dist/cjs/dates/adapters/yearToDate.d.ts

@@ -1,7 +1,8 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transforms String Date from a [Year] format to Date object.
  * @param yearDate String of [Year] date
  * @param time Flag to parse the object date to milliseconds.
  * @returns The date object or the date in milliseconds. If the argument is an unexpected date, the function will return the same value.
  */
-export declare function yearToDate(yearDate: string, time?: boolean): string | Date | number;
+export declare function yearToDate(yearDate: string, settings?: IDateSettings): string | Date | number;

package/dist/cjs/dates/adapters/yearToDate.js

@@ -4,6 +4,8 @@ exports.yearToDate = void 0;
 const isEmpty_1 = require("../../general/mix/isEmpty");
 const isTokenLabel_1 = require("../../tokens/isTokenLabel");
 const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const getDateByTimezone_1 = require("../helpers/getDateByTimezone");
+const getDefaultDateSettings_1 = require("../helpers/getDefaultDateSettings");
 const validateDate_1 = require("../helpers/validateDate");
 /**
  * Transforms String Date from a [Year] format to Date object.
@@ -11,13 +13,15 @@ const validateDate_1 = require("../helpers/validateDate");
  * @param time Flag to parse the object date to milliseconds.
  * @returns The date object or the date in milliseconds. If the argument is an unexpected date, the function will return the same value.
  */
-function yearToDate(yearDate, time = false) {
+function yearToDate(yearDate, settings) {
     if ((0, isEmpty_1.isEmpty)(yearDate) ||
         (0, isTokenLabel_1.isTokenLabel)(yearDate) ||
         typeof yearDate !== "string" ||
         !(0, validateDate_1.validateDate)(yearDate, DATE_FORMAT_1.DATE_FORMAT.YEAR))
         return yearDate;
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
     const start = new Date(+yearDate, 0, 1);
-    return time ? +start : start;
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(start, defaultSettings.timezone);
+    return (defaultSettings === null || defaultSettings === void 0 ? void 0 : defaultSettings.convertMiliseconds) ? +timezonedDate : timezonedDate;
 }
 exports.yearToDate = yearToDate;

package/dist/cjs/dates/constants/ISO_8601_REGEX.d.ts

@@ -0,0 +1 @@
+export declare const ISO_8601_REGEX: RegExp;

package/dist/cjs/dates/constants/ISO_8601_REGEX.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ISO_8601_REGEX = void 0;
+exports.ISO_8601_REGEX = /^[+-]?\d{2}:\d{2}$/;

package/dist/cjs/dates/constants/TIMEZONE_TYPE.d.ts

@@ -0,0 +1,5 @@
+export declare enum TIMEZONE_TYPE {
+    BROWSER = "BROWSER",
+    DEFAULT = "DEFAULT",
+    FIXED = "FIXED"
+}

package/dist/cjs/dates/constants/TIMEZONE_TYPE.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIMEZONE_TYPE = void 0;
+var TIMEZONE_TYPE;
+(function (TIMEZONE_TYPE) {
+    TIMEZONE_TYPE["BROWSER"] = "BROWSER";
+    TIMEZONE_TYPE["DEFAULT"] = "DEFAULT";
+    TIMEZONE_TYPE["FIXED"] = "FIXED";
+})(TIMEZONE_TYPE = exports.TIMEZONE_TYPE || (exports.TIMEZONE_TYPE = {}));

package/dist/cjs/dates/constants/index.d.ts

@@ -38,6 +38,7 @@ export * from "./DATE_YEAR_MONTHS_MMMM";
 export * from "./DATE_YEAR_QUARTERS";
 export * from "./DATE_YEAR_QUARTERS_RANGE";
 export * from "./DATETIME_COLUMN_FORMAT";
+export * from "./ISO_8601_REGEX";
 export * from "./TIME_GROUPING_PROPERTY_INFO_LIST";
 export * from "./TIME_GROUPING_PROPERTY_INFO";
 export * from "./TIME_GROUPING_PROPERTY_LABEL";

package/dist/cjs/dates/constants/index.js

@@ -54,6 +54,7 @@ __exportStar(require("./DATE_YEAR_MONTHS_MMMM"), exports);
 __exportStar(require("./DATE_YEAR_QUARTERS"), exports);
 __exportStar(require("./DATE_YEAR_QUARTERS_RANGE"), exports);
 __exportStar(require("./DATETIME_COLUMN_FORMAT"), exports);
+__exportStar(require("./ISO_8601_REGEX"), exports);
 __exportStar(require("./TIME_GROUPING_PROPERTY_INFO_LIST"), exports);
 __exportStar(require("./TIME_GROUPING_PROPERTY_INFO"), exports);
 __exportStar(require("./TIME_GROUPING_PROPERTY_LABEL"), exports);

package/dist/cjs/dates/helpers/getDateByDateFormat.d.ts

@@ -1,4 +1,5 @@
 import { IDateFormat } from "../interfaces/IDateFormat";
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Gets a Date Object instance by a Date format
  * @param date String with a formatted date
@@ -6,4 +7,4 @@ import { IDateFormat } from "../interfaces/IDateFormat";
  * @param time flag to convert the formatted date to miliseconds
  * @returns a Date object, milisecond time or the same value if date format does not match.
  */
-export declare function getDateByDateFormat(date: string, format: IDateFormat, time?: boolean): string | Date | number;
+export declare function getDateByDateFormat(date: string, format: IDateFormat, settings?: IDateSettings): string | Date | number;

package/dist/cjs/dates/helpers/getDateByDateFormat.js

@@ -14,21 +14,21 @@ const mdyDateToDate_1 = require("../adapters/mdyDateToDate");
  * @param time flag to convert the formatted date to miliseconds
  * @returns a Date object, milisecond time or the same value if date format does not match.
  */
-function getDateByDateFormat(date, format, time = false) {
+function getDateByDateFormat(date, format, settings) {
     switch (format) {
         case DATE_FORMAT_1.DATE_FORMAT.YEAR:
-            return (0, yearToDate_1.yearToDate)(date, time);
+            return (0, yearToDate_1.yearToDate)(date, settings);
         case DATE_FORMAT_1.DATE_FORMAT.MONTH:
-            return (0, monthYearToDate_1.monthYearToDate)(date, time);
+            return (0, monthYearToDate_1.monthYearToDate)(date, settings);
         case DATE_FORMAT_1.DATE_FORMAT.QUARTER:
-            return (0, quarterYearToDate_1.quarterYearToDate)(date, time);
+            return (0, quarterYearToDate_1.quarterYearToDate)(date, settings);
         case DATE_FORMAT_1.DATE_FORMAT.WEEK:
-            return (0, weekYearToDate_1.weekYearToDate)(date, time);
+            return (0, weekYearToDate_1.weekYearToDate)(date, settings);
         case DATE_FORMAT_1.DATE_FORMAT.DAY:
         case DATE_FORMAT_1.DATE_FORMAT.HOUR:
         case DATE_FORMAT_1.DATE_FORMAT.MINUTE:
         case DATE_FORMAT_1.DATE_FORMAT.SECOND:
-            return (0, mdyDateToDate_1.mdyDateToDate)(date, time);
+            return (0, mdyDateToDate_1.mdyDateToDate)(date, settings);
         default:
             return date;
     }

package/dist/cjs/dates/helpers/getDateByTimezone.d.ts

@@ -0,0 +1,8 @@
+import { IDTimezone } from "../interfaces/IDTimezone";
+/**
+ * Gets a date value in the given timezone
+ * @param {string} date the date
+ * @param {IDTimezone} timezone the timezone object
+ * @returns {string} A transformed value
+ */
+export declare function getDateByTimezone(date: string | number | Date, timezone: IDTimezone): string | number | Date;

package/dist/cjs/dates/helpers/getDateByTimezone.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDateByTimezone = void 0;
+const isEmpty_1 = require("../../general/mix/isEmpty");
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const getDateByTimezoneOffset_1 = require("./getDateByTimezoneOffset");
+const getTimezoneObject_1 = require("./getTimezoneObject");
+const isValidPotentialDate_1 = require("./isValidPotentialDate");
+const validateDate_1 = require("./validateDate");
+/**
+ * Gets a date value in the given timezone
+ * @param {string} date the date
+ * @param {IDTimezone} timezone the timezone object
+ * @returns {string} A transformed value
+ */
+function getDateByTimezone(date, timezone) {
+    const defaultTimezone = (0, getTimezoneObject_1.getTimezoneObject)(timezone);
+    if ((0, isEmpty_1.isEmpty)(timezone === null || timezone === void 0 ? void 0 : timezone.offset) ||
+        !(0, isValidPotentialDate_1.isValidPotentialDate)(date) ||
+        (typeof date === "string" && !(0, validateDate_1.validateDate)(date, DATE_FORMAT_1.DATE_FORMAT.SECOND)))
+        return date;
+    return (0, getDateByTimezoneOffset_1.getDateByTimezoneOffset)(date, defaultTimezone.offset);
+}
+exports.getDateByTimezone = getDateByTimezone;

package/dist/cjs/dates/helpers/getDateByTimezoneOffset.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Gets a Date with the given offset of the Timezone.
+ * No given an offset the default is going to be set by the browser
+ * @param date String, object or millisencond number of the date
+ * @returns updated Date object
+ */
+export declare function getDateByTimezoneOffset(date: string | Date | number, offset?: number | string): string | Date | number;

package/dist/cjs/dates/helpers/getDateByTimezoneOffset.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDateByTimezoneOffset = void 0;
+const dayjs_1 = __importDefault(require("dayjs"));
+const ISOToNumericOffset_1 = require("../adapters/ISOToNumericOffset");
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const isValidPotentialDate_1 = require("./isValidPotentialDate");
+const validateDate_1 = require("./validateDate");
+/**
+ * Gets a Date with the given offset of the Timezone.
+ * No given an offset the default is going to be set by the browser
+ * @param date String, object or millisencond number of the date
+ * @returns updated Date object
+ */
+function getDateByTimezoneOffset(date, offset) {
+    if (!(0, isValidPotentialDate_1.isValidPotentialDate)(date) ||
+        (typeof date === "string" && !(0, validateDate_1.validateDate)(date, DATE_FORMAT_1.DATE_FORMAT.SECOND)))
+        return date;
+    const dt = new Date(date.valueOf());
+    const newOffset = (0, ISOToNumericOffset_1.ISOToNumericOffset)(offset);
+    const timezonedDate = new Date(+dt + newOffset * 1000 * 60);
+    if (typeof date === "string") {
+        return (0, dayjs_1.default)(timezonedDate).format(DATE_FORMAT_1.DATE_FORMAT.SECOND);
+    }
+    else if (typeof date === "number") {
+        return +timezonedDate;
+    }
+    return timezonedDate;
+}
+exports.getDateByTimezoneOffset = getDateByTimezoneOffset;

package/dist/cjs/dates/helpers/getDefaultDateSettings.d.ts

@@ -0,0 +1,7 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
+/**
+ * Gets the default properties for Date Settings object
+ * @param settings the date settings
+ * @returns a new object with the date settings.
+ */
+export declare function getDefaultDateSettings(settings: IDateSettings): IDateSettings;

package/dist/cjs/dates/helpers/getDefaultDateSettings.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultDateSettings = void 0;
+const getTimezoneObject_1 = require("./getTimezoneObject");
+/**
+ * Gets the default properties for Date Settings object
+ * @param settings the date settings
+ * @returns a new object with the date settings.
+ */
+function getDefaultDateSettings(settings) {
+    var _a;
+    return {
+        convertMiliseconds: (_a = settings === null || settings === void 0 ? void 0 : settings.convertMiliseconds) !== null && _a !== void 0 ? _a : false,
+        timezone: (0, getTimezoneObject_1.getTimezoneObject)(settings === null || settings === void 0 ? void 0 : settings.timezone),
+    };
+}
+exports.getDefaultDateSettings = getDefaultDateSettings;

package/dist/cjs/dates/helpers/getFormattedDateByFormat.d.ts

@@ -1,4 +1,5 @@
 import { IDateFormat } from "../interfaces/IDateFormat";
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * A Date object, string or millisecond number are gotten in order to convert it in an formatted string date
  * - Some strings are valid
@@ -6,4 +7,4 @@ import { IDateFormat } from "../interfaces/IDateFormat";
  * @param format The date format
  * @returns a formmatted date or the same value if format does not match
  */
-export declare function getFormattedDateByFormat(date: string | Date | number, format: IDateFormat): string | Date | number;
+export declare function getFormattedDateByFormat(date: string | Date | number, format: IDateFormat, settings?: IDateSettings): string | Date | number;

package/dist/cjs/dates/helpers/getFormattedDateByFormat.js

@@ -14,22 +14,22 @@ const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
  * @param format The date format
  * @returns a formmatted date or the same value if format does not match
  */
-function getFormattedDateByFormat(date, format) {
+function getFormattedDateByFormat(date, format, settings) {
     switch (format) {
         case DATE_FORMAT_1.DATE_FORMAT.YEAR:
-            return (0, dateToYear_1.dateToYear)(date);
+            return (0, dateToYear_1.dateToYear)(date, settings);
         case DATE_FORMAT_1.DATE_FORMAT.MONTH:
-            return (0, dateToMonthYear_1.dateToMonthYear)(date);
+            return (0, dateToMonthYear_1.dateToMonthYear)(date, settings);
         case DATE_FORMAT_1.DATE_FORMAT.QUARTER:
-            return (0, dateToQuarterYear_1.dateToQuarterYear)(date);
+            return (0, dateToQuarterYear_1.dateToQuarterYear)(date, settings);
         case DATE_FORMAT_1.DATE_FORMAT.WEEK:
-            return (0, dateToWeekYear_1.dateToWeekYear)(date);
+            return (0, dateToWeekYear_1.dateToWeekYear)(date, settings);
         case DATE_FORMAT_1.DATE_FORMAT.DAY:
-            return (0, dateToMdyDate_1.dateToMdyDate)(date);
+            return (0, dateToMdyDate_1.dateToMdyDate)(date, settings);
         case DATE_FORMAT_1.DATE_FORMAT.HOUR:
         case DATE_FORMAT_1.DATE_FORMAT.MINUTE:
         case DATE_FORMAT_1.DATE_FORMAT.SECOND:
-            return (0, dateToMdyDate_1.dateToMdyDate)(date, true);
+            return (0, dateToMdyDate_1.dateToMdyDate)(date, Object.assign(Object.assign({}, settings), { convertMiliseconds: true }));
         default:
             return date;
     }

package/dist/cjs/dates/helpers/getTimezoneObject.d.ts

@@ -0,0 +1,11 @@
+import { IDataset } from "../../qrvey/interfaces/IDataset";
+import { IModel } from "../../qrvey/interfaces/IModel";
+import { IDTimezone } from "../interfaces/IDTimezone";
+/**
+ * Gets the timezone object by the given argument or the model object
+ * - In any case, the offset is prioritized to override other properties.
+ * @param {IDTimezone} timezone the timezone object
+ * @param {IModel | IDataset} model the info of the dataset (model)
+ * @returns a new timezone object
+ */
+export declare function getTimezoneObject(timezone: IDTimezone, model?: IModel | IDataset): IDTimezone;

package/dist/cjs/dates/helpers/getTimezoneObject.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTimezoneObject = void 0;
+const isEmpty_1 = require("../../general/mix/isEmpty");
+const TIMEZONE_TYPE_1 = require("../constants/TIMEZONE_TYPE");
+const getTimezoneOffsetByType_1 = require("./getTimezoneOffsetByType");
+const getUTCFormatByOffset_1 = require("./getUTCFormatByOffset");
+const isValidISOOffset_1 = require("./isValidISOOffset");
+/**
+ * Gets the timezone object by the given argument or the model object
+ * - In any case, the offset is prioritized to override other properties.
+ * @param {IDTimezone} timezone the timezone object
+ * @param {IModel | IDataset} model the info of the dataset (model)
+ * @returns a new timezone object
+ */
+function getTimezoneObject(timezone, model) {
+    const offset = getOffset(timezone, model);
+    const type = getType(timezone, model, offset);
+    const resultingOffset = (0, getTimezoneOffsetByType_1.getTimezoneOffsetByType)({ offset, type });
+    const utc = getUTC({ offset: resultingOffset, type });
+    return {
+        offset: resultingOffset,
+        type,
+        utc,
+    };
+}
+exports.getTimezoneObject = getTimezoneObject;
+/**
+ * Gets the offset of the timezone by the given objects
+ * - Searchs the first argument
+ * - If the timezone is empty, in the model timezone is searched
+ * - If it does not exist in any, a default one is set.
+ * @param {IDTimezone} timezone The timezone object
+ * @param {IModel | IDataset} model The model info
+ * @returns {IDTimezoneOffset} the offset of the objects
+ */
+function getOffset(timezone, model) {
+    var _a;
+    let offset;
+    if (!(0, isEmpty_1.isEmpty)(timezone === null || timezone === void 0 ? void 0 : timezone.offset)) {
+        offset = timezone.offset;
+    }
+    else if (!(0, isEmpty_1.isEmpty)((_a = model === null || model === void 0 ? void 0 : model.timezone) === null || _a === void 0 ? void 0 : _a.offset)) {
+        offset = model.timezone.offset;
+    }
+    else {
+        offset = "+00:00";
+    }
+    return offset;
+}
+/**
+ * Gets the type of the timezone
+ * - Searchs the first argument
+ * - If it does not exist, asking for the timezone offset in order to prioritized the offset above all.
+ * - If the timezone is empty, in the model timezone is searched.
+ * - If it does not exist in any, a default one is set.
+ * @param {IDTimezone} timezone The timezone object
+ * @param {IModel | IDataset} model The model info
+ * @param {IDTimezoneOffset} offset a default offset if the validation are not satisfied
+ * @returns {IDTimezoneType} the rigth type of the timezone
+ */
+function getType(timezone, model, offset) {
+    var _a;
+    let type;
+    if (!(0, isEmpty_1.isEmpty)(timezone === null || timezone === void 0 ? void 0 : timezone.type)) {
+        type = timezone.type;
+    }
+    else if (!(0, isEmpty_1.isEmpty)(timezone === null || timezone === void 0 ? void 0 : timezone.offset)) {
+        type = getTypeByOffset(timezone === null || timezone === void 0 ? void 0 : timezone.offset);
+    }
+    else if (!(0, isEmpty_1.isEmpty)((_a = model === null || model === void 0 ? void 0 : model.timezone) === null || _a === void 0 ? void 0 : _a.type)) {
+        type = model.timezone.type;
+    }
+    if ((0, isEmpty_1.isEmpty)(type)) {
+        type = getTypeByOffset(offset);
+    }
+    return type;
+}
+/**
+ * Gets the type by a offset
+ * - For a offset=0 the type is default
+ * - For a offset="browser" the type is browser
+ * - For a valid offset different to previous ones, the type is fixed;
+ * - Anything else, it is considered default.
+ * @param {IDTimezoneOffset} offset a given offset
+ * @returns {IDTimezoneType} the right timezone type for the offset
+ */
+function getTypeByOffset(offset) {
+    if (offset === "+00:00") {
+        return TIMEZONE_TYPE_1.TIMEZONE_TYPE.DEFAULT;
+    }
+    else if (offset === "browser") {
+        return TIMEZONE_TYPE_1.TIMEZONE_TYPE.BROWSER;
+    }
+    else if ((0, isValidISOOffset_1.isValidISOOffset)(offset)) {
+        return TIMEZONE_TYPE_1.TIMEZONE_TYPE.FIXED;
+    }
+    return TIMEZONE_TYPE_1.TIMEZONE_TYPE.DEFAULT;
+}
+/**
+ * Gets the UTC string by the timezone object
+ * @param {IDTimezone} timezone the timezone object
+ * @returns {string} the label of the UTC value
+ */
+function getUTC(timezone) {
+    return (0, getUTCFormatByOffset_1.getUTCFormatByOffset)(timezone);
+}

package/dist/cjs/dates/helpers/getTimezoneOffsetByType.d.ts

@@ -0,0 +1,13 @@
+import { IBTimezone } from "../interfaces/IBTimezone";
+import { IDTimezone } from "../interfaces/IDTimezone";
+import { IDTimezoneOffset } from "../interfaces/IDTimezoneOffset";
+/**
+ * Gets the timezone offset by the timezone type.
+ * For browser types, it is calculated by a Date instance
+ * Default types is UTC-0
+ * Undefined or Fixed types is gotten by the offset property
+ * @param {IDTimezoneType} type the timezone type
+ * @param {IDTimezone | IBTimezone} timezone the timezone object
+ * @returns {IDTimezoneOffset} the offset of the timezone
+ */
+export declare function getTimezoneOffsetByType(timezone: IDTimezone | IBTimezone): IDTimezoneOffset;

package/dist/cjs/dates/helpers/getTimezoneOffsetByType.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTimezoneOffsetByType = void 0;
+const isEmpty_1 = require("../../general/mix/isEmpty");
+const numericOffsetToISO_1 = require("../adapters/numericOffsetToISO");
+const TIMEZONE_TYPE_1 = require("../constants/TIMEZONE_TYPE");
+/**
+ * Gets the timezone offset by the timezone type.
+ * For browser types, it is calculated by a Date instance
+ * Default types is UTC-0
+ * Undefined or Fixed types is gotten by the offset property
+ * @param {IDTimezoneType} type the timezone type
+ * @param {IDTimezone | IBTimezone} timezone the timezone object
+ * @returns {IDTimezoneOffset} the offset of the timezone
+ */
+function getTimezoneOffsetByType(timezone) {
+    if ((0, isEmpty_1.isEmpty)(timezone))
+        return "+00:00";
+    if (timezone.type === TIMEZONE_TYPE_1.TIMEZONE_TYPE.BROWSER) {
+        return (0, numericOffsetToISO_1.numericOffsetToISO)("browser");
+    }
+    else if (timezone.type === TIMEZONE_TYPE_1.TIMEZONE_TYPE.DEFAULT) {
+        return "+00:00";
+    }
+    return timezone.offset || timezone.numericOffset || "+00:00";
+}
+exports.getTimezoneOffsetByType = getTimezoneOffsetByType;

package/dist/cjs/dates/helpers/getUTCFormatByOffset.d.ts

@@ -0,0 +1,7 @@
+import { IDTimezone } from "../interfaces/IDTimezone";
+/**
+ * Gets the UTC format dependeing on the given offset
+ * @param {IDTimezone} timezone the timezone object
+ * @returns {string} an string with the UTC format
+ */
+export declare function getUTCFormatByOffset(timezone: IDTimezone): string;

package/dist/cjs/dates/helpers/getUTCFormatByOffset.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUTCFormatByOffset = void 0;
+const numericOffsetToISO_1 = require("../adapters/numericOffsetToISO");
+/**
+ * Gets the UTC format dependeing on the given offset
+ * @param {IDTimezone} timezone the timezone object
+ * @returns {string} an string with the UTC format
+ */
+function getUTCFormatByOffset(timezone) {
+    let newOffset = (0, numericOffsetToISO_1.numericOffsetToISO)(timezone === null || timezone === void 0 ? void 0 : timezone.offset, false);
+    if (newOffset.search(":0") > -1) {
+        newOffset = newOffset.slice(0, newOffset.indexOf(":"));
+    }
+    return `UTC${newOffset}`;
+}
+exports.getUTCFormatByOffset = getUTCFormatByOffset;

package/dist/cjs/dates/helpers/getWeek.js

@@ -12,17 +12,17 @@ function getWeek(date) {
     if (!(0, isValidDateObject_1.isValidDateObject)(date))
         return;
     const target = new Date(date.valueOf());
-    const dayNr = (date.getDay() + 6) % 7;
-    target.setDate(target.getDate() - dayNr + 3);
+    const dayNr = (date.getUTCDay() + 6) % 7;
+    target.setDate(target.getUTCDate() - dayNr + 3);
     const firstThursday = target.valueOf();
     target.setMonth(0, 1);
-    if (target.getDay() !== 4) {
-        target.setMonth(0, 1 + ((4 - target.getDay() + 7) % 7));
+    if (target.getUTCDay() !== 4) {
+        target.setMonth(0, 1 + ((4 - target.getUTCDay() + 7) % 7));
     }
     return {
         week: 1 + Math.ceil((firstThursday - +target) / 604800000),
-        month: date.getMonth() + 1,
-        year: target.getFullYear(),
+        month: date.getUTCMonth() + 1,
+        year: target.getUTCFullYear(),
     };
 }
 exports.getWeek = getWeek;

package/dist/cjs/dates/helpers/index.d.ts

@@ -1,12 +1,17 @@
-export * from "./adjustTimezone";
 export * from "./areIncludedDateTokens";
 export * from "./getDateByDateFormat";
+export * from "./getDateByTimezone";
+export * from "./getDateByTimezoneOffset";
 export * from "./getDateFormatByProperty";
 export * from "./getDateFormatRegularExpressionInArray";
 export * from "./getDatePickerPickLevel";
 export * from "./getDateRange";
+export * from "./getDefaultDateSettings";
 export * from "./getFormattedDateByFormat";
 export * from "./getSeparatorByDateFormat";
+export * from "./getTimezoneObject";
+export * from "./getTimezoneOffsetByType";
+export * from "./getUTCFormatByOffset";
 export * from "./getWeek";
 export * from "./isValidDateObject";
 export * from "./isValidPotentialDate";

package/dist/cjs/dates/helpers/index.js

@@ -14,15 +14,20 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./adjustTimezone"), exports);
 __exportStar(require("./areIncludedDateTokens"), exports);
 __exportStar(require("./getDateByDateFormat"), exports);
+__exportStar(require("./getDateByTimezone"), exports);
+__exportStar(require("./getDateByTimezoneOffset"), exports);
 __exportStar(require("./getDateFormatByProperty"), exports);
 __exportStar(require("./getDateFormatRegularExpressionInArray"), exports);
 __exportStar(require("./getDatePickerPickLevel"), exports);
 __exportStar(require("./getDateRange"), exports);
+__exportStar(require("./getDefaultDateSettings"), exports);
 __exportStar(require("./getFormattedDateByFormat"), exports);
 __exportStar(require("./getSeparatorByDateFormat"), exports);
+__exportStar(require("./getTimezoneObject"), exports);
+__exportStar(require("./getTimezoneOffsetByType"), exports);
+__exportStar(require("./getUTCFormatByOffset"), exports);
 __exportStar(require("./getWeek"), exports);
 __exportStar(require("./isValidDateObject"), exports);
 __exportStar(require("./isValidPotentialDate"), exports);

package/dist/cjs/dates/helpers/isValidISOOffset.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Validate if offset uses a valid ISO 8601 offset specification
+ * - If the given offset is a numeric, returns an invalid flag.
+ * @param {string} offset the timezone offset
+ * @returns {boolean} true if the given offset is valid
+ */
+export declare function isValidISOOffset(offset: number | string): boolean;

package/dist/cjs/dates/helpers/isValidISOOffset.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidISOOffset = void 0;
+const ISO_8601_REGEX_1 = require("../constants/ISO_8601_REGEX");
+/**
+ * Validate if offset uses a valid ISO 8601 offset specification
+ * - If the given offset is a numeric, returns an invalid flag.
+ * @param {string} offset the timezone offset
+ * @returns {boolean} true if the given offset is valid
+ */
+function isValidISOOffset(offset) {
+    if (typeof offset !== "string")
+        return false;
+    const newOffset = (offset || "").trim();
+    return ISO_8601_REGEX_1.ISO_8601_REGEX.test(newOffset);
+}
+exports.isValidISOOffset = isValidISOOffset;

package/dist/cjs/dates/interfaces/IBTimezone.d.ts

@@ -0,0 +1,7 @@
+import { IBTimezoneType } from "./IBTimezoneType";
+export interface IBTimezone {
+    numericOffset: number;
+    offset: string;
+    timezoneid?: string;
+    type: IBTimezoneType;
+}

package/dist/cjs/dates/interfaces/IBTimezone.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/dates/interfaces/IBTimezoneType.d.ts

@@ -0,0 +1,2 @@
+import { TIMEZONE_TYPE } from "../constants/TIMEZONE_TYPE";
+export type IBTimezoneType = TIMEZONE_TYPE;

package/dist/cjs/dates/interfaces/IBTimezoneType.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/dates/interfaces/IDFDateToHmsSettings.d.ts

@@ -1,4 +1,5 @@
-export interface IDFDateToHmsSettings {
+import { IDateSettings } from "./IDateSettings";
+export interface IDFDateToHmsSettings extends IDateSettings {
     omitHour?: boolean;
     omitMinute?: boolean;
     omitSecond?: boolean;

package/dist/cjs/dates/interfaces/IDTimezone.d.ts

@@ -0,0 +1,7 @@
+import { IDTimezoneOffset } from "./IDTimezoneOffset";
+import { IDTimezoneType } from "./IDTimezoneType";
+export interface IDTimezone {
+    offset: IDTimezoneOffset;
+    type?: IDTimezoneType;
+    utc?: string;
+}

package/dist/cjs/dates/interfaces/IDTimezone.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/dates/interfaces/IDTimezoneOffset.d.ts

@@ -0,0 +1 @@
+export type IDTimezoneOffset = number | string;

package/dist/cjs/dates/interfaces/IDTimezoneOffset.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/dates/interfaces/IDTimezoneType.d.ts

@@ -0,0 +1,2 @@
+import { IBTimezoneType } from "./IBTimezoneType";
+export type IDTimezoneType = IBTimezoneType;

package/dist/cjs/dates/interfaces/IDTimezoneType.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/dates/interfaces/IDateSettings.d.ts

@@ -0,0 +1,5 @@
+import { IDTimezone } from "./IDTimezone";
+export interface IDateSettings {
+    timezone?: IDTimezone;
+    convertMiliseconds?: boolean;
+}

package/dist/cjs/dates/interfaces/IDateSettings.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });