@qrvey/utils 1.3.0-0 → 1.3.0-11

package/dist/globalization/service/i18nextBuilder.d.ts

@@ -5,6 +5,15 @@ export declare class I18nServiceBuilder {
     private static _initI18n;
     static setTranslations(i18nDefault: any, i18nResource: II18nResource): II18nResource;
 }
+/**
+ * This class allows to use the translation service of the i18next library
+ */
 export declare abstract class I18nService {
+    /**
+      * This method by means of the key searches in the configuration object, replaces the values received by means of the options parameter and returns the translated text. Ex: <b>translate('the_value_is {{number}}',{number: 1});</b>
+      * @param key String used as key
+      * @param options Object of type II18nServiceTranslateOption that contains the dynamic parameters to replace
+      * @returns The translated text Ex: <b>The value is: 1</b>
+      */
     abstract translate(key: string, options?: II18nServiceTranslateOption): string;
 }

package/dist/globalization/service/i18nextBuilder.js

@@ -40,6 +40,9 @@ export class I18nServiceBuilder {
         return mergeDeep(i18nResource, i18nDefault, { mergeExistingValues: false });
     }
 }
+/**
+ * This class allows to use the translation service of the i18next library
+ */
 export class I18nService {
 }
 class I18nServiceConcrete extends I18nService {

package/dist/index.d.ts

@@ -13,3 +13,4 @@ export * from './stencil/index';
 export * from './services/index';
 export * from './typescript/index';
 export * from './tokens/index';
+export * from './column_format/index';

package/dist/index.js

@@ -13,3 +13,4 @@ export * from './stencil/index';
 export * from './services/index';
 export * from './typescript/index';
 export * from './tokens/index';
+export * from './column_format/index';

package/dist/interfaces/format/IFormatDefaultFormat.d.ts

@@ -0,0 +1,5 @@
+export interface IFormatDefaultFormat {
+    format: string;
+    type: string;
+    decimals?: number;
+}

package/dist/interfaces/format/IFormatDefaultFormat.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/format/IFormatOutputFormat.Interface.d.ts

@@ -1,9 +1,7 @@
 import { IFormatCurrency } from "./IFormatCurrency.Interface";
-export interface IFormatOutputFormat {
-    format: string;
-    type: string;
-    decimals?: number;
+import { IFormatDefaultFormat } from "./IFormatDefaultFormat";
+export interface IFormatOutputFormat extends IFormatDefaultFormat {
     currency?: IFormatCurrency;
     backup_currency?: IFormatCurrency;
-    originalFormat?: any;
+    originalFormat?: IFormatOutputFormat;
 }

package/jest.config.js

@@ -1,4 +1,5 @@
 module.exports = {
+  // preset: 'ts-jest',
   testEnvironment: 'node',
   verbose: true,
 };

package/package.json

@@ -1,42 +1,41 @@
 {
   "name": "@qrvey/utils",
-  "version": "1.3.0-0",
+  "version": "1.3.0-11",
   "description": "Helper, Utils for all Qrvey Projects",
   "homepage": "https://bitbucket.org/qrvey/qrvey_utils/wiki/Home",
   "main": "dist/index.js",
   "scripts": {
     "build": "tsc && tsc -m commonjs --outDir dist/cjs",
     "build-clean": "node ./scripts/clean-build",
-    "docs": "./node_modules/.bin/jsdoc -c ./jsdoc.config.json",
-    "doxs": "doxdox './dist/**/*.js' --ignore './dist/cjs/**/*.js' --output README.md --layout markdown --package ./package.json",
+    "compodoc": "npx compodoc -p tsconfig.doc.json",
+    "compodoc:server": "./node_modules/.bin/compodoc -p ./tsconfig.doc.json -s --port=4400",
     "lint": "eslint src --quiet --exit-on-fatal-error --ext .ts,.js",
     "lint-dev": "eslint src --debug --ext .ts,.tsx",
+    "pipeline": "npm run build-clean && npm run lint && npm run test",
     "publishing-old": "node ./scripts/prepare-publish && np",
     "publishing-prerelease-old": "node ./scripts/prepare-publish && np --any-branch --tag=$npm_config_tag",
     "publishing-beta-1": "node ./scripts/publishing --np-new-version=$npm_config_np_new_version --np-any-branch=$npm_config_np_any_branch --np-tag=$npm_config_np_tag",
-    "publishing-beta-2": "node ./scripts/clean-build && node ./scripts/generating-docs && np --any-branch --np-tag=$npm_config_np_tag",
+    "publishing-beta-2": "node ./scripts/clean-build && node ./scripts/generating-docs --np-new-version=$npm_config_np_new_version && np $npm_config_np_new_version --any-branch --tag=$npm_config_np_tag",
     "test": "jest test",
     "test:watch": "jest --watch test"
   },
   "author": "Qrvey Inc",
   "license": "MIT",
   "devDependencies": {
-    "@types/jest": "27.4.1",
+    "@compodoc/compodoc": "1.1.19",
+    "@types/jest": "27.5.1",
     "@typescript-eslint/eslint-plugin": "5.22.0",
     "@typescript-eslint/parser": "5.22.0",
-    "doxdox": "3.0.0",
     "eslint": "8.14.0",
-    "jest": "27.5.1",
-    "jsdoc": "3.6.10",
+    "jest": "28.1.0",
     "np": "7.6.1",
+    "ts-jest": "28.0.2",
     "typedoc": "0.22.15",
     "typescript": "4.6.4"
   },
   "dependencies": {
     "d3": "6.3.1",
+    "dayjs": "1.11.1",
     "i18next": "21.6.16"
-  },
-  "peerDependencies": {
-    "dayjs": ">=1.11.1 <1.12.0"
   }
 }

package/scripts/generating-docs/index.js

@@ -67,9 +67,9 @@ async function startGeneratingDocs(settings) {
     await pushingChanges(settings);
 }
 
-async function generatingDocument(settings) {
+async function generatingDocument(_settings) {
     console.log('==>>> Generating Document...');
-    await execute(`doxdox './dist/**/*.js' --output ${settings.docsFileName} --ignore './dist/cjs/**/*.js' --package ${settings.packagePath} --layout markdown`);
+    await execute('npm run compodoc');
 }
 
 async function changingVersion(settings) {

package/src/column_format/constants/CHART_GROUP.ts

@@ -0,0 +1,4 @@
+export enum CHART_GROUPS {
+    TABLES = 'tables',
+    XY = 'xy'
+}

package/src/column_format/constants/DATEGROUP_UNSUPPORT_FORMAT.ts

@@ -0,0 +1,14 @@
+import { DATEGROUP_WITHOUT_FORMAT } from "./DATEGROUP_WITHOUT_FORMAT";
+
+export const DATEGROUP_UNSUPPORT_FORMAT = [
+    DATEGROUP_WITHOUT_FORMAT.YEAR,
+    DATEGROUP_WITHOUT_FORMAT.QUARTER,
+    DATEGROUP_WITHOUT_FORMAT.MONTH,
+    DATEGROUP_WITHOUT_FORMAT.WEEK,
+    DATEGROUP_WITHOUT_FORMAT.QUARTER_ONLY,
+    DATEGROUP_WITHOUT_FORMAT.MONTH_ONLY,
+    DATEGROUP_WITHOUT_FORMAT.DAY_ONLY,
+    DATEGROUP_WITHOUT_FORMAT.HOUR_ONLY,
+    DATEGROUP_WITHOUT_FORMAT.MINUTE_ONLY,
+    DATEGROUP_WITHOUT_FORMAT.SECOND_ONLY
+];

package/src/column_format/constants/DATEGROUP_WITHOUT_FORMAT.ts

@@ -0,0 +1,12 @@
+export enum DATEGROUP_WITHOUT_FORMAT  {
+    YEAR = 'YEAR',
+    QUARTER = 'QUARTER',
+    MONTH = 'MONTH',
+    WEEK = 'WEEK',
+    QUARTER_ONLY = 'QUARTER_ONLY',
+    MONTH_ONLY = 'MONTH_ONLY',
+    DAY_ONLY = 'DAY_ONLY',
+    HOUR_ONLY = 'HOUR_ONLY',
+    MINUTE_ONLY = 'MINUTE_ONLY',
+    SECOND_ONLY = 'SECOND_ONLY'
+}

package/src/column_format/constants/SHELF_TYPE.ts

@@ -0,0 +1,7 @@
+export enum SHELF_TYPE {
+    CATEGORY = 'category',
+    VALUE = 'value',
+    GROUPS = 'groups',
+    COLUMNS = 'columns',
+    SERIES = 'series'
+}

package/src/column_format/constants/STRING_FORMAT.ts

@@ -0,0 +1,3 @@
+export enum STRING_FORMAT {
+    NONE = 'none'
+}

package/src/column_format/constants/TABLE_TYPE.ts

@@ -0,0 +1,5 @@
+export enum TABLE_TYPE {
+    SIMPLE = 'simple',
+    GROUPED = 'grouped',
+    EXPANDABLE = 'expandable'
+}

package/src/column_format/constants/index.ts

@@ -0,0 +1,6 @@
+export * from './CHART_GROUP';
+export * from './DATEGROUP_UNSUPPORT_FORMAT';
+export * from './DATEGROUP_WITHOUT_FORMAT';
+export * from './SHELF_TYPE';
+export * from './STRING_FORMAT';
+export * from './TABLE_TYPE';

package/src/column_format/helpers/columnTypeByChart.ts

@@ -0,0 +1,27 @@
+import { NUMERICAL_COLUMN, NUMERICAL_COLUMNS } from "../..";
+import { COLUMN } from "../../columns";
+import { CHART_GROUPS } from "../constants/CHART_GROUP";
+import { SHELF_TYPE } from "../constants/SHELF_TYPE";
+import { IChartColumn } from "../interfaces/IChartColumn";
+import { IChartGroupType } from "../interfaces/IChartGroupType";
+import { IChartShelfType } from "../interfaces/IChartShelfType";
+import { parseFormulaTypeByCharts } from "./parseFormulaTypeByCharts";
+
+/**
+ * It returns the column type for a given column, shelf type, chart group, and whether the table is
+ * grouped or not
+ * @param {IChartColumn} column - IChartColumn
+ * @param {IChartShelfType} shelfType - IChartShelfType
+ * @param {IChartGroupType} chartGroup - IChartGroupType
+ * @param {boolean} [isGroupedTable] - boolean - this is a boolean that is true if the table is
+ * grouped.
+ * @returns The column type of the column.
+ */
+export const columnTypeByChart = (column: IChartColumn, shelfType: IChartShelfType, chartGroup: IChartGroupType, isGroupedTable?: boolean) => {
+    if (!column) return;
+    const currentType = column.type === COLUMN.FORMULA ? parseFormulaTypeByCharts(column.formulaType) : column.type;
+    const isNumericalColumn = NUMERICAL_COLUMNS.some(colType => colType === currentType)
+     || ((chartGroup === CHART_GROUPS.TABLES) && (isGroupedTable === true) && (shelfType === SHELF_TYPE.COLUMNS))
+      || ((chartGroup === CHART_GROUPS.XY) && (shelfType === SHELF_TYPE.VALUE || shelfType === SHELF_TYPE.SERIES));
+    return isNumericalColumn === true ? NUMERICAL_COLUMN.NUMERIC : currentType;
+};

package/src/column_format/helpers/defineFormatV2.ts

@@ -0,0 +1,17 @@
+import { IChartColumn } from "../interfaces/IChartColumn";
+import { IColumnFormatReturnType } from "../interfaces/IColumnFormatReturnType";
+import { IColumnFormatSettings } from "../interfaces/IColumnFormatSettings";
+import { defineTableChartFormat } from "./defineTableChartFormat";
+import { defineXYChartFormat } from "./defineXYChartFormat";
+
+/**
+ * > If the chart is a table chart, then define the format for a table chart, otherwise define the
+ * format for an XY chart
+ * @param {IChartColumn} column - IChartColumn - this is the column object that is passed to the chart.
+ * @param {IColumnFormatSettings} settings - IColumnFormatSettings
+ * @returns IColumnFormatReturnType
+ */
+export const defineFormatV2 = (column: IChartColumn, settings: IColumnFormatSettings) : IColumnFormatReturnType => {
+    const { isTableChart, isXYChart } = settings;
+    return isTableChart && !isXYChart ? defineTableChartFormat(column, settings) : defineXYChartFormat(column, settings);
+};

package/src/column_format/helpers/defineTableChartFormat.ts

@@ -0,0 +1,70 @@
+import { AGGREGATE, COLUMN, isEmpty } from "../..";
+import { CHART_GROUPS } from "../constants/CHART_GROUP";
+import { DATEGROUP_UNSUPPORT_FORMAT } from "../constants/DATEGROUP_UNSUPPORT_FORMAT";
+import { STRING_FORMAT } from "../constants/STRING_FORMAT";
+import { TABLE_TYPE } from "../constants/TABLE_TYPE";
+import { IChartColumn } from "../interfaces/IChartColumn";
+import { IColumnFormatReturnType } from "../interfaces/IColumnFormatReturnType";
+import { IColumnFormatSettings } from "../interfaces/IColumnFormatSettings";
+import { columnTypeByChart } from "./columnTypeByChart";
+
+/**
+ * It returns the format of a column based on the column type, the chart type, and the chart settings
+ * @param {IChartColumn} column - IChartColumn
+ * @param {IColumnFormatSettings} settings - IColumnFormatSettings
+ */
+export const defineTableChartFormat = (column: IChartColumn, settings: IColumnFormatSettings) : IColumnFormatReturnType => {
+    const { aggregate, type, defaultFormat, outputFormat, selectedFormat, dateGroup } = column;
+    const { tableType, shelfType } = settings;
+    //Defaults
+    const defaultText = 'Default';
+    const defaultNumeric = { type: 'NUMERIC', format: 'Numeric' };
+    const defaultAbb = { type: 'NUMERIC', format: 'Abbreviated' };
+
+    const isGroupedTable = tableType === TABLE_TYPE.GROUPED;
+    const columnType = columnTypeByChart(column, shelfType, CHART_GROUPS.TABLES, isGroupedTable);
+
+    const noFormatSupported = DATEGROUP_UNSUPPORT_FORMAT.some(gp => gp === dateGroup?.label);
+    const hasDefaultFormat = isEmpty(selectedFormat) && outputFormat?.format === defaultText;
+    const isUsedAsNumericColumn = type !== columnType;
+
+
+    switch(columnType) {
+        case COLUMN.YES_NO:
+        case COLUMN.PHONE:
+        case COLUMN.SINGLE_CHOICE:
+        case COLUMN.LONGTEXT:
+        case COLUMN.DROPDOWN:
+        case COLUMN.EXPRESSION:
+        case COLUMN.NAME:
+        case COLUMN.EMAIL_FORM:
+        case COLUMN.IMAGE:
+        case COLUMN.TEXT_LABEL:
+            return STRING_FORMAT.NONE;
+        case COLUMN.DATE: {
+            if(noFormatSupported) {
+                return STRING_FORMAT.NONE;
+            }
+            else if(hasDefaultFormat) {
+                return { ...defaultFormat, format: defaultText, originalFormat: { ...column.outputFormat } };
+            }
+            else {
+                return selectedFormat;
+            }
+        }
+        case COLUMN.NUMERIC:
+        case COLUMN.RATING:
+        case COLUMN.SLIDEBAR: {
+            if(isUsedAsNumericColumn) {
+                if(aggregate?.label === AGGREGATE.COUNT && hasDefaultFormat) return defaultNumeric;
+                else if(hasDefaultFormat) return defaultAbb;
+                else return outputFormat;
+            } else {
+                if(hasDefaultFormat) {
+                    return { ...defaultFormat, format: defaultText, originalFormat: { ...column.outputFormat } };
+                }
+                else return selectedFormat;
+            }
+        }
+    }
+};

package/src/column_format/helpers/defineXYChartFormat.ts

@@ -0,0 +1,80 @@
+import { AGGREGATE, COLUMN, isEmpty } from "../..";
+import { CHART_GROUPS } from "../constants/CHART_GROUP";
+import { DATEGROUP_UNSUPPORT_FORMAT } from "../constants/DATEGROUP_UNSUPPORT_FORMAT";
+import { STRING_FORMAT } from "../constants/STRING_FORMAT";
+import { IChartColumn } from "../interfaces/IChartColumn";
+import { IColumnFormatReturnType } from "../interfaces/IColumnFormatReturnType";
+import { IColumnFormatSettings } from "../interfaces/IColumnFormatSettings";
+import { columnTypeByChart } from "./columnTypeByChart";
+
+/**
+ * > It returns the format of a column based on the column's type, the chart's type, and the column's
+ * aggregate
+ * > Also, if the settings contains the prop withoutFormat as true, returns the default format
+ * @param {IChartColumn} column - IChartColumn
+ * @param {IColumnFormatSettings} settings - IColumnFormatSettings
+ */
+export const defineXYChartFormat = (column: IChartColumn, settings: IColumnFormatSettings) : IColumnFormatReturnType => {
+    const { aggregate, type, defaultFormat, outputFormat, selectedFormat, dateGroup } = column;
+    const { shelfType, withoutFormat } = settings;
+    const columnDefaultFormat = defaultFormat || outputFormat;
+
+    //Defaults
+    const defaultText = 'Default';
+    //const defaultNumeric = { type: 'NUMERIC', format: 'Numeric' };
+    const defaultAbb = { type: 'NUMERIC', format: 'Abbreviated' };
+
+    const columnType = columnTypeByChart(column, shelfType, CHART_GROUPS.XY);
+
+    const noFormatSupported = DATEGROUP_UNSUPPORT_FORMAT.some(gp => gp === dateGroup?.label);
+    const isUsedAsNumericColumn = type !== columnType;
+    const hasDefaultFormat = isEmpty(selectedFormat) || (outputFormat?.format === defaultText) || (selectedFormat?.format === defaultText);
+
+
+    switch(columnType) {
+        case COLUMN.YES_NO:
+        case COLUMN.PHONE:
+        case COLUMN.SINGLE_CHOICE:
+        case COLUMN.LONGTEXT:
+        case COLUMN.DROPDOWN:
+        case COLUMN.EXPRESSION:
+        case COLUMN.NAME:
+        case COLUMN.EMAIL_FORM:
+        case COLUMN.IMAGE:
+        case COLUMN.TEXT_LABEL:
+            return STRING_FORMAT.NONE;
+        case COLUMN.DATE: {
+            if(noFormatSupported) {
+                return STRING_FORMAT.NONE;
+            }
+            else if(hasDefaultFormat) {
+                return { ...columnDefaultFormat, format: defaultText, originalFormat: { ...outputFormat } };
+            }
+            else {
+                return selectedFormat;
+            }
+        }
+        case COLUMN.NUMERIC:
+        case COLUMN.RATING:
+        case COLUMN.SLIDEBAR: {
+            if(isUsedAsNumericColumn) {
+                if(
+                    (aggregate?.label === AGGREGATE.COUNT && hasDefaultFormat)
+                     || 
+                    (isUsedAsNumericColumn && outputFormat?.type !== COLUMN.NUMERIC)
+                     ||
+                    withoutFormat
+                    ) return defaultAbb;
+                else return outputFormat;
+            } else {
+                if(withoutFormat === true) {
+                    return columnDefaultFormat;
+                }
+                else if(hasDefaultFormat) {
+                    return { ...outputFormat };
+                }
+                else return selectedFormat;
+            }
+        }
+    }
+};

package/src/column_format/helpers/index.ts

@@ -0,0 +1,5 @@
+export * from './columnTypeByChart';
+export * from './defineFormatV2';
+export * from './defineTableChartFormat';
+export * from './defineXYChartFormat';
+export * from './parseFormulaTypeByCharts';

package/src/column_format/helpers/parseFormulaTypeByCharts.ts

@@ -0,0 +1,17 @@
+import { FORMULA, IFormulaType } from "../..";
+
+/**
+ * It takes a string and returns a string
+ * @param {IFormulaType} type - IFormulaType - this is the type of the formula.
+ * @returns The type of the formula.
+ */
+export const parseFormulaTypeByCharts = (type: IFormulaType) => {
+    switch (type) {
+        case FORMULA.NUMBER:
+            return 'NUMERIC';
+        case FORMULA.DATE:
+            return 'DATE';
+        default:
+            return 'TEXT_LABEL';
+    }
+};

package/src/column_format/index.ts

@@ -0,0 +1,3 @@
+export * from './constants/index';
+export * from './helpers/index';
+export * from './interfaces/index';

package/src/column_format/interfaces/IChartColumn.ts

@@ -0,0 +1,24 @@
+import { IColumnSortingSettings, IColumnType, IFormatOutputFormat, IFormulaType } from "../..";
+import { IColumnAggregate } from "../../columns/interfaces/IColumnAggregate";
+import { IColumnDateGroupSettings } from "../../columns/interfaces/IColumnDateGroupSettings";
+import { IColumnScale } from "../../columns/interfaces/IColumnScale";
+import { IFormatDefaultFormat } from "../../interfaces/format/IFormatDefaultFormat";
+
+export interface IChartColumn {
+    aggregate: IColumnAggregate;
+    colIndex: number;
+    dateGroup?: IColumnDateGroupSettings;
+    defaultFormat: IFormatDefaultFormat;
+    format?: string;
+    formulaType?: IFormulaType;
+    groupAgg: string;
+    id: string;
+    isGroup: string;
+    outputFormat: IFormatOutputFormat;
+    property: string;
+    scaleType?: IColumnScale;
+    selectedFormat?: IFormatDefaultFormat;
+    sorting?: IColumnSortingSettings;
+    text: string;
+    type: IColumnType;
+}

package/src/column_format/interfaces/IChartGroupType.ts

@@ -0,0 +1,3 @@
+import { CHART_GROUPS } from "../constants/CHART_GROUP";
+
+export type IChartGroupType = CHART_GROUPS;

package/src/column_format/interfaces/IChartShelfType.ts

@@ -0,0 +1,3 @@
+import { SHELF_TYPE } from "../constants/SHELF_TYPE";
+
+export type IChartShelfType = SHELF_TYPE;

package/src/column_format/interfaces/IChartTableType.ts

@@ -0,0 +1,3 @@
+import { TABLE_TYPE } from "../constants/TABLE_TYPE";
+
+export type IChartTableType = TABLE_TYPE;

package/src/column_format/interfaces/IColumnFormatReturnType.ts

@@ -0,0 +1,4 @@
+import { IFormatOutputFormat } from "../..";
+import { IFormatStringType } from "./IFormatStringType";
+
+export type  IColumnFormatReturnType = IFormatStringType | IFormatOutputFormat;

package/src/column_format/interfaces/IColumnFormatSettings.ts

@@ -0,0 +1,11 @@
+import { IChartShelfType } from "./IChartShelfType";
+import { IChartTableType } from "./IChartTableType";
+
+/* Defining an interface for the column format settings. */
+export interface IColumnFormatSettings {
+    tableType?: IChartTableType;
+    isTableChart?: boolean;
+    isXYChart?: boolean;
+    shelfType: IChartShelfType;
+    withoutFormat: boolean;
+}

package/src/column_format/interfaces/IFormatStringType.ts

@@ -0,0 +1,3 @@
+import { STRING_FORMAT } from "../constants/STRING_FORMAT";
+
+export type IFormatStringType = STRING_FORMAT;

package/src/column_format/interfaces/index.ts

@@ -0,0 +1,7 @@
+export * from './IChartColumn';
+export * from './IChartGroupType';
+export * from './IChartShelfType';
+export * from './IChartTableType';
+export * from './IColumnFormatReturnType';
+export * from './IColumnFormatSettings';
+export * from './IFormatStringType';

package/src/columns/interfaces/IColumnAggregate.ts

@@ -0,0 +1,7 @@
+export interface IColumnAggregate {
+    abbreviation: string;
+    id: string;
+    key: string;
+    label: string;
+    text: string;
+}

package/src/columns/interfaces/IColumnDateGroupSettings.ts

@@ -0,0 +1,7 @@
+export interface IColumnDateGroupSettings {
+    default: boolean;
+    format: string;
+    label: string;
+    secondatyText: string;
+    text: string;
+}

package/src/columns/interfaces/IColumnScale.ts

@@ -0,0 +1,5 @@
+export interface IColumnScale {
+    key: string;
+    text: string;
+    value: string;
+}

package/src/dates/adapters/dateToHms.ts

@@ -0,0 +1,15 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { padLeadingZeros } from "../../general/string/padLeadingZeros";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+
+/**
+ * * Transform a Date to [HH:mm:ss] date format.
+ * @param date String, object or millisencond number of the date
+ * @returns string of [HH:mm:ss] date format
+ */
+ export function dateToHms(date: string | Date | number) {
+    if (isEmpty(date) || isTokenLabel(date as any)) return date as any;
+
+    const dt = new Date(date.valueOf());
+    return padLeadingZeros(dt.getHours(), 2).slice(-2) + ':' + padLeadingZeros(dt.getMinutes(), 2).slice(-2) + ':' + padLeadingZeros(dt.getSeconds(), 2).slice(-2);
+}

package/src/dates/adapters/dateToMdyDate.ts

@@ -0,0 +1,16 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { padLeadingZeros } from "../../general/string/padLeadingZeros";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { dateToHms } from "./dateToHms";
+
+/**
+ * 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 function dateToMdyDate(date: string | Date | number, includeTime?: boolean): string{
+    if (isEmpty(date) || isTokenLabel(date as any)) return date as any;
+
+    const dt = new Date(date.valueOf());
+    return padLeadingZeros(dt.getMonth() + 1, 2).slice(-2) + '/' + padLeadingZeros(dt.getDate(), 2).slice(-2) + '/' + padLeadingZeros(dt.getFullYear(), 4) + (includeTime ? ' ' + dateToHms(date) : '');
+}

package/src/dates/adapters/dateToMonthYear.ts

@@ -0,0 +1,15 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_YEAR_MONTHS } from "../constants/DATE_YEAR_MONTHS";
+
+/**
+ * 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 function dateToMonthYear(date: string | Date | number): string {
+    if (isEmpty(date) || isTokenLabel(date as any)) return date as any;
+
+    const dt = new Date(date.valueOf());
+    return DATE_YEAR_MONTHS[dt.getMonth()] + ' ' + dt.getFullYear();
+}

package/src/dates/adapters/dateToQuarterYear.ts

@@ -0,0 +1,16 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_YEAR_QUARTERS } from "../constants/DATE_YEAR_QUARTERS";
+
+/**
+ * Transform a Date to [Quarter Year] date format.
+ * @param date String, object or millisencond number of the date
+ * @returns string of [Quarter Year] date format
+ */
+ export function dateToQuarterYear(date: string | Date | number): string {
+    if (isEmpty(date) || isTokenLabel(date as any)) return date as any;
+
+    const dt = new Date(date.valueOf());
+    const quarter = Math.ceil((dt.getMonth() + 1) / 3);
+    return DATE_YEAR_QUARTERS[quarter - 1] + ' ' + dt.getFullYear();
+}

package/src/dates/adapters/dateToWeekYear.ts

@@ -0,0 +1,16 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { getWeek } from "../helpers/getWeek";
+
+/**
+ * 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 function dateToWeekYear(date: string | Date | number): string {
+    if (isEmpty(date) || isTokenLabel(date as any)) return date as any;
+
+    const dt = new Date(date.valueOf());
+    const weekObj = getWeek(dt);
+    return `W${weekObj.week} ${weekObj.year}`;
+}

package/src/dates/adapters/dateToYear.ts

@@ -0,0 +1,14 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+
+/**
+ * Transform a Date to [Year] date format.
+ * @param date String, object or millisencond number of the date
+ * @returns string of [Year] date format
+ */
+ export function dateToYear(date: string | Date | number): string {
+    if (isEmpty(date) || isTokenLabel(date as any)) return date as any;
+
+    const dt = new Date(date.valueOf());
+    return String(dt.getFullYear());
+}