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

تحويل التاريخ الفارسي الجلالي إلى التاريخ الميلادي

حوّلوا سنة وشهراً ويوماً محددة من التقويم الفارسي الجلالي، أي الهجري الشمسي، إلى التاريخ المقابل في التقويم الميلادي.

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

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

تعتمد الأداة الدورة الحسابية الفارسية البالغة 2,820 سنة وتجري العملية مباشرة، من دون الرجوع إلى خدمة بعيدة أو ساعة الجهاز. تتضمن النتيجة تاريخاً ميلادياً واضحاً بصيغة شبيهة بمعيار ISO، إلى جانب قيم منفصلة للسنة والشهر واليوم، لتناسب الاستخدام اليدوي والبرامج النصية وعمليات الاستيراد والسجلات التاريخية وحقول التاريخ القابلة للتشغيل البيني.

أدخلوا تاريخاً فارسياً كاملاً

أدخلوا سنة التقويم الهجري الشمسي الفارسي وشهره ويومه في ثلاثة أعداد صحيحة منفصلة. يمكن أن تضم الأشهر من 1 إلى 6 عدد 31 يوماً، وتضم الأشهر من 7 إلى 11 عدداً أقصاه 30 يوماً، أما الشهر 12 ففيه 29 يوماً في السنة العادية أو 30 يوماً في السنة الكبيسة الحسابية. تتحقق الأداة من هذه القواعد قبل بدء التحويل، لذلك ترفض التاريخ المستحيل بدلاً من ترحيله بصمت إلى الشهر التالي. تقبل السنوات من 1 إلى 9999. استخدموا رقم السنة كما هو مكتوب في التقويم الفارسي، من دون إضافة فرق ميلادي ومن دون تحديد وقت أو اختصار لمنطقة زمنية. تعرض النتيجة التاريخ الميلادي المقابل في سلسلة مرتبة على هيئة سنة وشهر ويوم شبيهة بصيغة ISO، وتعرض أيضاً المكونات الثلاثة كأرقام مستقلة. تفيد الحقول المنفصلة في تعبئة أعمدة قواعد البيانات، أو إعداد عرض محلي، أو مقارنة النتيجة بتاريخ منظم آخر. يمثل التحويل يوماً تقويمياً، ولا يمثل لحظة زمنية بعينها داخل ذلك اليوم.

تعرّفوا إلى طريقة التحويل الحسابية

يتبع الحساب نموذج التقويم الفارسي الحسابي القائم على دورة متكررة طولها 2,820 سنة. يحوّل أولاً التاريخ الفارسي المدخل إلى رقم اليوم اليولياني، وهو عدّ متصل للأيام يصلح جسراً محايداً بين أنظمة التقويم. ثم يفكك هذا الرقم وفق دورات التقويم الميلادي البالغة 400 و100 و4 و1 سنة لاستخراج السنة والشهر واليوم الميلادية. تستخدم جميع الخطوات حسابات صحيحة محدودة وثوابت تقويمية ثابتة. لا يشارك التاريخ الحالي، ولا إعداد المنطقة في نظام التشغيل، ولا نطاق المتصفح الزمني، ولا طلب شبكي، ولا جدول تاريخي في تكوين النتيجة. ولهذا تعطي المدخلات نفسها الإجابة ذاتها دائماً عبر API وفي المتصفح. ووصف الطريقة بأنها «حسابية» مهم؛ إذ تستخدم بعض تطبيقات التقويم الفارسي الرصد الفلكي أو الحساب الرسمي للاعتدال، وقد تختلف عن نظام الدورة الثابتة في بعض السنوات البعيدة. تطبق هذه القدرة الاتفاقية الحسابية المعلنة باستمرار، لتتمكنوا من معرفة النموذج الذي أنتج النتيجة وإعادة تطبيقه بصورة مستقلة.

استخدموا النتيجة بأمان في السجلات والبرامج

