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

حساب الأسابيع حتى تاريخ مستقبلي بدقة

من 25 يوليو إلى 10 سبتمبر 2026 توجد 47 يومًا: 6 أسابيع كاملة و5 أيام، أو 6.714286 أسبوعًا بالكسور العشرية. أنت تحدد التاريخين، فلا يتغير العد التنازلي لموعد إطلاق مع مرور الأيام. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

تاريخ المرجع: 2026-07-25
التاريخ المستهدف: 2026-09-10

تحصل على

إجمالي الأيام: 47
الأسابيع الكاملة: 6
الأيام المتبقية: 5
الأسابيع الكسرية: 6.714286

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

أدخلوا تاريخين تقويميين صريحين بصيغة ISO

فعلى سبيل المثال، تُقبل 2026-07-25، بينما تُرفض 2026-7-25 وJuly 25 2026 وأي سلسلة تتضمن وقتا. يمنع اشتراط تمثيل واحد واضح اختلاف ترتيب اليوم والشهر حسب المنطقة من تغيير النتيجة. ولا تكتفي الحاسبة بفحص النمط الظاهر، بل تتحقق أيضا من صحة التاريخ في التقويم الغريغوري الاستباقي.

لذلك يكون 29 فبراير صحيحا في 2024 و2000، وغير صحيح في 2023 و1900؛ أما 31 أبريل فغير صحيح دائما. وتدعم الحاسبة السنوات من 0001 إلى 9999. يجب أن يكون الهدف لاحقا للمرجع بشكل صارم.

ولا تستنتج أي شيء من تاريخ اليوم. إذا شغلتم الطلب نفسه في الشهر المقبل فستحصلون على الإجابة نفسها، لأن التاريخ المرجعي جزء من الطلب ولا يُقرأ من الساعة. تجعل هذه الخاصية الحسابات المحفوظة وسجلات التدقيق والاختبارات والمهام المجدولة قابلة لإعادة الإنتاج.

كما تسهل مراجعة عقد الإدخال: فالتاريخان الظاهران في الطلب هما الأساس الكامل للنتيجة، من دون افتراض خفي بشأن المنطقة الزمنية أو الإعدادات المحلية أو التاريخ الحالي يؤثر في العد.

لماذا تكون النتيجة حتمية وفق UTC

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

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

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

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

خططوا لمحطة ثابتة

قيسوا الأسابيع الكاملة والعشرية من تاريخ تخطيط معتمد حتى تاريخ لاحق للتسليم أو الإطلاق أو النشر.

أنشئوا عدا تنازليا قابلا لإعادة الإنتاج

احفظوا مرجعا صريحا مع الهدف لكي تعيدوا إنشاء التقارير من دون أن تتغير مع تقدم التاريخ الحالي.

قارنوا الفترات المستقبلية

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

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

كيف تُحسب الأسابيع العشرية؟

يُقسم الفرق الدقيق بالأيام التقويمية على سبعة ويُعاد إلى ست منازل عشرية. كما تُعرض الأسابيع الكاملة والأيام المتبقية كل على حدة.

هل يمكن أن يغير التوقيت الصيفي الإجابة؟

لا. تستخدم الخوارزمية حساب أيام غريغورية صحيحة بدلالة UTC، ولا تستخدم الأوقات المحلية أو كائن Date في JavaScript.

كم أسبوعًا من 25 يوليو إلى 10 سبتمبر 2026؟

توجد 47 يومًا، أي 6 أسابيع كاملة و5 أيام، أو 6.714286 أسبوعًا بالكسور العشرية. الرقم العشري يصف المدة كلها، وليس جزءًا من أسبوع يُضاف إلى الأسابيع الستة.

هل يمكن أن يكون التاريخ المستهدف مساويًا للتاريخ المرجعي أو قبله؟

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

هل تُستبعد عطلات نهاية الأسبوع والأعياد من العد؟

لا. يُحتسب كل يوم في التقويم، فمن يوم اثنين إلى الاثنين التالي سبعة أيام بالضبط وأسبوع واحد. يناسب ذلك العد التنازلي ومهل العقود، لا حساب أيام العمل.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/weeks-until-date

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

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

curl -X POST https://api.kit.forhosting.com/date/weeks-until-date \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference_date":"2026-07-25","target_date":"2026-09-10"}'

