Add support for jiff::Timestamp (#1416)

Author: paolobarbolini

README.md

@@ -84,8 +84,8 @@ and the `ipa` is _api_ reversed. Aaand... `ipa` is also an awesome type of beer
   By default these types are parsed as `string`. `OffsetDateTime` and `PrimitiveDateTime` will use `date-time` format. `Date` will use
   `date` format and `Duration` will not have any format. To override default `string` representation users have to use `value_type` attribute
   to override the type. See [docs](https://docs.rs/utoipa/latest/utoipa/derive.ToSchema.html) for more details.
-- **`jiff_0_2`** Add support for [jiff 0.2](https://crates.io/crates/jiff) `Zoned`, and `civil::Date` types.
-  By default these types are parsed as `string`. `Zoned` will use `date-time` format. `civil::Date` will use
+- **`jiff_0_2`** Add support for [jiff 0.2](https://crates.io/crates/jiff) `Timestamp`, `Zoned`, and `civil::Date` types.
+  By default these types are parsed as `string`. `Timestamp` and `Zoned` will use `date-time` format. `civil::Date` will use
   `date` format. To override default `string` representation users have to use `value_type` attribute
   to override the type. See [docs](https://docs.rs/utoipa/latest/utoipa/derive.ToSchema.html) for more details.
 - **`decimal`**: Add support for [rust_decimal](https://crates.io/crates/rust_decimal) `Decimal` type. **By default**

utoipa-gen/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog - utoipa-gen
 
+## Unreleased
+
+### Added
+
+* Add support for jiff v0.2 `Timestamp` (https://github.com/juahku/utoipa/pull/1416)
+
 ## 5.4.0 - Jun 16 2025
 
 ### Added

utoipa-gen/src/schema_type.rs

@@ -137,7 +137,7 @@ impl SchemaType<'_> {
 
             #[cfg(feature = "jiff_0_2")]
             if !primitive {
-                primitive = matches!(name, "Zoned" | "Date");
+                primitive = matches!(name, "Zoned" | "Date" | "Timestamp");
             }
 
             primitive
@@ -301,7 +301,9 @@ impl ToTokensDiagnostics for SchemaType<'_> {
                 schema_type_tokens(tokens, SchemaTypeInner::String, self.nullable)
             }
             #[cfg(feature = "jiff_0_2")]
-            "Zoned" => schema_type_tokens(tokens, SchemaTypeInner::String, self.nullable),
+            "Zoned" | "Timestamp" => {
+                schema_type_tokens(tokens, SchemaTypeInner::String, self.nullable)
+            }
             _ => schema_type_tokens(tokens, SchemaTypeInner::Object, self.nullable),
         };
 
@@ -425,7 +427,7 @@ impl KnownFormat {
             "PrimitiveDateTime" | "OffsetDateTime" => Self::DateTime,
 
             #[cfg(feature = "jiff_0_2")]
-            "Zoned" => Self::DateTime,
+            "Zoned" | "Timestamp" => Self::DateTime,
             _ => Self::Unknown,
         };
 
@@ -750,7 +752,7 @@ impl PrimitiveType {
             }
 
             #[cfg(feature = "jiff_0_2")]
-            "Zoned" => {
+            "Zoned" | "Timestamp" => {
                 syn::parse_quote!(String)
             }
             _ => {

utoipa-gen/tests/schema_derive_test.rs

@@ -1670,6 +1670,7 @@ fn derive_component_with_time_feature() {
 fn derive_component_with_jiff_0_2_feature() {
     let doc = api_doc! {
         struct Timetest {
+            timestamp: jiff::Timestamp,
             civil_date: jiff::civil::Date,
             zoned: jiff::Zoned,
         }

utoipa-gen/tests/snapshots/schema_derive_test__derive_component_with_jiff_0_2_feature.snap

@@ -8,12 +8,17 @@ expression: "&doc"
       "format": "date",
       "type": "string"
     },
+    "timestamp": {
+      "format": "date-time",
+      "type": "string"
+    },
     "zoned": {
       "format": "date-time",
       "type": "string"
     }
   },
   "required": [
+    "timestamp",
     "civil_date",
     "zoned"
   ],

utoipa/CHANGELOG.md

@@ -3,6 +3,12 @@
 **`utoipa`** is in direct correlation with **`utoipa-gen`** ([CHANGELOG.md](../utoipa-gen/CHANGELOG.md)). You might want
 to look into changes introduced to **`utoipa-gen`**.
 
+## Unreleased
+
+### Added
+
+* Add support for jiff v0.2 `Timestamp` (https://github.com/juahku/utoipa/pull/1416)
+
 ## 5.4.0 - Jun 16 2025
 
 ### Added

utoipa/src/lib.rs

@@ -81,8 +81,8 @@
 //!   By default these types are parsed as `string`. `OffsetDateTime` and `PrimitiveDateTime` will use `date-time` format. `Date` will use
 //!   `date` format and `Duration` will not have any format. To override default `string` representation users have to use `value_type` attribute
 //!   to override the type. See [docs](https://docs.rs/utoipa/latest/utoipa/derive.ToSchema.html) for more details.
-//! * **`jiff_0_2`** Add support for [jiff 0.2](https://crates.io/crates/jiff) `Zoned`, and `civil::Date` types.
-//!   By default these types are parsed as `string`. `Zoned` will use `date-time` format. `civil::Date` will use
+//! * **`jiff_0_2`** Add support for [jiff 0.2](https://crates.io/crates/jiff) `Timestamp`, `Zoned`, and `civil::Date` types.
+//!   By default these types are parsed as `string`. `Timestamp` and `Zoned` will use `date-time` format. `civil::Date` will use
 //!   `date` format. To override default `string` representation users have to use `value_type` attribute
 //!   to override the type. See [docs](https://docs.rs/utoipa/latest/utoipa/derive.ToSchema.html) for more details.
 //! * **`decimal`** Add support for [rust_decimal](https://crates.io/crates/rust_decimal) `Decimal` type. **By default**