formatDate / timestampToTime

Formata uma data com um padrão de tokens.

API

formatDate(value?, pattern?)

Parâmetro	Descrição	Tipo	Padrão
value	Carimbo de tempo, string de data ou Date; omita para o momento atual	number | string | Date	agora
pattern	Padrão de tokens	string	'YYYY-MM-DD HH:mm:ss'

Token	Significado	Token	Significado
YYYY/YY	Ano	mm/m	Minuto
MM/M	Mês (1–12)	ss/s	Segundo
DD/D	Dia	SSS	Milissegundos
HH/H	Hora (0–23)	A/a	AM/PM · am/pm
hh/h	Hora (1–12)	[...]	Texto literal

Devolve 'Invalid Date' quando a entrada não pode ser interpretada.

timestampToTime(timestamp?)

Obsoleto. Devolve um Date com um método format pendurado na instância.

Exemplo

import { formatDate } from 'ranuts';

formatDate(); // '2026-07-25 14:30:00'
formatDate(1753425000000, 'YYYY/MM/DD'); // '2026/07/25'
formatDate(new Date(), 'YYYY[年]MM[月]DD[日] hh:mm a');
formatDate('not a date'); // 'Invalid Date'

Notas

1. Maiúsculas contam. MM é o mês e mm é o minuto; HH é de 24 horas e hh de 12.
2. O padrão é substituído em uma única passada, então um valor recém-escrito nunca é capturado de novo por um token posterior.
3. Ponha o texto literal entre [] para tirar suas letras da substituição.

Corrigido e substituído na 0.3

O formatador antigo encadeava seis chamadas a .replace() com a flag de ignorar maiúsculas. Daí duas consequências: um padrão posterior podia capturar os dígitos que outro anterior acabara de escrever, e /M+/g, /m+/g e /D+/gi se sobrepunham, então um padrão em minúsculas como yyyy-mm-dd dava ano-minuto-dia.

timestampToTime ficou obsoleto em favor de formatDate: pendurar um método numa instância de Date não sobrevive à serialização e não dá para tipar além de Function. O format dele agora delega a formatDate, então quem já o usava recebe o tratamento de tokens já corrigido.