الأيام المنقضية من السنة
حتى 15 مارس 2024 انقضى 74 يومًا كاملًا من السنة، فهو إذن اليوم 75 من سنة كبيسة. أدخل تاريخًا لترى عدد الأيام التي مضت منذ 1 يناير، الذي يُحتسب صفرًا. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- التاريخ
- 2024-03-15
- السنة
- 2,024
- الشهر
- 3
- اليوم
- 15
- اليوم من السنة
- 75
تأخذ حاسبة الأيام المنقضية من السنة هذه تاريخًا ميلاديًّا واحدًا بصيغة صارمة YYYY-MM-DD وتُرجع عدد الأيام الكاملة التي مضت بالفعل منذ 1 يناير من السنة نفسها. من الفحوص الكلاسيكية: 2024-01-01 يُعطي صفر أيام منقضية، و2024-03-15 يُعطي أربعة وسبعين يومًا في سنة كبيسة، و2023-12-31 يُعطي ثلاثمئة وأربعة وستين يومًا في سنة عادية. يستخدم المحرك حسابًا ميلاديًّا حتميًّا استرجاعيًّا فقط: يتحقّق من أن اليوم موجود فعلًا على التقويم، ويجمع أطوال الأشهر السابقة للشهر المُعطى، ويضيف يوم الشهر، ثم يطرح واحدًا كي يكون 1 يناير صفرًا لا واحدًا. لا نداءات شبكة، ولا أخذ عيّنات عشوائية، ولا اعتماد على ساعة الجهاز أو كائن Date.
ماذا تعني الأيام المنقضية وماذا تحتوي الاستجابة
الأيام المنقضية منذ 1 يناير تجيب عن سؤال مختلف عن اليوم الترتيبي من السنة الذي يُطبَع أحيانًا من واحد إلى ثلاثمئة وستة وستين، وعن مسافة الأيام الكاملة بين تاريخَين عشوائيَّين، وعن حاسبات أيام العمل أو العمر. هنا تبدأ ساعة السنة من صفر في 1 يناير: بحلول 15 مارس في سنة كبيسة يكون قد انتهى أربعة وسبعون يومًا كاملًا بالفعل، واليوم التقويمي نفسه هو اليوم رقم خمسة وسبعين من السنة.
من الحالات المرفوضة: غياب حقل date، أو صيغ خاطئة مثل 2024/03/15، أو أشهر مستحيلة، أو أيام غير موجودة مثل 2023-02-29، وسنوات خارج نطاق واحد إلى 9999. إن احتجت المسافة بين تاريخين، أو أرقام أسابيع ISO، أو تنقّل طرح الأيام، أو التحليل متعدّد الصيغ، فاستخدم الأدوات المخصّصة لذلك؛ هذه الصفحة تجيب فقط عن عدد الأيام الكاملة التي مضت منذ 1 يناير من السنة التي يقع فيها التاريخ المُعطى.
أين يفيد حساب تقدّم السنة في التخطيط والتقارير والبرمجيات
تقيس فرق العمليات والمنتجات الأيام المنقضية من السنة حين تعرض لوحة قيادة التقدّم منذ بداية السنة، أو حين تشير سياسة إلى اليوم التقويمي رقم N بعد رأس السنة، أو حين تُعرَّف نافذة احتفاظ أو تقرير نسبة إلى 1 يناير لا إلى ساعة حيّة. يستخدم المحلّلون الذين يبنون أفواج سنوية الرقم نفسه لوسم مواضع المراقبة داخل السنة دون أخطاء الفارق الواحد عند نهايات الأشهر والأيام الكبيسة التي تظهر عند طرح الأرقام التسلسلية لجداول البيانات يدويًّا.
يستدعي المطوّرون العقد من النصوص البرمجية لتوليد متجهات اختبار حتمية لأشرطة التقدّم، أو لتأكيد حقول اليوم من السنة في حمولات التحليلات، أو لتلبية متطلّبات منتج تتطلّب إزاحة تقويمية بحتة دون انحراف منطقة زمنية من كائن Date في الجهاز. يستخدم المعلّمون وكاتبو المعايير الأداة لعرض أن 2024-02-29 هو اليوم الستّون من سنة كبيسة بينما طول فبراير نفسه غير موجود في 2023، دون الاعتماد على تطبيقات حاسبة مبهمة تدرج بصمت أوقات اليوم.
اقرنها بمساعدات الأيام بين تاريخين أو أسبوع ISO أو تحويل الحقبة الزمنية حين تحتاج خطوات تقويمية ذات صلة، وبأدوات حتمية مجانية أخرى عند بناء مختبر صغير من أدوات التاريخ.
حالات الاستخدام
عروض تقدّم منذ بداية السنة
اعرض عدد الأيام التقويمية الكاملة التي مضت منذ 1 يناير للوحات القيادة وجداول أهداف الأداء وأشرطة التقدّم السنوية دون انحراف منطقة زمنية.
فحوص اليوم من السنة في السنوات الكبيسة
تحقّق من المواضع الترتيبية والمنقضية التي تعبر 29 فبراير في السنوات الكبيسة فقط، بما في ذلك 31 ديسمبر عند 364 أو 365 يومًا منقضيًا.
الأسئلة الشائعة
هل هذا مثل الأيام بين تاريخين؟
لا. تقيس هذه الأداة فقط المسافة من 1 يناير للسنة نفسها. لزوج تواريخ عشوائي، استخدم حاسبة الأيام بين تاريخين.
هل تُدرَج أوقات اليوم أو المناطق الزمنية؟
لا. تعدّ هذه الأداة أيامًا تقويمية ميلادية بحتة فقط. لا تحلّل الأوقات أو الإزاحات أو ساعة الجهاز.
لماذا يُحتسب 1 يناير صفرًا؟
لأن العدّ يُظهر الأيام المكتملة، وفي 1 يناير لم يكتمل أي يوم بعد. ورقم اليوم نفسه أكبر دائمًا بواحد: ففي 31 ديسمبر 2023 تكون قد انقضت 364 يومًا.
كيف تغيّر السنة الكبيسة العدد؟
ابتداءً من 29 فبراير يتقدم كل تاريخ يومًا واحدًا، لأن هذا اليوم لا يوجد إلا في السنوات الكبيسة. وفي سنة 2024 يكون 29 فبراير نفسه هو اليوم 60 من السنة.
ما صيغ التاريخ التي يمكنني استخدامها؟
السنة والشهر واليوم مفصولة بشرطات فقط، مثل 2024-03-15. ولا تُقبل صيغ مثل 2024/03/15 ولا أسماء الشهور ولا التواريخ المصحوبة بوقت، وتُحذف المسافات في البداية والنهاية.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/date/days-elapsed-year \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15"}'const res = await fetch("https://api.kit.forhosting.com/date/days-elapsed-year", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/days-elapsed-year",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/days-elapsed-year", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/days-elapsed-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-15"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.days_elapsed_year",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
year_min | 1 |
year_max | 9999 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
استخدمها مجانًا في المتصفح للتخطيط ومتتبّعات التقدّم والواجبات المدرسية، أو استدعِ واجهة برمجة التطبيقات مقابل $0.002 لكل طلب ناجح حين تحتاج بيانات ثابتة ليوم من السنة قابلة لإعادة الإنتاج في التكامل المستمر أو خطوط أنابيب التقارير أو ميزات المنتج.
ماذا تعني الأيام المنقضية وماذا تحتوي الاستجابة
تزوّد الأداة بتاريخ واحد كسلسلة صارمة YYYY-MM-DD؛ تتحقّق الحاسبة من أن اليوم يوم تقويمي ميلادي حقيقي — 29 فبراير فقط في السنوات الكبيسة، وثلاثون يومًا في أبريل، ولا يوم اثنين وثلاثين مطلقًا — ثم تُرجع سلسلة التاريخ المُطبَّعة، ومكوّنات السنة والشهر واليوم، وday_of_year كترتيب يبدأ من واحد، وdays_elapsed كـ day_of_year ناقص واحد، وis_leap كقيمة منطقية، وdays_in_year كثلاثمئة وخمسة وستين أو ثلاثمئة وستة وستين، وتذكيرًا مختصرًا بالصيغة. لا توجد بداية أسبوع تعتمد على المنطقة، ولا تقريب عائم لطول اليوم، ولا اعتماد على كائن Date في الجهاز: فإما أن يكون الإدخال يومًا تقويميًّا حقيقيًّا ضمن نافذة السنة المدعومة ويكون العدّ المنقضي محدَّدًا تمامًا، أو يفشل الطلب برمز invalid_input.
كيف يُقرأ التاريخ وكيف يبقى العدّ قابلًا لإعادة الإنتاج
يجب أن تطابق السلسلة أربعة أرقام، ثم شرطة، ثم رقمَين، ثم شرطة أخرى، ثم رقمَين؛ تُزال المسافات البادئة أو اللاحقة، لكن التواريخ الجزئية أو يوم السنة الترتيبي وحده أو أسماء الأشهر أو الأوقات المضمّنة لا تُوسَّع هنا. بعد التحليل، يجب أن تقع السنة بين 1 و9999، والشهر بين 1 و12، واليوم بين 1 والطول الحقيقي لذلك الشهر في تلك السنة، مع اتّباع السنوات الكبيسة قاعدة الميلادي: القابلية للقسمة على أربعة إلا سنوات القرن غير القابلة للقسمة على أربعمئة. الحقل المفضّل هو date، لكن الأسماء البديلة iso_date وd وvalue وday مقبولة كي تستطيع جداول البيانات وسلاسل الاستعلام والنماذج المُكتَّبة إعادة استخدام العقد نفسه دون إعادة تسمية الأعمدة. داخليًّا يجمع المحرك أيام كل شهر كامل قبل الشهر المُعطى، ويضيف يوم الشهر للحصول على day_of_year، ثم يضبط days_elapsed على day_of_year ناقص واحد — حساب أعداد صحيحة بحت مستقر بتًّا للبت عبر بيئات التشغيل. 1 يناير يُعطي دائمًا صفرًا منقضيًا وday_of_year واحدًا؛ و31 ديسمبر يُعطي ثلاثمئة وأربعة وستين يومًا منقضيًا في سنة عادية وثلاثمئة وخمسة وستين في سنة كبيسة. اقرن التشغيل المجاني في المتصفح بالواجهة البرمجية المدفوعة حين تحتاج رقم اليوم المنقضي نفسه داخل خط أنابيب آلي.
أين يفيد حساب تقدّم السنة في التخطيط والتقارير والبرمجيات
تعمل هذه الصفحة كليًّا داخل متصفحك؛ وعبر الواجهة البرمجية يكلّف كل استعلام ناجح $0.002، ولا تُحتسب رسوم على التحقّق الفاشل، ولا يُحفَظ شيء بعد إعادة الاستجابة. هذا الفصل — استكشاف تفاعلي مجاني وواجهة برمجية مدفوعة مطابقة له — يواكب بقية كتالوج الفئة A في KIT، ويتيح لك الانتقال من فحص لمرّة واحدة إلى خط أنابيب دون أن تتغيّر النتيجة الرياضية.
حالات التكامل
بيانات اختبار حتمية
أنشئ أرقام days_elapsed وday_of_year قابلة لإعادة الإنتاج لاختبارات الوحدة وفحوص الخصائص وتأكيدات التكامل المستمر دون الاعتماد على Date.
أسئلة تقنية
كم تكلّف حاسبة الأيام المنقضية من السنة؟
هي مجانية في متصفحك على هذه الصفحة. عبر الواجهة البرمجية يكلّف الطلب الناجح $0.002؛ ولا تُحتسب رسوم على المدخلات غير الصالحة.
كيف يُعرَّف days_elapsed؟
days_elapsed هو day_of_year ناقص واحد. 1 يناير يُعطي 0؛ و2 يناير يُعطي 1. day_of_year هو الترتيب الذي يبدأ من واحد (1 في 1 يناير).
ماذا يحدث مع السنوات الكبيسة والتواريخ غير الصالحة؟
تُتحقَّق أطوال الأشهر والأيام الكبيسة. فمثلًا تُقبَل 2024-02-29 بينما تُرفَض 2023-02-29 برمز invalid_input.