RESTful API design - лучшие практики для прохождения дат

Question

Как лучше всего делиться датами в API?

Лучше ли делиться датами в формате даты и времени, похожем на SQL - «ГГГ-ММ-ДД ЧЧ: ММ: СС» с дополнительнымчасовой пояс, встроенный в него?

Или лучше использовать миллисекунды на основе UTC?

Answer 1

Я предпочитаю кодировать времена как полные ISO 8601 даты, но с ограничением, что мой код только когда-либо генерирует их в часовом поясе UTC. Если у вас есть хорошая библиотека для разбора дат (например, Jodatime для Java), принять полный ISO 8601 не особенно сложно, и они, по крайней мере, несколько читабельны. (Смещения из какого-то эпохального момента не так просты для чтения).

Answer 2

Вам решать, но, если вы не делаете какое-то приложение для календаря, я бы не стал поддерживать полную версию формата ISO, потому что их анализ при обработке часового пояса, перехода на летнее время и т. Д. Может быстро стать очень сложным.Передавать их как UTC почти всегда достаточно хорошо, и программистам, использующим ваш API, легко преобразовать любую дату в этот формат.