@qrvey/utils 1.10.0-0 → 1.10.0-10

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/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/columns/helpers/isNumericalColumn.js

@@ -11,4 +11,6 @@ import { NUMERICAL_COLUMNS } from "../constants/NUMERICAL_COLUMNS";
 export const isNumericalColumn = (column) => !isEmpty(column) &&
     isObject(column) &&
     (NUMERICAL_COLUMNS.includes(column.type) ||
-        (column.type === COLUMN.FORMULA && column.formulaType === FORMULA.NUMBER));
+        (column.type === COLUMN.FORMULA && column.formulaType === FORMULA.NUMBER) ||
+        (column.type === COLUMN.AGGREGATED_FORMULA &&
+            column.formulaType === FORMULA.NUMBER));

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/dateToHms.js

@@ -1,4 +1,5 @@
 import { padLeadingZeros } from "../../general/string/padLeadingZeros";
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
 import { isValidDateObject } from "../helpers/isValidDateObject";
 import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
 /**
@@ -10,10 +11,11 @@ import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
 export function dateToHms(date, settings) {
     if (!isValidPotentialDate(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = getDefaultSettings(settings);
+    const timezonedDate = getDateByTimezone(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!isValidDateObject(dt))
         return date;
-    const defaultSettings = getDefaultSettings(settings);
     const hours = getHours(dt, defaultSettings);
     const minutes = getMinutes(dt, defaultSettings);
     const seconds = getSeconds(dt, defaultSettings);
@@ -26,11 +28,7 @@ export function dateToHms(date, settings) {
  */
 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
