Diga qual relógio está mostrando
Ao apresentar conversas históricas do Reddit, o principal desafio é esclarecer qual marca de tempo define a idade do resultado. A criação na origem, o momento da consulta pelo aplicativo e a incorporação ao arquivo respondem a perguntas diferentes. Não rotule tudo como Atualizado. Uma solicitação de hoje pode recuperar uma conversa antiga sem tornar atual o conteúdo.
No exemplo de trilhas, quem compara conselhos sobre offline maps precisa saber que a referência é histórica. Se houver created_utc válido, identifique a data exibida como criação da publicação ou comentário de origem. A API repassa registros planos; não suponha que todos tenham esse campo ou um valor válido para exibição.
Desenhe um estado real para datas ausentes
Considere dois rótulos propostos, não exemplos recuperados: Data original: disponível no registro e Data original: indisponível. O segundo cartão deve continuar legível sem substituir silenciosamente a data por hoje. Falta de marca de tempo é falta de evidência, não prova de que a conversa seja nova.
Valide tipo e intervalo antes de formatar o campo. Para um rótulo relativo como anos atrás, esclareça a base e ofereça uma data absoluta compreensível quando possível. Considere o fuso horário de exibição. Se o relógio do cliente estiver errado ou o valor for duvidoso, prefira o estado conservador de data ausente a uma idade precisa mas não confiável.
Separe o histórico de consulta
O aplicativo pode registrar quando buscou ou salvou um item para explicar o estado da lista local. Use rótulos como Consultado por este aplicativo ou Salvo localmente. Eles descrevem a ação do aplicativo, não criação, última edição, última resposta, incorporação ao arquivo ou exatidão atual. Tampouco medem latência por si só.
Não invente a data de incorporação ao arquivo a partir da solicitação. A interface atual não promete essa marca em cada registro. Nem deduza um período completo de cobertura pelo item mais antigo ou recente de uma resposta pequena. A ausência de resultado pode ter várias explicações e não prova que a conversa nunca existiu.
Filtre por data sem prometer uma cronologia
Filtrar por data restringe a busca, mas não fornece ordenação cronológica. from e to aceitam datas YYYY-MM-DD em UTC, incluindo todo o dia to. Uma solicitação hipotética com from=2025-01-01 e to=2025-12-31 pede aquele intervalo de criação, não os registros mais recentes primeiro.
O serviço usa a ordem _doc do arquivo. Se o aplicativo ordena localmente os registros recebidos por um campo válido de criação, descreva a operação como ordenação dos registros carregados. Não estabelece que o primeiro cartão seja a correspondência mais recente de todo o arquivo. Registros sem data utilizável precisam de posição separada e explicada, não de uma marca inventada.
Ligue a data à decisão do leitor
Uma conversa antiga pode ajudar a escolher o que investigar sobre mapas offline: preparação do download, bateria ou limites do aparelho. Não estabelece que uma rota esteja aberta, que um produto funcione igual hoje ou que uma solução antiga continue adequada. Separe a leitura de navegação e informações atuais de segurança.
Um rótulo histórico discreto é mais útil que um indicador de atualidade sem base. Evite Ativo recentemente, Totalmente sincronizado ou Orientação ao vivo sem evidências separadas para aquela afirmação; esta resposta não as fornece. Preserve links disponíveis e trate uma fonte alterada ou desaparecida. Volte a /pt/#field-notes para cartões e listas locais.
