@qrvey/utils 1.2.4-13 → 1.2.4-17

package/dist/dates/adapters/monthYearToDate.js

@@ -0,0 +1,20 @@
+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 { validateDate } from "../helpers/validateDate";
+/**
+ * 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
+ */
+export function monthYearToDate(monthYearDate, time = false) {
+    if (isEmpty(monthYearDate) || isTokenLabel(monthYearDate))
+        return monthYearDate;
+    if (validateDate(monthYearDate, DATE_FORMAT.MONTH)) {
+        const [month, year] = monthYearDate.split(' ');
+        const start = new Date(+year, DATE_YEAR_MONTHS.indexOf(month), 1);
+        return time ? +start : start;
+    }
+}

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

@@ -0,0 +1,7 @@
+/**
+ * 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
+ */
+export declare function quarterYearToDate(quarterYearDate: string, time?: boolean): string | number | Date;

package/dist/dates/adapters/quarterYearToDate.js

@@ -0,0 +1,20 @@
+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 { validateDate } from "../helpers/validateDate";
+/**
+ * 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
+ */
+export function quarterYearToDate(quarterYearDate, time = false) {
+    if (isEmpty(quarterYearDate) || isTokenLabel(quarterYearDate))
+        return quarterYearDate;
+    if (validateDate(quarterYearDate, DATE_FORMAT.QUARTER)) {
+        const [quarter, year] = quarterYearDate.split(' ');
+        const start = new Date(+year, DATE_YEAR_QUARTERS_RANGE[quarter].initial, 1);
+        return time ? +start : start;
+    }
+}

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

@@ -0,0 +1,7 @@
+/**
+ * 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
+ */
+export declare function weekYearToDate(weekYear: string, time?: boolean): string | number | Date;

package/dist/dates/adapters/weekYearToDate.js

@@ -0,0 +1,28 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { getWeek } from "../helpers/getWeek";
+import { validateDate } from "../helpers/validateDate";
+/**
+ * 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
+ */
+export function weekYearToDate(weekYear, time = false) {
+    if (isEmpty(weekYear) || isTokenLabel(weekYear))
+        return weekYear;
+    if (validateDate(weekYear, DATE_FORMAT.WEEK)) {
+        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 weekNoToday = 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;
+    }
+}
+;

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

@@ -0,0 +1,7 @@
+/**
+ * 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
+ */
+export declare function yearToDate(yearDate: string, time?: boolean): string | number | Date;

package/dist/dates/adapters/yearToDate.js

@@ -0,0 +1,18 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { validateDate } from "../helpers/validateDate";
+/**
+ * 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
+ */
+export function yearToDate(yearDate, time = false) {
+    if (isEmpty(yearDate) || isTokenLabel(yearDate))
+        return yearDate;
+    if (validateDate(yearDate, DATE_FORMAT.YEAR)) {
+        const start = new Date(+yearDate, 0, 1);
+        return time ? +start : start;
+    }
+}

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

@@ -1,16 +1,18 @@
 export declare const DATE_FORMAT: {
-    year: string;
-    month: string;
-    quarter: string;
-    week: string;
-    day: string;
-    hour: string;
-    minute: string;
-    second: string;
-    day_only: string;
-    month_only: string;
-    quarter_only: string;
-    hour_only: string;
-    minute_only: string;
-    second_only: string;
+    YEAR: string;
+    MONTH: string;
+    QUARTER: string;
+    WEEK: string;
+    DAY: string;
+    DAY_TIME: string;
+    HOUR: string;
+    MINUTE: string;
+    SECOND: string;
+    MONTH_DAY: string;
+    YEAR_MONTH: string;
+    YEAR_QUARTER: string;
+    YEAR_WEEK: string;
+    DAY_HOUR: string;
+    HOUR_MINUTE: string;
+    MINUTE_SECOND: string;
 };

package/dist/dates/constants/DATE_FORMAT.js

