تاریخ بدون زمان و تاریخوزمان دو مسئله متفاوتاند. در Jira ممکن است Due Date فقط یک روز تقویمی باشد، اما created، updated، worklog، زمان شروع و SLA به ساعت و دقیقه وابستهاند. هر راهکار شمسی باید این تفاوت را در تشخیص، نمایش و ذخیره رعایت کند.
Date و DateTime چه تفاوتی دارند؟
Date معمولاً برای یک روز مانند موعد تحویل استفاده میشود و DateTime لحظهای با ساعت و دقیقه را نمایش میدهد. تبدیل DateTime بدون توجه به timezone میتواند تاریخ را یک روز جلو یا عقب نشان دهد؛ مخصوصاً نزدیک نیمهشب یا هنگام مشاهده در چند منطقه زمانی.
در کد افزونه، تشخیص نوع field از metadata Jira و الگوهای ورودی پشتیبانی میشود، اما کیفیت نتیجه به فرمت و ساختار همان instance وابسته است.
فرمت تنظیمشده Jira را مبنا بگیرید
Jira برای date picker و date-time picker تنظیمات فرمت دارد. افزونه endpointی برای خواندن این تنظیمات دارد و parser/formatter را بر اساس آن تنظیم میکند. پیش از تست، فرمت Java و JavaScript، نمایش ۱۲ یا ۲۴ ساعته و ترتیب روز/ماه/سال را ثبت کنید.
- ترتیب روز، ماه و سال
- نام ماه یا عدد ماه
- ۱۲ ساعته یا ۲۴ ساعته
- وجود ثانیه و timezone
- فرمت ورودی در جستوجو
سناریوهای حساس
برای پروژههای زمانمحور، پایان ماههای شمسی، ابتدای روز کاری، deadline نزدیک نیمهشب، worklog و SLA را تست کنید. یک timestamp که در صفحه issue درست بهنظر میرسد ممکن است در گزارش یا integration با timezone دیگری نمایش داده شود.
راهنمای استفاده برای کاربران
به کاربران توضیح دهید که تاریخ نمایش دادهشده فارسی است، اما قواعد محاسبه و ذخیره Jira همچنان باید با پیکربندی سازمان هماهنگ باشد. برای گزارشهای رسمی، قالب تاریخ و timezone مرجع را در مستند پروژه ثبت کنید.