@qrvey/utils 1.10.0-0 → 1.10.0-10

package/dist/charts/adapters/endpointData.js

@@ -401,7 +401,6 @@ export function configMetricData(metricObj //
     }
     if (data.dateColumn) {
         const dateColum = data.dateColumn.id;
-        const timeZoneOffset = 0;
         // TIME PERIOD
         try {
             const timePeriod = data.timePeriod.label;
@@ -409,7 +408,6 @@ export function configMetricData(metricObj //
                 id: dateColum,
                 type: timePeriod,
                 dataType: data.dateColumn.type,
-                timeZoneOffset,
             };
             if (timePeriod === "CUSTOM_RANGE") {
                 const type = data.timePeriodCustomRange.label;
@@ -442,7 +440,6 @@ export function configMetricData(metricObj //
                 id: dateColum,
                 type: comparison,
                 dataType: data.dateColumn.type,
-                timeZoneOffset,
             };
             if (comparison === "CUSTOM_RANGE") {
                 const type = data.comparisonCustomRange.label;

package/dist/cjs/charts/adapters/endpointData.js

@@ -405,7 +405,6 @@ function configMetricData(metricObj //
     }
     if (data.dateColumn) {
         const dateColum = data.dateColumn.id;
-        const timeZoneOffset = 0;
         // TIME PERIOD
         try {
             const timePeriod = data.timePeriod.label;
@@ -413,7 +412,6 @@ function configMetricData(metricObj //
                 id: dateColum,
                 type: timePeriod,
                 dataType: data.dateColumn.type,
-                timeZoneOffset,
             };
             if (timePeriod === "CUSTOM_RANGE") {
                 const type = data.timePeriodCustomRange.label;
@@ -446,7 +444,6 @@ function configMetricData(metricObj //
                 id: dateColum,
                 type: comparison,
                 dataType: data.dateColumn.type,
-                timeZoneOffset,
             };
             if (comparison === "CUSTOM_RANGE") {
                 const type = data.comparisonCustomRange.label;

package/dist/cjs/columns/constants/COLUMN_PROPERTIES.d.ts

@@ -2,4 +2,4 @@ import { COLUMN_PROPERTY } from "./COLUMN_PROPERTY";
 /**
  * @description Collection of column properties
  */
-export declare const COLUMN_PROPERTIES: (import("../..").DATE_DISTINCT_PROPERTY | import("../..").DATE_DISTINCT_TIME_PROPERTY | import("./COMPOUND_COLUMN_PROPERTY").COMPOUND_COLUMN_PROPERTY | import("../..").DATE_GROUPING_PROPERTY | import("../..").DATE_GROUPING_TIME_PROPERTY | import("./COMPLEX_COLUMN_PROPERTY").COMPLEX_COLUMN_PROPERTY | COLUMN_PROPERTY)[];
+export declare const COLUMN_PROPERTIES: (import("./COMPOUND_COLUMN_PROPERTY").COMPOUND_COLUMN_PROPERTY | import("../..").DATE_GROUPING_PROPERTY | import("../..").DATE_GROUPING_TIME_PROPERTY | import("../..").DATE_DISTINCT_PROPERTY | import("../..").DATE_DISTINCT_TIME_PROPERTY | import("./COMPLEX_COLUMN_PROPERTY").COMPLEX_COLUMN_PROPERTY | COLUMN_PROPERTY)[];

package/dist/cjs/columns/helpers/isNumericalColumn.js

@@ -14,5 +14,7 @@ const NUMERICAL_COLUMNS_1 = require("../constants/NUMERICAL_COLUMNS");
 const isNumericalColumn = (column) => !(0, isEmpty_1.isEmpty)(column) &&
     (0, isObject_1.isObject)(column) &&
     (NUMERICAL_COLUMNS_1.NUMERICAL_COLUMNS.includes(column.type) ||
-        (column.type === COLUMN_1.COLUMN.FORMULA && column.formulaType === FORMULA_1.FORMULA.NUMBER));
+        (column.type === COLUMN_1.COLUMN.FORMULA && column.formulaType === FORMULA_1.FORMULA.NUMBER) ||
+        (column.type === COLUMN_1.COLUMN.AGGREGATED_FORMULA &&
+            column.formulaType === FORMULA_1.FORMULA.NUMBER));
 exports.isNumericalColumn = isNumericalColumn;

package/dist/cjs/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/cjs/dates/adapters/ISOToNumericOffset.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ISOToNumericOffset = void 0;
+const isNaNV2_1 = require("../../general/mix/isNaNV2");
+const isValidISOOffset_1 = require("../helpers/isValidISOOffset");
+/**
+ * Gets the numeric offset (minutes) from the ISO offset (string)
+ * @param {string} offset the timezone offset
+ * @returns {number} the offset in minutes
+ */
+function ISOToNumericOffset(offset) {
+    if (typeof offset === "string" && offset === "browser")
+        return -1 * new Date().getTimezoneOffset();
+    if (typeof offset === "number" || !(0, isNaNV2_1.isNaNV2)(offset))
+        return +offset;
+    if (!(0, isValidISOOffset_1.isValidISOOffset)(offset))
+        return 0;
+    const [hours, minutes] = offset.split(":").map(Number);
+    return hours * 60 + minutes;
+}
+exports.ISOToNumericOffset = ISOToNumericOffset;

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateToHms = void 0;
 const padLeadingZeros_1 = require("../../general/string/padLeadingZeros");
+const getDateByTimezone_1 = require("../helpers/getDateByTimezone");
 const isValidDateObject_1 = require("../helpers/isValidDateObject");
 const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
 /**
@@ -13,10 +14,11 @@ const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
 function dateToHms(date, settings) {
     if (!(0, isValidPotentialDate_1.isValidPotentialDate)(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = getDefaultSettings(settings);
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!(0, isValidDateObject_1.isValidDateObject)(dt))
         return date;
-    const defaultSettings = getDefaultSettings(settings);
     const hours = getHours(dt, defaultSettings);
     const minutes = getMinutes(dt, defaultSettings);
     const seconds = getSeconds(dt, defaultSettings);
@@ -30,11 +32,7 @@ exports.dateToHms = dateToHms;
  */
 function getDefaultSettings(settings) {
     var _a, _b, _c;
-    return {
-        omitHour: (_a = settings === null || settings === void 0 ? void 0 : settings.omitHour) !== null && _a !== void 0 ? _a : false,
-        omitMinute: (_b = settings === null || settings === void 0 ? void 0 : settings.omitMinute) !== null && _b !== void 0 ? _b : false,
-        omitSecond: (_c = settings === null || settings === void 0 ? void 0 : settings.omitSecond) !== null && _c !== void 0 ? _c : false,
-    };
+    return Object.assign(Object.assign({}, settings), { omitHour: (_a = settings === null || settings === void 0 ? void 0 : settings.omitHour) !== null && _a !== void 0 ? _a : false, omitMinute: (_b = settings === null || settings === void 0 ? void 0 : settings.omitMinute) !== null && _b !== void 0 ? _b : false, omitSecond: (_c = settings === null || settings === void 0 ? void 0 : settings.omitSecond) !== null && _c !== void 0 ? _c : false });
 }
 /**
  * Gets the Hours
@@ -43,7 +41,7 @@ function getDefaultSettings(settings) {
  * @returns the hour string
  */
 function getHours(date, settings) {
-    return (0, padLeadingZeros_1.padLeadingZeros)(settings.omitHour ? "0" : date.getHours(), 2).slice(-2);
+    return (0, padLeadingZeros_1.padLeadingZeros)(settings.omitHour ? "0" : date.getUTCHours(), 2).slice(-2);
 }
 /**
  * Gets the Minutes
@@ -52,7 +50,7 @@ function getHours(date, settings) {
  * @returns the minute string
  */
 function getMinutes(date, settings) {
-    return (0, padLeadingZeros_1.padLeadingZeros)(settings.omitMinute ? "0" : date.getMinutes(), 2).slice(-2);
+    return (0, padLeadingZeros_1.padLeadingZeros)(settings.omitMinute ? "0" : date.getUTCMinutes(), 2).slice(-2);
 }
 /**
  * Gets the Seconds
@@ -61,5 +59,5 @@ function getMinutes(date, settings) {
  * @returns the seconds string
  */
 function getSeconds(date, settings) {
-    return (0, padLeadingZeros_1.padLeadingZeros)(settings.omitSecond ? "0" : date.getSeconds(), 2).slice(-2);
+    return (0, padLeadingZeros_1.padLeadingZeros)(settings.omitSecond ? "0" : date.getUTCSeconds(), 2).slice(-2);
 }

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

@@ -1,6 +1,7 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transform a Date to [mm/dd/yyyy] date format.
  * @param date String, object or millisencond number of the date
  * @returns string of [mm/dd/yyyy] date format
  */
-export declare function dateToMdyDate(date: string | Date | number, includeTime?: boolean): string;
+export declare function dateToMdyDate(date: string | Date | number, settings?: IDateSettings): string;

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

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateToMdyDate = void 0;
 const padLeadingZeros_1 = require("../../general/string/padLeadingZeros");
+const getDateByTimezone_1 = require("../helpers/getDateByTimezone");
+const getDefaultDateSettings_1 = require("../helpers/getDefaultDateSettings");
 const isValidDateObject_1 = require("../helpers/isValidDateObject");
 const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
 const dateToHms_1 = require("./dateToHms");
@@ -10,12 +12,16 @@ const dateToHms_1 = require("./dateToHms");
  * @param date String, object or millisencond number of the date
  * @returns string of [mm/dd/yyyy] date format
  */
-function dateToMdyDate(date, includeTime = false) {
+function dateToMdyDate(date, settings) {
     if (!(0, isValidPotentialDate_1.isValidPotentialDate)(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!(0, isValidDateObject_1.isValidDateObject)(dt))
         return date;
-    return `${(0, padLeadingZeros_1.padLeadingZeros)(dt.getMonth() + 1, 2).slice(-2)}/${(0, padLeadingZeros_1.padLeadingZeros)(dt.getDate(), 2).slice(-2)}/${(0, padLeadingZeros_1.padLeadingZeros)(dt.getFullYear(), 4)}${includeTime ? ` ${(0, dateToHms_1.dateToHms)(date)}` : ""}`;
+    return `${(0, padLeadingZeros_1.padLeadingZeros)(dt.getUTCMonth() + 1, 2).slice(-2)}/${(0, padLeadingZeros_1.padLeadingZeros)(dt.getUTCDate(), 2).slice(-2)}/${(0, padLeadingZeros_1.padLeadingZeros)(dt.getUTCFullYear(), 4)}${defaultSettings.convertMiliseconds
+        ? ` ${(0, dateToHms_1.dateToHms)(date, defaultSettings)}`
+        : ""}`;
 }
 exports.dateToMdyDate = dateToMdyDate;

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

@@ -1,6 +1,7 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transform a Date to [Month Year] date format.
  * @param date String, object or millisencond number of the date
  * @returns string of [Month Year] date format
  */
-export declare function dateToMonthYear(date: string | Date | number): string;
+export declare function dateToMonthYear(date: string | Date | number, settings?: IDateSettings): string;

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

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateToMonthYear = void 0;
 const DATE_YEAR_MONTHS_1 = require("../constants/DATE_YEAR_MONTHS");
+const getDateByTimezone_1 = require("../helpers/getDateByTimezone");
+const getDefaultDateSettings_1 = require("../helpers/getDefaultDateSettings");
 const isValidDateObject_1 = require("../helpers/isValidDateObject");
 const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
 /**
@@ -9,12 +11,14 @@ const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
  * @param date String, object or millisencond number of the date
  * @returns string of [Month Year] date format
  */
-function dateToMonthYear(date) {
+function dateToMonthYear(date, settings) {
     if (!(0, isValidPotentialDate_1.isValidPotentialDate)(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!(0, isValidDateObject_1.isValidDateObject)(dt))
         return date;
-    return `${DATE_YEAR_MONTHS_1.DATE_YEAR_MONTHS[dt.getMonth()]} ${dt.getFullYear()}`;
+    return `${DATE_YEAR_MONTHS_1.DATE_YEAR_MONTHS[dt.getUTCMonth()]} ${dt.getUTCFullYear()}`;
 }
 exports.dateToMonthYear = dateToMonthYear;

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

@@ -1,6 +1,7 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transform a valid Date to [Quarter Year] date format.
  * @param date String of a valid date, date object or millisencond number of the date
  * @returns string of [Quarter Year] date format
  */
-export declare function dateToQuarterYear(date: string | Date | number): string;
+export declare function dateToQuarterYear(date: string | Date | number, settings?: IDateSettings): string;

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

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateToQuarterYear = void 0;
 const DATE_YEAR_QUARTERS_1 = require("../constants/DATE_YEAR_QUARTERS");
+const getDateByTimezone_1 = require("../helpers/getDateByTimezone");
+const getDefaultDateSettings_1 = require("../helpers/getDefaultDateSettings");
 const isValidDateObject_1 = require("../helpers/isValidDateObject");
 const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
 /**
@@ -9,13 +11,15 @@ const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
  * @param date String of a valid date, date object or millisencond number of the date
  * @returns string of [Quarter Year] date format
  */
-function dateToQuarterYear(date) {
+function dateToQuarterYear(date, settings) {
     if (!(0, isValidPotentialDate_1.isValidPotentialDate)(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!(0, isValidDateObject_1.isValidDateObject)(dt))
         return date;
-    const quarter = Math.ceil((dt.getMonth() + 1) / 3);
-    return `${DATE_YEAR_QUARTERS_1.DATE_YEAR_QUARTERS[quarter - 1]} ${dt.getFullYear()}`;
+    const quarter = Math.ceil((dt.getUTCMonth() + 1) / 3);
+    return `${DATE_YEAR_QUARTERS_1.DATE_YEAR_QUARTERS[quarter - 1]} ${dt.getUTCFullYear()}`;
 }
 exports.dateToQuarterYear = dateToQuarterYear;

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

@@ -1,6 +1,7 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transform a Date to [W# Year] date format.
  * @param date String, object or millisencond number of the date
  * @returns string of [W# Year] date format
  */
-export declare function dateToWeekYear(date: string | Date | number): string;
+export declare function dateToWeekYear(date: string | Date | number, settings?: IDateSettings): string;

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

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateToWeekYear = void 0;
+const getDateByTimezone_1 = require("../helpers/getDateByTimezone");
+const getDefaultDateSettings_1 = require("../helpers/getDefaultDateSettings");
 const getWeek_1 = require("../helpers/getWeek");
 const isValidDateObject_1 = require("../helpers/isValidDateObject");
 const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
@@ -9,10 +11,12 @@ const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
  * @param date String, object or millisencond number of the date
  * @returns string of [W# Year] date format
  */
-function dateToWeekYear(date) {
+function dateToWeekYear(date, settings) {
     if (!(0, isValidPotentialDate_1.isValidPotentialDate)(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!(0, isValidDateObject_1.isValidDateObject)(dt))
         return date;
     const weekObj = (0, getWeek_1.getWeek)(dt);

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

@@ -1,6 +1,7 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transform a Date to [Year] date format.
  * @param {string | Date | number} date String, object or millisencond number of the date
  * @returns string of [Year] date format
  */
-export declare function dateToYear(date: string | Date | number): string;
+export declare function dateToYear(date: string | Date | number, settings?: IDateSettings): string;

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

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dateToYear = void 0;
+const getDateByTimezone_1 = require("../helpers/getDateByTimezone");
+const getDefaultDateSettings_1 = require("../helpers/getDefaultDateSettings");
 const isValidDateObject_1 = require("../helpers/isValidDateObject");
 const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
 /**
@@ -8,12 +10,14 @@ const isValidPotentialDate_1 = require("../helpers/isValidPotentialDate");
  * @param {string | Date | number} date String, object or millisencond number of the date
  * @returns string of [Year] date format
  */
-function dateToYear(date) {
+function dateToYear(date, settings) {
     if (!(0, isValidPotentialDate_1.isValidPotentialDate)(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!(0, isValidDateObject_1.isValidDateObject)(dt))
         return date;
-    return String(dt.getFullYear());
+    return String(dt.getUTCFullYear());
 }
 exports.dateToYear = dateToYear;

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

@@ -1,7 +1,8 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transforms String time from a [H:m:s] format to Date object.
  * @param monthYearDate String of [H:m:s] time
  * @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 time, the function will return the same value
  */
-export declare function hmsToDate(hmsDate: string, time?: boolean): string | Date | number;
+export declare function hmsToDate(hmsDate: string, settings?: IDateSettings): string | Date | number;

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

@@ -4,6 +4,8 @@ exports.hmsToDate = 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 time from a [H:m:s] format to Date object.
@@ -11,14 +13,16 @@ 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 time, the function will return the same value
  */
-function hmsToDate(hmsDate, time = false) {
+function hmsToDate(hmsDate, settings) {
     if ((0, isEmpty_1.isEmpty)(hmsDate) ||
         (0, isTokenLabel_1.isTokenLabel)(hmsDate) ||
         typeof hmsDate !== "string" ||
         !(0, validateDate_1.validateDate)(hmsDate, DATE_FORMAT_1.DATE_FORMAT.DAY_TIME))
         return hmsDate;
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
     const [hour, minute, second] = hmsDate.split(":");
     const start = new Date(0, 0, 0, +hour, +minute, +second);
-    return time ? +start : start;
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(start, defaultSettings.timezone);
+    return defaultSettings.convertMiliseconds ? +timezonedDate : timezonedDate;
 }
 exports.hmsToDate = hmsToDate;

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

@@ -21,8 +21,10 @@ __exportStar(require("./dateToQuarterYear"), exports);
 __exportStar(require("./dateToWeekYear"), exports);
 __exportStar(require("./dateToYear"), exports);
 __exportStar(require("./hmsToDate"), exports);
+__exportStar(require("./ISOToNumericOffset"), exports);
 __exportStar(require("./mdyDateToDate"), exports);
 __exportStar(require("./monthYearToDate"), exports);
+__exportStar(require("./numericOffsetToISO"), exports);
 __exportStar(require("./quarterYearToDate"), exports);
 __exportStar(require("./weekYearToDate"), exports);
 __exportStar(require("./yearToDate"), exports);

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

@@ -1,7 +1,8 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transforms String Date from a [mm/dd/yyyy] format to Date object.
  * @param monthYearDate String of [mm/dd/yyyy] 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 mdyDateToDate(date: string, time?: boolean): string | Date | number;
+export declare function mdyDateToDate(date: string, settings?: IDateSettings): string | Date | number;

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

@@ -4,6 +4,8 @@ exports.mdyDateToDate = 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 [mm/dd/yyyy] format to Date object.
@@ -11,13 +13,16 @@ 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 mdyDateToDate(date, time = false) {
+function mdyDateToDate(date, settings) {
     if ((0, isEmpty_1.isEmpty)(date) ||
         (0, isTokenLabel_1.isTokenLabel)(date) ||
         typeof date !== "string" ||
         !validatingDate(date))
         return date;
-    return time ? +new Date(date) : new Date(date);
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
+    const dateObject = new Date(date);
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(dateObject, defaultSettings.timezone);
+    return defaultSettings.convertMiliseconds ? +timezonedDate : timezonedDate;
 }
 exports.mdyDateToDate = mdyDateToDate;
 function validatingDate(date) {

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

@@ -1,7 +1,8 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transforms String Date from a [Month Year] format to Date object.
  * @param monthYearDate String of [Month 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 monthYearToDate(monthYearDate: string, time?: boolean): string | Date | number;
+export declare function monthYearToDate(monthYearDate: string, settings?: IDateSettings): string | Date | number;

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

@@ -5,6 +5,8 @@ const isEmpty_1 = require("../../general/mix/isEmpty");
 const isTokenLabel_1 = require("../../tokens/isTokenLabel");
 const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
 const DATE_YEAR_MONTHS_1 = require("../constants/DATE_YEAR_MONTHS");
+const getDateByTimezone_1 = require("../helpers/getDateByTimezone");
+const getDefaultDateSettings_1 = require("../helpers/getDefaultDateSettings");
 const validateDate_1 = require("../helpers/validateDate");
 /**
  * Transforms String Date from a [Month Year] format to Date object.
@@ -12,14 +14,16 @@ 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 monthYearToDate(monthYearDate, time = false) {
+function monthYearToDate(monthYearDate, settings) {
     if ((0, isEmpty_1.isEmpty)(monthYearDate) ||
         (0, isTokenLabel_1.isTokenLabel)(monthYearDate) ||
         typeof monthYearDate !== "string" ||
         !(0, validateDate_1.validateDate)(monthYearDate, DATE_FORMAT_1.DATE_FORMAT.MONTH))
         return monthYearDate;
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
     const [month, year] = monthYearDate.split(" ");
     const start = new Date(+year, DATE_YEAR_MONTHS_1.DATE_YEAR_MONTHS.indexOf(month), 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.monthYearToDate = monthYearToDate;

package/dist/cjs/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, leadZeros?: boolean): string;

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.numericOffsetToISO = void 0;
+const isNaNV2_1 = require("../../general/mix/isNaNV2");
+const getSign_1 = require("../../general/numeric/getSign");
+const padLeadingZeros_1 = require("../../general/string/padLeadingZeros");
+const isValidISOOffset_1 = require("../helpers/isValidISOOffset");
+const ISOToNumericOffset_1 = require("./ISOToNumericOffset");
+/**
+ * Gets the ISO offset From the numeric offset (minutes)
+ * @param {number} offset the timezone offset
+ * @returns {string} the offset in minutes
+ */
+function numericOffsetToISO(offset, leadZeros = true) {
+    const leadZeroNumber = leadZeros ? 2 : 0;
+    let newOffset = offset;
+    if (typeof newOffset === "string" && newOffset === "browser")
+        newOffset = -1 * new Date().getTimezoneOffset();
+    if (typeof newOffset === "string" && (0, isValidISOOffset_1.isValidISOOffset)(newOffset)) {
+        if (leadZeros)
+            return String(newOffset);
+        newOffset = (0, ISOToNumericOffset_1.ISOToNumericOffset)(newOffset);
+    }
+    if (typeof newOffset !== "number" && (0, isNaNV2_1.isNaNV2)(newOffset))
+        return leadZeros ? "+00:00" : "+0:0";
+    if (typeof newOffset === "string" && !(0, isNaNV2_1.isNaNV2)(newOffset))
+        newOffset = +newOffset;
+    const sign = (0, getSign_1.getSign)(newOffset);
+    newOffset = Math.abs(newOffset);
+    const hours = (0, padLeadingZeros_1.padLeadingZeros)(Math.floor(newOffset / 60), leadZeroNumber);
+    const minutes = (0, padLeadingZeros_1.padLeadingZeros)(newOffset % 60, leadZeroNumber);
+    return `${sign}${hours}:${minutes}`;
+}
+exports.numericOffsetToISO = numericOffsetToISO;

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

@@ -1,7 +1,8 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transforms String Date from a [Quarter Year] format to Date object.
  * @param quarterYearDate String of [Quarter 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 quarterYearToDate(quarterYearDate: string, time?: boolean): string | Date | number;
+export declare function quarterYearToDate(quarterYearDate: string, settings?: IDateSettings): string | Date | number;

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

@@ -5,6 +5,8 @@ const isEmpty_1 = require("../../general/mix/isEmpty");
 const isTokenLabel_1 = require("../../tokens/isTokenLabel");
 const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
 const DATE_YEAR_QUARTERS_RANGE_1 = require("../constants/DATE_YEAR_QUARTERS_RANGE");
+const getDateByTimezone_1 = require("../helpers/getDateByTimezone");
+const getDefaultDateSettings_1 = require("../helpers/getDefaultDateSettings");
 const validateDate_1 = require("../helpers/validateDate");
 /**
  * Transforms String Date from a [Quarter Year] format to Date object.
@@ -12,14 +14,16 @@ 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 quarterYearToDate(quarterYearDate, time = false) {
+function quarterYearToDate(quarterYearDate, settings) {
     if ((0, isEmpty_1.isEmpty)(quarterYearDate) ||
         (0, isTokenLabel_1.isTokenLabel)(quarterYearDate) ||
         typeof quarterYearDate !== "string" ||
         !(0, validateDate_1.validateDate)(quarterYearDate, DATE_FORMAT_1.DATE_FORMAT.QUARTER))
         return quarterYearDate;
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
     const [quarter, year] = quarterYearDate.split(" ");
     const start = new Date(+year, DATE_YEAR_QUARTERS_RANGE_1.DATE_YEAR_QUARTERS_RANGE[quarter].initial, 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.quarterYearToDate = quarterYearToDate;

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

@@ -1,7 +1,8 @@
+import { IDateSettings } from "../interfaces/IDateSettings";
 /**
  * Transforms String Date from a [Week Year] format to Date object.
  * @param date String of [Week 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 weekYearToDate(weekYear: string, time?: boolean): string | Date | number;
+export declare function weekYearToDate(weekYear: string, settings?: IDateSettings): string | Date | number;

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

@@ -4,6 +4,8 @@ exports.weekYearToDate = 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 getWeek_1 = require("../helpers/getWeek");
 const validateDate_1 = require("../helpers/validateDate");
 /**
@@ -12,21 +14,23 @@ 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 weekYearToDate(weekYear, time = false) {
+function weekYearToDate(weekYear, settings) {
     if ((0, isEmpty_1.isEmpty)(weekYear) ||
         (0, isTokenLabel_1.isTokenLabel)(weekYear) ||
         typeof weekYear !== "string" ||
         !(0, validateDate_1.validateDate)(weekYear, DATE_FORMAT_1.DATE_FORMAT.WEEK))
         return weekYear;
+    const defaultSettings = (0, getDefaultDateSettings_1.getDefaultDateSettings)(settings);
     const [week, year] = weekYear.split(" ");
     const weekNumber = Number(week.substring(1));
     const dateObj = new Date(+year, 1, 1);
-    const numOfdaysPastSinceLastSunday = dateObj.getDay();
-    dateObj.setDate(dateObj.getDate() - numOfdaysPastSinceLastSunday);
+    const numOfdaysPastSinceLastSunday = dateObj.getUTCDay();
+    dateObj.setDate(dateObj.getUTCDate() - numOfdaysPastSinceLastSunday);
     const weekNoToday = (0, getWeek_1.getWeek)(dateObj).week;
     const weeksInTheFuture = weekNumber - weekNoToday;
-    dateObj.setDate(dateObj.getDate() + 7 * weeksInTheFuture);
-    const date = new Date(`${dateObj.getMonth() + 1}/${dateObj.getDate()}/${dateObj.getFullYear()}`);
-    return time ? +date : date;
+    dateObj.setDate(dateObj.getUTCDate() + 7 * weeksInTheFuture);
+    const date = new Date(`${dateObj.getUTCMonth() + 1}/${dateObj.getUTCDate()}/${dateObj.getUTCFullYear()}`);
+    const timezonedDate = (0, getDateByTimezone_1.getDateByTimezone)(date, defaultSettings.timezone);
+    return (defaultSettings === null || defaultSettings === void 0 ? void 0 : defaultSettings.convertMiliseconds) ? +timezonedDate : timezonedDate;
 }
 exports.weekYearToDate = weekYearToDate;