@sankhyalabs/core 0.0.0-hotfix-ga-KB-4098

package/dist/utils/CriteriaModel.js

@@ -0,0 +1,172 @@
+/**
+ * `CriteriaParameter`: Utilizado para validar e manipular os critérios da requisição.
+ *
+ */
+export class Criteria {
+    //Constructor
+    //================================================================
+    constructor(exp, params) {
+        //Internal Properties
+        //================================================================
+        this._expression = undefined;
+        this._parameters = [];
+        //Methods
+        //================================================================
+        /**
+         * @ngdoc
+         * @name sankhyalabs.core.src:Criteria#getSize
+         * @methodOf sankhyalabs.core.src:Criteria
+         * @description Método que retorna o Número de caracteres da expressão da classe Criteria.
+         * @returns {number} Número de caracteres da expressão da classe Criteria.
+         */
+        this.getSize = () => {
+            return this._expression === undefined ? 0 : this._expression.length;
+        };
+        /**
+         * @ngdoc
+         * @name sankhyalabs.core.src:Criteria#or
+         * @methodOf sankhyalabs.core.src:Criteria
+         * @description Concatena a expressão ' OR ' ao critério.
+         * @param {Criteria | string} [exp] Expressão a ser concatenada
+         * @param {Array<CriteriaParameter>} [param] Parâmetros a serem concatenados.
+         * @returns {Criteria} Retorna a própria instância do Criterio para encadeamento.
+         */
+        this.or = (exp, param) => {
+            if (this.getSize() > 0) {
+                this.append(' OR ');
+            }
+            this.append(exp, param);
+            return this;
+        };
+        /**
+         * @ngdoc
+         * @name sankhyalabs.core.src:Criteria#and
+         * @methodOf sankhyalabs.core.src:Criteria
+         * @description Concatena a expressão ' AND ' ao critério.
+         * @param {Criteria | string} [exp] Expressão a ser concatenada
+         * @param {Array<CriteriaParameter>} [param] Parâmetros a serem concatenados.
+         * @returns {Criteria} Retorna a própria instância do Criterio para encadeamento.
+         */
+        this.and = (exp, param) => {
+            if (this.getSize() > 0) {
+                this.append(' AND ');
+            }
+            this.append(exp, param);
+            return this;
+        };
+        /**
+         * @ngdoc
+         * @name sankhyalabs.core.src:Criteria#toJSON
+         * @methodOf sankhyalabs.core.src:Criteria
+         * @description Retorna um JSON que representa o objeto Criteria.
+         * @returns {Object} Retorna um JSON que representa o objeto Criteria.
+         */
+        this.toJSON = () => {
+            const parametersArray = [];
+            this.parameters.map(function (param) {
+                parametersArray.push(param.buildParam());
+            });
+            let result = undefined;
+            if (this.getSize() > 0) {
+                result = {
+                    expression: this.expression,
+                    parameters: parametersArray,
+                };
+            }
+            return result;
+        };
+        this._expression = exp ? exp : undefined;
+        this._parameters = params ? params : [];
+    }
+    //Getters and Setters
+    //================================================================
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:Criteria#parameters
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "parameters". Trata-se de uma Array de parametros da classe Criteria.
+     * @param {Array<CriteriaParameter>} [parameters] Array de parametros da classe Criteria.
+     */
+    set parameters(parameters) {
+        this._parameters = parameters;
+    }
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:Criteria#parameters
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para parameters
+     * @returns {Array<CriteriaParameter>}
+     */
+    get parameters() {
+        return this._parameters;
+    }
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:Criteria#expression
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "expression". Trata-se do expressão da classe Criteria.
+     * @param {string} [expression] Expressão da classe Criteria.
+     */
+    set expression(expression) {
+        this._expression = expression;
+    }
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:Criteria#expression
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para expression
+     * @returns {string} expression em formato string.
+     */
+    get expression() {
+        return this._expression;
+    }
+    /**
+    * @ngdoc
+    * @name sankhyalabs.core.src:Criteria#append
+    * @methodOf sankhyalabs.core.src:Criteria
+    * @description Concatena uma expressão e parâmetros ao critério.
+    * @param {string} [exp=undefined] Expressão a ser concatenada
+    * @param {array} [param=undefined] Parâmetros a serem concatenados.
+    * @returns {Criteria} Retorna a própria instância do Criterio para encadeamento.
+    */
+    append(exp, param) {
+        if (exp instanceof Criteria) {
+            if (exp.getSize() > 0) {
+                param = exp.parameters;
+                exp = '(' + exp.expression + ')';
+            }
+            else {
+                return this;
+            }
+        }
+        if (this.expression === undefined) {
+            this.expression = exp;
+        }
+        else {
+            this.expression += exp;
+        }
+        if (param) {
+            this.addParameter(param);
+        }
+        return this;
+    }
+    /**
+     * @ngdoc
+     * @name sankhyalabs.core.src:Criteria#addParameter
+     * @methodOf sankhyalabs.core.src:Criteria
+     * @description Concatena parâmetros ao critério.
+     *  - Se passado um array, o metodo iterará no array e adicionará cada um dos itens.
+     *  - É possível passar um Objeto CriteriaParameter, um número, string ou uma instancia de data, eles serão inferidos para o tipo certo.
+     * @param {CriteriaParameter} Parâmetro a ser adicionado.
+     */
+    addParameter(param) {
+        for (const index in param) {
+            this.parameters.push(param[index]);
+        }
+    }
+}
+//# sourceMappingURL=CriteriaModel.js.map