@@ -1,20 +1,25 @@
-import { DATE_GROUPING_TIME_PROPERTY } from "./DATE_GROUPING_TIME_PROPERTY";
-import { DATE_GROUPING_PROPERTY } from "./DATE_GROUPING_PROPERTY";
-import { DATE_DISTINCT_PROPERTY } from "./DATE_DISTINCT_PROPERTY";
-import { DATE_DISTINCT_TIME_PROPERTY } from "./DATE_DISTINCT_TIME_PROPERTY";
+const YEAR = 'yyyy';
+const DAY = 'mm/dd/yyyy';
+const DAY_TIME = 'HH:mm:ss';
+const MONTH_DAY = 'dd';
+const YEAR_MONTH = 'M';
+const YEAR_QUARTER = 'Q#';
+const YEAR_WEEK = 'W#';
 export const DATE_FORMAT = {
-    [DATE_GROUPING_PROPERTY.YEAR]: 'yyyy',
-    [DATE_GROUPING_PROPERTY.MONTH]: 'M yyyy',
-    [DATE_GROUPING_PROPERTY.QUARTER]: 'Q# yyyy',
-    [DATE_GROUPING_PROPERTY.WEEK]: 'W# yyyy',
-    [DATE_GROUPING_PROPERTY.DAY]: 'mm/dd/yyyy',
-    [DATE_GROUPING_TIME_PROPERTY.HOUR]: 'mm/dd/yyyy HH:mm:ss',
-    [DATE_GROUPING_TIME_PROPERTY.MINUTE]: 'mm/dd/yyyy HH:mm:ss',
-    [DATE_GROUPING_TIME_PROPERTY.SECOND]: 'mm/dd/yyyy HH:mm:ss',
-    [DATE_DISTINCT_PROPERTY.MONTH_DAY]: 'dd',
-    [DATE_DISTINCT_PROPERTY.YEAR_MONTH]: 'M',
-    [DATE_DISTINCT_PROPERTY.YEAR_QUARTER]: 'Q#',
-    [DATE_DISTINCT_TIME_PROPERTY.DAY_HOUR]: 'HH',
-    [DATE_DISTINCT_TIME_PROPERTY.HOUR_MINUTE]: 'mm',
-    [DATE_DISTINCT_TIME_PROPERTY.MINUTE_SECOND]: 'ss',
+    YEAR: YEAR,
+    MONTH: `${YEAR_MONTH} ${YEAR}`,
+    QUARTER: `${YEAR_QUARTER} ${YEAR}`,
+    WEEK: `${YEAR_WEEK} ${YEAR}`,
+    DAY: DAY,
+    DAY_TIME: DAY_TIME,
+    HOUR: `${DAY} ${DAY_TIME}`,
+    MINUTE: `${DAY} ${DAY_TIME}`,
+    SECOND: `${DAY} ${DAY_TIME}`,
+    MONTH_DAY: MONTH_DAY,
+    YEAR_MONTH: YEAR_MONTH,
+    YEAR_QUARTER: YEAR_QUARTER,
+    YEAR_WEEK: YEAR_WEEK,
+    DAY_HOUR: 'HH',
+    HOUR_MINUTE: 'mm',
+    MINUTE_SECOND: 'ss',
 };

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

@@ -1 +1,19 @@
-export declare const DATE_REGULAR_EXPRESSION: {};
+export declare const DATE_REGULAR_EXPRESSION: {
+    YEAR: string;
+    MONTH: string;
+    QUARTER: string;
+    WEEK: string;
+    DAY: string;
+    DAY_TIME: string;
+    HOUR: string;
+    MINUTE: string;
+    SECOND: string;
+    MONTH_DAY: string;
+    YEAR_MONTH: string;
+    YEAR_MONTH_NUMBER: string;
+    YEAR_QUARTER: string;
+    YEAR_WEEK: string;
+    DAY_HOUR: string;
+    HOUR_MINUTE: string;
+    MINUTE_SECOND: string;
+};

package/dist/dates/constants/DATE_REGULAR_EXPRESSION.js

