@gmikami/utils

Pacote de utilitários genéricos para Node, React e React Native, com funções de datas, imagens, moeda e strings.

Funções de data

Baseadas em date-fns, com suporte a pt-BR.

formatFullDate(date: string | Date): string

Formata a data completa em pt-BR.
Exemplo: "21 de setembro de 2025"

formatDate(date: string | Date, mask: string = "dd/MM/yyyy"): string

Formata a data de acordo com a máscara fornecida.
Exemplo: "2025-09-21" ou "21/09/2025"

formatDateTime(date: string | Date): string

Formata data e hora, exemplo: "21/09/2025 14:30:00"

generateMonthCarousel(centerDate: Date, range: number = 5): string[]

Gera um array de meses em torno de uma data central.
Exemplo: ["2025-07","2025-08","2025-09","2025-10","2025-11"]

Re-exports

• addMonths(date, amount)
• startOfMonth(date)

Funções de imagem

getCroppedImg(imageSrc, pixelCrop, size)

Corta uma imagem em formato circular e retorna base64 JPEG.

Parâmetros

• imageSrc: string → URL ou base64 da imagem original
• pixelCrop: { x: number; y: number; width: number; height: number } → área de corte
• size?: number → tamanho final da imagem quadrada (default: 160px)

Retorno

• Promise<string> → imagem recortada em base64 JPEG

Funções de moeda

formatCurrency(value: number): string

Formata um número como moeda brasileira incluindo o símbolo R$.
Exemplo: "R$ 1.234,56"

formatCurrencyValueOnly(value: number): string

Formata um número como moeda brasileira sem o símbolo R$.
Exemplo: "1.234,56"

Instalação

yarn add @gmikami/utils
# ou
npm install @gmikami/utils