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

حاسبة يوم السنة

يوم 1 مارس 2024 هو اليوم 61 من السنة، وكان سيكون اليوم 60 في سنة عادية لأن 2024 سنة كبيسة. أدخل تاريخًا لتعرف موضعه في السنة وطول السنة والأيام المتبقية حتى 31 ديسمبر. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

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

تحصل على

السنة: 2,024
الشهر: 3
اليوم: 1
يوم السنة: 61

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

كيف يُحسب يوم السنة من تاريخ ISO

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

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

المجموع هو الترتيبي ليوم السنة: الأول من يناير دائمًا واحد، والأول من مارس واحد وستون في سنة كبيسة وستون في سنة عادية، والحادي والثلاثون من ديسمبر ثلاثمئة وستة وستون أو ثلاثمئة وخمسة وستون.

ما ترسله وما تستقبله

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

اربط نموذج المتصفح المجاني للواجبات والفحوص السريعة، ثم استدعِ العقد نفسه من النصوص البرمجية عندما تحتاج تحويلًا جماعيًا لقوائم الأحداث أو ثوابت الانحدار.

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

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

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

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

المحاذاة العلمية والموسمية

اسقط سلاسل المناخ أو الزراعة متعددة السنوات على محور مشترك 1–366، مع إزاحة صحيحة من مارس فصاعدًا بعد أيام الكبيسة.

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

ما هو يوم السنة؟

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

هل تتعامل مع السنوات الكبيسة؟

نعم. تُطبَّق قواعد الكبيسة الميلادية: القسمة على 4، باستثناء القرون التي يجب أن تقبل القسمة على 400. يُقبل 29 فبراير فقط في السنوات الكبيسة ويزيح الأشهر اللاحقة يومًا واحدًا.

ما تنسيق التاريخ المطلوب؟

ISO صارم YYYY-MM-DD بسنة من أربعة أرقام وشهر ويوم من رقمين. تُرفض قيم مثل 2024-3-1 أو 2024/03/01 حتى يتفق كل عميل على السلسلة نفسها.

ماذا يحدث مع تاريخ غير صالح مثل 2023-02-29؟

توضح رسالة الخطأ أن اليوم غير صالح لتلك السنة وذلك الشهر.

فيمَ يُستخدم رقم اليوم في السنة؟

المجلدات وملفات البيانات التي تحمل رقم اليوم تترتب زمنيًا من تلقاء نفسها. وفي سلاسل المناخ والزراعة تتطابق المواسم بين السنوات، ويمكن متابعة أهداف السنة كنسبة مما مضى منها.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/day-of-year

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

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

curl -X POST https://api.kit.forhosting.com/date/day-of-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-01"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/day-of-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-03-01"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2024-03-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/day-of-year", 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-01"
}

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

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

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

كيف يُحسب يوم السنة من تاريخ ISO

المسار بأكمله حساب صحيح حتمي بلا بذور عشوائية، ولا طوابع زمنية لساعة الحائط، ولا كائن Date في JavaScript، ولا استدعاءات شبكة، فتنتج المدخلات المتطابقة دائمًا JSON متطابقًا.

ما ترسله وما تستقبله

الحقول الناقصة والقيم غير السلاسل والسلاسل التي لا تطابق نمط الأرقام أربعة-اثنين-اثنين تفشل بـ invalid_input ولا تُحسب. عند النجاح تعيد الاستجابة سلسلة التاريخ المعيارية، ومكوّنات السنة والشهر واليوم العددية، والعدد الصحيح day_of_year من واحد إلى ثلاثمئة وخمسة وستين أو ثلاثمئة وستة وستين، وعلامة منطقية is_leap_year، وdays_in_year كثلاثمئة وخمسة وستين أو ثلاثمئة وستة وستين، وremaining_days حتى آخر يوم من تلك السنة، وسلسلة formula قصيرة توثّق قاعدة الكبيسة. تسعير استدعاءات API الناجحة هو الأساس المنشور $0.002 لكل عنصر؛ إخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقًا.

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

يريد مؤلفو المناهج الذين يعلّمون قواعد الكبيسة الميلادية مرجعًا موثوقًا يرفض التواريخ المستحيلة ويعيد الأرقام نفسها في ودجة المتصفح وواجهة API. لأن هذه القدرة محرك parse نقي، تسعير API هو الأساس المنشور $0.002 لكل عنصر ناجح والتحقق الفاشل لا يستهلك الرصيد.

حالات التكامل

متتبعات التقدّم والأهداف السنوية

حوّل تاريخ ISO لليوم إلى day_of_year وremaining_days لتعرض لوحات المعلومات نسبة اكتمال السنة دون الاعتماد على مناطق زمنية المضيف.

تسميات الدفعات وأقسام السجلات

اختم الملفات وأقسام المستودع برقم يوم ترتيبي مستقر مشتق من مدخلات YYYY-MM-DD صارمة وinvalid_input واضح عند التواريخ السيئة.

أسئلة تقنية

كم التكلفة؟

أداة المتصفح مجانية وتعمل محليًا. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بـ $0.002 لكل عنصر ناجح؛ الإدخال غير الصالح لا يُحسب.

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

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

مثال محلول

كيف يُحسب يوم السنة من تاريخ ISO

ما ترسله وما تستقبله

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

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

المحاذاة العلمية والموسمية

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

كيف يُحسب يوم السنة من تاريخ ISO

ما ترسله وما تستقبله

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

حالات التكامل

متتبعات التقدّم والأهداف السنوية

تسميات الدفعات وأقسام السجلات

أسئلة تقنية

شكرًا