日期作为查询参数的最佳传递方式及行业标准格式问询

嘿，这个问题问得很实在！我来分享下业内常用的做法：

一、日期作为查询参数的最佳传递方式 #

• 直接用字符串参数传递：这是最普遍的做法，比如?start_date=2024-05-20&end_date=2024-05-27，简单直观，后端解析起来也省心。
• 尽量别用时间戳：虽然时间戳（比如?timestamp=1716182400）精度够高，但可读性极差，除非是后端内部调用或者对性能有极致要求的场景，否则不推荐给前端用户或公开API使用。
• 范围查询用成对参数：如果是查日期范围，用start_date和end_date（或者from/to）这类成对参数，比把两个日期塞到一个参数里清晰得多。比如?from=2024-01-01&to=2024-12-31，就比?date_range=2024-01-01,2024-12-31更易读也更规范。

二、日期格式的行业标准 #

你提到的YYYY-MM-DD（也就是HTML输入的日期格式），绝对是行业首选！原因有这么几个：

1. 符合ISO 8601标准，全球通用，完全没有地域歧义——不会出现10/05到底是10月5日还是5月10日的混乱。
2. 字符串的字典序和日期的时间顺序完全一致，比如2024-05-20小于2024-05-27，不管是排序还是做日期比较都特别方便。
3. 几乎所有编程语言和框架都内置了对这个格式的解析支持，不用自己写复杂的解析逻辑，减少出错概率。

如果需要包含时间信息，就用完整的ISO格式YYYY-MM-DDTHH:mm:ss（比如2024-05-20T14:30:00），要是需要带时区，可以加Z或者偏移量，比如2024-05-20T14:30:00+08:00。不过如果只是需要日期维度的查询，用纯日期格式就够了，没必要画蛇添足。

小建议 #

• 一定要在API文档里明确标注日期参数的格式，避免前后端出现理解偏差。
• 接收参数时记得做合法性校验，比如拒绝2024-13-01这种无效日期。

内容的提问来源于stack exchange，提问作者Andrew Kim