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