package/dist/utils/CriteriaModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CriteriaModel.js","sourceRoot":"","sources":["../../src/utils/CriteriaModel.ts"],"names":[],"mappings":"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"}

package/dist/utils/CriteriaParameter.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Possible values of CriteriaType
+ */
+export declare enum CriteriaType {
+    TYPE_STRING = "S",
+    TYPE_DATE = "D",
+    TYPE_NUMBER = "N"
+}
+/**
+ * Interface: return of method "buildParam" of CriteriaParameter class
+ */
+export interface InputCriteria {
+    type: CriteriaType;
+    value: any;
+}
+/**
+ * CriteriaParameter:
+ */
+export declare class CriteriaParameter {
+    private _type;
+    private _value;
+    constructor(type: CriteriaType, value: any);
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#value
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "value". Trata-se do valor do Parâmetro.
+     * @param {any} [value] Valor do Parâmetro.
+     * @returns {void}
+     */
+    set value(value: any);
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#value
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para "value". Trata-se do valor do Parâmetro.
+     * @returns {any} Retorna valor do Parâmetro da classe Criteria
+     */
+    get value(): any;
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#type
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "type". Trata-se do tipo do valor do Parâmetro.
+     * @param {CriteriaType} [type] Tipo do valor do Parâmetro.
+     * @returns {void}
+     */
+    set type(type: CriteriaType);
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#type
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para "type". Trata-se do valor do Parâmetro.
+     * @returns {CriteriaType} Retorna o tipo do Parâmetro da classe Criteria
+     */
+    get type(): CriteriaType;
+    /**
+     * @sankhyalabscore
+     * @name sankhyalabs.core.src:CriteriaParameter#buildParam
+     * @methodOf sankhyalabscore src.utils.CriteriaParameter
+     * @description Cria um JSON/Objeto de acordo com as propriedades internas "value" e "type" da classe CriteriaParameter
+     * @returns {InputCriteria} Retorna JSON/Objeto no formato InputCriteria.
+     */
+    buildParam: () => InputCriteria;
+}

package/dist/utils/CriteriaParameter.js

@@ -0,0 +1,83 @@
+/**
+ * Possible values of CriteriaType
+ */
+export var CriteriaType;
+(function (CriteriaType) {
+    CriteriaType["TYPE_STRING"] = "S";
+    CriteriaType["TYPE_DATE"] = "D";
+    CriteriaType["TYPE_NUMBER"] = "N";
+})(CriteriaType || (CriteriaType = {}));
+/**
+ * CriteriaParameter:
+ */
+export class CriteriaParameter {
+    //Constructor
+    //================================================================
+    constructor(type, value) {
+        /**
+         * @sankhyalabscore
+         * @name sankhyalabs.core.src:CriteriaParameter#buildParam
+         * @methodOf sankhyalabscore src.utils.CriteriaParameter
+         * @description Cria um JSON/Objeto de acordo com as propriedades internas "value" e "type" da classe CriteriaParameter
+         * @returns {InputCriteria} Retorna JSON/Objeto no formato InputCriteria.
+         */
+        this.buildParam = () => {
+            const paramObj = {
+                type: this._type,
+                value: this._value,
+            };
+            return paramObj;
+        };
+        this._type = type;
+        this._value = value;
+    }
+    //Getters and Setters
+    //================================================================
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#value
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "value". Trata-se do valor do Parâmetro.
+     * @param {any} [value] Valor do Parâmetro.
+     * @returns {void}
+     */
+    set value(value) {
+        this._value = value;
+    }
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#value
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para "value". Trata-se do valor do Parâmetro.
+     * @returns {any} Retorna valor do Parâmetro da classe Criteria
+     */
+    get value() {
+        return this._value;
+    }
+    /**
+     * @ngdoc
+     * @Getter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#type
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Setter para "type". Trata-se do tipo do valor do Parâmetro.
+     * @param {CriteriaType} [type] Tipo do valor do Parâmetro.
+     * @returns {void}
+     */
+    set type(type) {
+        this._type = type;
+    }
+    /**
+     * @ngdoc
+     * @Setter_______________
+     * @name sankhyalabs.core.src:CriteriaParameter#type
+     * @methodOf sankhyalabs.core.src:CriteriaProvider
+     * @description Getter para "type". Trata-se do valor do Parâmetro.
+     * @returns {CriteriaType} Retorna o tipo do Parâmetro da classe Criteria
+     */
+    get type() {
+        return this._type;
+    }
+}
+//# sourceMappingURL=CriteriaParameter.js.map

