ui-marilha

README - Utilizando React.js

Introdução

Este repositório contém utilitários em JavaScript para formatação de dados comumente utilizados em aplicações React.js. Os scripts fornecem funções para formatar data, CEP, telefone, moeda, CPF, CNPJ, entre outros.

Como Utilizar Instalação Para utilizar os utilitários em seu projeto React.js, siga os passos abaixo:

1-Intalar bibliotéca: npm i ui-markilha

2- Importe os scripts necessários em seus componentes: import {dataAtual,maskCep,maskPhone,maskCurrency,maskCPF,maskData,convertString,converterMoedaParaFloat,converterFloatParaMoeda} from "ui-markilha";

3 - Utilize as funções conforme necessário em seus componentes React.

Exemplos de Uso

Formatação de Data Atual

const dataFormatada = dataAtual(); console.log(dataFormatada); // Saída: "31/01/2024"

Máscara para CEP

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

Máscara para Telefone

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

Máscara para Moeda

const valorFormatado = maskCurrency('12345.67'); console.log(valorFormatado); // Saída: "12.345,67"

Máscara para CPF

const cpfFormatado = maskCPF('12345678901'); console.log(cpfFormatado); // Saída: "123.456.789-01"

Máscara para Data

const dataFormatada = maskData('31122024'); console.log(dataFormatada); // Saída: "31/12/2024"

Conversão para String

const valorConvertido = convertString(12345); console.log(valorConvertido); // Saída: "12345"

Conversão de Moeda para Float

const valorFloat = converterMoedaParaFloat('12.345,67'); console.log(valorFloat); // Saída: 12345.67

Conversão de Float para Moeda

const valorMoeda = converterFloatParaMoeda(12345.67, false); console.log(valorMoeda); // Saída: "12.345,67"

Adição de Zeros à Esquerda

const numeroFormatado = adicionarZerosEsquerda(42, 5); console.log(numeroFormatado); // Saída: "00042"

Formatação de Data para o Padrão BR

const dataFormatada = formatDataBR('2024-01-31'); console.log(dataFormatada); // Saída: "31/01/2024"

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para enviar pull requests para melhorar ou adicionar novas funcionalidades aos utilitários.

Licença

Este projeto está licenciado sob a MIT License - veja o arquivo LICENSE.md para mais detalhes.