Minha Biblioteca de Utilidades

Esta biblioteca fornece várias funções úteis para formatação e validação de dados, especialmente para o contexto brasileiro. Inclui funções para formatação de datas, CEP, telefones, moedas, CPF, e mais.

Instalação

Você pode instalar a biblioteca via npm:

``bash
npm install malmeida-lib-formatacao

Uso
Importe as funções que você precisa:
import {
formatDateTime,
maskCep,
maskPhone,
maskCurrency,
maskCPF,
maskData,
maskPorc,
converterMoedaParaFloat,
converterFloatParaMoeda,
maskMoeda,
maskAre,
validateCPF,
maskSafra,
verificarFormatoData
} from 'malmeida-lib-formatacao';

Funções Disponíveis
formatDateTime(dateString: string): Date
Converte uma string de data em um objeto Date.

maskCep(value: string): string
Formata uma string como um CEP brasileiro.

maskPhone(value: string): string
Formata uma string como um número de telefone brasileiro.

maskCurrency(value: string): string
Formata uma string como um valor monetário brasileiro.

maskCPF(value: string): string
Formata uma string como um CPF brasileiro.

maskData(value: string): string
Formata uma string como uma data no formato DD/MM/YYYY.

maskPorc(value: string): string
Formata uma string como uma porcentagem.

converterMoedaParaFloat(moeda: string): number
Converte uma string formatada como moeda para um valor float.

converterFloatParaMoeda(valorFloat: number, area: boolean): string
Converte um valor float para uma string formatada como moeda brasileira.

maskMoeda(value: string): string
Formata uma string como um valor monetário brasileiro usando a biblioteca Intl.

maskAre(value: string): string
Formata uma string como uma área com quatro casas decimais.

validateCPF(cpf: string): boolean
Valida se um CPF brasileiro é válido.

maskSafra(value: string): string
Formata uma string como uma safra no formato YYYY/YYYY.

verificarFormatoData(data: string): boolean
Verifica se uma string está no formato de data DD/MM/YYYY ou é uma string vazia.

Exemplo de Uso
const cpf = "12345678909";
console.log(maskCPF(cpf)); // Saída: 123.456.789-09
console.log(validateCPF(cpf)); // Saída: true ou false

const cep = "12345678";
console.log(maskCep(cep)); // Saída: 12345-678

const phone = "11987654321";
console.log(maskPhone(phone)); // Saída: (11)98765-4321

const data = "01012020";
console.log(maskData(data)); // Saída: 01/01/2020

const moeda = "123456";
console.log(maskMoeda(moeda)); // Saída: R$ 1.234,56

const safra = "20232024";
console.log(maskSafra(safra)); // Saída: 2023/2024

import { verificarFormatoData } from 'minha-biblioteca-de-utilidades';

const dataValida = "01/01/2020";
console.log(verificarFormatoData(dataValida)); // Saída: true

const dataInvalida = "2020-01-01";
console.log(verificarFormatoData(dataInvalida)); // Saída: false

const dataVazia = "";
console.log(verificarFormatoData(dataVazia)); // Saída: true


Contribuição
Sinta-se à vontade para contribuir com melhorias e novas funcionalidades. Faça um fork deste repositório e envie um pull request com suas alterações.

Licença
Esta biblioteca é distribuída sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.


Adapte conforme necessário para refletir corretamente o nome da sua biblioteca e outros detalhes específicos.
``