تعاملوا مع القيمة المعادة باعتبارها تحويلاً بين تاريخين في تقويمين معلومين، لا باعتبارها طابعاً زمنياً بنظام Unix. لا يحدد التاريخ وحده لحظة بعينها حتى يضاف إليه وقت ومنطقة زمنية والقواعد المدنية ذات الصلة. إذا كانت قاعدة البيانات تخزن قيماً للتاريخ فقط، فعادة ما تكون السلسلة الشبيهة بصيغة ISO أنسب حقل مباشر للحفظ. وإذا كان النظام يتطلب طابعاً زمنياً، فأضيفوا الوقت المحلي المقصود والمنطقة الزمنية في خطوة مستقلة وصريحة بدلاً من افتراض منتصف الليل بتوقيت UTC. يمنع هذا الفصل ظهور التاريخ في اليوم السابق أو اللاحق عندما يطبق البرنامج فرقاً زمنياً غير مقصود. يلائم النموذج الحسابي خصوصاً عمليات ترحيل البيانات القابلة للتكرار، ومسارات التحقق، وتحويلات الأرشيف، لأنه لا يتغير مع رصد جديد أو إعداد إقليمي. في المعاملات الرسمية أو القانونية المعاصرة، تحققوا من أن الجهة المستقبلة تعتمد الاتفاقية نفسها، ولا سيما إذا كانت قواعدها تنص على تقويم فارسي رصدي. سعر طلب API هو $0.002، أما نسخة المتصفح فتجري التحويل النقي نفسه محلياً.

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

توحيد السجلات المستوردة

حوّلوا أعمدة التواريخ الفارسية إلى قيم ميلادية منظمة قبل تحميل السجلات في نظام يعتمد التواريخ الميلادية معياراً له.

التحقق من تاريخ مستند

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

إنشاء منطق تقويمي حتمي

استخدموا تحويلاً حسابياً ثابتاً في الاختبارات وعمليات التكامل والأدوات غير المتصلة حين يجب أن تنتج المدخلات المتطابقة نتائج متطابقة.

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

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

تستخدم التقويم الهجري الشمسي الفارسي الحسابي بدورته المتكررة البالغة 2,820 سنة، ولا تستخدم حساباً رصدياً للاعتدال.

هل يعتمد التحويل على منطقتي الزمنية؟

لا. تحوّل الأداة يوماً تقويمياً إلى آخر بحساب ثابت، ولا تستخدم ساعة الجهاز أو المنطقة الزمنية المحلية أو قواعد التوقيت الصيفي.

كيف تعالج الأداة السنوات الفارسية الكبيسة؟

تحددها الدورة الحسابية نفسها البالغة 2,820 سنة والمستخدمة في التحويل. يمكن أن يحتوي الشهر 12 على 30 يوماً في السنة الكبيسة الحسابية.

ماذا يحدث إذا أدخلت تاريخاً مستحيلاً؟

يعيد الطلب خطأ يفيد بأن المدخلات غير صالحة. يجري التحقق من نطاق الشهر وعدد الأيام المسموح به للسنة والشهر المحددين قبل التحويل.

هل النتيجة طابع زمني؟

لا. النتيجة تاريخ في التقويم الميلادي. أضيفوا وقتاً ومنطقة زمنية محددة في خطوة منفصلة إذا كان تطبيقكم يحتاج إلى طابع زمني.

ما تكلفة طلب API؟

سعر طلب API هو $0.002. يتوفر التحويل الحتمي نفسه محلياً في المتصفح أيضاً.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/persian-to-gregorian

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

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

curl -X POST https://api.kit.forhosting.com/date/persian-to-gregorian \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1400,"month":1,"day":1}'

const res = await fetch("https://api.kit.forhosting.com/date/persian-to-gregorian", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 1400,
    "month": 1,
    "day": 1
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/persian-to-gregorian",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 1400,
    "month": 1,
    "day": 1
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/persian-to-gregorian", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":1400,"month":1,"day":1}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":1400,"month":1,"day":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/persian-to-gregorian", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "year": 1400,
  "month": 1,
  "day": 1
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.persian_to_gregorian",
  "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 الكامل ←