release: 0.5.11

Author: protocolstardust

docs/docs/content/CHANGELOG.md

@@ -5,13 +5,25 @@ All notable changes to Rayforce-Py will be documented in this file.
 !!! note ""
     You can also subscribe for release notifications by joining our [:simple-zulip: Zulip](https://rayforcedb.zulipchat.com/#narrow/channel/549008-Discuss)!
 
+## **`0.5.11`**
+
+### New Features
+
+- **`Timestamp.shift_tz()` method**: Shift a `Timestamp` value by a timezone offset. Accepts any `datetime.tzinfo` (including `datetime.timezone` and `zoneinfo.ZoneInfo`).
+
+- **`Column.shift_tz()` for queries**: Shift an entire column of timestamps by a timezone offset within `select()` expressions.
+
+2026-02-19 | **[🔗 PyPI](https://pypi.org/project/rayforce-py/0.5.11/)** | **[🔗 GitHub](https://github.com/RayforceDB/rayforce-py/releases/tag/0.5.11)**
+
+
 ## **`0.5.10`**
 
 ### Bug Fixes
 - Various bugfixes to the database operations
 
 2026-02-11 | **[🔗 PyPI](https://pypi.org/project/rayforce-py/0.5.10/)** | **[🔗 GitHub](https://github.com/RayforceDB/rayforce-py/releases/tag/0.5.10)**
 
+
 ## **`0.5.9`**
 
 ### Bug Fixes

docs/docs/content/documentation/data-types/temporal.md

@@ -78,3 +78,36 @@ Timestamp(datetime.datetime(2025, 5, 10, 14, 30, 45, tzinfo=datetime.timezone.ut
 >>> timestamp
 datetime.datetime(2025, 5, 10, 14, 30, 45, tzinfo=datetime.timezone.utc)
 ```
+
+### Shift Timezone
+
+The `shift_tz()` method shifts a `Timestamp` by a timezone offset, returning a new `Timestamp`. The original value is not mutated. It accepts any `datetime.tzinfo`, including `datetime.timezone` and `zoneinfo.ZoneInfo`.
+
+```python
+>>> import datetime as dt
+>>> from zoneinfo import ZoneInfo
+>>> from rayforce import Timestamp
+
+>>> ts = Timestamp(dt.datetime(2025, 6, 15, 12, 0, 0, tzinfo=dt.UTC))
+
+>>> ts.shift_tz(dt.timezone(dt.timedelta(hours=5)))
+Timestamp(datetime.datetime(2025, 6, 15, 17, 0, 0, tzinfo=datetime.timezone.utc))
+
+>>> ts.shift_tz(dt.timezone(dt.timedelta(hours=-5)))
+Timestamp(datetime.datetime(2025, 6, 15, 7, 0, 0, tzinfo=datetime.timezone.utc))
+
+>>> ts.shift_tz(ZoneInfo("Etc/GMT-5"))  # Etc/GMT-5 = UTC+5
+Timestamp(datetime.datetime(2025, 6, 15, 17, 0, 0, tzinfo=datetime.timezone.utc))
+```
+
+`shift_tz` is also available on `Column` for use in queries, allowing you to shift an entire column of timestamps:
+
+```python
+>>> import datetime as dt
+>>> from rayforce import Table, Column
+
+>>> result = table.select(
+        "id",
+        local_time=Column("created_at").shift_tz(dt.timezone(dt.timedelta(hours=3))),
+    ).execute()
+```

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rayforce_py"
-version = "0.5.10"
+version = "0.5.11"
 description = "Python bindings for RayforceDB"
 readme = "README.md"
 authors = [{name = "Karim"}]

rayforce/__init__.py

@@ -10,7 +10,7 @@
 
 FFI.init_runtime()
 
-version = "0.5.10"
+version = "0.5.11"
 
 if sys.platform == "linux":
     lib_name = "_rayforce_c.so"

setup.py

@@ -9,7 +9,7 @@ def has_ext_modules(self):
 
 setup(
     name="rayforce_py",
-    version="0.5.10",
+    version="0.5.11",
     packages=find_packages(),
     package_data={
         "rayforce": ["*.so", "*.dylib", "*.pyi", "bin/rayforce"],