راهنمای HTML : استفاده از فرمت‌های تاریخ و زمان در HTML

برخی از عناصر HTML از مقادیر تاریخ و/یا زمان استفاده می‌کنند. قالب‌های رشته‌هایی که این مقادیر را مشخص می‌کنند در این مقاله توضیح داده شده‌اند.

عناصری که از چنین قالب‌هایی استفاده می‌کنند شامل اشکال خاصی از عنصر هستند که به کاربر اجازه می‌دهند تاریخ، زمان یا هر دو را انتخاب یا مشخص کند، و همچنین عناصر و که ویژگی datetime آنها تاریخ یا تاریخ و زمانی را که درج یا حذف محتوا در آن رخ داده است، مشخص می‌کند. برای ، مقادیر نوع ورودی‌هایی که مقدار آنها شامل رشته‌ای است که نشان دهنده تاریخ و/یا زمان است عبارتند از: date datetime-local month time week

مثال‌ها

قبل از اینکه به پیچیدگی‌های نحوه‌ی نگارش و تجزیه‌ی رشته‌های تاریخ و زمان در HTML بپردازیم، در اینجا چند مثال آورده شده است که باید به شما ایده‌ی خوبی از قالب‌های رایج‌تر رشته‌های تاریخ و زمان بدهد.

رشته	تاریخ و/یا زمان
2005-06-07	June 7, 2005
08:45	8:45 AM
08:45:25	8:45 AM and 25 seconds
0033-08-04T03:40	3:40 AM on August 4, 33
1977-04-01T14:00:30	30 seconds after 2:00 PM on April 1, 1977
1901-01-01T00:00Z	Midnight UTC on January 1, 1901
1901-01-01T00:00:01-04:00	1 second past midnight Eastern Standard Time (EST) on January 1, 1901

مبانی

قبل از بررسی قالب‌های مختلف رشته‌های مرتبط با تاریخ و زمان که توسط عناصر HTML استفاده می‌شوند، درک چند واقعیت اساسی در مورد نحوه تعریف آنها مفید است. HTML از نوعی استاندارد ISO 8601 برای رشته‌های تاریخ و زمان خود استفاده می‌کند. برای اطمینان از سازگاری رشته‌های شما با HTML، بررسی توضیحات قالب‌هایی که استفاده می‌کنید، ارزشمند است، زیرا مشخصات HTML شامل الگوریتم‌هایی برای تجزیه این رشته‌ها است که در واقع دقیق‌تر از ISO 8601 است، بنابراین ممکن است تفاوت‌های ظریفی در نحوه نمایش رشته‌های تاریخ و زمان وجود داشته باشد. تاریخ و زمان در HTML همیشه رشته‌هایی هستند که از مجموعه کاراکترهای ASCII استفاده می‌کنند.

سال شمارها

برای ساده‌سازی قالب پایه مورد استفاده برای رشته‌های تاریخ در HTML، مشخصات ایجاب می‌کند که همه سال‌ها با استفاده از تقویم میلادی مدرن (یا تقویم میلادی اولیه) ارائه شوند. در حالی که رابط‌های کاربری ممکن است امکان ورود تاریخ‌ها با استفاده از تقویم‌های دیگر را فراهم کنند، مقدار اصلی همیشه از تقویم میلادی استفاده می‌کند. در حالی که تقویم میلادی تا سال ۱۵۸۲ (جایگزین تقویم جولیان مشابه) ایجاد نشد، برای اهداف HTML، تقویم میلادی تا سال ۱ میلادی گسترش می‌یابد. مطمئن شوید که تاریخ‌های قدیمی‌تر این را در نظر می‌گیرند. برای اهداف تاریخ‌های HTML، سال‌ها همیشه حداقل چهار رقم دارند. سال‌های قبل از سال ۱۰۰۰ با صفرهای پیشرو (۰) پر می‌شوند، بنابراین سال ۷۲ به صورت ۰۰۷۲ نوشته می‌شود. سال‌های قبل از سال ۱ میلادی پشتیبانی نمی‌شوند، بنابراین HTML از سال‌های ۱ قبل از میلاد (۱ قبل از میلاد) یا قبل از آن پشتیبانی نمی‌کند. یک سال معمولاً ۳۶۵ روز طول دارد، مگر در سال‌های کبیسه.

سال‌های کبیسه

