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

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

تعرض حاسبة الأيام حتى عيد الحب عدد الأيام التقويمية المتبقية من التاريخ الذي تقدمونه إلى 14 فبراير.

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

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

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

أدخلوا تاريخ بداية العد التنازلي

قدموا تاريخا من التقويم الميلادي بالصيغة الدقيقة YYYY-MM-DD، مثل 2026-02-01. تأتي السنة أولا، ثم الشهر واليوم برقمين لكل منهما. تمنع هذه البنية الصارمة الالتباس؛ فقد يعني 03-04 يوم 4 مارس أو 3 أبريل بحسب المنطقة، بينما لا يحمل 2026-03-04 إلا معنى واحدا. تتحقق الحاسبة من التاريخ كاملا، لا من شكله فقط. وهي ترفض القيم المستحيلة مثل 30 فبراير، أو الشهر 13، أو اليوم صفر، أو 29 فبراير في سنة غير كبيسة. تبدأ السنوات من 0001، ولا يقبل نص إضافي أو طابع زمني أو صيغة مختصرة. تجعل هذه الدقة النتيجة مناسبة للأتمتة وللفحص السريع معا. اختاروا التاريخ الذي يبدأ فيه التخطيط، وليس بالضرورة تاريخ إرسال الطلب. ولأن القيمة المقدمة هي المرجع الزمني الوحيد، فإن الإدخال نفسه ينتج النتيجة نفسها دائما، بصرف النظر عن ساعة الخادم أو منطقة المتصفح الزمنية أو التوقيت الصيفي أو الموقع.

افهموا كيفية اختيار عيد الحب القادم

يوافق عيد الحب 14 فبراير في التقويم الميلادي. إذا سبق تاريخ الإدخال هذا اليوم، يكون الهدف 14 فبراير من السنة نفسها. وإذا وافقه تماما، تكون النتيجة صفرا لعدم بقاء أي يوم تقويمي قبل المناسبة. وإذا جاء بعده، تختار الحاسبة 14 فبراير من السنة التالية. تحافظ هذه القاعدة على نتيجة بين صفر و365 يوما، وتوافق المعنى المعتاد للعد التنازلي السنوي. تحول العملية التاريخين إلى موضعين صحيحين على خط زمني ميلادي ممتد ثم تطرح أحدهما من الآخر. وتطبق قواعد السنة الكبيسة بدقة: تكون السنة القابلة للقسمة على أربعة كبيسة، باستثناء السنوات المئوية ما لم تقبل القسمة أيضا على 400. لذلك يضيف يوم 29 فبراير الواقع بين البداية والهدف يوما صحيحا إلى الحساب. لا تدخل الساعات في العملية، فلا يغير اليوم الأقصر أو الأطول بسبب التوقيت الصيفي الجواب. فالنتيجة تعد حدود التواريخ، لا أجزاء فترات من أربع وعشرين ساعة.

استخدموا العدد في الخطط وسير العمل الآلي

تحتوي الاستجابة على حقل واحد اسمه days_until_valentines_day، ويمكن لقيمته الصحيحة تشغيل عرض أو قاعدة تذكير أو تقويم تحريري أو خطة مخزون أو جدول حملة. قد يغير متجر رسالته عندما يدخل العدد نطاقا محددا، وقد يضع فريق فعالية نقاط مراجعة قبل 90 و30 و14 و7 أيام، كما يمكن لناشر إنشاء عد يومي من دون تكرار منطق التقويم في كل قناة. لا تستخدم القدرة تاريخ اليوم تلقائيا، لأن ذلك يجعل الطلبات المتطابقة تتغير مع الزمن ويخلق اختلافات بين المناطق الزمنية. للحصول على عد حي، قدموا تاريخ اليوم من ساعة موثوقة؛ وللاختبار قدموا أي تاريخ ماض أو مستقبل. الحساب حتمي ولا يستخدم شبكة أو حالة مخزنة أو قيمة عشوائية أو كائن Date من بيئة التشغيل. ولذلك يسهل تخزين النتائج بحسب الإدخال واختبار الحالات الحدية. يعيد التاريخ غير الصحيح خطأ إدخال مصنفا بدلا من رقم يبدو معقولا، فتستطيع عملية التكامل التوقف وتصحيح بيانات المصدر والمحاولة بأمان من دون نشر عد مضلل.

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

التخطيط لحملة عيد الحب

حولوا تاريخ البداية إلى عد دقيق لمواعيد الإطلاق والمراجعات الإبداعية والتغييرات الترويجية.

إنشاء تذكير سنوي

استخدموا العدد الصحيح المعاد لتشغيل التذكيرات في فواصل تختارونها قبل 14 فبراير كل عام.

اختبار التجارب المرتبطة بالتاريخ

قدموا تواريخ ثابتة حول 14 فبراير وسنوات كبيسة للتحقق من العروض من دون تغيير ساعة النظام.

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

ماذا يحدث إذا كان تاريخ الإدخال 14 فبراير؟

تكون النتيجة صفرا لأن التاريخ المدخل هو عيد الحب بالفعل.

ماذا يحدث بعد 14 فبراير؟

تتخذ الحاسبة 14 فبراير من السنة التالية هدفا للحساب.

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

نعم، فهي تطبق القواعد الميلادية، بما فيها استثناءات السنوات المئوية والقابلة للقسمة على 400.

ما صيغة التاريخ المقبولة؟

استخدموا YYYY-MM-DD بدقة مع سنة وشهر ويوم صحيحة، مثل 2026-02-01.

هل تؤثر المنطقة الزمنية أو التوقيت الصيفي في الجواب؟

لا، فالحساب يستخدم تواريخ تقويمية وحسابا صحيحا، لا ساعات أو مناطق زمنية.

كم تبلغ تكلفة طلب API؟

يكلف كل طلب API مقدار $0.002. ويمكن تشغيل إصدار المتصفح محليا من دون اتصال شبكي.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/days-until-valentines-day

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

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

curl -X POST https://api.kit.forhosting.com/date/days-until-valentines-day \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-02-01"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/days-until-valentines-day",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-02-01"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2026-02-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/days-until-valentines-day", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "date": "2026-02-01"
}

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

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