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

طرح دقائق من التاريخ والوقت

تعيد هذه الحاسبة التاريخ والوقت الصريح بصيغة ISO 8601 إلى الوراء بعدد الدقائق المحدد، ثم تعرض قيمة واحدة موحدة بتوقيت UTC.

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

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

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

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

أدخلوا لحظة تتضمن منطقتها الزمنية

ابدؤوا بتاريخ ووقت بصيغة ISO 8601 يحددان لحظة حقيقية، مثل 2026-07-25T12:30:00Z، أو بقيمة تنتهي بإزاحة مثل +05:30. يلزم وجود محدد للمنطقة الزمنية لأن قراءة الساعة من دونه ملتبسة؛ فمنتصف النهار في لندن ومنتصف النهار في طوكيو لا يشيران إلى اللحظة نفسها. تتحقق الحاسبة من التاريخ الميلادي كاملا، بما في ذلك عدد أيام كل شهر وقواعد السنوات الكبيسة. كما تتحقق من الساعات والدقائق والثواني والميلي ثانية والإزاحة الرقمية. يمكنكم حذف الثواني عندما تكون صفرا، لكن القيمة المعادة تعرض دائما تمثيلا كاملا بتوقيت UTC. أدخلوا في حقل الدقائق المقدار المراد طرحه. تلائم الأعداد الصحيحة أعمال الجدولة المعتادة، بينما تمثل قيمة عشرية مثل 1.5 تسعين ثانية. وتقبل القيم السالبة أيضا، وهي تحرك اللحظة إلى الأمام فعليا. كلا الحقلين إلزامي، ويجب أن يكون مقدار الدقائق عددا محدودا.

افهموا حساب UTC وصيغة النتيجة

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

استخدموا النتيجة بأمان في التطبيقات

استخدموا هذه القدرة عندما يملك نظامكم طابعا زمنيا بالفعل ويحتاج إلى موعد نهائي أو تذكير أو حد قبول أو بداية نافذة أو موضع سابق في السجل. أرسلوا التاريخ والوقت الأصليين مع المدة المطلوب طرحها، ثم استخدموا حقل datetime المعاد بوصفه النتيجة الموحدة. ينبغي التمييز بين الدقائق المنقضية والعمليات التقويمية. فطرح 1,440 دقيقة يزيل أربعا وعشرين ساعة بالضبط، لكنه لا يعني الحصول على التوقيت المحلي نفسه في اليوم السابق عند عبور تغيير التوقيت الصيفي. إذا كان هذا السلوك مطلوبا، فحلوا المنطقة الزمنية المسماة وقواعدها قبل استدعاء هذه العملية. تبلغ القيم المستحيلة، مثل 30 فبراير أو الساعة 25، بوصفها أخطاء إدخال بدلا من تصحيحها بصمت. وترفض أيضا الإزاحات الهائلة والدقة الأصغر من ميلي ثانية حتى لا تظهر نتيجة دقيقة ظاهريا فقط. تناسب أداة المتصفح الحسابات الفردية، أما الاستدعاءات الآلية فتكلف $0.002 لكل طلب وتندمج في مسارات الجدولة وتنظيف البيانات وتوحيد الطوابع الزمنية.

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

حساب وقت التذكير

أعيدوا الطابع الزمني إلى الوراء بمهلة ثابتة واحفظوا لحظة UTC الناتجة لاستخدامها في التذكير.

تحديد حد المعالجة

اطرحوا دقائق من الموعد النهائي لتحديد الوقت الذي ينبغي فيه لمسار آلي أن يتوقف عن قبول العمل.

توحيد الطوابع الزمنية المعدلة

حولوا التواريخ ذات الإزاحة إلى UTC مع تطبيق تعديل زمني قابل لإعادة الإنتاج أثناء إعداد البيانات.

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

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

لا. فهو يستخدم فقط التاريخ والوقت ومقدار الدقائق المقدم، ولذلك تنتج المدخلات المتطابقة النتيجة نفسها دائما.

ما صيغ المناطق الزمنية المقبولة؟

استخدموا Z للدلالة على UTC أو إزاحة رقمية صريحة مثل +05:30 أو -04:00. وترفض التواريخ الخالية من محدد المنطقة لأنها ملتبسة.

هل يمكن طرح كسور من الدقيقة؟

نعم. تقبل الكسور التي تتحول بدقة إلى عدد صحيح من وحدات الميلي ثانية؛ فالقيمة 1.5 دقيقة تطرح تسعين ثانية مثلا.

ما صيغة النتيجة؟

النتيجة تاريخ ووقت بصيغة ISO موحدان وفق UTC، وتنتهي بالحرف Z وتتضمن الثواني وثلاث خانات للميلي ثانية.

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/subtract-minutes

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

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

curl -X POST https://api.kit.forhosting.com/date/subtract-minutes \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-07-25T12:30:00Z","minutes":45}'

const res = await fetch("https://api.kit.forhosting.com/date/subtract-minutes", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2026-07-25T12:30:00Z",
    "minutes": 45
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/subtract-minutes",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2026-07-25T12:30:00Z",
    "minutes": 45
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/subtract-minutes", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2026-07-25T12:30:00Z","minutes":45}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2026-07-25T12:30:00Z","minutes":45}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/subtract-minutes", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "datetime": "2026-07-25T12:30:00Z",
  "minutes": 45
}

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

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