Каков правильный формат даты для поля полезной нагрузки rest api?

Question

Мы разрабатываем api rest, который будет обслуживать поля даты, как в запросах get, так и в post.

Таким образом, поля даты будут присутствовать в теле полезных данных http.

Насколько я знаю (поправьте меня, если я ошибаюсь), в json нет определения типа данных date, это просто строка. Таким образом, от реализации зависит, какой будет формат этих полей строки-даты.

Но нет ли лучшей практики для таких случаев? Мне сложно найти ориентир. Можете ли вы помочь с этим, пожалуйста?

ОБНОВЛЕНИЕ: Этот вопрос помечен как дубликат этого , но это не так, поскольку я спрашиваю о рекомендуемом формате даты ЗАГРУЗКИ поля даты, в то время как в этом другом посте обсуждается формат ПОЛУЧИТЬ URI запроса!

Answer 1

После некоторого исследования альтернативой ISO-8601 будет формат даты и времени , как предлагается в json-schema.org .

Здесь - соответствующая документация, которая следует за

RFC-3339

(который является "профилем" ISO-8601)

Преимущество такого стандартного форматирования заключается в том, что

1. это может быть легко проверяется
2. это может быть четко задокументировано

Answer 2

Наиболее часто используемый формат, который вы, вероятно, найдете: ISO-8601 .

Учитывая его широко принятый и признанный стандарт, я бы сказал, что это правильный путь, особенно если ваш API используется неизвестными клиентскими приложениями.