فهرست مستندات پروژه

تاریخ شمسی

Persian Kitv1.0.1مشاهده منبعفارسی / انگلیسی

نمایش و ورود تاریخ شمسی، منطقه زمانی و فیلدهای REST را بشناسید.

تاریخی که کاربر می‌بیند

در Persian Kit > نمایش، بخش تاریخ شمسی پیش‌فرض روشن است. وردپرس تاریخ را میلادی ذخیره می‌کند؛ این بخش نمایش تاریخ نوشته و دیدگاه، تاریخ‌های پیشخوان و رابط ورود تاریخ را تغییر می‌دهد. ستون‌های تاریخ دیتابیس شمسی نمی‌شوند. منطقه زمانی را در تنظیمات > عمومی سایت تنظیم کنید؛ ساعت سرور یا مرورگر جای آن را نمی‌گیرد.

با قالب Y/m/d، تاریخ میلادی 2026-10-02 به شکل 1405/07/10 نمایش داده می‌شود. برای اعداد فارسی باید بخش اعداد فارسی و گزینه تاریخ آن هم روشن باشند. timestamp یک لحظه مشخص است؛ تاریخ بدون منطقه زمانی باید با توجه به منبعش خوانده شود. کد، فیلدهای GMT وردپرس را با UTC و فیلدهای محلی را با منطقه زمانی سایت می‌خواند تا اختلاف ساعت دو بار اضافه نشود. یک لحظه آخر شب در UTC ممکن است در ساعت محلی به روز بعد برسد.

تاریخ نوشته در Classic Editor و ویرایش سریع انتخابگر شمسی دارد. ویرایشگر بلوکی یک ردیف انتشار شمسی در پنل‌های انتشار اضافه می‌کند و گزینه اکنون از ساعت سایت استفاده می‌کند. فیلتر ماه نوشته‌ها و رسانه هم بازه شمسی دارد. تاریخ انتخاب‌شده میلادی ذخیره می‌شود. رابط انتخابگر به JavaScript نیاز دارد؛ این به معنی پشتیبانی از ورود شمسی در همه فیلدهای افزونه‌های دیگر نیست.

قالب تاریخ و نام ماه‌ها

از قالب‌های تاریخ وردپرس استفاده کنید: Y/m/d برای تاریخ عددی یا j F Y برای روز، نام ماه و سال. نام ماه‌ها پیش‌فرض خودکار است: ایرانی، دری برای fa_AF، پشتو برای ps و کردی سورانی برای ckb. انتخاب نام‌ها محاسبات تقویم را عوض نمی‌کند. در سایت چندزبانه برای هر زبان انتخاب جدا دارید. انتخابگر مرورگر از داده Intl استفاده می‌کند؛ اگر نام‌های پشتو یا سورانی موجود نباشند، به‌ترتیب نام‌های دری یا ایرانی را نشان می‌دهد.

نمایش تاریخ میلادی در کنار شمسی پیش‌فرض خاموش است. با روشن کردن آن می‌توانید حالت عددی یا نام ماه، ترتیب تاریخ‌ها و جداکننده پرانتز، اسلش یا خط تیره را انتخاب کنید. با قالب j F Y، وقتی اعداد فارسی خاموش باشد، ۲ اکتبر ۲۰۲۶ به شکل 10 مهر 1405 (2026-10-02) دیده می‌شود. این قابلیت فقط برای تاریخ نوشته و دیدگاه در سایت است که روز، ماه و سال دارند؛ برای ساعت، بایگانی، پیشخوان، ایمیل، REST یا persian_kit_date() اجرا نمی‌شود. قالب‌های Y-m-d و Ymd هم کنار گذاشته می‌شوند، مگر اینکه قالب تاریخ خود سایت باشند. در حالت عددی، علامت‌های نامرئی جهت متن هم اضافه می‌شوند تا ترتیب تاریخ در متن راست‌به‌چپ درست بماند.

تبدیل همه تاریخ‌ها در بخش پیشرفته خاموش است. این گزینه خروجی wp_date() را هم تغییر می‌دهد و ممکن است روی افزونه‌ای که متن تاریخ را پردازش می‌کند اثر بگذارد. فقط بعد از آزمایش قالب، SEO، رزرو و فرم‌ها آن را روشن کنید. برای قالب‌های ماشینی و feed محافظت وجود دارد، ولی سازگاری با هر افزونه‌ای تضمین نشده است.

REST و استفاده در کد

وقتی این بخش روشن باشد، post typeهایی که در REST هستند دو فیلد فقط‌خواندنی date_jalali و date_modified_jalali در حالت view/embed می‌گیرند. مقدار آن‌ها با اعداد انگلیسی و ساعت سایت در شکل YYYY-MM-DDTHH:MM:SS است؛ اگر تاریخ در دسترس نباشد null است. با وجود شکل مشابه، تاریخ میلادی ISO 8601 نیستند. فیلدهای اصلی REST میلادی می‌مانند و همه endpointها تبدیل نمی‌شوند. انتخاب فقط همین فیلدها با _fields هم پشتیبانی می‌شود.

برای قالب‌بندی و تبدیل صریح تقویم از توابع تاریخ استفاده کنید. برای نتیجه قابل تکرار، timestamp و DateTimeZone مشخص بدهید. توابع 0 و '' را اکنون حساب می‌کنند و رشته تاریخ را به strtotime() در PHP می‌دهند. رشته بدون منطقه زمانی از timezone پیش‌فرض PHP پیروی می‌کند که در وردپرس معمولا UTC است.

اگر قالب هنوز تاریخ میلادی نشان می‌دهد، پیش از روشن کردن گزینه پیشرفته، زبان، قالب تاریخ و تابع وردپرسی مورد استفاده را بررسی کنید. بعد از تغییر cache یا بهینه‌سازی فایل‌ها هم انتخابگر را امتحان کنید. مرتبط: بایگانی و لینک، فرم‌ها، WooCommerce و سازگاری.

جستجو در مستندات

در همه پروژه‌ها جستجو کنید. با بستن این پنجره به راهنما برمی‌گردید.

Tab برای جابه‌جایی · Enter برای باز کردنEsc برای بستن