ForHosting KIT · أدوات المطورين

حساب دورة تقويم المايا لأي تاريخ

تحوّل حاسبة دورة تقويم المايا هذه تاريخًا ميلاديًا محددًا إلى موضعي Tzolkin وHaab المقترنين.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

وهي تستخدم ثابت ارتباط Goodman-Martinez-Thompson البالغ 584283 وتعتمد على حساب الأعداد الصحيحة، لذلك لا تتأثر النتيجة بساعة الجهاز أو المنطقة الزمنية أو التوقيت الصيفي أو بيانات الشبكة. تعرض الاستجابة رقم يوم Tzolkin واسمه، ويوم Haab وشهره، والتسمية الموحّدة، ورقم اليوم اليولياني المستخدم في التحويل، مما يتيح لكم تدقيق الحساب أو إعادة إنتاجه بسهولة.

ما الذي تمثله دورة تقويم المايا

تجمع دورة التقويم بين دورتين متكررتين من تقويم المايا. تتألف دورة Tzolkin من 260 يومًا، وتنتج من إقران ثلاثة عشر رقمًا للأيام بعشرين اسمًا لها. ولأن تسلسلي الأرقام والأسماء يتقدمان معًا، تعود تسمية Tzolkin بعينها بعد 260 يومًا. أما Haab فهي دورة مدنية من 365 يومًا، تتكون من ثمانية عشر شهرًا في كل منها عشرون يومًا، ثم Wayeb، وهي فترة ختامية قصيرة من خمسة أيام. ويتكرر اقتران محدد لموضعي Tzolkin وHaab بعد 18,980 يومًا، أي بعد 52 سنة من سنوات Haab. تعرض هذه الحاسبة الموضعين معًا ولا تتعامل مع أي منهما بوصفه تاريخًا كاملًا يمتد عبر العصور. وهذا التمييز مهم، فتسمية دورة التقويم تحدد موضعًا داخل دورة متكررة، ولا تحدد وحدها يومًا فريدًا في التاريخ كله. لذلك تتضمن الاستجابة أيضًا تاريخ ISO المدخل ورقم يومه اليولياني. تجعل هذه الحقول التحويل قابلًا للتدقيق وتمنع الخلط بين التسمية المتكررة وتاريخ فريد في العد الطويل. وتستخدم الأداة صيغًا إملائية شائعة في الدراسات المتخصصة بالمايا، ومنها Ajaw وKankin وWayeb.

كيف يبقى التحويل حتميًا

أدخلوا تاريخًا ميلاديًا بالصيغة الدقيقة YYYY-MM-DD. تتحقق الحاسبة من الشهر واليوم وقواعد السنوات الكبيسة في التقويم الميلادي قبل إجراء أي تحويل. ثم تحوّل التاريخ إلى رقم يوم يولياني صحيح باستخدام حساب التقويم الميلادي الاستباقي. ولا تنشئ كائن Date في JavaScript، ولذلك يسلك متصفح في طوكيو وخادم يعمل بتوقيت UTC وحاسوب في نيويورك المسار الحسابي نفسه ويعطي كل منها القيمة ذاتها. يُثبّت موضع المايا بواسطة ثابت ارتباط Goodman-Martinez-Thompson ذي القيمة 584283، والذي يُختصر عادة إلى GMT. عند أصل هذا الارتباط، تقابل إزاحتا الدورتين 4 Ajaw و8 Kumku، ثم يقدمهما الحساب النمطي حتى اليوم المطلوب. وتُطبّع البواقي السالبة صراحة، وبذلك تظل التواريخ السابقة لأصل الارتباط محددة بصورة متسقة ضمن النطاق الميلادي المدعوم. تُظهر النتيجة الارتباط المختار لأن اختياره فرضية تفسيرية وليس تفصيلًا برمجيًا مخفيًا. وإذا اعتمد مرجع ما ارتباطًا آخر، فقد ينتج قيمة مختلفة حتى لو كان الحسابان متسقين داخليًا.

كيفية قراءة النتيجة واستخدامها بمسؤولية

