Назовите время, которое показываете
При показе исторических обсуждений Reddit в приложении важно прояснить, какой момент определяет возраст результата. Время создания источника, момент получения записи приложением и момент её включения в архив отвечают на разные вопросы. Не называйте всё это «Обновлено». Сегодняшний запрос может получить старое обсуждение, не делая его содержание актуальным.
В гипотетической туристической функции человеку, сравнивающему советы об офлайн-картах, важно знать, что материал исторический. Если есть корректное значение created_utc, обозначьте показанную дату как дату создания исходной публикации или комментария. API передаёт плоские исходные записи; не предполагайте, что это поле есть у каждой записи и его значение пригодно для показа.
Выделите отдельное состояние для отсутствующей даты
Рассмотрите две предлагаемые подписи карточек, не полученные примеры: «Исходная дата: доступна из записи» и «Исходная дата: недоступна». Вторая карточка должна оставаться читаемой без скрытой подстановки сегодняшней даты. Отсутствующая отметка времени — отсутствие данных, а не доказательство новизны обсуждения.
Проверяйте тип и диапазон поля перед форматированием. Для относительной подписи вроде «несколько лет назад» поясняйте основу и по возможности показывайте понятную абсолютную дату. Учитывайте часовой пояс отображения приложения. При неверных часах клиента или неоднозначном значении выбирайте осторожное состояние отсутствующей даты вместо точного, но ненадёжного возраста.
Отделяйте историю получения
Приложение может записывать время получения или сохранения записи, чтобы объяснять состояние локального списка чтения. Назовите это «Получено этим приложением» или «Сохранено локально». Такая отметка описывает действие приложения, а не создание записи, последнее изменение, ответ, включение в архив или нынешнюю точность. Сама по себе она также не является измерением задержки.
Не выдумывайте дату включения в архив из времени запроса. Текущий интерфейс не обещает такую отметку для каждой записи. Не выводите и полный период охвата архива из самой старой или новой записи небольшого ответа. Отсутствие результата может иметь разные причины и не доказывает, что обсуждения никогда не было.
Фильтруйте даты, не обещая хронологию
Фильтрация дат сужает поиск, но не обеспечивает хронологическую сортировку. from и to принимают даты YYYY-MM-DD в UTC, причём день to включён целиком. Гипотетический запрос с from=2025-01-01 и to=2025-12-31 задаёт диапазон дат источника, а не просит вернуть самый новый результат первым.
Сервис возвращает порядок архива _doc. Если приложение локально сортирует полученные записи по корректному полю создания, описывайте это как сортировку загруженных записей. Она не устанавливает, что первая карточка — новейшее совпадение во всём архиве. Для записей без пригодной даты нужно отдельное понятное расположение, а не выдуманная отметка времени.
Свяжите дату с решением читателя
Старое обсуждение может помочь туристу определить, какие вопросы об офлайн-картах изучить: подготовку загрузок, расход батареи или ограничения устройства. Оно не устанавливает, открыт ли маршрут, ведёт ли продукт себя так же сегодня и подходит ли прежний обходной способ. Отделяйте чтение от навигации и актуальной информации о безопасности.
Спокойная отметка исторического источника полезнее неподтверждённого значка свежести. Избегайте подписей «Недавно активно», «Полностью синхронизировано» и «Советы в реальном времени», если нет отдельного подтверждения конкретного утверждения; этот архивный ответ его не даёт. Сохраняйте ссылки на источник при наличии и обрабатывайте изменённые или исчезнувшие страницы. В /ru/#field-notes есть заметки о карточках обсуждений и локальном списке чтения.
