البندالقيمة
الاسمGREGORIAN-DATE (مستند المواصفة BIND GREGORIAN-DATE)
TAG ID0x06AL
Codec ID0x000006A0
مستند المواصفة0x00000000/codecs/0x000006A0/ (هدف DECLARE هو 06A0)
القسم3 0011 (Value)، الإزاحة داخل القسم C = 10
KindValue · العائلة: TIME
TAG WORD0000 0110 1010 LLLL (000K KKKC CCCC LLLL)
وصف الفهرسعدد أيام signed بالنسبة إلى proleptic Gregorian 1970-01-01
جهة Hugovalue/time/gregorian-date.md

الحقول (مستند المواصفة)

ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند مواصفة Codec).

الترتيبالحقل (BIND)FIELDالعرضالصيغة المقبولة (CODEC)ENUM
1days#2قيمة خام 2 WORD

GREGORIAN-DATE عدد أيام signed يعدّ proleptic Gregorian 1970-01-01 اليوم 0. لا تُحفظ المنطقة الزمنية ولا الوقت من اليوم.

التخطيط

  • الرمز: رمز مباشر في Value هو 0x06AL. العائلة TIME.
  • يستخدم النوع الفيزيائي signed int32 ثابت العرض نفسه في Arrow Date32 وParquet DATE.
TAG WORD          0x06A2 (0000 0110 1010 0010)  المجموع 3 WORD
Payload WORD 1st (bits 31..16)     Signed Day Count high 16bit
Payload WORD 2nd (bits 15..0)      Signed Day Count low 16bit

التفسير والصلاحية

  • يُقرأ Payload كله (WORD اثنتان) على أنه عدد أيام signed بمتمم الاثنين ذي 32 بت بترتيب WORD من نوع big-endian.
  • المدى الصالح هو من -2^31 إلى 2^31-1 يوماً. والقيمة السالبة تاريخ قبل epoch.
  • عند حساب السنة والشهر واليوم من عدد الأيام يُستخدم تقويم proleptic Gregorian دون أي انتقال تقويمي تاريخي.
  • تُستخدم دائماً WORD اثنتان حتى للقيم الصغيرة.

الطول

  • المجموع هو TAG (1 WORD) وPayload (2 WORD)، أي 3 WORD تماماً، ويُستخدم الطول المباشر LLLL=0010. لا يوجد TAG ممتد لـ Length ولا descriptor ولا padding.
  • يُرفض ما لا يكون Payload فيه WORD اثنتين تماماً.

مثال

التاريخPayloadLength الكلي
1970-01-010000 00003 WORD (LLLL=0010)
1970-01-020000 00013 WORD (LLLL=0010)
1969-12-31FFFF FFFF3 WORD (LLLL=0010)

العلاقة بـ EDTF

  • الدقة الأقل من اليوم، وعدم اليقين والتقريب، والفترات تُكتب بـ EDTF. أما التاريخ الذي يمكن كتابته بدقة بـ GREGORIAN-DATE فلا يُكتب بـ EDTF (الصيغة القياسية لـ EDTF).

الأساس المعياري

  • DATE في Apache Parquet Logical Types هو int32 يخزن عدد الأيام منذ 1970-01-01 (Unix epoch) ويستخدم ترتيب signed.
  • Date32 في Apache Arrow Columnar Format وفي Schema.fbs المرجعي يخزن عدد الأيام منذ Unix epoch بعدد صحيح signed من 32 بت.
  • حساب proleptic Gregorian هو calendar profile في GEUL تعتمده هذه الصيغة. يبقى معنى int32 لعدد الأيام في Arrow/Parquet كما هو، ولا يُضاف إلا TAG وإطار WORD ذي 16 بت بترتيب big-endian.

نص مستند المواصفة

هذا ما يظهر عند قراءة مستند المواصفة 0x00000000/codecs/0x000006A0/latest.geul بالأمر geul show (الأرقام الستة عشرية بأحرف كبيرة).

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006A000000000
BODY
#1 DECLARE 0x06A0
#2 FIELD #1 0x0002
#3 BIND #1 "GREGORIAN-DATE"
#4 BIND #2 "days"