اقرؤوا حقل calendar_round بحيث يأتي Tzolkin أولًا ثم Haab. فمثلًا تعني القيمة 4 Ajaw / 3 Kankin رقم Tzolkin ‏4 مع اسم اليوم Ajaw، مقترنًا باليوم 3 من شهر Kankin في Haab. تناسب الكائنات المتداخلة tzolkin وhaab البرمجيات التي تحتاج إلى حقول منفصلة، بينما تلائم السلسلة الموحّدة العرض أو الملاحظات أو مسودة الإحالة. استخدموا julian_day_number عند مقارنة النتيجة بأداة تحويل أخرى؛ فإذا تطابقت أرقام الأيام واختلفت مواضع المايا، كان السبب غالبًا اختلاف الارتباط أو اصطلاح الإزاحة. يطبق الحساب التقويم الميلادي الاستباقي على كامل النطاق المدعوم، بما في ذلك التواريخ السابقة لاعتماد بلد ما التقويم الميلادي تاريخيًا. يضمن ذلك حسابًا موحدًا، لكنه قد يختلف عن تاريخ سجلته وثيقة تاريخية وفق التقويم اليولياني. تحسب هذه الأداة المواضع التقويمية فقط؛ فهي لا توثق أصالة النقوش، ولا تستنتج العد الطويل، ولا تحسم الخلافات الأثرية، ولا تدّعي تقديم تفسير ثقافي. ولأغراض البحث القابل لإعادة الإنتاج، احتفظوا معًا بمدخل ISO وارتباط GMT 584283 وجميع الحقول المعادة، لكي يتمكن قارئ آخر من إعادة الحساب بدقة.

حالات الاستخدام

تدقيق تحويل منشور

قارنوا مقالًا أو بطاقة عرض متحفي بحساب واضح يعتمد GMT 584283، واحتفظوا برقم اليوم اليولياني للمراجعة.

إضافة سياق تقويمي إلى سجل مؤرخ

أضيفوا حقول Tzolkin وHaab المنظمة إلى مذكرة بحثية أو خط زمني تعليمي أو مجموعة بيانات مؤرخة بصيغة ISO.

إنشاء عرض تقويمي قابل لإعادة الإنتاج

أنشئوا تسمية ثابتة من دون الاعتماد على منطقة الجهاز الزمنية أو الساعة الحالية أو استعلام بعيد أو محلل تواريخ محلي.

الأسئلة الشائعة

أي ارتباط لتقويم المايا تستخدمه الحاسبة؟

تستخدم ثابت ارتباط Goodman-Martinez-Thompson البالغ 584283 وتذكره في كل نتيجة.

هل تاريخ دورة التقويم فريد؟

لا. يتكرر اقتران Tzolkin وHaab نفسه كل 18,980 يومًا، ولذلك لا يحدد وحده يومًا تاريخيًا فريدًا.

هل تغير منطقتي الزمنية الإجابة؟

لا. المدخل تاريخ محدد، وتستخدم الخوارزمية حساب الأعداد الصحيحة من دون تحويل للساعة المحلية أو المنطقة الزمنية.

ما التواريخ الميلادية المقبولة؟

استخدموا الصيغة الدقيقة YYYY-MM-DD من 0001-01-01 إلى 9999-12-31. تتحقق الأداة من أطوال الشهور والسنوات الكبيسة الميلادية.

هل تحسب هذه الأداة العد الطويل للمايا؟

لا. فهي تعيد موضعي Tzolkin وHaab المقترنين ورقم اليوم اليولياني للتدقيق، لكنها لا تستنتج العد الطويل.

ما كلفة طلب API؟

تبلغ كلفة كل طلب API ‏$0.002. يعالج الحساب تاريخًا واحدًا بوصفه عنصرًا واحدًا.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/date/maya-calendar-round

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/date/maya-calendar-round \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2012-12-21"}'

const res = await fetch("https://api.kit.forhosting.com/date/maya-calendar-round", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2012-12-21"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/maya-calendar-round",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2012-12-21"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/maya-calendar-round", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2012-12-21"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2012-12-21"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/maya-calendar-round", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "date": "2012-12-21"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.maya_calendar_round",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←