@@ -39,7 +37,7 @@ function getDefaultSettings(settings) {
  * @returns the hour string
  */
 function getHours(date, settings) {
-    return padLeadingZeros(settings.omitHour ? "0" : date.getHours(), 2).slice(-2);
+    return padLeadingZeros(settings.omitHour ? "0" : date.getUTCHours(), 2).slice(-2);
 }
 /**
  * Gets the Minutes
@@ -48,7 +46,7 @@ function getHours(date, settings) {
  * @returns the minute string
  */
 function getMinutes(date, settings) {
-    return padLeadingZeros(settings.omitMinute ? "0" : date.getMinutes(), 2).slice(-2);
+    return padLeadingZeros(settings.omitMinute ? "0" : date.getUTCMinutes(), 2).slice(-2);
 }
 /**
  * Gets the Seconds
@@ -57,5 +55,5 @@ function getMinutes(date, settings) {
  * @returns the seconds string
  */
 function getSeconds(date, settings) {
-    return padLeadingZeros(settings.omitSecond ? "0" : date.getSeconds(), 2).slice(-2);
+    return padLeadingZeros(settings.omitSecond ? "0" : date.getUTCSeconds(), 2).slice(-2);
 }

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

@@ -1,4 +1,6 @@
 import { padLeadingZeros } from "../../general/string/padLeadingZeros";
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
+import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { isValidDateObject } from "../helpers/isValidDateObject";
 import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
 import { dateToHms } from "./dateToHms";
@@ -7,11 +9,15 @@ import { dateToHms } from "./dateToHms";
  * @param date String, object or millisencond number of the date
  * @returns string of [mm/dd/yyyy] date format
  */
-export function dateToMdyDate(date, includeTime = false) {
+export function dateToMdyDate(date, settings) {
     if (!isValidPotentialDate(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = getDefaultDateSettings(settings);
+    const timezonedDate = getDateByTimezone(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!isValidDateObject(dt))
         return date;
-    return `${padLeadingZeros(dt.getMonth() + 1, 2).slice(-2)}/${padLeadingZeros(dt.getDate(), 2).slice(-2)}/${padLeadingZeros(dt.getFullYear(), 4)}${includeTime ? ` ${dateToHms(date)}` : ""}`;
+    return `${padLeadingZeros(dt.getUTCMonth() + 1, 2).slice(-2)}/${padLeadingZeros(dt.getUTCDate(), 2).slice(-2)}/${padLeadingZeros(dt.getUTCFullYear(), 4)}${defaultSettings.convertMiliseconds
+        ? ` ${dateToHms(date, defaultSettings)}`
+        : ""}`;
 }

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

@@ -1,4 +1,6 @@
 import { DATE_YEAR_MONTHS } from "../constants/DATE_YEAR_MONTHS";
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
+import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { isValidDateObject } from "../helpers/isValidDateObject";
 import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
 /**
@@ -6,11 +8,13 @@ import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
  * @param date String, object or millisencond number of the date
  * @returns string of [Month Year] date format
  */
-export function dateToMonthYear(date) {
+export function dateToMonthYear(date, settings) {
     if (!isValidPotentialDate(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = getDefaultDateSettings(settings);
+    const timezonedDate = getDateByTimezone(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!isValidDateObject(dt))
         return date;
-    return `${DATE_YEAR_MONTHS[dt.getMonth()]} ${dt.getFullYear()}`;
+    return `${DATE_YEAR_MONTHS[dt.getUTCMonth()]} ${dt.getUTCFullYear()}`;
 }

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

@@ -1,4 +1,6 @@
 import { DATE_YEAR_QUARTERS } from "../constants/DATE_YEAR_QUARTERS";
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
+import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { isValidDateObject } from "../helpers/isValidDateObject";
 import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
 /**
@@ -6,12 +8,14 @@ import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
  * @param date String of a valid date, date object or millisencond number of the date
  * @returns string of [Quarter Year] date format
  */
-export function dateToQuarterYear(date) {
+export function dateToQuarterYear(date, settings) {
     if (!isValidPotentialDate(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = getDefaultDateSettings(settings);
+    const timezonedDate = getDateByTimezone(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!isValidDateObject(dt))
         return date;
-    const quarter = Math.ceil((dt.getMonth() + 1) / 3);
-    return `${DATE_YEAR_QUARTERS[quarter - 1]} ${dt.getFullYear()}`;
+    const quarter = Math.ceil((dt.getUTCMonth() + 1) / 3);
+    return `${DATE_YEAR_QUARTERS[quarter - 1]} ${dt.getUTCFullYear()}`;
 }

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

@@ -1,3 +1,5 @@
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
+import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { getWeek } from "../helpers/getWeek";
 import { isValidDateObject } from "../helpers/isValidDateObject";
 import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
@@ -6,10 +8,12 @@ import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
  * @param date String, object or millisencond number of the date
  * @returns string of [W# Year] date format
  */
-export function dateToWeekYear(date) {
+export function dateToWeekYear(date, settings) {
     if (!isValidPotentialDate(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = getDefaultDateSettings(settings);
+    const timezonedDate = getDateByTimezone(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!isValidDateObject(dt))
         return date;
     const weekObj = getWeek(dt);

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

@@ -1,3 +1,5 @@
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
+import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { isValidDateObject } from "../helpers/isValidDateObject";
 import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
 /**
@@ -5,11 +7,13 @@ import { isValidPotentialDate } from "../helpers/isValidPotentialDate";
  * @param {string | Date | number} date String, object or millisencond number of the date
  * @returns string of [Year] date format
  */
-export function dateToYear(date) {
+export function dateToYear(date, settings) {
     if (!isValidPotentialDate(date))
         return date;
-    const dt = new Date(date.valueOf());
+    const defaultSettings = getDefaultDateSettings(settings);
+    const timezonedDate = getDateByTimezone(date, defaultSettings.timezone);
+    const dt = new Date(timezonedDate.valueOf());
     if (!isValidDateObject(dt))
         return date;
-    return String(dt.getFullYear());
+    return String(dt.getUTCFullYear());
 }

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

@@ -1,6 +1,8 @@
 import { isEmpty } from "../../general/mix/isEmpty";
 import { isTokenLabel } from "../../tokens/isTokenLabel";
 import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
+import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { validateDate } from "../helpers/validateDate";
 /**
  * Transforms String time from a [H:m:s] format to Date object.
@@ -8,13 +10,15 @@ import { validateDate } from "../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
  */
-export function hmsToDate(hmsDate, time = false) {
+export function hmsToDate(hmsDate, settings) {
     if (isEmpty(hmsDate) ||
         isTokenLabel(hmsDate) ||
         typeof hmsDate !== "string" ||
         !validateDate(hmsDate, DATE_FORMAT.DAY_TIME))
         return hmsDate;
+    const defaultSettings = getDefaultDateSettings(settings);
     const [hour, minute, second] = hmsDate.split(":");
     const start = new Date(0, 0, 0, +hour, +minute, +second);
-    return time ? +start : start;
+    const timezonedDate = getDateByTimezone(start, defaultSettings.timezone);
+    return defaultSettings.convertMiliseconds ? +timezonedDate : timezonedDate;
 }

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/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/dates/adapters/mdyDateToDate.js

@@ -1,6 +1,8 @@
 import { isEmpty } from "../../general/mix/isEmpty";
 import { isTokenLabel } from "../../tokens/isTokenLabel";
 import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
+import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { validateDate } from "../helpers/validateDate";
 /**
  * Transforms String Date from a [mm/dd/yyyy] format to Date object.
@@ -8,13 +10,16 @@ import { validateDate } from "../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
  */
-export function mdyDateToDate(date, time = false) {
+export function mdyDateToDate(date, settings) {
     if (isEmpty(date) ||
         isTokenLabel(date) ||
         typeof date !== "string" ||
         !validatingDate(date))
         return date;
-    return time ? +new Date(date) : new Date(date);
+    const defaultSettings = getDefaultDateSettings(settings);
+    const dateObject = new Date(date);
+    const timezonedDate = getDateByTimezone(dateObject, defaultSettings.timezone);
+    return defaultSettings.convertMiliseconds ? +timezonedDate : timezonedDate;
 }
 function validatingDate(date) {
     return (validateDate(date, DATE_FORMAT.DAY) ||

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

@@ -2,6 +2,8 @@ import { isEmpty } from "../../general/mix/isEmpty";
 import { isTokenLabel } from "../../tokens/isTokenLabel";
 import { DATE_FORMAT } from "../constants/DATE_FORMAT";
 import { DATE_YEAR_MONTHS } from "../constants/DATE_YEAR_MONTHS";
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
+import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { validateDate } from "../helpers/validateDate";
 /**
  * Transforms String Date from a [Month Year] format to Date object.
@@ -9,13 +11,15 @@ import { validateDate } from "../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
  */
-export function monthYearToDate(monthYearDate, time = false) {
+export function monthYearToDate(monthYearDate, settings) {
     if (isEmpty(monthYearDate) ||
         isTokenLabel(monthYearDate) ||
         typeof monthYearDate !== "string" ||
         !validateDate(monthYearDate, DATE_FORMAT.MONTH))
         return monthYearDate;
+    const defaultSettings = getDefaultDateSettings(settings);
     const [month, year] = monthYearDate.split(" ");
     const start = new Date(+year, DATE_YEAR_MONTHS.indexOf(month), 1);
-    return time ? +start : start;
+    const timezonedDate = getDateByTimezone(start, defaultSettings.timezone);
+    return (defaultSettings === null || defaultSettings === void 0 ? void 0 : defaultSettings.convertMiliseconds) ? +timezonedDate : timezonedDate;
 }

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

package/dist/dates/adapters/numericOffsetToISO.js

@@ -0,0 +1,30 @@
+import { isNaNV2 } from "../../general/mix/isNaNV2";
+import { getSign } from "../../general/numeric/getSign";
+import { padLeadingZeros } from "../../general/string/padLeadingZeros";
+import { isValidISOOffset } from "../helpers/isValidISOOffset";
+import { ISOToNumericOffset } from "./ISOToNumericOffset";
+/**
+ * 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, 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" && isValidISOOffset(newOffset)) {
+        if (leadZeros)
+            return String(newOffset);
+        newOffset = ISOToNumericOffset(newOffset);
+    }
+    if (typeof newOffset !== "number" && isNaNV2(newOffset))
+        return leadZeros ? "+00:00" : "+0:0";
+    if (typeof newOffset === "string" && !isNaNV2(newOffset))
+        newOffset = +newOffset;
+    const sign = getSign(newOffset);
+    newOffset = Math.abs(newOffset);
+    const hours = padLeadingZeros(Math.floor(newOffset / 60), leadZeroNumber);
+    const minutes = padLeadingZeros(newOffset % 60, leadZeroNumber);
+    return `${sign}${hours}:${minutes}`;
+}

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

@@ -2,6 +2,8 @@ import { isEmpty } from "../../general/mix/isEmpty";
 import { isTokenLabel } from "../../tokens/isTokenLabel";
 import { DATE_FORMAT } from "../constants/DATE_FORMAT";
 import { DATE_YEAR_QUARTERS_RANGE } from "../constants/DATE_YEAR_QUARTERS_RANGE";
+import { getDateByTimezone } from "../helpers/getDateByTimezone";
+import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { validateDate } from "../helpers/validateDate";
 /**
  * Transforms String Date from a [Quarter Year] format to Date object.
@@ -9,13 +11,15 @@ import { validateDate } from "../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.
  */
-export function quarterYearToDate(quarterYearDate, time = false) {
+export function quarterYearToDate(quarterYearDate, settings) {
     if (isEmpty(quarterYearDate) ||
         isTokenLabel(quarterYearDate) ||
         typeof quarterYearDate !== "string" ||
         !validateDate(quarterYearDate, DATE_FORMAT.QUARTER))
         return quarterYearDate;
+    const defaultSettings = getDefaultDateSettings(settings);
     const [quarter, year] = quarterYearDate.split(" ");
     const start = new Date(+year, DATE_YEAR_QUARTERS_RANGE[quarter].initial, 1);
-    return time ? +start : start;
+    const timezonedDate = getDateByTimezone(start, defaultSettings.timezone);
+    return (defaultSettings === null || defaultSettings === void 0 ? void 0 : defaultSettings.convertMiliseconds) ? +timezonedDate : timezonedDate;
 }

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