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

عد تنازلي بين تاريخين

من منتصف ليل 1 يناير 2026 بتوقيت UTC حتى 01:01:01 يوم 2 يناير يمر يوم واحد وساعة ودقيقة وثانية، أي 90061 ثانية. أدخل تاريخين مع الوقت وفرق التوقيت لتحصل على العد الكامل. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

تاريخ ووقت ISO-8601 للبداية: 2026-01-01T00:00:00Z
تاريخ ووقت ISO-8601 للنهاية: 2026-01-02T01:01:01Z

تحصل على

ثواني الحقبة للبداية: 1,767,225,600
ثواني الحقبة للنهاية: 1,767,315,661
إجمالي الثواني: 90,061
الأيام: 1

يحتاج منظمو الفعاليات وصفحات إطلاق المنتجات وعدّادات الامتحانات ولوحات SLA إلى نفس الإجابة الواضحة: كم يومًا وساعةً ودقيقةً وثانيةً تبقى بين لحظتين معروفتين. تقبل حاسبة العد التنازلي بين تاريخين زوجًا من تواريخ وأوقات ISO-8601، وتتحقق من كل يوم مدني وكل حقل ساعة وفق القواعد الغريغورية، وتحوّل الطرفين إلى ثوانٍ مطلقة UTC بحساب صحيح خالص، وتعيد باقيًا منظمًا يمكن للواجهات عرضه دون إعادة تنفيذ السنوات الكبيسة أو إزاحات المناطق الزمنية.

اختيار from وto بصيغة ISO والتنسيقات المقبولة

أرسل حقلين نصيين باسم from وto. يجب أن تكون كل قيمة تاريخًا ووقتًا مدنيًا ISO-8601: سنة بأربعة أرقام وشهر ويوم، وقد يتبعها وقت اليوم بساعات ودقائق وثوانٍ. يمكنك إلحاق جزء كسري من الثانية؛ يقبلها المحرك للتوافق ويقتطع إلى ثوانٍ صحيحة لأعداد العد التنازلي.

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

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

الاستخدامات الشائعة والحدود العملية

استدعِ أداة العد التنازلي المجانية بين تاريخين في المتصفح لصفحات الإطلاق ومؤقتات الأعراس وعروض الصف وسكربتات الدعم دون تثبيت مكتبات تواريخ أو قواعد مناطق زمنية. اربطها بعدّادات أيام العمل عندما تهم أيام الأسبوع والعطل فقط، أو بأدوات طول الشهر عند التحقق أولاً من الحقول المدنية قبل بناء طابع زمني كامل. حافظ على توقعات صادقة: يقيس هذا المنتج الزمن المدني المنقضي بين لحظتين مطلقتين بعد تطبيق إزاحات صريحة؛ ولا يجدول إشعارات ولا يحمّل تقاويم عطل عامة ولا يخترع الآن من ساعة الجدار.

تتبع المدخلات قواعد الاحتفاظ نفسها لعناصر parse الأخرى في KIT.

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

عد تنازلي لإطلاق المنتجات والتسويق

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

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

ماذا يحدث إذا كان التاريخ والوقت غير صالح؟

تُرفض أشكال ISO السيئة والأيام المدنية المستحيلة وحقول الساعة خارج النطاق ولا تُحسب.

هل يستخدم ساعة جدار الخادم أو Date في JavaScript؟

لا. تأتي اللحظتان من سلاسل الإدخال. يستخدم المحرك حسابًا غريغوريًا وإزاحة خالصًا دون Date أو شبكة أو عشوائية، فالنتائج حتمية بالكامل.

ماذا يحدث إذا كان تاريخ النهاية قبل تاريخ البداية؟

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

هل يمكنني إدخال تاريخ فقط دون وقت؟

نعم. يُقرأ التاريخ وحده على أنه منتصف ليل ذلك اليوم بتوقيت UTC، فتعمل حدود الأيام دون أن تضطر إلى اختراع وقت.

كيف تُراعى المناطق الزمنية؟

أضف Z بعد الوقت للدلالة على UTC، أو فرقًا مثل +02:00. يُحوَّل الطرفان إلى UTC قبل الطرح، فيبقى الفرق دقيقًا حتى بين بلدين مختلفين.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/countdown-between

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

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

curl -X POST https://api.kit.forhosting.com/date/countdown-between \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-01-01T00:00:00Z","to":"2026-01-02T01:01:01Z"}'

const res = await fetch("https://api.kit.forhosting.com/date/countdown-between", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-01-02T01:01:01Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/countdown-between",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-01-02T01:01:01Z"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"from":"2026-01-01T00:00:00Z","to":"2026-01-02T01:01:01Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/countdown-between", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "from": "2026-01-01T00:00:00Z",
  "to": "2026-01-02T01:01:01Z"
}

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

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

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