@@ -1,7 +1,31 @@
+import { DATE_YEAR_MONTHS } from "./DATE_YEAR_MONTHS";
+import { DATE_YEAR_QUARTERS } from "./DATE_YEAR_QUARTERS";
+const YEAR = '\\d{4}';
+const YEAR_MONTH = `(${DATE_YEAR_MONTHS.join('|')})`;
+const YEAR_MONTH_NUMBER = '((0)[1-9]|[0-1][0-2])';
+const YEAR_QUARTER = `(${DATE_YEAR_QUARTERS.join('|')})`;
+const YEAR_WEEK = '(W)(5[0-3]|[1-4][0-9]|[1-9])';
+const MONTH_DAY = '(0?[1-9]|[12][0-9]|3[01])';
+const DAY_HOUR = '(([0-1][0-9])|(2[0-3]))';
+const HOUR_MINUTE = '[0-5][0-9]';
+const MINUTE_SECOND = '[0-5][0-9]';
+const DAY_TIME = `((${DAY_HOUR}:?${HOUR_MINUTE}:?${MINUTE_SECOND}+))`;
 export const DATE_REGULAR_EXPRESSION = {
-// MONTH_NUMBER: new RegExp('^((0)[1-9]|[0-1][0-2])$'),
-// DAY: new RegExp('^(0?[1-9]|[12][0-9]|3[01])$'),
-// YEAR: new RegExp(`\\d{4}$`, 'g'),
-// MONTH_LABEL: new RegExp(`^(${months.join('|')})$`, 'g'),
-// QUARTER: new RegExp(`(${quarters.join('|')})`, 'g')
+    YEAR: `^${YEAR}$`,
+    MONTH: `^${YEAR_MONTH} ${YEAR}$`,
+    QUARTER: `^${YEAR_QUARTER} ${YEAR}$`,
+    WEEK: `^${YEAR_WEEK} ${YEAR}$`,
+    DAY: `^${YEAR_MONTH_NUMBER}/${MONTH_DAY}/${YEAR}$`,
+    DAY_TIME: `^${DAY_TIME}$`,
+    HOUR: `^${YEAR_MONTH_NUMBER}/${MONTH_DAY}/${YEAR} ${DAY_TIME}$`,
+    MINUTE: `^${YEAR_MONTH_NUMBER}/${MONTH_DAY}/${YEAR} ${DAY_TIME}$`,
+    SECOND: `^${YEAR_MONTH_NUMBER}/${MONTH_DAY}/${YEAR} ${DAY_TIME}$`,
+    MONTH_DAY: `^${MONTH_DAY}$`,
+    YEAR_MONTH: `^${YEAR_MONTH}$`,
+    YEAR_MONTH_NUMBER: `${YEAR_MONTH_NUMBER}`,
+    YEAR_QUARTER: `^${YEAR_QUARTER}$`,
+    YEAR_WEEK: `^${YEAR_WEEK}$`,
+    DAY_HOUR: `^${DAY_HOUR}$`,
+    HOUR_MINUTE: `^${HOUR_MINUTE}$`,
+    MINUTE_SECOND: `^${MINUTE_SECOND}$`,
 };

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

@@ -0,0 +1,18 @@
+export declare const DATE_YEAR_QUARTERS_RANGE: {
+    Q1: {
+        initial: number;
+        final: number;
+    };
+    Q2: {
+        initial: number;
+        final: number;
+    };
+    Q3: {
+        initial: number;
+        final: number;
+    };
+    Q4: {
+        initial: number;
+        final: number;
+    };
+};

package/dist/dates/constants/DATE_YEAR_QUARTERS_RANGE.js

@@ -0,0 +1,18 @@
+export const DATE_YEAR_QUARTERS_RANGE = {
+    Q1: {
+        initial: 0,
+        final: 2
+    },
+    Q2: {
+        initial: 3,
+        final: 5
+    },
+    Q3: {
+        initial: 6,
+        final: 8
+    },
+    Q4: {
+        initial: 9,
+        final: 11
+    }
+};

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

