ForHosting KIT · التواريخ والوقت

محول التاريخ الترتيبي ISO

يوم 15 مارس 2024 هو اليوم 75 من السنة، ويُكتب 2024-075 بصيغة التاريخ الترتيبي ISO. حوّل أي تاريخ إلى رقم يومه في السنة وبالعكس، مع مراعاة السنوات الكبيسة. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

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

مثال محلول

إذا أدخلت

التاريخ: 2024-03-15

تحصل على

السنة: 2,024
الشهر: 3
اليوم: 15
رقم اليوم في السنة: 75

يحدد المعيار ISO 8601 صيغتين مدنيتين للتاريخ تتقاسمان السنة نفسها لكنهما تعبّران عن اليوم بطريقتين مختلفتين: الثلاثية المألوفة سنة-شهر-يوم، والصيغة الترتيبية التي تتكون من السنة مضافًا إليها رقم اليوم داخل السنة من 1 إلى 365 أو 366. وغالبًا ما تحتاج خطوط معالجة البيانات التي تخزن أرقام الأيام المتسلسلة، ومجموعات البيانات العلمية، وبيانات الشحن اللوجستية، وسجلات الامتثال، إلى جسر بلا فقد بين هاتين الصيغتين دون الاعتماد على كائنات Date في لغة المضيف أو على خصوصيات المناطق الزمنية.

الصيغة التقويمية والصيغة الترتيبية ومتى يُستخدم كل اتجاه

يُكتب تاريخ ISO التقويمي على هيئة سنة من أربعة أرقام وشهر من رقمين ويوم من رقمين تفصل بينها شرطات، مثل 2024-03-15 للخامس عشر من مارس. أما تاريخ ISO الترتيبي فيستخدم السنة نفسها تليها شرطة ثم رقم اليوم داخل السنة من ثلاثة أرقام، يمتد من 001 في أول يناير حتى 365 في السنة البسيطة أو 366 في السنة الكبيسة الغريغورية. حوّل من التقويمي إلى الترتيبي عندما تحتاج إلى فهرس أيام مضغوط للسنة، أو أسماء ملفات متسلسلة، أو تحليلات تتعامل مع كل يوم كمحور صحيح.

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

السنوات الكبيسة وطول السنة وأخطاء رقم اليوم غير الصالح

وفق القواعد الغريغورية تكون السنة كبيسة إذا كانت تقبل القسمة على أربعة، باستثناء سنوات القرون التي يجب أن تقبل القسمة على أربعمئة أيضًا. تحتوي السنوات الكبيسة على 366 يومًا وفبراير من 29 يومًا؛ أما السنوات البسيطة فتحتوي على 365 يومًا وفبراير من 28 يومًا. لهذا كانت سنة 2000 كبيسة، وسنة 1900 ليست كذلك، وسنة 2024 كبيسة بينما سنة 2023 ليست كذلك.

وبالمثل تُرفض المدخلات التقويمية التي تتضمن يومًا مستحيلًا للشهر، مثل 31 أبريل أو 29 فبراير في سنة غير كبيسة.

متى تستخدم التاريخ الترتيبي وما حدوده

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

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

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

فهارس الأيام العلمية وبيانات المستشعرات

تخزن خطوط معالجة الأبحاث العينات على هيئة سنة ورقم يوم داخلها؛ حوّلها إلى تواريخ تقويمية للتقارير وإلى الصيغة الترتيبية للأرشيف المضغوط دون انحراف كائن Date في المضيف.

تسمية ملفات اللوجستيات والدُفعات

تسمّي المستودعات ومهام الدُفعات الملفات بتسلسلات YYYY-DDD وتحتاج إلى جسر موثوق نحو تسميات YYYY-MM-DD المقروءة في الواجهات والفواتير.

التحقق من التغذيات الترتيبية

ترفض التكاملات التي تستقبل رقم اليوم داخل السنة من الشركاء القيم الفائضة مثل اليوم 366 في سنة غير كبيسة قبل دخولها أنظمة الفوترة أو الجدولة.

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

ماذا يحدث إذا تجاوز اليوم الترتيبي طول السنة؟

فمثلًا اليوم 366 في سنة غير كبيسة، أو أي يوم فوق 366، يُرفض ولا يُحاسَب عليه.

ما التاريخ الترتيبي ليوم 15 مارس 2024؟

هو 2024-075، لأن 15 مارس هو اليوم 75 من عام 2024. تأتي السنة أولًا ثم عدد من ثلاث خانات يبدأ من 001 في 1 يناير.

لماذا تغيّر السنة الكبيسة أرقام الأيام بعد فبراير؟

تضيف السنة الكبيسة يوم 29 فبراير، فيحصل كل تاريخ من 1 مارس فصاعدًا على رقم أكبر بواحد مما في السنة العادية. ولهذا ينتهي العد عند 366 بدل 365.

هل يمكنني تحويل رقم اليوم في السنة إلى تاريخ عادي؟

نعم. أدخل السنة ورقم اليوم، مثل 2024-075، فتحصل على الشهر واليوم، وهنا 15 مارس 2024. ويُرفض أي رقم يتجاوز عدد أيام تلك السنة.

فيمَ يُستخدم التاريخ الترتيبي؟

