ForHosting KIT · التواريخ والوقت

UUID v1/v6/v7 إلى الطابع الزمني

الصق معرّف UUID من الإصدار 1 أو 6 أو 7 واحصل على الوقت المخزَّن فيه: المعرّف 018bcfe5-6800-7000-8000-000000000000 يقابل 2023-11-14T22:13:20.000Z، أي 1700000000000 ميلي ثانية في Unix. لا يغادر شيء جهازك. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

معرّف UUID: 018bcfe5-6800-7000-8000-000000000000

تحصل على

إصدار UUID: 7
طابع Unix الزمني (مللي ثانية): 1,700,000,000,000
التاريخ والوقت بصيغة ISO: 2023-11-14T22:13:20.000Z

أداة مجانية وحتمية. استخرج الطابع الزمني المضمَّن في معرّفات UUID من الإصدارات 1 أو 6 أو 7، واحصل على النتيجة بوحدة Unix بالمللي ثانية وبصيغة ISO-8601.

كيف يعمل

تستخرج هذه الأداة الطابع الزمني المضمَّن في معرّف UUID من الإصدارات 1 أو 6 أو 7، ثم تُعيد القيمة بوحدة Unix بالمللي ثانية إلى جانب صيغة ISO-8601. في الإصدارين 1 و6 يَعُدّ الطابع الزمني فتراتٍ مقدارها مئة نانو ثانية منذ بداية التقويم الغريغوري، بينما يضع الإصدار 7 مللي ثواني Unix مباشرةً في بتّاته الأولى. ننصحك بقراءة الأمثلة المرجعية لمسارات النجاح والخطأ معًا قبل دمج هذه القدرة في مسارات الإنتاج أو الاختبارات الآلية.

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

المدخلات والمخرجات

يجب أن تكون الحقول المطلوبة في المخطط موجودةً وذات أنواع صحيحة، بينما تستخدم الحقول الاختيارية قيمًا افتراضية موثَّقة. تتضمن كل استجابة ناجحة الحقول الأساسية نفسها دائمًا، أي الطابع الزمني بوحدة Unix بالمللي ثانية وتمثيله بصيغة ISO-8601، كي تبقى ارتباطات واجهتك مستقرة مع مرور الوقت. يجب أن تكون السلسلة المُدخَلة معرّف UUID صالحًا يدعم إصداره طابعًا زمنيًا، أي 1 أو 6 أو 7، لأن الإصدارات الأخرى لا تحمل أي تاريخ قابل للاستخدام.

راجع الأمثلة المرجعية لمسارات النجاح والخطأ قبل أتمتة استدعاءاتك في بيئة الإنتاج. وبهذه الطريقة يمكنك الاعتماد على عقد إخراج ثابت وكتابة اختبارات آلية لا تنكسر عندما تطوّر تطبيقك وتضيف حقولًا جديدة إلى واجهتك مع مرور الوقت.

الحالات الحدّية والقيود

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

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

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

العمل اليومي

احصل على تاريخ موثوق دون جدول بيانات.

التعليم

أمثلة مرجعية ثابتة لعروضك التوضيحية.

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

هل تحتاج إلى شبكة؟

لا حاجة إلى شبكة؛ يجري التحليل على الجهاز.

ما إصدارات UUID التي يمكن قراءتها؟

الإصدارات 1 و6 و7، وهي التي تحمل وقتًا مضمَّنًا. وتخبرك النتيجة أيضًا بإصدار المعرّف الذي لصقته، إلى جانب الوقت الذي يحمله.

ماذا تعرض النتيجة؟

تعرض إصدار المعرّف، والوقت المضمَّن بالميلي ثانية في Unix، واللحظة نفسها بتاريخ ووقت ISO 8601 بتوقيت UTC. فمثلًا 1700000000000 ميلي ثانية تعني 2023-11-14T22:13:20.000Z.

ماذا يحدث إذا لصقت قيمة فارغة أو خاطئة؟

تُرفض فورًا برسالة واضحة بدل إنتاج وقت مختلَق. تأكد من أنك لصقت معرّف UUID كاملًا من الإصدار 1 أو 6 أو 7.

هل يعطي المعرّف نفسه الوقت نفسه دائمًا؟

نعم. تعتمد النتيجة على المعرّف الذي تدخله فقط، لذلك تعيد القيمة نفسها الوقت نفسه دائمًا، أيًا كان وقت السؤال أو مكانه.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/uuid-time

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

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

curl -X POST https://api.kit.forhosting.com/date/uuid-time \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"uuid":"018bcfe5-6800-7000-8000-000000000000"}'

const res = await fetch("https://api.kit.forhosting.com/date/uuid-time", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "uuid": "018bcfe5-6800-7000-8000-000000000000"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/uuid-time",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "uuid": "018bcfe5-6800-7000-8000-000000000000"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/uuid-time", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"uuid":"018bcfe5-6800-7000-8000-000000000000"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"uuid":"018bcfe5-6800-7000-8000-000000000000"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/uuid-time", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "uuid": "018bcfe5-6800-7000-8000-000000000000"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.uuid_time",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

كيف يعمل

الحساب حتمي بالكامل ويجري مجانًا داخل متصفحك، مستخدِمًا الدالة النقية نفسها التي تستخدمها الواجهة البرمجية تمامًا. تُتحقَّق المدخلات قبل أي عملية حسابية، بحيث يصبح النوع الخاطئ أو السلسلة المشوَّهة خطأ invalid_input واضحًا بدلًا من نتيجة صامتة.

المدخلات والمخرجات

القيم الوسيطة الكبيرة جدًا التي تتجاوز دقة IEEE-754 تُنتج خطأً صريحًا بدلًا من قيمة فارغة.

الحالات الحدّية والقيود

أما إصدار UUID الذي لا يحتوي على طابع زمني، مثل الإصدار 4 العشوائي بالكامل، فيُعيد خطأ invalid_input مصحوبًا برسالة ثابتة صُمِّمت من أجل الاعتماد والمقارنة الآلية. ولأن الدالة حتمية، فإن معرّف UUID نفسه يُعطي دائمًا الطابع الزمني نفسه، في المتصفح كما في الواجهة البرمجية.

حالات التكامل

الأتمتة

الدالة النقية نفسها في الأداة والواجهة البرمجية.

أسئلة تقنية

هل هي مجانية؟

نعم، المستوى A مباشرةً في المتصفح.

ماذا عن المدخل غير الصالح؟

خطأ invalid_input مع رسالة واضحة.

هل هي مستقرة؟

أمثلة مرجعية حتمية تُثبِّت العقد.

من المؤلف؟

samurai.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

كيف يعمل

المدخلات والمخرجات

الحالات الحدّية والقيود

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

العمل اليومي

التعليم

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

كيف يعمل

المدخلات والمخرجات

الحالات الحدّية والقيود

حالات التكامل

الأتمتة

أسئلة تقنية

شكرًا