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

اقتطاع التاريخ والوقت لوحدة

اقتطاع طابع زمني إلى وحدة أخشن هو أساس المجموعات اليومية والتقارير الشهرية والمخططات الساعية ومفاتيح التخزين المؤقت التي يجب أن تتوافق عبر اللغات والمضيفين.

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

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

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

تجعل مناطق المضيف وجداول التوقيت الصيفي عملية أرضية ساذجة تتباعد بين المتصفحات والخوادم وعمال الحافة. تقبل أداة اقتطاع التاريخ والوقت إلى وحدة تاريخًا ووقتًا صريحين بصيغة ISO-8601 — وقت كامل مع Z أو إزاحة رقمية، أو سلسلة تاريخ فقط تُعامل كمنتصف ليل UTC — بالإضافة إلى وحدة سنة أو شهر أو يوم أو ساعة أو دقيقة. تُطبّع الإدخال إلى التوقيت العالمي المنسق بحساب تقويمي غريغوري خالص، ثم تصفّر كل حقل أدق من الوحدة المختارة ليكون الناتج لحظة أرضية UTC مستقرة مكتوبة سنة-شهر-يوم T ساعة-دقيقة-ثانية Z. لا يدخل كائن Date في JavaScript ولا ساعة جدارية ولا نداء شبكة في المسار، لذا تنتج المدخلات المتطابقة دائمًا نفس JSON لاختبارات golden والودجات دون اتصال والأتمتة. تفشل الأيام التقويمية المستحيلة والوحدات المجهولة بخطأ تحقق واضح بدل اختراع ترحيل. يشارك النموذج المجاني في المتصفح وواجهة API المدفوعة دالة متماثلة واحدة بسعر $0.002 لكل عنصر ناجح.

طريقة الاستخدام

أدخل القيم في النموذج أعلاه. تتحقق الأداة منها قبل الحساب ثم تعرض النتيجة في الصفحة نفسها.

راجع بياناتك

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

أعد الحساب أو نفّذه آليًا

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

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

احصل على النتيجة الآن

أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.

قارن السيناريوهات

غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.

أتمت العمل المتكرر

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

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

كيف أقتطع تاريخًا ووقتًا إلى اليوم بتوقيت UTC؟

أرسلوا datetime كسلسلة ISO-8601 وunit كـ day. تعيد API نفس التاريخ التقويمي عند 00:00:00Z بعد تطبيع أي إزاحة رقمية إلى UTC.

ما الوحدات المدعومة؟

خمسة رموز فقط دون تمييز لحالة الأحرف: year وmonth وday وhour وminute. الوحدات المجهولة تفشل بـ invalid_input ولا تُفوتر.

هل يستخدم الاقتطاع منطقتي الزمنية المحلية؟

لا. تُحسب الأرضية دائمًا بتوقيت UTC من سلسلة الإدخال الصريحة. تُحوَّل الإزاحات في السلسلة إلى UTC أولًا؛ ولا تُقرأ ساعة المضيف أبدًا.

ماذا يحدث مع يوم تقويمي غير صالح؟

التواريخ المستحيلة مثل 2023-02-29 تفشل بـ invalid_input. لا تنتقل المهمة إلى مارس ولا تخترع يوم كبيسة.

كم تكلفة أداة اقتطاع التاريخ والوقت إلى وحدة؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/truncate-to-unit

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

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

curl -X POST https://api.kit.forhosting.com/date/truncate-to-unit \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}'

const res = await fetch("https://api.kit.forhosting.com/date/truncate-to-unit", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/truncate-to-unit",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/truncate-to-unit", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2024-06-15T14:37:52Z","unit":"day"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/truncate-to-unit", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "datetime": "2024-06-15T14:37:52Z",
  "unit": "day"
}

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

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