const res = await fetch("https://api.kit.forhosting.com/date/weeks-until-date", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "reference_date": "2026-07-25",
    "target_date": "2026-09-10"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weeks-until-date",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "reference_date": "2026-07-25",
    "target_date": "2026-09-10"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/weeks-until-date", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"reference_date":"2026-07-25","target_date":"2026-09-10"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"reference_date":"2026-07-25","target_date":"2026-09-10"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weeks-until-date", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "reference_date": "2026-07-25",
  "target_date": "2026-09-10"
}

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

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

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

أدخلوا تاريخين تقويميين صريحين بصيغة ISO

قدموا الحقلين reference_date وtarget_date بالصيغة الثابتة YYYY-MM-DD مع جميع الأصفار البادئة. تؤدي التواريخ المتساوية أو الأهداف السابقة إلى خطأ invalid_input، لأن هذه القدرة تجيب عن سؤال محدد عمدا: كم أسبوعا يفصل تاريخ بدء معلوم عن تاريخ مستقبلي معلوم.

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

لا يعد الحساب طرفي الفترة يومين كاملين. فالانتقال من منتصف ليل إلى منتصف الليل التالي يساوي يوما واحدا، ومن يوم اثنين إلى يوم الاثنين التالي سبعة أيام كاملة وأسبوعا واحدا. ولا تُستبعد عطلات نهاية الأسبوع أو الأعياد. يعامل كل يوم بوصفه يوما مدنيا عاديا، وهو مناسب للعد التنازلي ومحطات المشاريع والنوافذ التعاقدية وغيرها من حسابات الفترات بين التواريخ، وليس لتقاويم أيام العمل. تبدأ النتيجة بالحقل total_days، وهو عدد الفواصل من منتصف الليل إلى منتصف الليل بين المرجع والهدف. يمثل whole_weeks خارج القسمة الصحيح عند قسمة ذلك العدد على سبعة، ويمثل remaining_days الباقي من صفر إلى ستة. أما fractional_weeks فيعبر عن الفترة كلها بالأسابيع من خلال قسمة total_days على سبعة وتقريب رقم JSON المعروض إلى ست منازل عشرية. لذلك تحتوي فترة قدرها 47 يوما على 6 أسابيع كاملة و5 أيام متبقية و6.714286 أسبوعا عشريا. تصف هذه الحقول المدة نفسها بطرق متكاملة؛ فلا يمثل fractional_weeks أسبوعا جزئيا إضافيا ينبغي جمعه مع whole_weeks. استخدموا whole_weeks عندما لا تُحتسب إلا كتل الأيام السبعة المكتملة، وremaining_days عندما يحتاج الجدول إلى الأيام التقويمية المتبقية، وfractional_weeks للتقديرات والرسوم والمعدلات والمقارنات التي تقبل الكسور العشرية.

لماذا تكون النتيجة حتمية وفق UTC

لذلك تنتج المدخلات المتطابقة ملف JSON نفسه في المتصفح أو worker طرفي أو حزمة اختبارات أو إعادة تشغيل لاحقة. يمكنكم تجربة الحساب مجانا في المتصفح، بينما يستخدم كل عنصر API ناجح السعر الأساسي المنشور وقدره $0.002.

أسئلة تقنية

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

لا. يجب أن تقدموا reference_date وtarget_date، ولذلك لا يعتمد الحساب أبدا على الساعة الحالية.

هل يجب أن يكون التاريخ الهدف لاحقا؟

نعم. تُرفض التواريخ المتساوية والأهداف السابقة للمرجع مع invalid_input، لأن هذه القدرة تقيس الوقت حتى هدف مستقبلي.

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

يستخدم كل عنصر ناجح السعر الأساسي المنشور وقدره $0.002. وتتوفر حاسبة المتصفح من دون رسوم API.

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

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

مثال محلول

أدخلوا تاريخين تقويميين صريحين بصيغة ISO

لماذا تكون النتيجة حتمية وفق UTC

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

خططوا لمحطة ثابتة

أنشئوا عدا تنازليا قابلا لإعادة الإنتاج

قارنوا الفترات المستقبلية

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

أدخلوا تاريخين تقويميين صريحين بصيغة ISO

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

لماذا تكون النتيجة حتمية وفق UTC

أسئلة تقنية

شكرًا