Support for date, time and date-time format strings

Currently, Zod is lacking support for validating date, time and date-time stamps. As a result, users may need to implement custom validation via .refine. But the use case for date/time/date-time is very common, so if Zod ships it out-of-the-box like it does for uuid, email, etc, it would be helpful.

• Stemmed from https://github.com/vriad/zod/issues/30#issuecomment-679383286
• AJV’s in-built regexes are here for reference.

[colinhacks]

RFC for datetime methods

The hard problem here is naming the methods such that the validation behavior is clear to everyone. I’m opposed to adding a method called .datetime() since different people will have different ideas of what should be valid. I don’t like AJV’s datetime regex since it allows timezone offsets, which should almost never ever be used imo.

Here is a set of method names I’d be happy with:

• z.string().date() — 2020-10-14
• z.string().time() — T18:45:12.123 (T is optional)
• z.string().utc() — 2020-10-14T17:42:29Z (no offsets allowed)
• z.string().iso8601() — 2020-10-14T17:42:29+00:00 (offset allowed)

The longer method name iso8601 makes the validation rule explicit. The documentation will clearly indicate that using UTC date strings is a best practice and will encourage usage of .utc() over .iso8601().

Milliseconds will be supported but not required in all cases.

[devinhalladay]

Any updates on this?