تبدیل مهر زمانی

راهنمای کامل مهر زمانی Unix

به عنوان توسعه دهنده تقریبا هر مهر زمانی که دریافت می کنید — در API ها، پایگاه های داده، فایل های گزارش و توکن های JWT — مهر زمانی Unix است: عددی ساده که ثانیه ها را از ایپاک Unix (نیمه شب، 1 ژانویه 1970، UTC) می شمارد. این انتخاب شده است چون مقایسه دو لحظه به ریاضی ساده اعداد صحیح تبدیل می شود، بدون بحث درباره مناطق زمانی یا قالب ها.

تله ثانیه ها در برابر میلی ثانیه ها این در واقع نخستین اشتباه مهر زمانی است. Date.now() در جاوا اسکریپت برمی گرداند میلی ثانیه ها (13 رقم)، در حالی که بیشتر API های سرور و پایگاه های داده استفاده می کنند ثانیه ها (10 رقم). مقدار میلی ثانیه ای را در کدی که انتظار ثانیه دارد بچسبانید و به سال 56000 می رسید. و این مبدل تعداد ارقام را به صورت خودکار تشخیص می دهد تا همیشه بدانید کدام را دارید.

استفاده روزمره

• اشکال زدایی گزارش ها: گزارش های سرور اغلب مقادیر خام ایپاک چاپ می کنند — آنها را تبدیل کنید تا دقیقا ببینید چیزی در منطقه زمانی شما چه زمانی رخ داده است.
• کار با API: API های REST برمی گردانند created_at به صورت ثانیه های ایپاک؛ برای بررسی انقضای توکن یا مدت کش تبدیل کنید.
• پایگاه های داده: پیش از اجرای مهاجرت ها تایید کنید مقدار تاریخ عدد صحیح ذخیره شده واقعا چه چیزی را نشان می دهد.
• زمان بندی: برای کارهای cron، یادآوری ها یا تایمرهای شمارش معکوس، تاریخ آینده را به مهر زمانی تبدیل کنید.

تبدیل در کد

در جاوا اسکریپت: 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) — قالب اصلی جاوا اسکریپت توسط Date.now().
• RFC 2822 ("Thu, 22 Oct 2026 07:00:00 GMT") — در ایمیل و سربرگ های HTTP استفاده می شود.

وقتی مهر زمانی دریافت می کنید و از قالب آن مطمئن نیستید، نخست آن را در اینجا بچسبانید — تشخیص خودکار پیش از نوشتن یک خط کد به شما می گوید ثانیه ها را می بینید یا میلی ثانیه ها.