From e44178445db2be968215e0d174e25472da3b2266 Mon Sep 17 00:00:00 2001
From: steve-chavez <stevechavezast@gmail.com>
Date: Fri, 31 Jul 2026 12:35:26 -0500
Subject: [PATCH] docs: timezone offsets

---
 docs/references/api/preferences.rst | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/docs/references/api/preferences.rst b/docs/references/api/preferences.rst
index 767b982f6..5f94ad91c 100644
--- a/docs/references/api/preferences.rst
+++ b/docs/references/api/preferences.rst
@@ -66,7 +66,8 @@ Timezone
 
   ``handling=lenient`` is ignored for ``timezone``. Invalid time zones always return an error.
 
-The ``timezone`` preference allows you to change the `PostgreSQL timezone <https://www.postgresql.org/docs/current/runtime-config-client.html#GUC-TIMEZONE>`_. It accepts all time zones in `pg_timezone_names <https://www.postgresql.org/docs/current/view-pg-timezone-names.html>`_.
+The ``timezone`` preference allows you to change the `PostgreSQL timezone <https://www.postgresql.org/docs/current/runtime-config-client.html#GUC-TIMEZONE>`_.
+It accepts all time zones in `pg_timezone_names <https://www.postgresql.org/docs/current/view-pg-timezone-names.html>`_ and numeric offsets.
 
 .. code-block:: bash
 
@@ -87,6 +88,29 @@ The ``timezone`` preference allows you to change the `PostgreSQL timezone <https
     {"t":"2023-10-18T09:37:59.611-07:00"}
   ]
 
+Offsets are also accepted:
+
+.. code-block:: bash
+
+  curl -i "http://localhost:3000/timestamps" \
+    -H "Prefer: timezone=05:30"
+
+.. code-block:: http
+
+  HTTP/1.1 200 OK
+  Content-Type: application/json; charset=utf-8
+  Preference-Applied: timezone=05:30
+
+.. code-block:: json
+
+  [
+    {"t":"2023-10-18T17:07:59.611+05:30"},
+    {"t":"2023-10-18T19:07:59.611+05:30"},
+    {"t":"2023-10-18T21:07:59.611+05:30"}
+  ]
+
+You can also use negative offsets like ``-03:00``.
+
 For an invalid time zone, PostgREST returns a database error.
 
 .. code-block:: bash