@qrvey/utils 1.10.0-0 → 1.10.0-2

package/dist/cjs/format/format.js

@@ -9,6 +9,7 @@ const dayjs_1 = __importDefault(require("dayjs"));
 const definition_1 = require("./definition");
 const isoWeek_1 = __importDefault(require("dayjs/plugin/isoWeek"));
 const advancedFormat_1 = __importDefault(require("dayjs/plugin/advancedFormat"));
+const utc_1 = __importDefault(require("dayjs/plugin/utc"));
 const isEmpty_1 = require("../general/mix/isEmpty");
 const get_1 = require("../general/object/get");
 const COLUMN_1 = require("../columns/constants/COLUMN");
@@ -19,6 +20,7 @@ const DURATION_PARTS_LIST_1 = require("../column_format/constants/DURATION_PARTS
 const cloneDeep_1 = require("../general/object/cloneDeep");
 dayjs_1.default.extend(isoWeek_1.default); // Add support for iso week format https://github.com/iamkun/dayjs/issues/1328
 dayjs_1.default.extend(advancedFormat_1.default); // Add support to advanced formats https://day.js.org/docs/en/plugin/advanced-format
+dayjs_1.default.extend(utc_1.default);
 /**
  * Apply to the given date format to a date value
  * @param bytes type number
@@ -27,7 +29,7 @@ function isValidDateString(dateString = "") {
     return (/^\d{2}\/\d{2}\/\d{4}/.test(dateString) || // MM/DD/YYY OR DD/MM/YYYY
         /^\d{4}-\d{2}-\d{2}/.test(dateString)); // YYYY-MM-DD
 }
-function formatDate(dateString, format) {
+function formatDate(dateString, format, offset) {
     let _format = (0, cloneDeep_1.cloneDeep)(format);
     if ((0, isObject_1.isObject)(format))
         _format = _format.format || "";
@@ -35,8 +37,12 @@ function formatDate(dateString, format) {
         return dateString;
     if (!isValidDateString(dateString))
         return dateString;
-    const dateValue = dateString === null || dateString === void 0 ? void 0 : dateString.replace(/Z$/i, "");
-    return (0, dayjs_1.default)(dateValue.split(".")[0]).format(_format
+    const dateStringCleaned = dateString === null || dateString === void 0 ? void 0 : dateString.replace(/Z$/i, "");
+    const firstPartOfDateString = (0, dayjs_1.default)(dateStringCleaned.split(".")[0]);
+    const newDateValue = !(0, isEmpty_1.isEmpty)(offset)
+        ? firstPartOfDateString.utcOffset(offset)
+        : firstPartOfDateString;
+    return newDateValue.format(_format
         .replace("HH24:", "HH:")
         .replace("MI:SS", "mm:ss")
         .replace("MM:SS", "mm:ss"));
@@ -146,7 +152,7 @@ const addFormat = (value, outputFormat = "None", config) => {
                 : formatDate(value, (outputFormat === null || outputFormat === void 0 ? void 0 : outputFormat.format) === "Default" &&
                     ((_c = outputFormat === null || outputFormat === void 0 ? void 0 : outputFormat.originalFormat) === null || _c === void 0 ? void 0 : _c.format)
                     ? (_d = outputFormat === null || outputFormat === void 0 ? void 0 : outputFormat.originalFormat) === null || _d === void 0 ? void 0 : _d.format
-                    : outputFormat === null || outputFormat === void 0 ? void 0 : outputFormat.format);
+                    : outputFormat === null || outputFormat === void 0 ? void 0 : outputFormat.format, config === null || config === void 0 ? void 0 : config.offset);
         case "NUMERIC": {
             const parse = parseFloat(value);
             const withLocale = (outputFormat !== "None" && (config === null || config === void 0 ? void 0 : config.lang)) ||

package/dist/cjs/general/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./array/index";
 export * from "./function/index";
 export * from "./mix/index";
+export * from "./numeric/index";
 export * from "./object/index";
 export * from "./string/index";

package/dist/cjs/general/index.js

@@ -17,5 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./array/index"), exports);
 __exportStar(require("./function/index"), exports);
 __exportStar(require("./mix/index"), exports);
+__exportStar(require("./numeric/index"), exports);
 __exportStar(require("./object/index"), exports);
 __exportStar(require("./string/index"), exports);

package/dist/cjs/general/numeric/getSign.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Gets the numeric sign of a given number
+ * @param {number} num the number
+ * @returns {string} an string with the sign
+ */
+export declare function getSign(num: number): string;

package/dist/cjs/general/numeric/getSign.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSign = void 0;
+/**
+ * Gets the numeric sign of a given number
+ * @param {number} num the number
+ * @returns {string} an string with the sign
+ */
+function getSign(num) {
+    return Math.sign(num) > -1 ? "+" : "-";
+}
+exports.getSign = getSign;

package/dist/cjs/general/numeric/index.d.ts

@@ -0,0 +1 @@
+export * from "./getSign";

package/dist/cjs/general/numeric/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./getSign"), exports);

package/dist/cjs/general/object/applyTimezoneDeep.d.ts

@@ -0,0 +1,8 @@
+import { IDTimezone } from "../../dates/interfaces/IDTimezone";
+/**
+ * Transforms the date+times propertiesof the given object by the Timezone object
+ * @param {any} obj the object
+ * @param {IDTimezone} timezone the timezone object
+ * @returns {IFSData | IFUData} the new filter data with the transformed datetime values
+ */
+export declare function applyTimezoneDeep(obj: any, timezone: IDTimezone): any;

package/dist/cjs/general/object/applyTimezoneDeep.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyTimezoneDeep = void 0;
+const DATE_FORMAT_1 = require("../../dates/constants/DATE_FORMAT");
+const DATE_GROUPING_TIME_PROPERTY_1 = require("../../dates/constants/DATE_GROUPING_TIME_PROPERTY");
+const getDateByTimezone_1 = require("../../dates/helpers/getDateByTimezone");
+const validateDate_1 = require("../../dates/helpers/validateDate");
+const isEmpty_1 = require("../mix/isEmpty");
+const isObject_1 = require("./isObject");
+/**
+ * Transforms the date+times propertiesof the given object by the Timezone object
+ * @param {any} obj the object
+ * @param {IDTimezone} timezone the timezone object
+ * @returns {IFSData | IFUData} the new filter data with the transformed datetime values
+ */
+function applyTimezoneDeep(obj, timezone) {
+    if ((0, isEmpty_1.isEmpty)(obj))
+        return obj;
+    let result;
+    if ((0, isObject_1.isObject)(obj)) {
+        result = {};
+    }
+    else if (Array.isArray(obj)) {
+        result = [];
+    }
+    try {
+        for (const i in obj) {
+            if ((0, isObject_1.isObject)(obj[i]) || Array.isArray(obj[i])) {
+                result[i] = applyTimezoneDeep(obj[i], timezone);
+            }
+            else if (obj[i] instanceof Date ||
+                (0, validateDate_1.validateDate)(obj[i], DATE_FORMAT_1.DATE_FORMAT.HOUR)) {
+                result[i] = (0, getDateByTimezone_1.getDateByTimezone)(obj[i], {
+                    property: DATE_GROUPING_TIME_PROPERTY_1.DATE_GROUPING_TIME_PROPERTY.HOUR,
+                    timezone,
+                });
+            }
+            else {
+                result[i] = obj[i];
+            }
+        }
+        return result;
+    }
+    catch (_a) {
+        return obj;
+    }
+}
+exports.applyTimezoneDeep = applyTimezoneDeep;

package/dist/cjs/general/object/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./applyTimezoneDeep";
 export * from "./cloneDeep";
 export * from "./get";
 export * from "./getAttribute";

package/dist/cjs/general/object/index.js

@@ -14,6 +14,7 @@ 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("./applyTimezoneDeep"), exports);
 __exportStar(require("./cloneDeep"), exports);
 __exportStar(require("./get"), exports);
 __exportStar(require("./getAttribute"), exports);

