malmeida-lib-formatacao
v0.1.4
Published
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.
Downloads
6
Readme
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:
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.