This is an automated email from the ASF dual-hosted git repository.
chaokunyang pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/fory-site.git
The following commit(s) were added to refs/heads/main by this push:
new aedcaf1e9 🔄 synced local 'docs/specification/' with remote
'docs/specification/'
aedcaf1e9 is described below
commit aedcaf1e938ee3becca31a414d7a220ea552679d
Author: chaokunyang <[email protected]>
AuthorDate: Mon Nov 3 04:03:38 2025 +0000
🔄 synced local 'docs/specification/' with remote 'docs/specification/'
---
docs/specification/xlang_serialization_spec.md | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/docs/specification/xlang_serialization_spec.md
b/docs/specification/xlang_serialization_spec.md
index 9ab038c6a..297f9b627 100644
--- a/docs/specification/xlang_serialization_spec.md
+++ b/docs/specification/xlang_serialization_spec.md
@@ -597,6 +597,26 @@ Which encoding to choose:
- If the string is encoded by `utf-8`, then fory will use `utf-8` to decode
the data. Cross-language string
serialization of fory uses `utf-8` by default.
+### duration
+
+Duration is an absolute length of time, independent of any calendar/timezone,
as a count of seconds and nanoseconds.
+
+Format:
+
+```
+| signed varint64: seconds | signed int32: nanoseconds |
+```
+
+- `seconds`: Number of seconds in the duration, encoded as a signed varint64.
Can be positive or negative.
+- `nanoseconds`: Nanosecond adjustment to the duration, encoded as a signed
int32. Value range is [0, 999,999,999] for positive durations, and
[-999,999,999, 0] for negative durations.
+
+Notes:
+
+- The duration is stored as two separate fields to maintain precision and
avoid overflow issues.
+- Seconds are encoded using varint64 for compact representation of common
duration values.
+- Nanoseconds are stored as a fixed int32 since the range is limited.
+- The sign of the duration is determined by the seconds field. When seconds is
0, the sign is determined by nanoseconds.
+
### collection/list
Format:
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
