@qrvey/utils 1.10.0-timezone-1 → 1.10.0

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

@@ -1,3 +1,8 @@
 import { IDTimezone } from "../../dates/interfaces/IDTimezone";
-import { IBTimezone } from "../../qrvey/interfaces/IBTimezone";
+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

@@ -1,9 +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 {
-        offset: timezone.offset || timezone.numericOffset,
+        type,
+        offset: (0, getTimezoneOffsetByType_1.getTimezoneOffsetByType)(Object.assign(Object.assign({}, timezone), { type })),
     };
 }
 exports.BTimezoneToUITimezone = BTimezoneToUITimezone;

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/constants/COLUMN_PROPERTY_LABEL.d.ts

@@ -13,6 +13,7 @@ export declare const COLUMN_PROPERTY_LABEL: {
     ADDRESS_STATE: COMPOUND_COLUMN_PROPERTY_LABEL.ADDRESS_STATE;
     ADDRESS_POSTAL: COMPOUND_COLUMN_PROPERTY_LABEL.ADDRESS_POSTAL;
     ADDRESS_COUNTRY: COMPOUND_COLUMN_PROPERTY_LABEL.ADDRESS_COUNTRY;
+    ADDRESS_COUNTY: COMPOUND_COLUMN_PROPERTY_LABEL.ADDRESS_COUNTY;
     USADDRESS_LINE_1: COMPOUND_COLUMN_PROPERTY_LABEL.USADDRESS_LINE_1;
     USADDRESS_LINE_2: COMPOUND_COLUMN_PROPERTY_LABEL.USADDRESS_LINE_2;
     USADDRESS_CITY: COMPOUND_COLUMN_PROPERTY_LABEL.ADDRESS_CITY;

package/dist/columns/constants/COMPOUND_COLUMN_PROPERTY_LABEL.d.ts

@@ -6,6 +6,7 @@ export declare enum COMPOUND_COLUMN_PROPERTY_LABEL {
     ADDRESS_STATE = "State/Region/Province",
     ADDRESS_POSTAL = "Postal/Zip Code",
     ADDRESS_COUNTRY = "Country",
+    ADDRESS_COUNTY = "County",
     USADDRESS_LINE_1 = "Address 1",
     USADDRESS_LINE_2 = "Address 2",
     USADDRESS_CITY = "City",

package/dist/columns/constants/COMPOUND_COLUMN_PROPERTY_LABEL.js

@@ -7,6 +7,7 @@ export var COMPOUND_COLUMN_PROPERTY_LABEL;
     COMPOUND_COLUMN_PROPERTY_LABEL["ADDRESS_STATE"] = "State/Region/Province";
     COMPOUND_COLUMN_PROPERTY_LABEL["ADDRESS_POSTAL"] = "Postal/Zip Code";
     COMPOUND_COLUMN_PROPERTY_LABEL["ADDRESS_COUNTRY"] = "Country";
+    COMPOUND_COLUMN_PROPERTY_LABEL["ADDRESS_COUNTY"] = "County";
     COMPOUND_COLUMN_PROPERTY_LABEL["USADDRESS_LINE_1"] = "Address 1";
     COMPOUND_COLUMN_PROPERTY_LABEL["USADDRESS_LINE_2"] = "Address 2";
     COMPOUND_COLUMN_PROPERTY_LABEL["USADDRESS_CITY"] = "City";

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

@@ -1,4 +1,5 @@
 import { isNaNV2 } from "../../general/mix/isNaNV2";
+import { getSign } from "../../general/numeric/getSign";
 import { isValidISOOffset } from "../helpers/isValidISOOffset";
 /**
  * Gets the numeric offset (minutes) from the ISO offset (string)
@@ -6,10 +7,14 @@ import { isValidISOOffset } from "../helpers/isValidISOOffset";
  * @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;
+    const sign = getSign(hours);
+    const absoluteOffset = Math.abs(hours) * 60 + minutes;
+    return sign === "-" ? -1 * absoluteOffset : absoluteOffset;
 }

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

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.getMonth() + 1, 2).slice(-2)}/${padLeadingZeros(dt.getDate(), 2).slice(-2)}/${padLeadingZeros(dt.getFullYear(), 4)}${defaultSettings.convertMiliseconds
+        ? ` ${dateToHms(timezonedDate, 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,10 +8,12 @@ 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()}`;

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,10 +8,12 @@ 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);

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,10 +7,12 @@ 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());

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/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

@@ -3,4 +3,4 @@
  * @param {number} offset the timezone offset
  * @returns {string} the offset in minutes
  */
-export declare function numericOffsetToISO(offset: number): string;
+export declare function numericOffsetToISO(offset: number | string, leadZeros?: boolean): string;

package/dist/dates/adapters/numericOffsetToISO.js

@@ -2,22 +2,29 @@ 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) {
+export function numericOffsetToISO(offset, leadZeros = true) {
+    const leadZeroNumber = leadZeros ? 2 : 0;
     let newOffset = offset;
-    if (typeof offset === "string" && isValidISOOffset(offset))
-        return String(newOffset);
-    if (typeof offset !== "number" && isNaNV2(offset))
-        return "+00:00";
-    if (typeof offset === "string" && !isNaNV2(offset))
-        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";
+    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 hours = padLeadingZeros(Math.floor(newOffset / 60), leadZeroNumber);
     const minutes = padLeadingZeros(newOffset % 60, 2);
     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;

package/dist/dates/adapters/weekYearToDate.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 { getWeek } from "../helpers/getWeek";
 import { validateDate } from "../helpers/validateDate";
 /**
@@ -9,12 +11,13 @@ 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 weekYearToDate(weekYear, time = false) {
+export function weekYearToDate(weekYear, settings) {
     if (isEmpty(weekYear) ||
         isTokenLabel(weekYear) ||
         typeof weekYear !== "string" ||
         !validateDate(weekYear, DATE_FORMAT.WEEK))
         return weekYear;
+    const defaultSettings = getDefaultDateSettings(settings);
     const [week, year] = weekYear.split(" ");
     const weekNumber = Number(week.substring(1));
     const dateObj = new Date(+year, 1, 1);
@@ -24,5 +27,6 @@ export function weekYearToDate(weekYear, time = false) {
     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;
+    const timezonedDate = getDateByTimezone(date, defaultSettings.timezone);
+    return (defaultSettings === null || defaultSettings === void 0 ? void 0 : defaultSettings.convertMiliseconds) ? +timezonedDate : timezonedDate;
 }

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

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

package/dist/dates/adapters/yearToDate.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 [Year] format to Date object.
@@ -8,12 +10,14 @@ 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 yearToDate(yearDate, time = false) {
+export function yearToDate(yearDate, settings) {
     if (isEmpty(yearDate) ||
         isTokenLabel(yearDate) ||
         typeof yearDate !== "string" ||
         !validateDate(yearDate, DATE_FORMAT.YEAR))
         return yearDate;
+    const defaultSettings = getDefaultDateSettings(settings);
     const start = new Date(+yearDate, 0, 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/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/helpers/getDateByDateFormat.d.ts

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