[Suggest] typia date format follow RFC3339

[rojiwon123]

Summary

suggest that the typia.tags.Format > "date-time" | "date" | "time" format follow RFC3339.

Problem

The current typia.tags.Format<'date-time'> format follows just ISO8601. it allows time and timezone to be omitted. And the type is represented as date-time in swagger when building swagger documentation.
However, the date-time format in swagger is defined by the date-time format in the RFC3339 standard, which requires the time and timezone to be indicated.

In conclusion, the current typia definition of date-time leads to inaccuracies in documentation and confusion of terms.

Therefore, I suggest the following

Suggest

format

• RFC3339 standard full-date format is define typia.tags.Format<'date'>
• RFC3339 standard full-time format is define typia.tags.Format<'time'>
• RFC3339 standard date-time format is define typia.tags.Format<'date-time'>

code

• FormatCheatSheet.ts

export const FormatCheatSheet = {
// ...
"date-time": RegexCall(`/^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])(T|\\s)([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i`),
"date": RegexCall(`/^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$/`),
"time": RegexCall(`/^([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](?:\\.[0-9]{1,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$/i`),
// ...
};

Example

// before
import typia from "typia"
typia.is<string & typia.tags.Format<"date-time">>("2024-05-23"); // true
typia.is<string & typia.tags.Format<"date-time">>("2024-05-23T23:59:59Z"); // true

// after
import typia from "typia"
typia.is<string & typia.tags.Format<"date-time">>("2024-05-23"); // false
typia.is<string & typia.tags.Format<"date-time">>("2024-05-23T23:59:59Z"); // true

Reference

• Swagger v3 Doc > Data Type > date-time
• RFC3339 > #5.6 > date-time

[samchon]

Of course, why not