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

بداية العام التالي

تقبل أداة بداية العام التالي تاريخًا صريحًا بصيغة ISO وهي YYYY-MM-DD، ثم تعيد الأول من يناير من العام اللاحق.

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

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

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

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

أرسل الحقل date في صورة قيمة كاملة بالصيغة YYYY-MM-DD، مع الأصفار البادئة للشهر واليوم. تقبل الأداة السنوات الغريغورية من 0001 إلى 9998، حتى تظل قادرة على إعادة السنة التالية بالصيغة نفسها المكونة من أربعة أرقام. وترفض التواريخ الناقصة، والطوابع الزمنية، ولواحق المناطق الزمنية، وأرقام الشهور المستحيلة، والأيام غير الصحيحة مثل 31 أبريل أو 29 فبراير في سنة غير كبيسة. يفيد عقد الإدخال الصارم هذا عندما تأتي التواريخ من نماذج أو جداول بيانات أو قواعد بيانات أو خدمات أخرى، لأن القيمة غير الصحيحة تُرفض بوضوح بدل تعديلها بصمت. لا يغير الشهر واليوم المقدمان شكل الإجابة، لكن يجري التحقق منهما لضمان أن الإدخال يمثل يومًا تقويميًا حقيقيًا. فمثلًا، ينتج عن 2024-08-19 التاريخ 2025-01-01، ويُقبل 2024-02-29 لأن 2024 سنة كبيسة في التقويم الغريغوري. أرسل تاريخ المصدر نفسه، لا عبارة مثل العام القادم أو التاريخ الحالي، لأن هذه العملية لا تستنتج أبدًا سياقًا زمنيًا مفقودًا.

افهم نتيجة UTC الحتمية

تتضمن النتيجة تاريخ المصدر بعد التحقق منه، والسنة التالية في صورة رقم، والحقل start_of_next_year الذي يمثل الأول من يناير بالصيغة YYYY-MM-DD. تفسر الخوارزمية مكونات التاريخ الأربعة أعدادًا صحيحة عشرية، وتتحقق من قواعد السنوات الكبيسة وأطوال الشهور في التقويم الغريغوري، ثم تضيف واحدًا فقط إلى السنة وتنسق الشهر واليوم على هيئة 01-01. ولا تنشئ كائن Date، ولا تفحص ساعة النظام، ولا تقرأ الإعدادات الإقليمية للمتصفح، ولا تجري تحويلًا عبر منطقة زمنية محلية. لذلك ينتج الطلب المنفذ وفق UTC أو في نيويورك أو طوكيو أو عبر متصفح غير متصل JSON نفسه عند تقديم الإدخال نفسه. والمقصود بالحساب التقويمي وفق UTC أن التاريخ المعاد حد مدني واضح يصلح لتمثيل 00:00:00 UTC إذا احتاج نظام لاحق إلى طابع زمني. لا تعيد الأداة طابعًا زمنيًا هنا، ولذلك لا يحدث انزياح عرضي ولا تحويل للتوقيت الصيفي. يكتسب هذا الفرق أهمية قرب ليلة رأس السنة، حين قد تختار الاختصارات المعتمدة على الساعة سنوات مختلفة بحسب مكان تشغيل الشفرة. ويظل الإدخال الصريح المصدر الوحيد للحقيقة الزمنية.

استخدم الحد بأمان في مسارات العمل

استخدم هذه الأداة عندما يحتاج مسار العمل إلى أول يوم تقويمي بعد سنة تاريخ المصدر، مثل فتح فترة التقارير السنوية التالية، أو إنشاء حد للتجديد، أو حساب بداية سنة مالية مستقبلية تتبع السنة التقويمية، أو إعداد بيانات ثابتة لاختبارات تتأثر بالتاريخ. خزّن start_of_next_year أو قارنه كتاريخ ISO عندما يتعامل النظام المحيط مع قيم تاريخ فقط. وإذا طلبت API أخرى لحظة زمنية، فأضف وقت UTC صريحًا في تلك الطبقة اللاحقة وحدها؛ فمثلًا يمكن اعتبار الحد المعاد منتصف الليل وفق UTC وبحسب الصيغة الموثقة لتلك API. لا تفسر الناتج على أنه بعد سنة واحدة من تاريخ الإدخال، فهما عمليتان مختلفتان. بعد سنة من 2024-08-19 يكون التاريخ 2025-08-19، أما بداية العام التالي فهي 2025-01-01. تبلغ كلفة كل عنصر مطلوب عبر API مقدار $0.002، كما يلائم الحساب الخالص عميل المتصفح الذي يُنشأ تلقائيًا. ولأن الأداة لا تقرأ الساعة الحالية، تظل الأمثلة المحفوظة والمهام المتكررة قابلة لإعادة الإنتاج حتى بعد مرور وقت طويل على إنشائها.

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

فتح سنة التقارير التالية

حوّل أي سجل مؤرخ إلى حد الأول من يناير لفترة التقارير السنوية التالية الخاصة به.

إنشاء بيانات اختبار ثابتة

أنشئ حدًا متوقعًا للعام التالي من دون محاكاة ساعة النظام أو التحكم في المنطقة الزمنية لمشغل الاختبارات.

جدولة قواعد الاحتفاظ السنوية

استخرج بداية السنة التقويمية التالية من تاريخ صريح لمستند أو حدث قبل تطبيق مدة الاحتفاظ.

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

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

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

ما كلفة الطلب الواحد؟

تبلغ كلفة كل طلب API مقدار $0.002.

هل يجري التحقق من السنوات الكبيسة؟

نعم. لا يُقبل 29 فبراير إلا عندما تكون السنة المقدمة كبيسة وفق التقويم الغريغوري.

لماذا الحد الأقصى لسنة الإدخال هو 9998؟

يجب أن تظل السنة التالية قابلة للتمثيل كتاريخ ISO من أربعة أرقام، ولذلك لا يمكن زيادة 9999 ضمن هذا العقد.

هل تعادل هذه العملية إضافة سنة واحدة؟

لا. فهي تعيد دائمًا الأول من يناير من العام التالي، بصرف النظر عن شهر تاريخ المصدر ويومه.

هل تعتمد النتيجة على منطقة زمنية؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/start-of-next-year

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

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

curl -X POST https://api.kit.forhosting.com/date/start-of-next-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-08-19"}'

const res = await fetch("https://api.kit.forhosting.com/date/start-of-next-year", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-08-19"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/start-of-next-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-08-19"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/start-of-next-year", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2024-08-19"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2024-08-19"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/start-of-next-year", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "date": "2024-08-19"
}

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

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