EDTF قيمة Value تحمل سلسلة تاريخ ممتدة من ISO 8601-2 لتواريخ بدقة السنة أو الشهر، وقبل الميلاد، وغير المؤكدة، والفترات (Codec 0x06EL/0x06FL).
| البند | القيمة |
|---|---|
| الاسم | EDTF (حزمة زوجي/فردي. اسم كل رمز في جدول الأعضاء أدناه) |
| TAG ID | 0x06EL·0x06FL |
| القسم | 3 0011 (Value)، الإزاحة داخل القسم C = 14~15 |
| Kind | Value · العائلة: TIME |
| وصف الفهرس | سلسلة تاريخ EDTF (ISO 8601-2). بايتات زوجية وفردية. لا تُستخدم للتاريخ الذي يمكن كتابته بـ GREGORIAN-DATE |
| جهة Hugo | value/time/edtf.md |
الأعضاء
تتناول هذه الصفحة رمزين من زوج زوجي/فردي معاً. الرمز الزوجي للقيمة ذات عدد البايتات الزوجي، والرمز الفردي لذات العدد الفردي (السجل وTAG WORD). لكل رمز مستند Codec واحد. حقول مستندي Codec هما نفسها، ولا يختلف إلا هدف DECLARE والاسم (BIND).
| TAG ID | الاسم | عدد البايتات | Codec ID | مستند المواصفة | TAG WORD |
|---|---|---|---|---|---|
0x06EL | EDTF-EVEN | زوجي | 0x000006E0 | 0x00000000/codecs/0x000006E0/ | 0000 0110 1110 LLLL |
0x06FL | EDTF-ODD | فردي | 0x000006F0 | 0x00000000/codecs/0x000006F0/ | 0000 0110 1111 LLLL |
الحقول (مستند المواصفة)
ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند مواصفة Codec).
| الترتيب | الحقل (BIND) | FIELD | العرض | الصيغة المقبولة (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | bytes | #2 | القيمة الخام المتبقية (0xFFFF) |
EDTF قيمة Value تحمل التاريخ في سلسلة Extended Date/Time Format (مكتبة الكونغرس الأمريكية، ISO 8601-2:2019). وتمثل الدقة الأقل من اليوم، وقبل الميلاد، وعدم اليقين والتقريب والمجهول جزئياً، والفترات.
التخطيط
- الرمز: رمز مباشر في Value هو
0x06EL(بايتات زوجية) و0x06FL(بايتات فردية). العائلة TIME. Payload سلسلة نصية لكنها توضع في عائلة TIME. - يُحدَّد عدد البايتات بأدنى بت في Codec وعدد Payload WORD. وهو
2 × عدد Payload WORD − أدنى بت، ولا يوجد Byte Count (Value).
TAG WORD 0000 0110 111P LLLL Codec 0x06EL/0x06FL (P = بايتات فردية)
[TAG ممتد لـ Length] عندما يبلغ المجموع 15 WORD أو أكثر
Payload WORD 1st ... Nth بايتات ASCII لسلسلة EDTF / وإذا كانت فردية فآخرها 0x00
التفسير والصلاحية
- سلسلة البايتات هي سلسلة ASCII تتبع قواعد EDTF في Level 0 وLevel 1 وLevel 2. والسلسلة الفارغة invalid.
- أمثلة: يوم
1952-03-11، شهر1952-03، سنة1952، عقد195X، سنة 44 قبل الميلاد-0043، غير مؤكد1974?، تقريبي~1974، فترة1952/2001، سنة كبيرةY-13799999999. - السنة بنمط ISO 8601 الفلكي.
0000هي سنة 1 قبل الميلاد، و-0043هي سنة 44 قبل الميلاد. وعند النقل من التدوين التاريخي تُزاح سنة واحدة. - التقويم هو الغريغوري. ولا يتناول EDTF تقاويم أخرى. أما التدوين الأصلي في تقاويم أخرى مثل التقويم اليولياني فيُحفظ بـ GEDCOM-DATE. والقيمة التي تنقل ذلك التاريخ نفسه أو تلك الفترة نفسها إلى التقويم الغريغوري يمكن كتابتها بـ EDTF أو GREGORIAN-DATE.
- الصيغة القياسية: التاريخ الذي يمكن كتابته بدقة بـ GREGORIAN-DATE، أي
[-]YYYY-MM-DDبلا محدِّد (?و~و%) ولا خانات مجهولة (X) ولا فترة ولا بادئةY، يُكتب بـ GREGORIAN-DATE. وكتابة مثل هذا التاريخ بـ EDTF هي invalid. فاليوم الواحد لا يُفهرس ويُقارَن زمنياً إلا إذا كُتب بصيغة واحدة فقط. - لا يفحص schema قواعد EDTF بعد. ويفحصها المُنتِج بمحلل EDTF. مثال:
parser.ParseStringفيgithub.com/sfomuseum/go-edtf(BSD-3-Clause). ولا يُستخدمparser.IsValidلأنه يفحص القواعد فقط فيُمرّر2023-02-29و1974-13. وهذا المحلل لا يدعم بعد السنة ذات البادئةY.
الطول
- المجموع هو عدد WORD في TAG (1 WORD) وTAG الممتد لـ Length (إن وُجد) وPayload معاً (Length).
مثال
| التاريخ | البايتات | WORD الكلي |
|---|---|---|
1974 | 4 (زوجي) | 06E2 3139 3734 |
197X | 4 (زوجي) | 06E2 3139 3758 |
1952-03 | 7 (فردي) | 06F4 3139 3532 2D30 3300 |
الأساس المعياري
- Library of Congress, Extended Date/Time Format (EDTF) Specification. Level 0 مجموعة جزئية من ISO 8601-1، وLevel 1 وLevel 2 من مزايا ISO 8601-2.
- في RDF تُعرض السلسلة نفسها بنوع البيانات
http://id.loc.gov/datatypes/edtf.
مسائل مفتوحة
- فحص قواعد EDTF في المدقق (هل يعتمد المدقق على مكتبة خارجية).
- قاعدة نقل دقة القرن والألفية في ويكي بيانات إلى خانات EDTF المجهولة.
صفحات ذات صلة
نص مستند المواصفة
هذا ما يظهر عند قراءة مستند المواصفة 0x00000000/codecs/0x000006E0/latest.geul بالأمر geul show (الأرقام الستة عشرية بأحرف كبيرة).
SPEC-VERSION 0x0001
DOC-ID 0x042600000000000006E000000000
BODY
#1 DECLARE 0x06E0
#2 FIELD #1 rest
#3 BIND #1 "EDTF-EVEN"
#4 BIND #2 "bytes"
ما سبق هو مستند Codec الخاص بـ EDTF-EVEN (0x06EL). أما مستند Codec للعضو الآخر (EDTF-ODD) فيختلف فقط في Codec ID ضمن DOC-ID وهدف DECLARE والاسم المربوط (BIND) في #1.