في تسمية الملفات المتتابعة في المستودعات وعمليات الدُّفعات، وفي التحليلات التي تعامل كل يوم كرقم. وإذا أرسل شريك رقم اليوم فقط، تعيده إلى تاريخ مقروء للفواتير والشاشات.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/ordinal-date

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

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

curl -X POST https://api.kit.forhosting.com/date/ordinal-date \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'

const res = await fetch("https://api.kit.forhosting.com/date/ordinal-date", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-03-15",
    "calendar": "valor-ejemplo"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/ordinal-date",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-03-15",
    "calendar": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/ordinal-date", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "date": "2024-03-15",
  "calendar": "valor-ejemplo"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.ordinal_date",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

يحوّل هذا المحول التاريخ YYYY-MM-DD إلى YYYY-DDD وفي الاتجاه المعاكس بحساب كبس غريغوري حتمي، ويرفض قيم day_of_year التي تتجاوز الطول الحقيقي للسنة، ويعيد التمثيلين معًا مع حقول منظمة في حمولة JSON واحدة.

الصيغة التقويمية والصيغة الترتيبية ومتى يُستخدم كل اتجاه

أرسل إما سلسلة تاريخ، أو سلسلة ترتيبية، أو سنة وشهرًا ويومًا، أو سنة مع day_of_year؛ وتُقبل الأسماء المستعارة مثل calendar_date وordinal_date وdoy وddd عندما تكون موثقة. لا تخلط وضعين متعاكسين في طلب واحد، فالمحرك يرفض الحمولات الملتبسة بـ invalid_input ليصحح المتصل جسم الطلب بدل تخمين أي حقل يغلب. المدخلات المتطابقة تعطي دائمًا JSON متطابقًا لأن المسار لا يقرأ ساعة الحائط ولا الإعدادات المحلية ولا الشبكة.

السنوات الكبيسة وطول السنة وأخطاء رقم اليوم غير الصالح

وعند التحويل من الترتيبي إلى التقويمي، يفشل أي رقم يوم داخل السنة أقل من واحد أو أكبر من طول السنة بـ invalid_input مع رسالة توضح عدد أيام تلك السنة الفعلي؛ فمثلًا اليوم 366 في سنة 2023 يتجاوز طول السنة. وتعيد الاستجابة الحقلين is_leap_year وdays_in_year حتى تعرض لوحات المتابعة حقائق السنة دون استدعاء ثانٍ.

استخدام API والتسعير وسير العمل والحدود العملية

أرسل جسم JSON بوضع واحد واضح: date بصيغة YYYY-MM-DD، أو ordinal بصيغة YYYY-DDD، أو سنة وشهرًا ويومًا منظمة، أو سنة وday_of_year منظمين. عند النجاح تتضمن الحمولة calendar_date وordinal_date والمكونات الرقمية، وdirection تساوي to_ordinal أو to_calendar، وcalendar تساوي gregorian، وmethod تساوي iso_ordinal_date لأدوات التوجيه والاختبارات التي تتفرع على التسميات. واستخدم API المدفوعة مسبقًا عندما تحتاج منصة لوجستية أو خط معالجة علمي أو أرشيف امتثال أو SDK إلى عقد مستقر برصيد KIT بسعر $0.002 عن كل عنصر ناجح؛ فإخفاقات التحقق لا تستهلك الرصيد أبدًا بعد أن يرفض المحرك الطلب.

أسئلة تقنية

كيف أحوّل YYYY-MM-DD إلى تاريخ ISO ترتيبي؟

أرسل JSON مع date مضبوطًا على سلسلة تقويمية مثل 2024-03-15، أو أرسل السنة والشهر واليوم. تتضمن الاستجابة ordinal_date بصيغة YYYY-DDD وday_of_year كعدد صحيح.

كيف أعيد تحويل YYYY-DDD إلى تاريخ تقويمي؟

أرسل ordinal بالشكل 2024-075، أو أرسل السنة مع day_of_year. تعيد الاستجابة calendar_date بصيغة YYYY-MM-DD مع تعبئة الشهر واليوم.

هل محول التاريخ الترتيبي ISO مجاني؟

أداة المتصفح تعمل مجانًا على جهازك. تستخدم استدعاءات API رصيد KIT المدفوع مسبقًا بسعر $0.002 عن كل عنصر ناجح؛ وإخفاقات التحقق لا تُحاسَب.

هل يستخدم هذا كائن Date في JavaScript أو المناطق الزمنية؟

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

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

شغّل الأداة مجانًا

مثال محلول

الصيغة التقويمية والصيغة الترتيبية ومتى يُستخدم كل اتجاه

السنوات الكبيسة وطول السنة وأخطاء رقم اليوم غير الصالح

متى تستخدم التاريخ الترتيبي وما حدوده

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

فهارس الأيام العلمية وبيانات المستشعرات

تسمية ملفات اللوجستيات والدُفعات

التحقق من التغذيات الترتيبية

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

الصيغة التقويمية والصيغة الترتيبية ومتى يُستخدم كل اتجاه

السنوات الكبيسة وطول السنة وأخطاء رقم اليوم غير الصالح

استخدام API والتسعير وسير العمل والحدود العملية

أسئلة تقنية

شكرًا