سال کبیسه به سالی گفته می‌شود که بر ۴۰۰ قابل تقسیم باشد یا بر ۴ قابل تقسیم باشد اما بر ۱۰۰ قابل تقسیم نباشد. اگرچه سال تقویمی معمولاً ۳۶۵ روز است، اما در واقع سیاره زمین تقریباً ۳۶۵.۲۴۲۲ روز طول می‌کشد تا یک دور کامل به دور خورشید بچرخد. سال‌های کبیسه به تنظیم تقویم کمک می‌کنند تا با موقعیت واقعی سیاره در مدار خود هماهنگ باشد. اضافه کردن یک روز به سال هر چهار سال اساساً طول سال متوسط را ۳۶۵.۲۵ روز می‌کند که تقریباً صحیح است. تنظیمات الگوریتم (در نظر گرفتن سال کبیسه وقتی سال را می‌توان بر ۴۰۰ تقسیم کرد و صرف نظر کردن از سال‌های کبیسه وقتی سال بر ۱۰۰ قابل تقسیم است) به نزدیک‌تر کردن میانگین به تعداد صحیح روزها (۳۶۵.۲۴۲۵ روز) کمک می‌کند. دانشمندان گاهی اوقات (جدی) ثانیه‌های کبیسه را به تقویم اضافه می‌کنند تا سه ده هزارم روز باقی مانده را مدیریت کنند و کند شدن تدریجی و طبیعی چرخش زمین را جبران کنند. در حالی که ماه دوم، فوریه، معمولاً ۲۸ روز دارد، در سال‌های کبیسه ۲۹ روز دارد.

ماه‌های سال

سال ۱۲ ماه دارد که از ۱ تا ۱۲ شماره‌گذاری شده‌اند. این ماه‌ها همیشه با یک رشته ASCII دو رقمی نمایش داده می‌شوند که مقدار آن از ۰۱ تا ۱۲ متغیر است. برای شماره ماه‌ها و نام‌های مربوط به آنها (و طول آنها بر حسب روز) به جدول موجود در بخش «روزهای ماه» مراجعه کنید.

روزهای ماه

ماه‌های ۱، ۳، ۵، ۷، ۸، ۱۰ و ۱۲، ۳۱ روز دارند. ماه‌های ۴، ۶، ۹ و ۱۱، ۳۰ روز دارند. ماه دوم، فوریه، در بیشتر سال‌ها ۲۸ روز دارد، اما در سال‌های کبیسه ۲۹ روز است. این موضوع در جدول زیر به تفصیل آمده است.

شماره ماه	نام	تعداد روز
01	ژانویه	31
02	فوریه	28 (29 در سال‌های کبیسه)
03	مارس	31
04	آوریل	30
05	مه (می)	31
06	ژوئن	30
07	جولای	31
08	اوت	31
09	سپتامبر	30
10	اکتبر	31
11	نوامبر	30
12	دسامبر	31

رشته‌های هفته

رشته هفته، یک هفته را در یک سال خاص مشخص می‌کند. یک رشته هفته معتبر شامل یک شماره سال معتبر، به دنبال آن یک کاراکتر خط تیره (-، یا U+002D)، سپس حرف بزرگ W (U+0057) و به دنبال آن یک هفته دو رقمی از مقدار سال است. هفته سال یک رشته دو رقمی بین 01 تا 53 است. هر هفته از دوشنبه شروع می‌شود و در یکشنبه پایان می‌یابد. این بدان معناست که می‌توان چند روز اول ژانویه را بخشی از هفته-سال قبل و چند روز آخر دسامبر را بخشی از هفته-سال بعد در نظر گرفت. هفته اول سال، هفته‌ای است که شامل اولین پنجشنبه سال است. به عنوان مثال، اولین پنجشنبه سال 1953 در 1 ژانویه بود، بنابراین آن هفته - که از دوشنبه، 29 دسامبر شروع می‌شود - اولین هفته سال در نظر گرفته می‌شود. بنابراین، 30 دسامبر 1952 در طول هفته 1953-W01 رخ می‌دهد. یک سال ۵۳ هفته دارد اگر: روز اول سال تقویمی (اول ژانویه) پنجشنبه باشد یا روز اول سال (اول ژانویه) چهارشنبه باشد و سال کبیسه باشد تمام سال‌های دیگر ۵۲ هفته دارند.