package/dist/utils/CriteriaParameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CriteriaParameter.js","sourceRoot":"","sources":["../../src/utils/CriteriaParameter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,iCAAiB,CAAA;AACrB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAYD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAQ1B,aAAa;IACb,kEAAkE;IAClE,YAAY,IAAkB,EAAE,KAAU;QA4D1C;;;;;;WAMG;QACI,eAAU,GAAG,GAAkB,EAAE;YACpC,MAAM,QAAQ,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,KAAK;gBAChB,KAAK,EAAE,IAAI,CAAC,MAAM;aACrB,CAAA;YACD,OAAO,QAAQ,CAAC;QACpB,CAAC,CAAA;QAxEG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,qBAAqB;IACrB,kEAAkE;IAElE;;;;;;;;OAQG;IACH,IAAW,KAAK,CAAC,KAAU;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;;;;;;OAOG;IACH,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAGD;;;;;;;;OAQG;IACH,IAAW,IAAI,CAAC,IAAkB;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CAkBJ"}

package/dist/utils/DateUtils.d.ts

@@ -0,0 +1,97 @@
+/**
+ * `DateUtils`: Utilizado para formatação, padronização e cálculos de datas.
+ */
+export default class DateUtils {
+    /**
+    * Zerar o horário de uma data.
+    *
+    * @param date - Data a ser manipulada.
+    * @param adjustDayLightSavingTime - Ajusta horário de verão na data recebida.
+    * @returns - Data sem as informações de horário.
+    * @example
+    * Informo: 2023-03-09 12:42:40      | Obtenho: 2023-03-09 00:00:00
+    */
+    static clearTime(date: Date, adjustDayLightSavingTime?: boolean): Date;
+    /**
+     * Converte data para uma string no formato pt-BR.
+     *
+     * @param date - Data a ser convertida.
+     * @param options - Opções de formatação da data.
+     * @returns - Uma string com a data no formato pt-BR DD/MM/YYYY.
+     */
+    static formatDate(date: Date, options?: Intl.DateTimeFormatOptions): string;
+    /**
+     * Converte as horas de uma data para uma string pt-BR.
+     *
+     * @param date - Data a ser convertida.
+     * @param showSeconds - define se devemos considerar os segundos.
+     * @returns - Uma string com as horas no formato HH:MM ou HH:MM:SS.
+     */
+    static formatTime(date: Date, showSeconds?: boolean): string;
+    /**
+     * Converte a data e hora para uma string no formato pt-BR.
+     *
+     * @param date - Data a ser convertida.
+     * @param showSeconds - define se devemos considerar os segundos.
+     * @returns - Uma string com as horas no formato DD/MM/YYYY HH:MM ou DD/MM/YYYY HH:MM:SS.
+     */
+    static formatDateTime(date: Date, showSeconds?: boolean): string;
+    /**
+     * Converte String para Date.
+     *
+     * @param strValue - Texto a ser convertido para data.
+     * @param adjustDayLightSavingTime - Se verdadeiro, ativa regra de horário de verão.
+     * @param monthYearMode - Quando ativado, retorna o primeiro dia do mês apenas para construir a data.
+     * @returns - Data sem as informações de horário.
+     */
+    static strToDate(strValue: string, adjustDayLightSavingTime?: boolean, monthYearMode?: boolean): Date | undefined;
+    /**
+     * Obtém a data atual.
+     *
+     * @param withTime - Caso true retorna a data com informações de horário.
+     * @returns - Data atual sem informação de horário.
+     */
+    static getToday(withTime?: boolean): Date;
+    /**
+     * Retorna se a data é válida.
+     *
+     * @param value - Data a ser validada.
+     * @param hasTime - Determina se a data retornada deve conter informação de horário ou não. Por padrão não retorna a hora.
+     * @returns - Caso válida, retorna a própria data.
+     */
+    static validateDate(value: Date, hasTime?: boolean): Date | undefined;
+    /**
+     * Realiza correção do horário de verão.
+     *
+     * @param date - Data a ser ajustada.
+     * @returns - Data informada ajustada para horário de verão.
+     */
+    private static adjustDLST;
+    /**
+     * Adiciona uma casa decimal a esquerda de uma unidade.
+     *
+     * @param n - Número a ser ajustado
+     * @returns - O número informado, com uma casa decimal a esquerda.
+     * @example
+     * Informo: 15     | Obtenho: 15
+     * @example
+     * Informo:  2     | Obtenho: "02"
+     */
+    private static pad;
+    /**
+     * Retorna timezone da data.
+     *
+     * @param offset - Valor do timezone desejado.
+     * @returns Timezone da data.
+     */
+    private static timezoneOffset;
+    /**
+     * Converte a data para o formato RFC3339.
+     *
+     * @param date - Data a ser convertida
+     * @returns - Data informada no formato RFC3339.
+     * * @example
+     * Informo: 2023-03-09 12:42:40     | Obtenho: 2023-03-09T12:42:47-03:00
+     */
+    static formatRfc3339(date: Date): string;
+}