@@ -30,3 +30,4 @@ export * from './DATE_WEEK_DAYS';
 export * from './DATE_YEAR_DAYS';
 export * from './DATE_YEAR_MONTHS';
 export * from './DATE_YEAR_QUARTERS';
+export * from './DATE_YEAR_QUARTERS_RANGE';

package/dist/dates/constants/index.js

@@ -30,3 +30,4 @@ export * from './DATE_WEEK_DAYS';
 export * from './DATE_YEAR_DAYS';
 export * from './DATE_YEAR_MONTHS';
 export * from './DATE_YEAR_QUARTERS';
+export * from './DATE_YEAR_QUARTERS_RANGE';

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

@@ -0,0 +1,9 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Gets a Date Object instance by a Date format
+ * @param date String with a formatted date
+ * @param format The date format
+ * @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 | number | Date;

package/dist/dates/helpers/getDateByDateFormat.js

@@ -0,0 +1,32 @@
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { yearToDate } from "../adapters/yearToDate";
+import { monthYearToDate } from "../adapters/monthYearToDate";
+import { quarterYearToDate } from "../adapters/quarterYearToDate";
+import { weekYearToDate } from "../adapters/weekYearToDate";
+import { mdyDateToDate } from "../adapters/mdyDateToDate";
+/**
+ * Gets a Date Object instance by a Date format
+ * @param date String with a formatted date
+ * @param format The date format
+ * @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 function getDateByDateFormat(date, format, time = false) {
+    switch (format) {
+        case DATE_FORMAT.YEAR:
+            return yearToDate(date, time);
+        case DATE_FORMAT.MONTH:
+            return monthYearToDate(date, time);
+        case DATE_FORMAT.QUARTER:
+            return quarterYearToDate(date, time);
+        case DATE_FORMAT.WEEK:
+            return weekYearToDate(date, time);
+        case DATE_FORMAT.DAY:
+        case DATE_FORMAT.HOUR:
+        case DATE_FORMAT.MINUTE:
+        case DATE_FORMAT.SECOND:
+            return mdyDateToDate(date, time);
+        default:
+            return date;
+    }
+}

package/dist/dates/helpers/getDateFormatByProperty.d.ts

@@ -0,0 +1,8 @@
+import { IColumnPropertyType } from "../../columns/interfaces/IColumnPropertyType";
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Gets the date format by the given property
+ * @param property The Column Property
+ * @returns The date format
+ */
+export declare function getDateFormatByProperty(property: IColumnPropertyType): IDateFormat;

package/dist/dates/helpers/getDateFormatByProperty.js

@@ -0,0 +1,23 @@
+import { COLUMN_PROPERTY } from "../../columns/constants/COLUMN_PROPERTY";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+/**
+ * Gets the date format by the given property
+ * @param property The Column Property
+ * @returns The date format
+ */
+export function getDateFormatByProperty(property) {
+    return property === COLUMN_PROPERTY.YEAR ? DATE_FORMAT.YEAR :
+        property === COLUMN_PROPERTY.MONTH ? DATE_FORMAT.MONTH :
+            property === COLUMN_PROPERTY.QUARTER ? DATE_FORMAT.QUARTER :
+                property === COLUMN_PROPERTY.WEEK ? DATE_FORMAT.WEEK :
+                    property === COLUMN_PROPERTY.DAY ? DATE_FORMAT.DAY :
+                        property === COLUMN_PROPERTY.HOUR ? DATE_FORMAT.HOUR :
+                            property === COLUMN_PROPERTY.MINUTE ? DATE_FORMAT.MINUTE :
+                                property === COLUMN_PROPERTY.SECOND ? DATE_FORMAT.SECOND :
+                                    property === COLUMN_PROPERTY.MONTH_DAY ? DATE_FORMAT.MONTH_DAY :
+                                        property === COLUMN_PROPERTY.YEAR_MONTH ? DATE_FORMAT.YEAR_MONTH :
+                                            property === COLUMN_PROPERTY.YEAR_QUARTER ? DATE_FORMAT.YEAR_QUARTER :
+                                                property === COLUMN_PROPERTY.DAY_HOUR ? DATE_FORMAT.DAY_HOUR :
+                                                    property === COLUMN_PROPERTY.HOUR_MINUTE ? DATE_FORMAT.HOUR_MINUTE :
+                                                        property === COLUMN_PROPERTY.MINUTE_SECOND ? DATE_FORMAT.MINUTE_SECOND : undefined;
+}