package/dist/cjs/interfaces/format/IFormatConfig.Interface.d.ts

@@ -1,5 +1,6 @@
 export interface IFormatConfig {
     lang?: string;
+    offset?: number;
     options?: object;
     isMultiplied?: boolean;
 }

package/dist/cjs/interfaces/general/IWidgetConfig.d.ts

@@ -1,3 +1,4 @@
+import { IDTimezone } from "../../dates/interfaces/IDTimezone";
 import { II18nConfig } from "../../globalization/interfaces/II18nConfig";
 export interface IWidgetConfig {
     appid?: string;
@@ -5,6 +6,6 @@ export interface IWidgetConfig {
     domain: string;
     i18n?: II18nConfig;
     qv_token?: string;
-    timezoneControl?: string;
+    timezone?: IDTimezone;
     userid?: string;
 }

package/dist/cjs/qrvey/helpers/transformValue.js

@@ -10,6 +10,7 @@ const format_1 = require("../../format/format");
 const isEmpty_1 = require("../../general/mix/isEmpty");
 const getI18nDateGroupLabel_1 = require("../../globalization/helpers/getI18nDateGroupLabel");
 const getValueWithSuffixes_1 = require("./getValueWithSuffixes");
+const getDateByTimezone_1 = require("../../dates/helpers/getDateByTimezone");
 /**
  * Transforms a value depending of localization/globalization and extras settings.
  * @param value A value to transform
@@ -19,14 +20,41 @@ const getValueWithSuffixes_1 = require("./getValueWithSuffixes");
 function transformValue(value, settings) {
     if ((0, isEmpty_1.isEmpty)(value))
         return value;
-    const valueWithI18n = (0, getI18nDateGroupLabel_1.getI18nDateGroupLabel)(value, settings.property, settings.translate);
-    const valueWithLocalization = (0, format_1.addFormat)(valueWithI18n, getOutputFormat(settings), getFormatConfig(settings));
-    return (0, getValueWithSuffixes_1.getValueWithSuffixes)(valueWithLocalization, {
-        suffixTranslateLabel: settings.suffixTranslateLabel,
-        translate: settings.translate,
-    });
+    const defaultSettings = getDefaultSettings(settings);
+    let timezonedValue = value;
+    if (!defaultSettings.noTimezone) {
+        timezonedValue = (0, getDateByTimezone_1.getDateByTimezone)(value, {
+            property: defaultSettings.property,
+            timezone: defaultSettings.timezone,
+        });
+    }
+    let valueWithI18n = timezonedValue;
+    if (!defaultSettings.noTranslate) {
+        valueWithI18n = (0, getI18nDateGroupLabel_1.getI18nDateGroupLabel)(timezonedValue, defaultSettings.property, defaultSettings.translate);
+    }
+    let valueWithLocalization = valueWithI18n;
+    if (!defaultSettings.noLocale) {
+        valueWithLocalization = (0, format_1.addFormat)(valueWithI18n, getOutputFormat(settings), getFormatConfig(settings));
+    }
+    let valueWithSuffix = valueWithI18n;
+    if (!defaultSettings.noSuffix) {
+        valueWithSuffix = (0, getValueWithSuffixes_1.getValueWithSuffixes)(valueWithLocalization, {
+            suffixTranslateLabel: defaultSettings.suffixTranslateLabel,
+            translate: defaultSettings.translate,
+        });
+    }
+    return valueWithSuffix;
 }
 exports.transformValue = transformValue;
+/**
+ * Gets the default settings properties
+ * @param {ITransformValueSettings} settings the given settings
+ * @returns {ITransformValueSettings} the settings with default properties
+ */
+function getDefaultSettings(settings) {
+    var _a, _b, _c, _d;
+    return Object.assign(Object.assign({}, settings), { noLocale: (_a = settings === null || settings === void 0 ? void 0 : settings.noLocale) !== null && _a !== void 0 ? _a : false, noSuffix: (_b = settings === null || settings === void 0 ? void 0 : settings.noSuffix) !== null && _b !== void 0 ? _b : false, noTimezone: (_c = settings === null || settings === void 0 ? void 0 : settings.noTimezone) !== null && _c !== void 0 ? _c : false, noTranslate: (_d = settings === null || settings === void 0 ? void 0 : settings.noTranslate) !== null && _d !== void 0 ? _d : false });
+}
 /**
  * Gets the outputformat settings
  * @param settings The settings of the transformValue function

package/dist/cjs/qrvey/interfaces/IBDataset.d.ts

@@ -1,4 +1,5 @@
 import { IBColumn } from "../../columns/interfaces/IBColumn";
+import { IBTimezone } from "../../dates/interfaces/IBTimezone";
 /**
  * Structure for Dataset in the frontend side of Qrvey App
  */
@@ -7,4 +8,5 @@ export interface IBDataset {
     name?: string;
     options?: IBColumn[];
     qrveyid: string;
+    timezone?: IBTimezone;
 }

package/dist/cjs/qrvey/interfaces/IBModel.d.ts

@@ -2,11 +2,15 @@ import { IAppStatus } from "./IAppStatus";
 import { IBModelBranchesMap } from "./IBModelBranchesMap";
 import { IBModelData } from "./IBModelData";
 import { IAppType } from "./IAppType";
+import { IBTimezone } from "../../dates/interfaces/IBTimezone";
 export interface IBModel {
     appType: IAppType;
     appid: string;
     branchesMap?: IBModelBranchesMap[];
     createDate: string;
+    /**
+     * @deprecated Data Link feature is not longer supported
+     */
     datalinkInfo?: any[];
     geoGroups?: any[];
     modifyDate: string;
@@ -16,5 +20,6 @@ export interface IBModel {
     questionOrder: string[];
     questions: IBModelData;
     status: IAppStatus;
+    timezone: IBTimezone;
     userid: string;
 }

package/dist/cjs/qrvey/interfaces/IDataset.d.ts

@@ -1,9 +1,11 @@
 import { IColumn } from "../../columns/interfaces/IColumn";
+import { IDTimezone } from "../../dates/interfaces/IDTimezone";
 import { IBDataset } from "./IBDataset";
 /**
  * Structure for Dataset in the frontend side of Qrvey App
  */
-export interface IDataset extends Omit<IBDataset, "name" | "options"> {
+export interface IDataset extends Omit<IBDataset, "name" | "options" | "timezone"> {
     label?: string;
     options?: IColumn[];
+    timezone?: IDTimezone;
 }

package/dist/cjs/qrvey/interfaces/IModel.d.ts

@@ -1,10 +1,12 @@
 import { IColumn } from "../../columns/interfaces/IColumn";
+import { IDTimezone } from "../../dates/interfaces/IDTimezone";
 import { IBModel } from "./IBModel";
 import { IModelBranchesMap } from "./IModelBranchesMap";
-export interface IModel extends Omit<IBModel, "questions" | "branchesMap" | "name" | "numResponses" | "questionOrder"> {
+export interface IModel extends Omit<IBModel, "questions" | "branchesMap" | "name" | "numResponses" | "questionOrder" | "timezone"> {
     columns: IColumn[];
     columnOrder: string[];
     branchesMap: IModelBranchesMap[];
     label: string;
+    timezone: IDTimezone;
     totalRecords: number;
 }

package/dist/cjs/qrvey/interfaces/ITransformValueSettings.d.ts

@@ -1,11 +1,17 @@
 import { IColumn } from "../../columns/interfaces/IColumn";
 import { IColumnPropertyType } from "../../columns/interfaces/IColumnPropertyType";
+import { IDTimezone } from "../../dates/interfaces/IDTimezone";
 import { II18nConfig } from "../../globalization/interfaces/II18nConfig";
 import { II18nServiceTranslate } from "../../globalization/interfaces/II18nServiceTranslate";
 export interface ITransformValueSettings {
     column: IColumn;
     property: IColumnPropertyType;
+    timezone?: IDTimezone;
     translate: II18nServiceTranslate;
     i18n: II18nConfig;
     suffixTranslateLabel?: string;
+    noLocale?: boolean;
+    noTranslate?: boolean;
+    noSuffix?: boolean;
+    noTimezone?: boolean;
 }

package/dist/cjs/services/adapters/BDatasetsToUIDatasets.adapter.js

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BDatasetsToUIDatasets = void 0;
 const getAttribute_1 = require("../../general/object/getAttribute");
 const BColumnsToUIColumns_adapter_1 = require("./BColumnsToUIColumns.adapter");
+const BTimezoneToUITimezone_1 = require("./BTimezoneToUITimezone");
 function BDatasetsToUIDatasets(datasets = []) {
     return datasets.map((dataset) => ({
         qrveyid: (0, getAttribute_1.getAttribute)(dataset, "qrvey_id"),
         label: dataset.name,
         options: (0, BColumnsToUIColumns_adapter_1.BColumnsToUIColumns)(dataset.options, dataset),
+        timezone: (0, BTimezoneToUITimezone_1.BTimezoneToUITimezone)(dataset.timezone),
     }));
 }
 exports.BDatasetsToUIDatasets = BDatasetsToUIDatasets;

package/dist/cjs/services/adapters/BModelToUIModel.adapter.js

@@ -4,6 +4,7 @@ exports.BModelToUIModel = void 0;
 const isEmpty_1 = require("../../general/mix/isEmpty");
 const BBranchesMapToUIBranchesMap_adapter_1 = require("./BBranchesMapToUIBranchesMap.adapter");
 const BColumnsToUIColumns_adapter_1 = require("./BColumnsToUIColumns.adapter");
+const BTimezoneToUITimezone_1 = require("./BTimezoneToUITimezone");
 function BModelToUIModel(model) {
     if ((0, isEmpty_1.isEmpty)(model))
         return;
@@ -23,6 +24,7 @@ function BModelToUIModel(model) {
         totalRecords: model.numResponses,
         qrveyid: model.qrveyid,
         status: model.status,
+        timezone: (0, BTimezoneToUITimezone_1.BTimezoneToUITimezone)(model.timezone),
         userid: model.userid,
     };
 }

package/dist/cjs/services/adapters/BTimezoneToUITimezone.d.ts

@@ -0,0 +1,8 @@
+import { IDTimezone } from "../../dates/interfaces/IDTimezone";
+import { IBTimezone } from "../../dates/interfaces/IBTimezone";
+/**
+ * Transforms the backenc timezone structure to UI timezone structure
+ * @param {IBTimezone} timezone the backend timezone object
+ * @returns {IDTimezone} the UI timezone object
+ */
+export declare function BTimezoneToUITimezone(timezone: IBTimezone): IDTimezone;

package/dist/cjs/services/adapters/BTimezoneToUITimezone.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BTimezoneToUITimezone = void 0;
+const TIMEZONE_TYPE_1 = require("../../dates/constants/TIMEZONE_TYPE");
+const getTimezoneOffsetByType_1 = require("../../dates/helpers/getTimezoneOffsetByType");
+/**
+ * Transforms the backenc timezone structure to UI timezone structure
+ * @param {IBTimezone} timezone the backend timezone object
+ * @returns {IDTimezone} the UI timezone object
+ */
+function BTimezoneToUITimezone(timezone) {
+    const type = (timezone === null || timezone === void 0 ? void 0 : timezone.type) || TIMEZONE_TYPE_1.TIMEZONE_TYPE.DEFAULT;
+    return {
+        type,
+        offset: (0, getTimezoneOffsetByType_1.getTimezoneOffsetByType)(Object.assign(Object.assign({}, timezone), { type })),
+    };
+}
+exports.BTimezoneToUITimezone = BTimezoneToUITimezone;

package/dist/cjs/services/helpers/Request.d.ts

@@ -2,7 +2,7 @@ export default class Request {
     static checkStatus(response: any): Promise<any>;
     static hasQvToken(config: any): boolean;
     static getQvToken(config: any): any;
-    static getTimezoneControl(config: any): any;
+    static getTimezoneOffset(config: any): string;
     static hasApiKey(config: any): boolean;
     static getApiKey(config: any): any;
     static makeUrl(config: any, url: any, params?: any): string;

package/dist/cjs/services/helpers/Request.js

@@ -9,6 +9,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const numericOffsetToISO_1 = require("../../dates/adapters/numericOffsetToISO");
+const isEmpty_1 = require("../../general/mix/isEmpty");
 const getAttribute_1 = require("../../general/object/getAttribute");
 const serialize_1 = require("../../general/object/serialize");
 const parseUrl_1 = require("../../general/string/parseUrl");
@@ -26,8 +28,12 @@ class Request {
     static getQvToken(config) {
         return (0, getAttribute_1.getAttribute)(config, "qv_token");
     }
-    static getTimezoneControl(config) {
-        return (0, getAttribute_1.getAttribute)(config, "timezone_control");
+    static getTimezoneOffset(config) {
+        var _a;
+        const timezoneOffset = (_a = config.timezone) === null || _a === void 0 ? void 0 : _a.offset;
+        if (!(0, isEmpty_1.isEmpty)(timezoneOffset)) {
+            return (0, numericOffsetToISO_1.numericOffsetToISO)(timezoneOffset);
+        }
     }
     static hasApiKey(config) {
         return !!this.getApiKey(config);
@@ -70,9 +76,9 @@ class Request {
                 cfg.credentials = "include";
             }
         }
-        const timezoneControl = this.getTimezoneControl(reqData.config);
-        if (timezoneControl) {
-            cfg.headers["q-timezone-control"] = `offset=${timezoneControl};use-client-offset-only`;
+        const timezoneOffset = this.getTimezoneOffset(reqData.config);
+        if (timezoneOffset) {
+            cfg.headers["q-timezone-control"] = `offset=${timezoneOffset}`;
         }
         // AbortSignal (https://developers.google.com/web/updates/2017/09/abortable-fetch)
         if (reqData.config && reqData.config.signal) {

package/dist/dates/adapters/ISOToNumericOffset.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Gets the numeric offset (minutes) from the ISO offset (string)
+ * @param {string} offset the timezone offset
+ * @returns {number} the offset in minutes
+ */
+export declare function ISOToNumericOffset(offset: number | string): number;

package/dist/dates/adapters/ISOToNumericOffset.js

@@ -0,0 +1,17 @@
+import { isNaNV2 } from "../../general/mix/isNaNV2";
+import { isValidISOOffset } from "../helpers/isValidISOOffset";
+/**
+ * Gets the numeric offset (minutes) from the ISO offset (string)
+ * @param {string} offset the timezone offset
+ * @returns {number} the offset in minutes
+ */
+export function ISOToNumericOffset(offset) {
+    if (typeof offset === "string" && offset === "browser")
+        return -1 * new Date().getTimezoneOffset();
+    if (typeof offset === "number" || !isNaNV2(offset))
+        return +offset;
+    if (!isValidISOOffset(offset))
+        return 0;
+    const [hours, minutes] = offset.split(":").map(Number);
+    return hours * 60 + minutes;
+}

package/dist/dates/adapters/index.d.ts

@@ -5,8 +5,10 @@ export * from "./dateToQuarterYear";
 export * from "./dateToWeekYear";
 export * from "./dateToYear";
 export * from "./hmsToDate";
+export * from "./ISOToNumericOffset";
 export * from "./mdyDateToDate";
 export * from "./monthYearToDate";
+export * from "./numericOffsetToISO";
 export * from "./quarterYearToDate";
 export * from "./weekYearToDate";
 export * from "./yearToDate";

package/dist/dates/adapters/index.js

@@ -5,8 +5,10 @@ export * from "./dateToQuarterYear";
 export * from "./dateToWeekYear";
 export * from "./dateToYear";
 export * from "./hmsToDate";
+export * from "./ISOToNumericOffset";
 export * from "./mdyDateToDate";
 export * from "./monthYearToDate";
+export * from "./numericOffsetToISO";
 export * from "./quarterYearToDate";
 export * from "./weekYearToDate";
 export * from "./yearToDate";

package/dist/dates/adapters/numericOffsetToISO.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Gets the ISO offset From the numeric offset (minutes)
+ * @param {number} offset the timezone offset
+ * @returns {string} the offset in minutes
+ */
+export declare function numericOffsetToISO(offset: number | string): string;

package/dist/dates/adapters/numericOffsetToISO.js

@@ -0,0 +1,25 @@
+import { isNaNV2 } from "../../general/mix/isNaNV2";
+import { getSign } from "../../general/numeric/getSign";
+import { padLeadingZeros } from "../../general/string/padLeadingZeros";
+import { isValidISOOffset } from "../helpers/isValidISOOffset";
+/**
+ * Gets the ISO offset From the numeric offset (minutes)
+ * @param {number} offset the timezone offset
+ * @returns {string} the offset in minutes
+ */
+export function numericOffsetToISO(offset) {
+    let newOffset = offset;
+    if (typeof offset === "string" && offset === "browser")
+        newOffset = -1 * new Date().getTimezoneOffset();
+    if (typeof newOffset === "string" && isValidISOOffset(newOffset))
+        return String(newOffset);
+    if (typeof newOffset !== "number" && isNaNV2(newOffset))
+        return "+00:00";
+    if (typeof newOffset === "string" && !isNaNV2(newOffset))
+        newOffset = +newOffset;
+    const sign = getSign(newOffset);
+    newOffset = Math.abs(newOffset);
+    const hours = padLeadingZeros(Math.floor(newOffset / 60), 2);
+    const minutes = padLeadingZeros(newOffset % 60, 2);
+    return `${sign}${hours}:${minutes}`;
+}

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

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

package/dist/dates/constants/ISO_8601_REGEX.js

@@ -0,0 +1 @@
+export const ISO_8601_REGEX = /^[+-]?\d{2}:\d{2}$/;

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

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

package/dist/dates/constants/TIMEZONE_TYPE.js

@@ -0,0 +1,6 @@
+export var TIMEZONE_TYPE;
+(function (TIMEZONE_TYPE) {
+    TIMEZONE_TYPE["BROWSER"] = "BROWSER";
+    TIMEZONE_TYPE["DEFAULT"] = "DEFAULT";
+    TIMEZONE_TYPE["FIXED"] = "FIXED";
+})(TIMEZONE_TYPE || (TIMEZONE_TYPE = {}));

package/dist/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/dates/constants/index.js

@@ -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/dates/helpers/getDateByTimezone.d.ts

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

package/dist/dates/helpers/getDateByTimezone.js

@@ -0,0 +1,37 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { DATE_GROUPING_TIME_PROPERTY } from "../constants/DATE_GROUPING_TIME_PROPERTY";
+import { TIMEZONE_TYPE } from "../constants/TIMEZONE_TYPE";
+import { getDateByDateFormat } from "./getDateByDateFormat";
+import { getDateByTimezoneOffset } from "./getDateByTimezoneOffset";
+import { getDateFormatByProperty } from "./getDateFormatByProperty";
+import { getFormattedDateByFormat } from "./getFormattedDateByFormat";
+/**
+ * Gets a date value in the given timezone
+ * @param {string} date the date
+ * @param {IGetDateByTimezoneSettings} settings The settings of the getDateByTimezone function
+ * @returns {string} A transformed value
+ */
+export function getDateByTimezone(date, settings) {
+    const defaultSettings = getDefaultSettings(settings);
+    const isDateTime = [
+        DATE_GROUPING_TIME_PROPERTY.HOUR,
+        DATE_GROUPING_TIME_PROPERTY.MINUTE,
+        DATE_GROUPING_TIME_PROPERTY.SECOND,
+    ].includes(defaultSettings.property);
+    if (!isEmpty(defaultSettings.timezone.offset) && isDateTime) {
+        const dateFormat = getDateFormatByProperty(defaultSettings.property);
+        const formattedDate = getDateByDateFormat(date, dateFormat);
+        const timezonedDate = getDateByTimezoneOffset(formattedDate, defaultSettings.timezone.offset);
+        return getFormattedDateByFormat(timezonedDate, dateFormat);
+    }
+    return date;
+}
+function getDefaultSettings(settings) {
+    return {
+        property: settings.property,
+        timezone: (settings === null || settings === void 0 ? void 0 : settings.timezone) || {
+            offset: undefined,
+            type: TIMEZONE_TYPE.DEFAULT,
+        },
+    };
+}

package/dist/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): Date;