package/dist/utils/DateUtils.js

@@ -0,0 +1,171 @@
+/**
+ * `DateUtils`: Utilizado para formatação, padronização e cálculos de datas.
+ */
+export default class DateUtils {
+    /**
+    * Zerar o horário de uma data.
+    *
+    * @param date - Data a ser manipulada.
+    * @param adjustDayLightSavingTime - Ajusta horário de verão na data recebida.
+    * @returns - Data sem as informações de horário.
+    * @example
+    * Informo: 2023-03-09 12:42:40      | Obtenho: 2023-03-09 00:00:00
+    */
+    static clearTime(date, adjustDayLightSavingTime = true) {
+        const newDate = new Date(date.getFullYear(), date.getMonth(), date.getDate(), 0, 0, 0, 0);
+        return adjustDayLightSavingTime ? DateUtils.adjustDLST(newDate) : newDate;
+    }
+    /**
+     * Converte data para uma string no formato pt-BR.
+     *
+     * @param date - Data a ser convertida.
+     * @param options - Opções de formatação da data.
+     * @returns - Uma string com a data no formato pt-BR DD/MM/YYYY.
+     */
+    static formatDate(date, options) {
+        return date ? new Intl.DateTimeFormat("pt-BR", options !== null && options !== void 0 ? options : {}).format(date) : "";
+    }
+    /**
+     * Converte as horas de uma data para uma string pt-BR.
+     *
+     * @param date - Data a ser convertida.
+     * @param showSeconds - define se devemos considerar os segundos.
+     * @returns - Uma string com as horas no formato HH:MM ou HH:MM:SS.
+     */
+    static formatTime(date, showSeconds = false) {
+        const timeOptions = { hour: "2-digit", minute: "2-digit", second: showSeconds ? "2-digit" : undefined };
+        return new Intl.DateTimeFormat("pt-BR", timeOptions).format(date);
+    }
+    /**
+     * Converte a data e hora para uma string no formato pt-BR.
+     *
+     * @param date - Data a ser convertida.
+     * @param showSeconds - define se devemos considerar os segundos.
+     * @returns - Uma string com as horas no formato DD/MM/YYYY HH:MM ou DD/MM/YYYY HH:MM:SS.
+     */
+    static formatDateTime(date, showSeconds = false) {
+        return `${DateUtils.formatDate(date)} ${DateUtils.formatTime(date, showSeconds)}`;
+    }
+    /**
+     * Converte String para Date.
+     *
+     * @param strValue - Texto a ser convertido para data.
+     * @param adjustDayLightSavingTime - Se verdadeiro, ativa regra de horário de verão.
+     * @param monthYearMode - Quando ativado, retorna o primeiro dia do mês apenas para construir a data.
+     * @returns - Data sem as informações de horário.
+     */
+    static strToDate(strValue, adjustDayLightSavingTime = true, monthYearMode = false) {
+        /** monthYearMode é um booleano para usar o formato MM/YYYY.
+         * Quando ativado, é retornado o primeiro dia do mês apenas para construir a data.
+         * Não há necessidade de verificar o horário de verão quando utilizado esse modo. */
+        let parts;
+        if (monthYearMode) {
+            parts = /^(1[0-2]|0[1-9]|[1-9])[^\d]?(\d{2}|\d{4})(?:\s(\d{1,2}):(\d{1,2}):?(\d{0,2}))?$/.exec(strValue);
+        }
+        else {
+            parts = /^(3[01]|[1-2]\d|0[1-9]|[1-9])[^\d]?(1[0-2]|0[1-9]|[1-9])[^\d]?(\d{2}|\d{4})(?:\s(\d{1,2}):(\d{1,2}):?(\d{0,2}))?$/.exec(strValue);
+        }
+        if (!parts) {
+            return undefined;
+        }
+        const day = monthYearMode ? 1 : Number(parts[1]);
+        const month = Number(parts[(monthYearMode ? 1 : 2)]);
+        let year = Number(parts[(monthYearMode ? 2 : 3)]);
+        const hour = Number(parts[(monthYearMode ? 3 : 4)] || 0);
+        const min = Number(parts[(monthYearMode ? 4 : 5)] || 0);
+        const sec = Number(parts[(monthYearMode ? 5 : 6)] || 0);
+        if (year < 100) {
+            year += year < 30 ? 2000 : 1900;
+        }
+        let date = new Date(year, month - 1, day, hour, min, sec, 0);
+        if (adjustDayLightSavingTime === true && !monthYearMode && hour == 0) {
+            date = DateUtils.adjustDLST(date);
+        }
+        return date;
+    }
+    /**
+     * Obtém a data atual.
+     *
+     * @param withTime - Caso true retorna a data com informações de horário.
+     * @returns - Data atual sem informação de horário.
+     */
+    static getToday(withTime = false) {
+        const today = new Date();
+        if (withTime) {
+            return today;
+        }
+        else {
+            return DateUtils.clearTime(today);
+        }
+    }
+    /**
+     * Retorna se a data é válida.
+     *
+     * @param value - Data a ser validada.
+     * @param hasTime - Determina se a data retornada deve conter informação de horário ou não. Por padrão não retorna a hora.
+     * @returns - Caso válida, retorna a própria data.
+     */
+    static validateDate(value, hasTime = false) {
+        return value instanceof Date && !isNaN(value.valueOf())
+            ? hasTime ? value : DateUtils.clearTime(value)
+            : undefined;
+    }
+    /**
+     * Realiza correção do horário de verão.
+     *
+     * @param date - Data a ser ajustada.
+     * @returns - Data informada ajustada para horário de verão.
+     */
+    static adjustDLST(date) {
+        if (date.getHours() == 23) {
+            return new Date(date.getFullYear(), date.getMonth(), date.getDate() + 1, 1, 0, 0, 0);
+        }
+        return date;
+    }
+    /**
+     * Adiciona uma casa decimal a esquerda de uma unidade.
+     *
+     * @param n - Número a ser ajustado
+     * @returns - O número informado, com uma casa decimal a esquerda.
+     * @example
+     * Informo: 15     | Obtenho: 15
+     * @example
+     * Informo:  2     | Obtenho: "02"
+     */
+    static pad(n) {
+        return n < 10 ? "0" + n : n;
+    }
+    /**
+     * Retorna timezone da data.
+     *
+     * @param offset - Valor do timezone desejado.
+     * @returns Timezone da data.
+     */
+    static timezoneOffset(offset) {
+        let sign;
+        if (offset === 0) {
+            return "Z";
+        }
+        sign = (offset > 0) ? "-" : "+";
+        offset = Math.abs(offset);
+        return sign + this.pad(Math.floor(offset / 60)) + ":" + this.pad(offset % 60);
+    }
+    /**
+     * Converte a data para o formato RFC3339.
+     *
+     * @param date - Data a ser convertida
+     * @returns - Data informada no formato RFC3339.
+     * * @example
+     * Informo: 2023-03-09 12:42:40     | Obtenho: 2023-03-09T12:42:47-03:00
+     */
+    static formatRfc3339(date) {
+        return date.getFullYear() + "-" +
+            this.pad(date.getMonth() + 1) + "-" +
+            this.pad(date.getDate()) + "T" +
+            this.pad(date.getHours()) + ":" +
+            this.pad(date.getMinutes()) + ":" +
+            this.pad(date.getSeconds()) +
+            this.timezoneOffset(date.getTimezoneOffset());
+    }
+}
+//# sourceMappingURL=DateUtils.js.map

package/dist/utils/DateUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateUtils.js","sourceRoot":"","sources":["../../src/utils/DateUtils.ts"],"names":[],"mappings":"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"}