HTML <time> datetime 属性

تعریف و استفاده

datetime ویژگی‌ها نمونه‌ای از فرمت machine-readable برای عنصر <time> را نشان می‌دهد.

مثال‌هایی از تاریخ‌های زمانی معتبر:

تاریخ:

<time datetime="1914">  <!-- به معنای 1914 -->
<time datetime="1914-12">  <!-- به معنای 12 ماه 1914 -->
<time datetime="1914-12-20">  <!-- به معنای 20 دسامبر 1914 -->
<time datetime="12-20">  <!-- به معنای 20 دسامبر هر سال -->
<time datetime="1914-W15">  <!-- به معنای هفته 15 سال 1914 -->

تاریخ و زمان:

<time datetime="1914-12-20T08:00">  <!-- به معنای 8 صبح 20 دسامبر 1914 -->
<time datetime="1914-12-20 08:00">  <!-- نیز به معنای 8 صبح 20 دسامبر 1914 -->
<time datetime="1914-12-20 08:30:45">  <!-- شامل دقیقه و ثانیه -->
<time datetime="1914-12-20 08:30:45.687">  <!-- شامل دقیقه، ثانیه و میلisecond -->

زمان:

<time datetime="08:00">  <!-- به معنای ساعت 8 صبح -->
<time datetime="08:00-03:00">  <!-- به معنای ساعت 8 صبح در زمان ریو دو ژانیرو (UTC-3 ساعت). -->
<time datetime="08:00+03:00">  <!-- به معنای ساعت 8 صبح در زمان ماداگاسکار (UTC+3 ساعت) -->

مدت زمان:

<time datetime="P2D">  <!-- به معنای 2 روز -->
<time datetime="PT15H10M">  <!-- به معنای 15 ساعت 10 دقیقه -->

مثال

عنصر time با خاصیت machine-readable datetime تنظیم شده است:

<p>من در <time datetime="2017-02-14">روز ولنتاین</time> یک معرفی داشتم.</p>

مخصوص طور تجربی

فارسی

<time datetime="YYYY-MM-DDThh:mm:ssTZD">

ارزش ویژگی

ارزش توضیح

YYYY-MM-DDThh:mm:ssTZD

یا

PTDHMS

تاریخ یا زمان تعیین شده. توضیح اجزا:

  • YYYY - سال (مثلاً 2011)
  • MM - ماه (مثلاً 01 به معنای ماه اول)
  • DD - روز (مثلاً 08)
  • T یا فاصله - جداکننده (اگر زمانی نیز مشخص شده باشد باید باشد)
  • hh - ساعت (مثلاً 22 به معنای 10 شب)
  • mm - دقیقه (مثلاً 55)
  • ss - ثانیه (مثلاً 03)
  • TZD - نشانگر منطقه زمانی (Z به معنای زمان استاندارد گرینویچ)
  • P - پیشوند "Period"
  • D - پیشوند "Days"
  • H - پیشوند "Hours"
  • M - پیشوند "Minutes"
  • S - پیشوند "Seconds"

پشتیبانی مرورگر

اعداد در جدول نشان‌دهنده نسخه اولیه مرورگرهایی است که از این ویژگی پشتیبانی می‌کنند.

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
62.0 18.0 22.0 7.0 49.0