Pular para o conteúdo
Dados

RelativeTime

/componentes/relative-time.mdmarkdown cru, para quem lê com agent em vez de olho

Fila de eventos

  • Deploy da versão 3.4 concluído
  • Joana entrou no projeto Atlas
  • Backup semanal salvo
  • Assinatura renovada
Importar
import { RelativeTime } from '@rivocode/ui'

Quando usar

"há 2 minutos", "em 3 dias".

Nenhuma biblioteca de fora entrega isto, porque não é problema de código. É decisão de idioma e de produto: onde cortar entre "agora" e "há 1 minuto", quando parar de contar e mostrar a data, como o plural se escreve. Deixar isso para a tela significa cada tela decidir diferente, e log, fila e notificação são justamente onde o mesmo instante aparece em três telas ao mesmo tempo.

Sai num <time> de verdade, com o instante exato no datetime e a data por extenso no title: o relativo é resumo, e resumo perde informação que às vezes é a que importa.

O texto se refaz sozinho num passo que acompanha a unidade: de trinta em trinta segundos enquanto conta minuto, de hora em hora quando já conta dia. Um relógio de segundo em segundo para cada linha de uma tabela de mil linhas é o jeito mais fácil de derrubar a rolagem. Passando now, o texto para de se atualizar: quem fixou o agora não quer relógio.

cutoff decide quando o relativo deixa de ajudar. "há 412 dias" não diz nada; a data diz.

Data inválida (new Date("ontem"), NaN) sai como "—", sem datetime, sem title e sem relógio. A linha da tabela com a data quebrada continua de pé, e não derruba a tela inteira com o RangeError do toISOString.

Quando não usar

Quando a data exata é o dado: vencimento, data da consulta, prazo de entrega. Ali o relativo esconde a informação que a pessoa foi buscar; use formatDate.

No React Native

Traduz com relógio e tudo: receber o texto pronto teria sido mais barato de escrever e teria devolvido o problema para a tela, que é de onde ele veio. O passo acompanha a unidade, como no web: trinta segundos enquanto conta minuto, uma hora quando já conta dia, e nunca um segundo. A hora anda de cinco em cinco minutos, e não de um em um: a diferença entre "há 1 hora" e "há 2 horas" não vale um timer por minuto vezes as linhas montadas. Duas coisas são só daqui. O texto se refaz ao voltar do fundo, porque enquanto o app dorme o timer do JS não corre e a tela reabriria dizendo "há 2 minutos" três horas depois. E o texto é sempre numérico: o Intl.RelativeTimeFormat não existe no Hermes, o plural vai escrito à mão, e onde o web diz "ontem" o nativo diz "há 1 dia". O cutoff e o now são os mesmos, e a data que ele mostra sai no formato do formatDate. O que não atravessa é o instante exato: no web ele mora no title do <time>, e no toque não há title nem onde pousar o ponteiro. Quando a data exata importa, ela precisa estar escrita na tela.

size e tone são os do Text (sm e muted por padrão), e não as props do Text do React Native.

API

PropTipo
valueobrigatória0.5.0

O instante que se descreve.

stringnumberDate
cutoff0.5.0

A partir de qual unidade parar de contar e mostrar a data.

"day""hour""minute""month""week""year"
now0.5.0

O agora, para teste e para renderizacao no servidor.

Date

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.