From 93f2eafcf7a2f84122d6868b0fa76052bf983b90 Mon Sep 17 00:00:00 2001
From: Sylvestre Ledru <sylvestre@debian.org>
Date: Tue, 31 Mar 2026 10:23:17 +0200
Subject: [PATCH] docs: add ExtendedDateTime usage example to README

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 6b99e97..a69de16 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,21 @@ match dt.unwrap() {
 }
 ```
 
+For years beyond jiff's representable range (e.g., year 10000+), the result is an `ExtendedDateTime`:
+
+```rs
+use parse_datetime::{parse_datetime, ParsedDateTime};
+
+let dt = parse_datetime("12000-01-01").unwrap();
+match dt {
+  ParsedDateTime::Extended(ext) => {
+    assert_eq!(ext.year, 12000);
+    assert_eq!(ext.to_string(), "12000-01-01 00:00:00+00:00");
+  }
+  ParsedDateTime::InRange(_) => unreachable!("year 12000 is out of jiff range"),
+}
+```
+
 ### Supported Formats
 
 The `parse_datetime` and `parse_datetime_at_date` functions support absolute datetime and the following relative times: