Update docs and changelog for temporal types

- CHANGELOG: document time_type addition and sql_datetime/sql_timestamp
  breaking rename to datetime_type/timestamp_type
- README: add temporal types to Features list and new Temporal Types
  section in Key API
- DEVELOPMENT.md: add datetime_type/timestamp_type/time_type helpers
  to the sql_type_format reference
- QUICKREF.md: add sql_temporal.hpp to Key Headers table

Author: Pierre-Luc Gagné

CHANGELOG.md

@@ -8,6 +8,19 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+### Added
+
+- `time_type` — maps to SQL `TIME`; wraps a `std::chrono::microseconds` duration with optional
+  fractional-second precision (0–6). Supports `INSERT`/`UPDATE` serialization and `SELECT`
+  deserialization, including negative durations.
+
+### Changed
+
+- **Breaking:** Renamed temporal value types to align with the `float_type` / `double_type` /
+  `decimal_type` naming scheme introduced in v1.1.0:
+  - `sql_datetime`  → `datetime_type`
+  - `sql_timestamp` → `timestamp_type`
+
 ---
 
 ## [1.1.0] - 2026-03-23

README.md

@@ -14,6 +14,10 @@ DSMySQL provides a **header-only** library for building type-safe SQL queries an
 - **Zero-overhead abstractions** — all query building happens at compile time
 - **Strong types** — `host_name`, `database_name`, `port_number`, `varchar_field<N>`, etc.
 - **Optional support** — `std::optional<T>` maps to nullable SQL columns automatically
+- **Temporal types** — `datetime_type`, `timestamp_type`, and `time_type` map to MySQL
+  `DATETIME`, `TIMESTAMP`, and `TIME`; `sql_now` sentinel resolves to `NOW()`
+- **Numeric precision wrappers** — `float_type`, `double_type`, and `decimal_type` with
+  optional `<precision>` and `<precision, scale>` overrides
 
 ## Quick Start
 
@@ -250,6 +254,23 @@ if (!r) std::println(stderr, "Mismatch: {}", r.error());
 auto r2 = db.validate_database<my_db>();
 ```
 
+### Temporal Types
+
+```cpp
+struct event {
+    COLUMN_FIELD(id,         uint32_t)
+    COLUMN_FIELD(created_at, datetime_type)           // DATETIME — defaults to NOW()
+    COLUMN_FIELD(updated_at, timestamp_type)          // TIMESTAMP — defaults to NOW()
+    COLUMN_FIELD(duration,   time_type)               // TIME
+    COLUMN_FIELD(started_at, std::optional<datetime_type>)  // nullable DATETIME
+};
+
+// Fractional-second precision (0–6) is set on the value object:
+event row;
+row.created_at_  = datetime_type{tp, 3};   // DATETIME(3)
+row.duration_    = time_type{std::chrono::milliseconds{1500}, 3};  // TIME(3) = 00:00:01.500
+```
+
 ### Numeric Precision Overrides
 
 ```cpp

docs/DEVELOPMENT.md

@@ -87,6 +87,9 @@ Available helpers:
 - `sql_type_format::float_type()` / `float_type(p)` / `float_type(p, s)`
 - `sql_type_format::double_type()` / `double_type(p)` / `double_type(p, s)`
 - `sql_type_format::decimal_type()` / `decimal_type(p)` / `decimal_type(p, s)`
+- `sql_type_format::datetime_type()` / `datetime_type(fsp)` — `DATETIME` / `DATETIME(fsp)`
+- `sql_type_format::timestamp_type()` / `timestamp_type(fsp)` — `TIMESTAMP` / `TIMESTAMP(fsp)`
+- `sql_type_format::time_type()` / `time_type(fsp)` — `TIME` / `TIME(fsp)`
 
 ## Useful Commands
 

docs/QUICKREF.md

@@ -52,6 +52,7 @@ DSMySQL/
 | `ds_mysql/database.hpp` | MySQL connection & queries |
 | `ds_mysql/sql.hpp` | SQL query builder |
 | `ds_mysql/sql_extension.hpp` | MySQL-specific extensions |
+| `ds_mysql/sql_temporal.hpp` | Temporal types: `datetime_type`, `timestamp_type`, `time_type` |
 | `ds_mysql/metadata.hpp` | MySQL information_schema types |
 | `ds_mysql/column_field.hpp` | Typed column descriptors |
 | `ds_mysql/schema_generator.hpp` | Schema generation |