محول الطوابع الزمنية

الدليل الكامل لطوابع Unix الزمنية

كل طابع زمني تقريبًا تصادفه كمطور — في واجهات API وقواعد البيانات وملفات السجلات ورموز JWT — هو طابع Unix زمني: رقم عادي يحسب الثواني من عصر Unix (منتصف الليل، 1 يناير 1970، UTC). وقد اختير لأن مقارنة لحظتين تصبح رياضيات أعداد صحيحة تافهة، دون مناطق زمنية أو صيغ للجدل حولها.

فخ الثواني مقابل أجزاء الثانية هو خطأ الطوابع الزمنية الأول في الواقع. Date.now() في JavaScript تعيد أجزاء الثانية (13 رقمًا)، بينما تستخدم معظم واجهات API للخوادم وقواعد البيانات الثواني (10 أرقام). الصق قيمة أجزاء ثانية في شيفرة تتوقع ثوانٍ وستصل إلى عام 56,000. ويكتشف هذا المحوّل عدد الأرقام تلقائيًا حتى تعرف دائمًا أيهما تحمل.

استخدامات يومية

• تصحيح السجلات: غالبًا ما تطبع سجلات الخوادم قيم عصر خام — حوّلها لترى بالضبط متى حدث أمر ما في منطقتك الزمنية.
• عمل API: تعيد واجهات REST created_at كثوانٍ عصر؛ حوّل للتحقق من انتهاء الرمز أو مدة التخزين المؤقت.
• قواعد البيانات: تحقق مما تمثله فعليًا قيمة تاريخ عدد صحيح مخزنة قبل تشغيل عمليات الترحيل.
• الجدولة: حوّل تاريخًا مستقبليًا إلى طابع زمني لمهام cron أو التذكيرات أو مؤقتات العد التنازلي.

التحويل في الشيفرة

في JavaScript: new Date(1761091200 * 1000) (اضرب الثواني في 1000). وفي Python: datetime.fromtimestamp(1761091200, tz=timezone.utc). وفي PostgreSQL: to_timestamp(1761091200). وبالاتجاه الآخر: Math.floor(Date.now() / 1000) في JS، أو int(datetime.now(timezone.utc).timestamp()) في Python.

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

الطوابع الزمنية السالبة والتواريخ البعيدة

لا تقتصر الطوابع الزمنية على التواريخ بعد 1970. فالقيم السالبة تمثل لحظات قبل العصر — مثلًا، -86400 هو 31 ديسمبر 1969. ويستخدم المؤرخون وأمناء المحفوظات الطوابع الزمنية السالبة لسجلات ما قبل 1970، ويتعامل المحوّل معها بشكل صحيح. وتعمل التواريخ البعيدة أيضًا: فطوابع 64 بت تبقى صالحة لمئات ملايين السنين، أبعد بكثير من أي حاجة عملية.

صيغ الطوابع الزمنية الشائعة في الواقع

• سلاسل ISO 8601 ("2026-10-22T07:00:00Z") — مقروءة وقابلة للفرز ولا لبس فيها. مفضلة لواجهات API.
• ثواني العصر (1761091200) — مدمجة؛ قياسية في أنظمة Unix وPHP (time()) ومعظم قواعد البيانات.
• أجزاء ثانية العصر (1761091200000) — الصيغة الأصلية لـ JavaScript عبر Date.now().
• RFC 2822 ("Thu, 22 Oct 2026 07:00:00 GMT") — مستخدم في ترويسات البريد وHTTP.

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