رشته هفته	هفته و سال (محدوده تاریخ)
2001-W37	Week 37, 2001 (September 10-16, 2001)
1953-W01	Week 1, 1953 (December 29, 1952-January 4, 1953)
1948-W53	Week 53, 1948 (December 27, 1948-January 2, 1949)
1949-W01	Week 1, 1949 (January 3-9, 1949)
0531-W16	Week 16, 531 (April 13-19, 531)
0042-W04	Week 4, 42 (January 21-27, 42)

توجه داشته باشید که هم شماره سال و هم شماره هفته با صفرهای ابتدایی پر شده‌اند، به طوری که سال چهار رقم و هفته دو رقم دارد.

رشته‌های ماه

یک رشته ماه، به جای یک ماه عمومی از سال، یک ماه خاص را در زمان نشان می‌دهد. یعنی، به جای نشان دادن "ژانویه"، یک رشته ماه HTML نشان دهنده یک جفت ماه و سال است، مانند "ژانویه ۱۹۷۲". یک رشته ماه معتبر شامل یک شماره سال معتبر (رشته‌ای حداقل چهار رقمی) است که به دنبال آن یک کاراکتر خط فاصله (- یا U+002D) و به دنبال آن یک شماره ماه عددی دو رقمی قرار می‌گیرد، که در آن ۰۱ نشان دهنده ژانویه و ۱۲ نشان دهنده دسامبر است.

رشته ماه	ماه و سال
17310-09	September, 17310
2019-01	January, 2019
1993-11	November, 1993
0571-04	April, 571
0001-07	July, 1 C.E.

توجه داشته باشید که تمام سال‌ها حداقل چهار کاراکتر دارند؛ سال‌های کمتر از چهار رقم با صفرهای ابتدایی پر می‌شوند.

رشته‌های تاریخ

یک رشته تاریخ معتبر شامل یک رشته ماه است که به دنبال آن یک کاراکتر خط فاصله (- یا U+002D) و به دنبال آن یک روز دو رقمی از ماه می‌آید.

رشته تاریخ	تاریخ کامل
1993-11-01	November 1, 1993
1066-10-14	October 14, 1066
0571-04-22	April 22, 571
0062-02-05	February 5, 62

رشته‌های زمانی

یک رشته زمان می‌تواند زمان را با دقت دقیقه، ثانیه یا میلی‌ثانیه مشخص کند. مشخص کردن فقط ساعت یا دقیقه مجاز نیست. یک رشته زمان معتبر حداقل شامل یک ساعت دو رقمی و به دنبال آن یک دونقطه (:, U+003A) و سپس یک دقیقه دو رقمی است. دقیقه می‌تواند به صورت اختیاری با یک دونقطه دیگر و یک عدد دو رقمی ثانیه دنبال شود. میلی‌ثانیه را می‌توان به صورت اختیاری با اضافه کردن یک کاراکتر نقطه اعشار (., U+002E) و به دنبال آن یک، دو یا سه رقم مشخص کرد. چند قانون اساسی دیگر نیز وجود دارد: ساعت همیشه با استفاده از ساعت ۲۴ ساعته مشخص می‌شود، که ۰۰ نیمه‌شب و ۱۱ شب ۲۳ است. هیچ مقداری خارج از محدوده ۰۰ تا ۲۳ مجاز نیست. دقیقه باید یک عدد دو رقمی بین ۰۰ تا ۵۹ باشد. هیچ مقداری خارج از آن محدوده مجاز نیست. اگر تعداد ثانیه‌ها حذف شود (برای مشخص کردن زمانی که فقط به دقیقه دقیق است)، هیچ دونقطه‌ای نباید بعد از تعداد دقیقه‌ها بیاید. در صورت مشخص شدن، بخش صحیح تعداد ثانیه‌ها باید بین ۰۰ تا ۵۹ باشد. نمی‌توانید ثانیه کبیسه را با استفاده از مقادیری مانند ۶۰ یا ۶۱ مشخص کنید. اگر تعداد ثانیه‌ها مشخص شده و عدد صحیح باشد، نباید بعد از آن نقطه اعشار بیاید. اگر کسری از ثانیه گنجانده شود، می‌تواند از یک تا سه رقم باشد که نشان دهنده تعداد میلی‌ثانیه‌ها است. این عدد بعد از نقطه اعشاری قرار می‌گیرد که بعد از جزء ثانیه رشته زمان قرار می‌گیرد.

رشته زمانی	زمان
00:00:30.75	12:00:30.75 AM (30.75 seconds after midnight)
12:15	12:15 PM
13:44:25	1:44:25 PM (25 seconds after 1:44 PM)

