محول الطابع الزمني Unix و JWT
حوّل قيم Unix Epoch بالثواني أو الملي ثانية إلى توقيت UTC و ISO 8601 و RFC 2822 وأي منطقة زمنية IANA محلياً داخل متصفحك. أنشئ مقاطع claims جاهزة لرموز JWT مثل iat و nbf و exp مع تنبيه تجاوز حد عام 2038.
كيف تعمل الأداة تقنياً
يحسب توقيت Unix Epoch عدد الثواني المنقضية منذ منتصف ليل 1 يناير 1970 بتوقيت UTC دون احتساب الثواني الكبيسة. وتحدد مواصفة RFC 7519 مطالبات الوقت في رموز JWT (مثل exp و nbf و iat) كقيم NumericDate بالثواني، بينما تُرجع دوال مثل Date.now() في JavaScript أرقاماً من 13 خانة بالملي ثانية، مما يسبب أخطاء شائعة عند الخلط بين الوحدتين.
يتعرف هذا المحول تلقائياً على الثواني مقابل الملي ثانية مع توفير خيار التبديل اليدوي، ويعتمد على واجهتي Date و Intl.DateTimeFormat المدمجتين في المتصفح لعرض صيغ UTC و ISO 8601 و RFC 2822 وأي منطقة زمنية IANA، إلى جانب دعم القيم السالبة لما قبل عام 1970 وإصدار تنبيه عند تجاوز حد الأعداد الصحيحة 32 بت لعام 2038 (2,147,483,647).
شرح عملي خطوة بخطوة مع مثال حقيقي
اتبع هذه الخطوات الأربع لتحويل أي طابع زمني وتوليد مقاطع claims جاهزة لرموز JWT وفحص حدود عام 2038.
1. راقب الوقت الحالي أو أدخل رقماً زمنياً
استخدم العداد المباشر في الأعلى أو أدخل أي رقم بالثواني أو الملي ثانية أو قيمة سالبة لما قبل 1970.
2. تأكد من وحدة الثواني أو الملي ثانية
يفصل الوضع التلقائي عند 1e11، ويمكنك تثبيت الثواني أو الملي ثانية يدوياً عند الحاجة إلى دقة كاملة للتواريخ القديمة أو البعيدة.
3. اختر المنطقة الزمنية IANA وقارن الصيغ
حدّد منطقة مثل Asia/Riyadh أو Europe/Paris لعرض التوقيت المحلي بجانب صيغتي ISO 8601 و RFC 2822 العالميتين.
4. انسخ قوالب JWT أو اختبر حد عام 2038
انسخ كائنات +15m أو +1h أو +24h أو +7d الجاهزة للرموز، أو جرّب القيمة 2147483647 لمعاينة حد 32 بت الشهير.
مثال تطبيقي: الحد الأقصى لأنظمة 32 بت في عام 2038
2147483647 (2^31 - 1)ISO 8601: 2038-01-19T03:14:07.000Z · RFC 2822: Tue, 19 Jan 2038 03:14:07 +0000 · تنبيه Int32 مفعّل.بعد ثانية واحدة فقط (2147483648) ينقلب العدد ذو الإشارة 32 بت إلى عام 1901؛ احرص دائماً على استخدام 64 بت (BIGINT) في قواعد البيانات.
الأخطاء الشائعة وتنبيهات الأمان
إدخال الملي ثانية داخل مطالبات exp أو iat لرمز JWT
استخدام Date.now() دون قسمة على 1000 يضبط انتهاء الرمز بعد آلاف السنين ويعطل مكتبات التحقق القياسية.
تخزين الطوابع الزمنية في أعمدة INT ذات 32 بت
ستفشل أي مواعيد أو رموز تمتد بعد 19 يناير 2038 داخل أعمدة قواعد البيانات التقليدية ذات 32 بت.
الاعتماد على التوقيت المحلي مع التوقيت الصيفي
احسب وقارن دائماً طوابع JWT بتوقيت UTC لتجنب فجوات الساعات عند تبدل التوقيت الصيفي.
إهمال سماحية انحراف الساعة بين الخوادم
امنح هامشاً صغيراً (30 إلى 60 ثانية) عند التحقق من nbf و exp بين الخدمات الموزعة.
مقارنة تمثيلات وقت Unix وحدودها التقنية
| التمثيل | الوحدة | حد التجاوز | الاستخدام الشائع |
|---|---|---|---|
| JWT NumericDate | ثوانٍ بتوقيت UTC | آمن في 64 بت | مطالبات iat و nbf و exp (RFC 7519) |
| JavaScript Date.now() | ملي ثانية بتوقيت UTC | ±8.64e15 ms (~عام 275,760) | مؤقتات المتصفح وسجلات الأحداث |
| time_t 32 بت بإشارة | ثوانٍ (Int32) | 2038-01-19T03:14:07Z | الأنظمة القديمة وبرامج C الموروثة |
| عدد صحيح 64 بت BIGINT | ثوانٍ أو ملي ثانية | > 292 مليار سنة | قواعد البيانات الحديثة وسجلات الأمان |
أمثلة برمجية (Node.js و Python و Java)
أنشئ مطالبات NumericDate بالثواني وحوّل المناطق الزمنية IANA برمجياً في الخوادم:
// JWT NumericDate claims in whole seconds (RFC 7519 Section 2)
const nowSeconds = Math.floor(Date.now() / 1000);
const payload = {
sub: 'user_12345',
iat: nowSeconds,
nbf: nowSeconds,
exp: nowSeconds + 900, // +15 minutes
};
const isoUtc = new Date(payload.exp * 1000).toISOString();from datetime import datetime, timezone, timedelta
now = datetime.now(timezone.utc)
iat = int(now.timestamp())
exp = int((now + timedelta(hours=1)).timestamp())
human_utc = datetime.fromtimestamp(exp, tz=timezone.utc).isoformat()import java.time.Instant;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
long nowEpochSec = Instant.now().getEpochSecond();
long expEpochSec = nowEpochSec + 3600; // +1 hour
String nyTime = DateTimeFormatter.ISO_OFFSET_DATE_TIME
.withZone(ZoneId.of("America/New_York"))
.format(Instant.ofEpochSecond(expEpochSec));الأسئلة الشائعة
هل تستخدم مطالبات JWT مثل exp و iat الثواني أم الملي ثانية؟
تستخدم الثواني دائماً؛ إذ تنص RFC 7519 على أن NumericDate يمثل عدد الثواني منذ 1970-01-01T00:00:00Z UTC.
كيف يميز المحول بين الثواني والملي ثانية تلقائياً؟
في الوضع التلقائي تُفسّر الأرقام التي تبلغ قيمتها المطلقة 1e11 فأكثر على أنها ملي ثانية، مع إمكانية التبديل اليدوي في أي وقت.
ما المقصود بمشكلة عام 2038 في توقيت Unix؟
الحد الأقصى للعدد الصحيح ذي 32 بت هو 2,147,483,647 ثانية الموافق 19 يناير 2038 الساعة 03:14:07 UTC، وبعدها يلتف العد في الأنظمة القديمة إلى عام 1901.
هل يدعم المحول الأرقام السالبة قبل عام 1970؟
نعم؛ فالقيمة -86400 ثانية مثلاً تعادل 31 ديسمبر 1969 الساعة 00:00:00 UTC بدقة تامة.
ما الفرق بين صيغة ISO 8601 وصيغة RFC 2822؟
كلاهما يعرض اللحظة الزمنية نفسها، لكن ISO 8601 هي القياسية في API و JSON بينما تُستخدم RFC 2822 في ترويسات HTTP والبريد الإلكتروني.
هل تُرسَل التواريخ أو الطوابع إلى أي خادم خارجي؟
لا، تجري كل العمليات محلياً داخل متصفحك عبر Date و Intl دون أي طلبات شبكية.
أدوات ذات صلة
عن الكاتب
تطوّر Avada Labs أدوات مجانية للمطورين، من بينها هذا الموقع، بخبرة تمتد لست سنوات في تطوير الويب والأدوات البرمجية. المشاريع والشيفرة المصدرية متاحة على GitHub.