package/dist/dates/helpers/getDateFormatRegularExpressionInArray.d.ts

@@ -0,0 +1,7 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Gets an array of regular expressions by the given date format
+ * @param dateFormat the date format
+ * @returns an array of regular expressions
+ */
+export declare function getDateFormatRegularExpressionInArray(dateFormat?: IDateFormat): string[];

package/dist/dates/helpers/getDateFormatRegularExpressionInArray.js

@@ -0,0 +1,43 @@
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { DATE_REGULAR_EXPRESSION } from "../constants/DATE_REGULAR_EXPRESSION";
+/**
+ * Gets an array of regular expressions by the given date format
+ * @param dateFormat the date format
+ * @returns an array of regular expressions
+ */
+export function getDateFormatRegularExpressionInArray(dateFormat = DATE_FORMAT.DAY) {
+    switch (dateFormat) {
+        case DATE_FORMAT.YEAR:
+            return [DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.MONTH:
+            return [DATE_REGULAR_EXPRESSION.YEAR_MONTH, DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.QUARTER:
+            return [DATE_REGULAR_EXPRESSION.YEAR_QUARTER, DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.WEEK:
+            return [DATE_REGULAR_EXPRESSION.YEAR_WEEK, DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.DAY:
+            return [DATE_REGULAR_EXPRESSION.YEAR_MONTH_NUMBER, DATE_REGULAR_EXPRESSION.MONTH_DAY, DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.DAY_TIME:
+            return [DATE_REGULAR_EXPRESSION.DAY_TIME];
+        case DATE_FORMAT.HOUR:
+        case DATE_FORMAT.MINUTE:
+        case DATE_FORMAT.SECOND:
+            return [DATE_REGULAR_EXPRESSION.DAY, DATE_REGULAR_EXPRESSION.DAY_TIME];
+        case DATE_FORMAT.MONTH_DAY:
+            return [DATE_REGULAR_EXPRESSION.MONTH_DAY];
+        case DATE_FORMAT.YEAR_MONTH:
+            return [DATE_REGULAR_EXPRESSION.YEAR_MONTH];
+        case DATE_FORMAT.YEAR_QUARTER:
+            return [DATE_REGULAR_EXPRESSION.YEAR_QUARTER];
+        case DATE_FORMAT.YEAR_WEEK:
+            return [DATE_REGULAR_EXPRESSION.YEAR_WEEK];
+        case DATE_FORMAT.DAY_HOUR:
+            return [DATE_REGULAR_EXPRESSION.DAY_HOUR];
+        case DATE_FORMAT.HOUR_MINUTE:
+            return [DATE_REGULAR_EXPRESSION.HOUR_MINUTE];
+        case DATE_FORMAT.MINUTE_SECOND:
+            return [DATE_REGULAR_EXPRESSION.MINUTE_SECOND];
+        default:
+            return [DATE_REGULAR_EXPRESSION.YEAR_MONTH_NUMBER, DATE_REGULAR_EXPRESSION.MONTH_DAY, DATE_REGULAR_EXPRESSION.YEAR];
+    }
+}

package/dist/dates/helpers/getSeparatorByDateFormat.d.ts

@@ -0,0 +1,7 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Gets the separator of the date format
+ * @param format the date format
+ * @returns a separator string
+ */
+export declare function getSeparatorByDateFormat(format?: IDateFormat): string;

package/dist/dates/helpers/getSeparatorByDateFormat.js

@@ -0,0 +1,11 @@
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+/**
+ * Gets the separator of the date format
+ * @param format the date format
+ * @returns a separator string
+ */
+export function getSeparatorByDateFormat(format = DATE_FORMAT.DAY) {
+    return format === DATE_FORMAT.YEAR || format === DATE_FORMAT.DAY_TIME || format === DATE_FORMAT.MONTH_DAY || format === DATE_FORMAT.YEAR_MONTH || format === DATE_FORMAT.YEAR_QUARTER || format === DATE_FORMAT.YEAR_WEEK || format === DATE_FORMAT.DAY_HOUR || format === DATE_FORMAT.HOUR_MINUTE || format === DATE_FORMAT.MINUTE_SECOND ? '' :
+        format === DATE_FORMAT.MONTH || format === DATE_FORMAT.QUARTER || format === DATE_FORMAT.WEEK || format === DATE_FORMAT.HOUR || format === DATE_FORMAT.MINUTE || format === DATE_FORMAT.SECOND ? ' ' :
+            '/';
+}

package/dist/dates/helpers/getWeek.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Gets the week number of the year
+ * Additionally, the month and the year
+ * @param date the date object
+ * @returns an object with the week, month and year.
+ */
+export declare function getWeek(date: Date): {
+    week: number;
+    month: number;
+    year: number;
+};

package/dist/dates/helpers/getWeek.js

@@ -0,0 +1,21 @@
+/**
+ * Gets the week number of the year
+ * Additionally, the month and the year
+ * @param date the date object
+ * @returns an object with the week, month and year.
+ */
+export function getWeek(date) {
+    const target = new Date(date.valueOf());
+    const dayNr = (date.getDay() + 6) % 7;
+    target.setDate(target.getDate() - dayNr + 3);
+    const firstThursday = target.valueOf();
+    target.setMonth(0, 1);
+    if (target.getDay() !== 4) {
+        target.setMonth(0, 1 + ((4 - target.getDay()) + 7) % 7);
+    }
+    return {
+        week: 1 + Math.ceil((firstThursday - +target) / 604800000),
+        month: target.getMonth() + 1,
+        year: target.getFullYear()
+    };
+}

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

@@ -0,0 +1,6 @@
+export * from './getDateFormatByProperty';
+export * from './getDateFormatRegularExpressionInArray';
+export * from './getSeparatorByDateFormat';
+export * from './getWeek';
+export * from './validateDate';
+export * from './validateDateByDateFormat';

package/dist/dates/helpers/index.js

@@ -0,0 +1,6 @@
+export * from './getDateFormatByProperty';
+export * from './getDateFormatRegularExpressionInArray';
+export * from './getSeparatorByDateFormat';
+export * from './getWeek';
+export * from './validateDate';
+export * from './validateDateByDateFormat';

package/dist/dates/helpers/validateDate.d.ts

@@ -0,0 +1,11 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Validate a string date depending on giving format
+ * - If the string is a token label, the function lets it pass.
+ * - Otherwise depends of the format
+ * - Some escenarios the string is a mix of token labels and dates
+ * @param date String of date
+ * @param format String of the format to validate
+ * @returns True if it is valid or not. Undefined if date is undefined
+ */
+export declare function validateDate(date: string, format?: IDateFormat): boolean;

package/dist/dates/helpers/validateDate.js

@@ -0,0 +1,20 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { validateDateByDateFormat } from "./validateDateByDateFormat";
+/**
+ * Validate a string date depending on giving format
+ * - If the string is a token label, the function lets it pass.
+ * - Otherwise depends of the format
+ * - Some escenarios the string is a mix of token labels and dates
+ * @param date String of date
+ * @param format String of the format to validate
+ * @returns True if it is valid or not. Undefined if date is undefined
+ */
+export function validateDate(date, format = DATE_FORMAT.DAY) {
+    if (isEmpty(date))
+        return false;
+    if (isTokenLabel(date))
+        return true;
+    return validateDateByDateFormat(date, format);
+}

package/dist/dates/helpers/validateDateByDateFormat.d.ts

@@ -0,0 +1,8 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Validates the given string as Date by its date format.
+ * @param date a string to validate as date form
+ * @param dateForma the format of the date to validate the string
+ * @returns true: the string is a valida date
+ */
+export declare function validateDateByDateFormat(date: string, dateFormat?: IDateFormat): boolean;

package/dist/dates/helpers/validateDateByDateFormat.js

@@ -0,0 +1,22 @@
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { getDateFormatRegularExpressionInArray } from "./getDateFormatRegularExpressionInArray";
+import { getSeparatorByDateFormat } from "./getSeparatorByDateFormat";
+/**
+ * Validates the given string as Date by its date format.
+ * @param date a string to validate as date form
+ * @param dateForma the format of the date to validate the string
+ * @returns true: the string is a valida date
+ */
+export function validateDateByDateFormat(date, dateFormat = DATE_FORMAT.DAY) {
+    const resultValidation = [];
+    const separator = getSeparatorByDateFormat(dateFormat);
+    const separatedDate = date.split(separator);
+    const regularExpression = getDateFormatRegularExpressionInArray(dateFormat);
+    if (regularExpression.length !== separatedDate.length)
+        return false;
+    for (let i = 0; i < separatedDate.length; i++) {
+        resultValidation.push(isTokenLabel(separatedDate[i]) || new RegExp(regularExpression[i], 'g').test(separatedDate[i]));
+    }
+    return resultValidation.every(validValue => validValue);
+}

package/dist/dates/index.d.ts

@@ -1,4 +1,5 @@
 export * from './constants/index';
+export * from './helpers/index';
 export * from './interfaces/index';
 export * from './range/index';
 export * from './relative/index';

package/dist/dates/index.js

@@ -1,4 +1,5 @@
 export * from './constants/index';
+export * from './helpers/index';
 export * from './interfaces/index';
 export * from './range/index';
 export * from './relative/index';

package/dist/dates/relative/constants/RELATIVE_CURSOR_INFO.d.ts

@@ -1,14 +1,5 @@
+import { IRelativeCursorInfo } from "../interfaces/IRelativeCursorInfo";
+import { RelativeCursor } from "../interfaces/RelativeCursor";
 export declare const RELATIVE_CURSOR_INFO: {
-    this: {
-        label: string;
-        value: string;
-    };
-    the_next: {
-        label: string;
-        value: string;
-    };
-    the_last: {
-        label: string;
-        value: string;
-    };
+    [key in RelativeCursor]: IRelativeCursorInfo;
 };

package/dist/dates/relative/constants/RELATIVE_CURSOR_INFO.js

@@ -1,6 +1,7 @@
 import { RELATIVE_CURSOR } from "./RELATIVE_CURSOR";
+import { RELATIVE_CURSOR_LABEL } from "./RELATIVE_CURSOR_LABEL";
 export const RELATIVE_CURSOR_INFO = {
-    [RELATIVE_CURSOR.THIS]: { label: 'This', value: 'this' },
-    [RELATIVE_CURSOR.NEXT]: { label: 'The next', value: 'the next' },
-    [RELATIVE_CURSOR.LAST]: { label: 'The last', value: 'the last' },
+    [RELATIVE_CURSOR.THIS]: { abbrLabel: 'This', shortLabel: 'This', label: RELATIVE_CURSOR_LABEL.THIS, value: RELATIVE_CURSOR.THIS, displayed: true },
+    [RELATIVE_CURSOR.NEXT]: { abbrLabel: 'Next', shortLabel: 'Next', label: RELATIVE_CURSOR_LABEL.NEXT, value: RELATIVE_CURSOR.NEXT, displayed: true },
+    [RELATIVE_CURSOR.LAST]: { abbrLabel: 'Last', shortLabel: 'Last', label: RELATIVE_CURSOR_LABEL.LAST, value: RELATIVE_CURSOR.LAST, displayed: true },
 };

package/dist/dates/relative/constants/RELATIVE_CURSOR_INFO_LIST.d.ts

@@ -0,0 +1,5 @@
+import { IRelativeCursorInfo } from "..";
+/**
+ * @description Key/array of compound relative cursor info
+ */
+export declare const RELATIVE_CURSOR_INFO_LIST: IRelativeCursorInfo[];