رشته‌های تاریخ و زمان محلی

یک رشته معتبر datetime-local شامل یک رشته تاریخ و یک رشته زمان است که با حرف T یا یک کاراکتر فاصله از هم جدا شده‌اند. هیچ اطلاعاتی در مورد منطقه زمانی در رشته گنجانده نشده است؛ فرض می‌شود که تاریخ و زمان در منطقه زمانی محلی کاربر هستند. هنگامی که مقدار یک ورودی datetime-local را تنظیم می‌کنید، رشته به شکل استاندارد نرمال‌سازی می‌شود. رشته‌های datetime نرمال‌سازی شده همیشه از حرف T برای جدا کردن تاریخ و زمان استفاده می‌کنند و بخش زمان رشته تا حد امکان کوتاه است. این کار با حذف جزء ثانیه در صورتی که مقدار آن :00 باشد، انجام می‌شود.

رشته تاریخ/زمان	رشته تاریخ/زمان نرمال‌سازی شده	تاریخ و زمان واقعی
1986-01-28T11:38:00.01	1986-01-28T11:38:00.01	January 28, 1986 at 11:38:00.01 AM
1986-01-28 11:38:00.010	1986-01-28T11:38:00.01 توجه داشته باشید که پس از نرمال‌سازی، این همان رشته‌ی datetime-local قبلی است. فاصله با کاراکتر T جایگزین شده و صفر انتهایی در کسر ثانیه حذف شده است تا رشته تا حد امکان کوتاه شود.	January 28, 1986 at 11:38:00.01 AM
0170-07-31T22:00:00	0170-07-31T22:00 توجه داشته باشید که شکل نرمال‌شده‌ی این تاریخ، :00 را که نشان‌دهنده‌ی تعداد ثانیه‌هایی است که باید صفر باشند، حذف می‌کند، زیرا ثانیه‌ها در حالت صفر اختیاری هستند و رشته‌ی نرمال‌شده طول رشته را به حداقل می‌رساند.	July 31, 170 at 10:00 PM

رشته‌های تاریخ و زمان سراسری

یک رشته تاریخ و زمان سراسری، علاوه بر منطقه زمانی که در آن رخ می‌دهد، تاریخ و زمان را نیز مشخص می‌کند. یک رشته تاریخ و زمان سراسری معتبر، همان قالب یک رشته تاریخ و زمان محلی را دارد، با این تفاوت که یک رشته منطقه زمانی به انتهای آن و پس از زمان اضافه شده است.

رشته اختلاف در منطقه‌های زمانی

یک رشته انحراف منطقه زمانی، انحراف را در تعداد مثبت یا منفی ساعت و دقیقه از مبنای زمان استاندارد مشخص می‌کند. دو مبنای زمان استاندارد وجود دارد که بسیار نزدیک به هم هستند، اما دقیقاً یکسان نیستند: برای تاریخ‌های پس از تأسیس زمان هماهنگ جهانی (UTC) در اوایل دهه 1960، مبنای زمان Z است و انحراف نشان دهنده انحراف یک منطقه زمانی خاص از زمان در نصف النهار مبدا در طول جغرافیایی 0 درجه (که از رصدخانه سلطنتی گرینویچ، انگلستان عبور می‌کند) است. برای تاریخ‌های قبل از UTC، مبنای زمان بر حسب UT1 بیان می‌شود که زمان خورشیدی زمین معاصر در نصف النهار مبدا است. رشته منطقه زمانی بلافاصله پس از زمان در رشته تاریخ و زمان اضافه می‌شود. می‌توانید Z را به عنوان رشته انحراف منطقه زمانی مشخص کنید تا نشان دهید که زمان بر حسب UTC مشخص شده است. در غیر این صورت، رشته منطقه زمانی به صورت زیر ساخته می‌شود: یک کاراکتر که علامت انحراف را نشان می‌دهد: کاراکتر مثبت (+، یا U+002B) برای مناطق زمانی در شرق نصف‌النهار مبدا یا کاراکتر منفی (-، یا U+002D) برای مناطق زمانی در غرب نصف‌النهار مبدا. یک عدد دو رقمی از ساعاتی که منطقه زمانی از نصف‌النهار مبدا انحراف دارد. این مقدار باید بین 00 تا 23 باشد. یک کاراکتر اختیاری دو نقطه (:). یک عدد دو رقمی از دقایق گذشته از ساعت؛ این مقدار باید بین 00 تا 59 باشد. در حالی که این قالب امکان استفاده از مناطق زمانی بین -23:59 و +23:59 را فراهم می‌کند، محدوده فعلی انحرافات منطقه زمانی از -12:00 تا +14:00 است و در حال حاضر هیچ منطقه زمانی به جز 00، 30 یا 45 دقیقه از ساعت انحراف ندارد. این ممکن است کم و بیش در هر زمانی تغییر کند، زیرا کشورها آزادند که در هر زمان و به هر روشی که مایل باشند، مناطق زمانی خود را دستکاری کنند.