لا يمس المسار ساعة الجدار ولا العشوائية ولا الشبكة، لذا تنتج نفس سلسلتي from وto دائمًا نفس JSON في التكامل المستمر والإنتاج. الأشكال غير الصالحة والتواريخ المستحيلة مثل 30 فبراير ومكوّنات الساعة خارج النطاق تفشل بـ invalid_input ولا تُحسب. يعمل ودجت المتصفح مجانًا على جهازك؛ وتفرض API المدفوعة مسبقًا $0.002 لكل عنصر ناجح عندما تحتاج الخوادم وSDK نفس العقد.

اختيار from وto بصيغة ISO والتنسيقات المقبولة

تُقابل الأسماء البديلة start وbegin وstart_date إلى from؛ وend وuntil وend_date وtarget إلى to، وفق تسمية النماذج وAPI الشائعة. الحقلان مطلوبان: إغفال أحدهما أو إرسال غير نص أو مسافات فقط يثير invalid_input يسمي الجانب الناقص.

قراءة الأيام والساعات والدقائق والثواني وtotal_seconds والاتجاه

الحقول days وhours وminutes وseconds دائمًا غير سالبة وتعيد معًا القيمة المطلقة لذلك الفرق، فمدى يوم واحد وساعة ودقيقة وثانية يعطي days واحدًا وhours واحدًا وminutes واحدًا وseconds واحدًا بغض النظر عن الاتجاه. لأن كل خطوة حساب غريغوري وإزاحة خالص، تثبت التركيبات بموثوقية عبر المحليات وإصدارات Node. عند النجاح تعيد الاستجابة سلسلتي from وto المطبّعتين اللتين أرسلتهما، مع from_epoch_seconds وto_epoch_seconds كثوانٍ صحيحة مطلقة بأسلوب يونكس محسوبة دون كائن Date للمضيف. الحقل total_seconds هو الفرق الموقع to ناقص from: موجب عندما تكون النهاية لاحقة، وصفر عندما تتطابق اللحظتان، وسالب عندما تكون النهاية أسبق. تتيح العلامتان is_past وis_zero وتسمية الاتجاه forward أو backward أو zero للوحات اختيار نصوص مثل المتبقي مقابل المتأخر دون إعادة اشتقاق الإشارة. السلسلة المنسّقة تجمع الأجزاء الأربعة في سطر مضغوط مثل one d one h one m one s للعرض السريع، بينما method دائمًا countdown_between للموجّهات والاختبارات الذهبية. استخدم total_seconds وحده عندما تحتاج رقمًا واحدًا للفرز؛ واستخدم التفصيل الرباعي عند رسم ودجت عد تنازلي كلاسيكي؛ واستخدم is_past عندما يجب أن ينقلب نص المنتج بعد اللحظة الهدف.

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

أرسل جسم JSON بحقول نصية مطلوبة from وto بصيغة ISO-8601. استخدم API المدفوعة مسبقًا عندما يحتاج موقع تسويق أو نظام تذاكر أو منصة امتحانات أو لوحة عمليات عقدًا مستقرًا تحت رصيد KIT بسعر $0.002 لكل عنصر ناجح؛ ولا تستهلك إخفاقات التحقق الرصيد بعد رفض المحرك. يمكن لمؤلفي SDK ربط days وhours وminutes وseconds مباشرة بأربعة أرقام عد تنازلي وتوجيه نمط التأخر من is_past بنفس شكل الاستجابة في كل ربط لغوي.

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

امتحانات وفعاليات ومواعيد التسجيل

تحسب أنظمة التعليم والتذاكر الوقت المتبقي حتى موعد ISO ثابت وتقلب نص الواجهة بـ is_past عند إغلاق التسجيل.

لوحات SLA والعمليات

تمرّر أدوات التشغيل لحظات فتح الحادث وحل الهدف، وتخزّن total_seconds للفرز، وتعرض البواقي المنسّقة على لوحات الحالة.

أسئلة تقنية

كيف أحصل على عد تنازلي بين تاريخين؟

أرسل JSON مع from وto كتاريخ ووقت ISO-8601 (مثل from: "2026-01-01T00:00:00Z" وto: "2026-01-02T01:01:01Z"). تتضمن الاستجابة days وhours وminutes وseconds وtotal_seconds موقع.

ماذا لو كانت النهاية قبل البداية؟

تبقى حقول التفصيل غير سالبة للمدى المطلق، وtotal_seconds سالب، وis_past صحيح، وdirection هو backward لتعرض الواجهات حالة التأخر.

هل حاسبة العد التنازلي بين تاريخين مجانية؟

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

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

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

مثال محلول

اختيار from وto بصيغة ISO والتنسيقات المقبولة

الاستخدامات الشائعة والحدود العملية

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

عد تنازلي لإطلاق المنتجات والتسويق

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

اختيار from وto بصيغة ISO والتنسيقات المقبولة

قراءة الأيام والساعات والدقائق والثواني وtotal_seconds والاتجاه

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

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

امتحانات وفعاليات ومواعيد التسجيل

لوحات SLA والعمليات

أسئلة تقنية

شكرًا