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

تنسيق فرق توقيت GMT في تسمية واضحة

يحوّل منسّق تسميات فرق GMT قيمة واحدة موقعة بالدقائق الصحيحة إلى نص عربي واضح، من دون الرجوع إلى ساعة أو موقع أو قاعدة بيانات للمناطق الزمنية أو قواعد التوقيت الصيفي.

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

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

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

عند إدخال 120 تحصلون على تسمية ثابتة تعني التقدم على GMT بساعتين. تحتفظ الفروق التي لا تساوي ساعات كاملة بالدقائق، وتعبّر القيم السالبة عن التأخر، بينما تصبح القيمة صفر GMT. تلائم النتيجة واجهات الاستخدام والتقارير والنصوص الميسّرة والرسائل المنشأة آلياً وأي سير عمل يحتاج إلى صياغة متوقعة انطلاقاً من قيمة رقمية.

ابدؤوا بفرق موقع محسوب بالدقائق

أدخلوا الفرق عن GMT في صورة عدد صحيح واحد من الدقائق. تمثل الأعداد الموجبة وقتاً متقدماً على GMT، وتمثل الأعداد السالبة وقتاً متأخراً عنه، أما الصفر فيمثل GMT نفسه. فالقيمة 120، مثلاً، تعني التقدم بساعتين، في حين تعني -240 التأخر بأربع ساعات. يزيل اعتماد الدقائق أي التباس في عقد الإدخال، كما يدعم الفروق التي لا تقع عند ساعة كاملة. يمتد النطاق المقبول من -840 إلى 840 دقيقة، أي من التأخر أربع عشرة ساعة إلى التقدم أربع عشرة ساعة. لا يستنتج المنسّق الفرق من مدينة أو دولة أو اختصار أو طابع زمني أو إعداد في الجهاز. وهذا الفصل مقصود، لأن المناطق الزمنية الجغرافية قد تتغير بتغير القوانين وقواعد التوقيت الصيفي، بينما تقتصر مهمة هذه الإمكانية على التعبير عن القيمة الرقمية التي تقدمونها بدقة. احسبوا قواعد الوقت المحلي أو تحققوا منها قبل الاستدعاء، ثم مرروا القيمة النهائية الموقعة بالدقائق. وبفضل صراحة الإدخال، تنتج القيمة نفسها دائماً التسمية نفسها في كل بيئة.

تعرّفوا إلى طريقة بناء التسمية الودية

تعيد القيمة صفر التسمية المختصرة GMT. أما أي قيمة غير صفرية، فيحدد المنسّق أولاً التقدم أو التأخر من الإشارة، ثم يقسم المقدار المطلق إلى ساعات كاملة ودقائق متبقية. إذا كانت القيمة ساعات كاملة، تُحذف كلمة ساعات من الصياغة المختصرة؛ فالقيمة 120 تعني GMT زائد ساعتين، والقيمة -60 تعني GMT ناقص ساعة. وعندما تبقى دقائق، توضح الوحدات البنية: تصبح 330 خمس ساعات وثلاثين دقيقة بعد GMT، بينما تصبح 30 ثلاثين دقيقة بعد GMT. تُراعى صيغ المفرد والمثنى والجمع بما يلائم العربية، وتُكتب الأعداد المركبة بصياغة طبيعية. يحتوي الكائن المعاد على التسمية المقروءة وعلى الفرق الأصلي في offset_minutes. وجود الرقم إلى جانب النص يجعل الناتج نافعاً للناس والبرامج معاً؛ إذ يمكنكم عرض التسمية والفرز أو المقارنة بواسطة الرقم من دون محاولة تحليل العبارة وإعادتها إلى بيانات. لا يغير إعداد اللغة أو البحث عن الاختصارات أو أي إعداد خفي هذه العملية.

استخدموا تسمية حتمية من دون ادعاء تحديد منطقة زمنية

يرتبط فرق GMT بالمنطقة الزمنية المسماة، لكنه لا يساويها. فالفرق يبين فقط مقدار ابتعاد الساعة عن GMT، ولا يحدد منطقة جغرافية ولا يضمن مواعيد التغييرات الموسمية. استخدموا هذا المنسّق عندما يحتوي مصدركم بالفعل على فرق ثابت، ويكون التعبير بالكلمات أوضح للجمهور من ترميز مختصر مثل +05:30. يناسب ذلك التسميات الميسّرة بجوار قوائم الاختيار والملخصات المنطوقة وسجلات التدقيق ومعاينات الإعداد واستجابات API الموحدة. لا تستخدموا الناتج للجزم بأن شخصاً موجود الآن في منطقة زمنية بعينها، ولا تعدّوه حاسبة للتوقيت الصيفي. لا تجري الخوارزمية أي طلب شبكي، ولا تقرأ الساعة أو إعدادات اللغة أو نظام التشغيل أو قاعدة للمناطق الزمنية. لذلك تبقى النتائج قابلة للتكرار في عمليات البناء والاختبارات والمستندات المخزنة والمتصفح. تبلغ كلفة الأتمتة عبر API مقدار $0.002 لكل طلب. وإذا كان الإدخال مفقوداً أو كسرياً أو غير رقمي أو خارج النطاق الموثق، تعيد الإمكانية خطأ إدخال مصنفاً بدلاً من التخمين أو التقريب الصامت.

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

إضافة تسميات إلى محدد فروق التوقيت

حوّلوا قيم الدقائق المحفوظة إلى خيارات مقروءة في شاشة الإعدادات من دون صيانة جدول مستقل للتسميات.

إنشاء بيانات زمنية ميسّرة

قدّموا لقارئات الشاشة أو للمخرجات الصوتية وصفاً واضحاً للفرق بدلاً من الاعتماد على ترميز رقمي مليء بالعلامات.

توحيد التقارير وعمليات التصدير

أنشئوا تسميات GMT ثابتة من قيم الإعداد الرقمية كي تستخدم عمليات التصدير المتكررة الصياغة نفسها كل مرة.

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

هل تحسب الأداة فرق مدينة أو منطقة زمنية؟

لا. فهي تنسّق فقط القيمة الموقعة بالدقائق التي تقدمونها، ولا تستشير بيانات جغرافية أو قواعد للتوقيت الصيفي.

ماذا تعيد القيمة صفر؟

تعيد GMT وحدها، من دون زائد أو ناقص أو ساعات أو دقائق.

هل تدعم فروق نصف الساعة وربع الساعة؟

نعم. يمكن لأي قيمة صحيحة بالدقائق ضمن النطاق المدعوم أن تحتفظ بجزء الدقائق في التسمية.

هل يقرّب المنسّق كسور الدقائق؟

لا. تُرفض القيم الكسرية لأن التقريب سيغير الفرق الذي قدمتموه.

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/gmt-offset-label

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

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

curl -X POST https://api.kit.forhosting.com/date/gmt-offset-label \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"minutes":330}'

const res = await fetch("https://api.kit.forhosting.com/date/gmt-offset-label", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "minutes": 330
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/gmt-offset-label",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "minutes": 330
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"minutes":330}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/gmt-offset-label", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "minutes": 330
}

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

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