رشته تاریخ و زمان سراسری	تاریخ و زمان جهانی واقعی	تاریخ و زمان در نصف النهار مبدا
2005-06-07T00:00Z	June 7, 2005 at midnight UTC	June 7, 2005 at midnight
1789-08-22T12:30:00.1-04:00	August 22, 1789 at a tenth of a second past 12:30 PM Eastern Daylight Time (EDT)	August 22, 1789 at a tenth of a second past 4:30 PM
3755-01-01 00:00+10:00	January 1, 3755 at midnight Australian Eastern Standard Time (AEST)	December 31, 3754 at 2:00 PM

مشکلات مربوط به تاریخ

به دلیل مشکلات مربوط به ذخیره سازی داده ها و دقت، ممکن است بخواهید از چند مشکل سمت کلاینت و سمت سرور آگاه باشید.

مشکل Y2K38 (اغلب سمت سرور)

جاوا اسکریپت از اعداد اعشاری با دقت مضاعف برای ذخیره تاریخ‌ها، مانند همه اعداد، استفاده می‌کند، به این معنی که کد جاوا اسکریپت از مشکل Y2K38 رنج نخواهد برد، مگر اینکه از اجبار عدد صحیح/هک‌های بیتی استفاده شود، زیرا همه عملگرهای بیتی جاوا اسکریپت از اعداد صحیح 32 بیتی علامت‌دار مکمل 2s استفاده می‌کنند. مشکل در سمت سرور است: ذخیره تاریخ‌های بزرگتر از 2^31 - 1. برای رفع این مشکل، باید همه تاریخ‌ها را با استفاده از اعداد صحیح 32 بیتی بدون علامت، اعداد صحیح 64 بیتی علامت‌دار یا اعداد اعشاری با دقت مضاعف روی سرور ذخیره کنید. اگر سرور شما با PHP نوشته شده است، رفع این مشکل ممکن است نیاز به ارتقاء PHP شما به نسخه جدیدتر و ارتقاء سخت‌افزار شما به x86_64 یا IA64 داشته باشد. اگر با سخت‌افزار دیگری گیر کرده‌اید، می‌توانید سعی کنید سخت‌افزار 64 بیتی را در یک ماشین مجازی 32 بیتی شبیه‌سازی کنید، اما اکثر ماشین‌های مجازی از این نوع مجازی‌سازی پشتیبانی نمی‌کنند، زیرا ممکن است پایداری آسیب ببیند و عملکرد قطعاً به شدت آسیب خواهد دید.

مشکل Y10k (اغلب از سمت کلاینت)

در بسیاری از سرورها، تاریخ‌ها به جای رشته، به صورت عدد ذخیره می‌شوند - اعدادی با اندازه ثابت و بدون وابستگی به قالب (به جز endianness). پس از سال ۱۰۰۰۰، این اعداد فقط کمی بزرگتر از قبل خواهند بود، بنابراین بسیاری از سرورها با فرم‌های ارسالی پس از سال ۱۰۰۰۰ مشکلی نخواهند داشت. مشکل از سمت کلاینت است: تجزیه تاریخ‌هایی با بیش از ۴ رقم در سال.

HTML

ما باید کد خود را برای هر تعداد رقم - نه فقط ۵ - آماده کنیم. تابع جاوا اسکریپت زیر به صورت برنامه‌نویسی شده مقدار را تنظیم می‌کند:

JAVASCRIPT

چرا نگران مشکل Y10K باشید اگر قرار است قرن‌ها بعد شما اتفاق بیفتد؟ دقیقاً به این دلیل که شما دیگر نیستید، بنابراین شرکت‌هایی که از نرم‌افزار شما استفاده می‌کنند، بدون هیچ کدنویس دیگری که سیستم را به خوبی بشناسد و بتواند آن را اصلاح کند، مجبور به استفاده از نرم‌افزار شما خواهند بود.