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

تحويل الدقائق إلى إزاحة UTC بصيغة UTC±HH:MM

يحوّل منسق الدقائق إلى إزاحة UTC قيمة صحيحة ذات إشارة إلى سلسلة رقمية ثابتة، مثل UTC+05:30 أو UTC-04:00.

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

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

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

أدخلوا الإزاحة في صورة دقائق صحيحة ذات إشارة

قدّموا عددا صحيحا واحدا في الحقل minutes. تمثل القيم الموجبة إزاحة متقدمة على UTC، وتمثل القيم السالبة إزاحة متأخرة عنه، ويمثل الصفر عدم وجود فرق عن UTC. فعلى سبيل المثال، تصف القيمة 330 تقدما مقداره خمس ساعات وثلاثون دقيقة، بينما تصف -240 تأخرا مقداره أربع ساعات. ويزيل التعبير عن المدخل بالدقائق غموض الساعات العشرية؛ فقد تكون 5.5 ساعات مفهومة للبشر، لكن 330 دقيقة قيمة دقيقة لا تحتاج إلى تفسير كعدد ذي فاصلة عائمة. يمتد النطاق المقبول من -840 إلى 840، وهو ما يقابل UTC-14:00 حتى UTC+14:00 ويغطي الحدود العملية لإزاحات UTC المدنية. يرفض المنسق الكسور والسلاسل النصية الرقمية والقيم المفقودة والأعداد غير المنتهية والقيم الخارجة عن النطاق، ولا يقربها أو يحولها ضمنيا. وتحمي هذه الصرامة إعدادات حضرتكم وعمليات الجدولة من تغيير طفيف غير مقصود في الإزاحة المطلوبة. احسبوا القيمة الصحيحة أو احصلوا عليها قبل استدعاء الإمكانية؛ فهي لا تستنتجها من مدينة أو دولة أو اختصار أو منطقة زمنية مسماة أو طابع زمني أو إعداد للجهاز. ولذلك تسلك القيمة الصحيحة نفسها مسار التنسيق نفسه في كل مرة.

اقرؤوا النتيجة المعيارية بصيغة UTC±HH:MM

تختار الخوارزمية الإشارة مباشرة من المدخل، ثم تأخذ المقدار المطلق وتقسمه إلى ساعات كاملة ودقائق متبقية، وتستكمل كل جزء إلى رقمين بالأصفار. تتحول القيمة 330 إلى UTC+05:30، وتتحول -75 إلى UTC-01:15، وتتحول 60 إلى UTC+01:00. ويعرض الصفر في صورة UTC+00:00 للمحافظة على البنية الثابتة نفسها التي تستخدمها سائر النتائج؛ فلا يستخدم الاختصار الخاص Z ولا تسمية UTC مختصرة. وتظل النقطتان الرأسيتان موجودتين دائما، ولا يحذف أي جزء عندما تكون قيمته صفرا. هذا النسق الثابت ملائم للواجهات ولقطات الاختبار والإعدادات المصدرة والوثائق المنشأة والأنظمة التي تقارن السلاسل الموحدة. كما تعيد الاستجابة الحقل offset_minutes، وبذلك تحتفظ بالقيمة الرقمية التي اجتازت التحقق إلى جانب الإزاحة المنسقة. ويمكن لحضرتكم عرض السلسلة مع إبقاء العدد الصحيح للفرز أو الحساب أو التخزين، من دون إعادة تحليل النص. وتعني كلمة معياري هنا شكل الناتج الموثق لهذه الإمكانية: UTC بأحرف كبيرة، ثم إشارة جمع أو طرح صريحة، ثم HH:MM مع أصفار بادئة. ولا يعني ذلك أن الناتج يحدد منطقة زمنية جغرافية.

افصلوا بين الإزاحات الثابتة والمناطق الزمنية المسماة

لا تعادل إزاحة UTC الرقمية منطقة زمنية مسماة مثل Europe/London أو America/New_York. فالمناطق المسماة تحتوي على قواعد تاريخية ومستقبلية، وقد تتغير إزاحتها السارية بسبب انتقالات التوقيت الصيفي أو التشريعات. لا يجري هذا المنسق أي بحث من هذا النوع، بل يمثل الرقم الدقيق الذي تقدمه حضرتكم فحسب. استخدموه عندما تكون الإزاحة الثابتة هي البيانات الصحيحة بالفعل، أو عند توحيد قيمة حُسبت في موضع آخر، أو عند إنشاء بيانات اختبار حتمية يجب ألا تتغير مع تحديث قواعد بيانات المناطق الزمنية. ولا تستخدموه لاكتشاف التوقيت المحلي لشخص، أو لتحديد الإزاحة الواجبة لمدينة في تاريخ معين، أو لتحويل منطقة مسماة إلى قيمة موسمية. لا توجد طلبات شبكة أو قيم عشوائية أو قراءة للساعة أو تبعية للغة والمنطقة أو فحص لبيئة التشغيل أو قيم افتراضية خفية. ولذلك يمكن إعادة إنتاج النتيجة في API والمتصفح على السواء. يكلف كل طلب API مبلغ $0.002. وتعيد المدخلات غير الصالحة خطأ محدد النوع مع شرح موجز، حتى تتمكنوا من تصحيح الحقل بدلا من قبول قيمة تخمينية. وللاستخدام اللاحق الموثوق، احتفظوا بالحقل offset_minutes مصدرا رقميا وبالحقل offset عرضا موحدا.

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

توحيد قيم الإعداد

حوّلوا الإزاحات المحفوظة بالدقائق إلى صيغة UTC±HH:MM واحدة للإعدادات وAPI وعمليات التصدير.

إنشاء تسميات لاختيار الإزاحة

أنشئوا تسميات رقمية متسقة لواجهة الاستخدام من دون صيانة جدول مطابقة يدوي.

إعداد بيانات اختبار حتمية

أنشئوا السلاسل المتوقعة من الأعداد الصحيحة من دون الاعتماد على ساعة أو لغة أو إصدار قاعدة مناطق زمنية.

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

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

تعيد القيمة صفر السلسلة UTC+00:00، مع الحفاظ على الإشارة الصريحة والعرض الثابت لبقية النتائج.

هل تقرب كسور الدقائق؟

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

هل يمكن معرفة الإزاحة الحالية لمدينة؟

لا. تنسق الأداة القيمة ذات الإشارة المقدمة فقط، ولا تستعلم عن الجغرافيا أو قواعد التوقيت الصيفي.

لماذا تعرض الساعات والدقائق برقمين دائما؟

توفر الأصفار البادئة تمثيلا متوقعا بصيغة UTC±HH:MM للشاشات والسجلات والاختبارات.

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/minutes-to-offset

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

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

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

const res = await fetch("https://api.kit.forhosting.com/date/minutes-to-offset", {
  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/minutes-to-offset",
    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/minutes-to-offset", 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/minutes-to-offset", 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.minutes_to_offset",
  "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 الكامل ←