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

تحويل طابع JavaScript الزمني إلى ISO 8601

حوّل طابع JavaScript الزمني إلى تاريخ ووقت دقيقين بصيغة ISO 8601 من دون الاعتماد على الوقت الحالي أو إعدادات المتصفح المحلية أو ساعة الخادم.

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

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

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

أدخل عدداً صحيحاً يمثل المللي ثانية منذ حقبة Unix، وستحصل على تاريخ UTC الموافق مع ثلاث خانات للمللي ثانية وحرف Z في النهاية. الحساب حتمي؛ فالعدد نفسه يعطي دائماً السلسلة نفسها. كما يدعم القيم السالبة السابقة لعام 1970 والنطاق الزمني الكامل في JavaScript، مما يجعله مناسباً للسجلات وعمليات الترحيل والاختبارات القابلة للتكرار.

أدخل المللي ثانية لا الثواني

تحسب طوابع JavaScript الزمنية عادةً المللي ثانية منذ 1970-01-01T00:00:00.000Z، بينما تحسب أدوات Unix وواجهات API كثيرة الثواني. وهذا الفرق البالغ 1,000 مرة هو السبب الأكثر شيوعاً للنتائج المفاجئة. ألصق القيمة الرقمية كما يعيدها JavaScript تماماً، من دون علامات اقتباس أو فواصل أو لاحقة وحدة أو تعبير حسابي. تقبل الأداة الأعداد الصحيحة لأن سلسلة ISO ذات الخانات الكسرية الثلاث تمثل المللي ثانية الصحيحة بدقة. وترفض الكسور والقيم غير المنتهية والنصوص الرقمية بدلاً من التقريب أو التخمين. تمنع هذه الصرامة مدخلاً غير صالح من إنتاج تاريخ يبدو معقولاً لكنه خاطئ. إذا كان المصدر بالثواني، فاضربه في ألف قبل الإرسال شرط بقاء الناتج ضمن النطاق المدعوم. ويكرر الحقل timestamp_ms العدد المقبول للمحافظة على رابط واضح بين القيمة الأصلية والتمثيل المنسق.

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

النتيجة تاريخ ووقت بصيغة ISO 8601 وبتوقيت UTC. ويعني حرف Z الأخير أن الإزاحة عن UTC تساوي صفراً، لا المنطقة الزمنية المحلية لمقدم الطلب. لذلك تظل الساعات والدقائق والثواني والمللي ثانية ثابتة عبر المناطق وتغييرات التوقيت وإعدادات التشغيل. لا يقرأ الحساب الساعة ولا يستدعي كائن Date في JavaScript. بل يقسم الطابع إلى يوم UTC كامل ووقت غير سالب داخله، ثم يحول عدد الأيام بحسابات صحيحة محدودة وفق التقويم الغريغوري. ولهذا لا تتغير المدخلات المتطابقة بسبب الإعدادات المحلية أو وقت التنفيذ. تستخدم القيم السالبة القسمة نحو الأسفل، فتعود المللي ثانية السابقة مباشرة لحقبة Unix إلى 1969-12-31 على نحو صحيح. أما السنوات خارج 0000–9999 فتستخدم صيغة السنة الموسعة ذات الإشارة.

استخدم الناتج بأمان

استخدم الحقل iso عندما تكون تسمية UTC القياسية أوضح من رقم الحقبة، مثل السجلات المنظمة ووحدات التصحيح والتدقيق وبيانات اختبار JSON وتقارير الترحيل واستجابات API. ويساعد الاحتفاظ بالعدد والسلسلة معاً على كشف الخلط بين الثواني والمللي ثانية. هذه العملية تنسيق فقط؛ فلا تحدد منطقة زمنية ولا تستنتج مكان الحدث ولا تنشئ عرضاً إقليمياً. نفّذ تلك الخطوات منفصلة واحتفظ بقيمة UTC للنقل والمقارنة. يطابق النطاق المقبول حد JavaScript المعتاد، أي زائد أو ناقص 8,640,000,000,000,000 مللي ثانية. وتُرفض القيم الخارجة عنه وNaN وInfinity والقيم المفقودة والنصوص والكسور. لا تؤثر الشبكة أو العشوائية أو الإعدادات المحلية أو الساعة في الجواب. يمكنكم استدعاء API مقابل $0.002 أو استخدام نسخة المتصفح والحصول دائماً على ناتج قابل للتكرار.

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

قراءة سجلات التطبيقات

حوّلوا حقل المللي ثانية الغامض إلى لحظة UTC يمكن مقارنتها بين الخدمات والمناطق.

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

أنشئوا قيمة ISO قياسية من طابع ثابت من دون أن تغير الساعة أو المنطقة الزمنية الاختبار.

تدقيق ترحيل الأوقات

احتفظوا بالعدد الأصلي إلى جانب صيغة ISO عند مراجعة تحويلات قواعد البيانات أو API.

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

هل يستخدم الإدخال الثواني أم المللي ثانية؟

يستخدم المللي ثانية. تحسب JavaScript الزمن منذ حقبة Unix بالمللي ثانية؛ اضربوا قيم الثواني في 1,000 أولاً.

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

لا. يكون الناتج دائماً بتوقيت UTC كما يبين حرف Z الأخير، ولا يعتمد على المتصفح أو الخادم.

هل يمكن تحويل تواريخ تسبق 1970؟

نعم. أدخلوا طابعاً زمنياً سالباً للحصول على تاريخ UTC الغريغوري الموافق.

لماذا تُرفض القيم الكسرية؟

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

ما التكلفة؟

تكلفة كل تحويل عبر API هي $0.002. وتتيح نسخة المتصفح أيضاً تحويلاً تفاعلياً حتمياً.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/js-timestamp-to-iso

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

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

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

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/js-timestamp-to-iso",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "timestamp": 1717245296789
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "timestamp": 1717245296789
}

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

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