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

تحويل التاريخ إلى سنة عشرية

يحوّل محول السنة الكسرية تاريخاً ووقتاً صريحين بتنسيق ISO 8601 إلى سنة عشرية مثل 2024.5.

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

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

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

ما الذي تمثله السنة العشرية الكسرية

تجمع السنة الكسرية في رقم واحد اسم السنة التقويمية وموضعاً متصلاً داخلها. يمثل الجزء الصحيح سنة UTC التقويمية التي تقع فيها اللحظة المدخلة. أما الجزء العشري فهو المدة الدقيقة المنقضية منذ 1 يناير في 00:00:00.000 UTC مقسومة على مدة السنة كاملة. لذلك تساوي أول لحظة من 2024 القيمة 2024 تماماً، ويساوي منتصف تلك السنة الكبيسة 2024.5. تقترب النتيجة من 2025 قرب نهاية 2024 من دون أن تبلغها؛ فأول لحظة من 2025 تنتمي إلى السنة الجديدة وتساوي 2025 تماماً. يعتمد هذا التعريف على المدة، لا على عد صفحات التقويم أو التواريخ المكتملة أو الأشهر أو الأرباع أو أيام العمل. وتسهم الساعات والدقائق والثواني والمللي ثانية بنسبها الفعلية. تتضمن الاستجابة التاريخ والوقت بعد توحيدهما إلى UTC، وسنة UTC المختارة، والمللي ثانية المنقضية، وإجمالي مللي ثانية السنة. وبذلك يمكنكم فحص كل عنصر أو التحقق من الحساب بصورة مستقلة عندما تحتاجون إلى إحداثي سنوي مدمج بدلاً من طابع زمني، مع الاحتفاظ بهوية السنة التقويمية.

أثر توحيد UTC والسنوات الكبيسة في النتيجة

يجب أن يحدد الإدخال لحظة حقيقية وينتهي بالحرف Z أو بإزاحة رقمية مثل +05:30 أو -04:00. يطبق المحول هذه الإزاحة قبل اختيار السنة وقياس الزمن المنقضي. ويهم هذا الترتيب عند حدود السنوات: فقد يكون الوقت المحلي بعد منتصف ليل 1 يناير بقليل ما زال 31 ديسمبر بتوقيت UTC، بينما قد يكون وقت محلي متأخر في ديسمبر قد صار 1 يناير بتوقيت UTC. بعد ذلك تطبق قواعد السنة الكبيسة الغريغورية على سنة UTC الناتجة. تضم السنوات القابلة للقسمة على أربعة 366 يوماً، باستثناء السنوات المئوية غير القابلة للقسمة على أربعمئة؛ أما غيرها فيضم 365 يوماً. وهكذا يتغير المقام حسب السنة المختارة، مما يمنع الانحراف الناجم عن افتراض مدة ثابتة قدرها 365 يوماً. يمثل كل يوم مدني 86,400 ثانية بالضبط، ولا تضاف الثواني الكبيسة. يرفض المحلل الإزاحة المفقودة أو المشوهة، والتواريخ المستحيلة، واليوم الكبيس في سنة عادية، والساعات فوق 23، والدقائق أو الثواني فوق 59، وأكثر من ثلاثة أرقام للمللي ثانية. الرفض أفضل من تخمين المنطقة الزمنية أو إصلاح الطابع الزمني، لأن التخمين يفسد قابلية إعادة النتيجة بين الأنظمة والمتصفحات.

استخدام السنوات الكسرية في البيانات والعلوم

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

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

توحيد مشاهدات السلاسل الزمنية

حوّلوا الطوابع الزمنية الصريحة ذات الإزاحة إلى إحداثيات سنة عشرية متصلة للرسم والانحدار والاستيفاء.

إعادة محاور التقارير العلمية

أنشئوا سنوات كسرية قابلة للتدقيق وفق اصطلاح موثق لمدة السنة الغريغورية بتوقيت UTC.

إنشاء اختبارات تاريخ حتمية

اختبروا السنوات الكبيسة وعبور المناطق الزمنية من دون قراءة وقت النظام الحالي أو محاكاته.

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

ما الصيغة المستخدمة؟

النتيجة هي سنة UTC مضافاً إليها مللي ثانية الزمن المنقضي منذ بدايتها مقسومة على إجمالي مللي ثانية سنة UTC نفسها.

لماذا يجب أن يتضمن التاريخ منطقة زمنية؟

لأن النص من دون Z أو إزاحة رقمية لا يحدد لحظة واحدة، وقد يعطي نتائج مختلفة باختلاف بيئة التشغيل.

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

تستخدم سنة UTC المعنية 366 يوماً وفق القواعد الغريغورية، وتستخدم 365 يوماً في الحالات الأخرى.

هل تدخل الثواني الكبيسة في الحساب؟

لا. يعامل كل يوم مدني على أنه 86,400 ثانية بالضبط للحصول على نتيجة حتمية قابلة للنقل.

ما كلفة الحساب عبر API؟

يكلف كل طلب API ناجح $0.002. ويمكن تشغيل الحساب النقي محلياً في المتصفح أيضاً.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/fractional-year

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

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

curl -X POST https://api.kit.forhosting.com/date/fractional-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2024-07-02T00:00:00Z"}'

const res = await fetch("https://api.kit.forhosting.com/date/fractional-year", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2024-07-02T00:00:00Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/fractional-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2024-07-02T00:00:00Z"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/fractional-year", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2024-07-02T00:00:00Z"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2024-07-02T00:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/fractional-year", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "datetime": "2024-07-02T00:00:00Z"
}

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

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