<time>: The (Date) Time element

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.

Phần tử <time> trong HTML đại diện cho một khoảng thời gian cụ thể. Nó có thể bao gồm thuộc tính datetime để chuyển đổi ngày tháng sang định dạng máy đọc được, cho phép kết quả tìm kiếm tốt hơn hoặc các tính năng tùy chỉnh như nhắc nhở.

Nó có thể đại diện cho một trong những điều sau:

Try it

<p>
  The Cure will be celebrating their 40th anniversary on
  <time datetime="2018-07-07">July 7</time> in London's Hyde Park.
</p>

<p>
  The concert starts at <time datetime="20:00">20:00</time> and you'll be able
  to enjoy the band for at least <time datetime="PT2H30M">2h 30m</time>.
</p>
time {
  font-weight: bold;
}

Thuộc tính

Giống như tất cả các phần tử HTML khác, phần tử này hỗ trợ các thuộc tính toàn cục.

datetime

Thuộc tính này chỉ ra thời gian và/hoặc ngày tháng của phần tử và phải ở một trong các định dạng được mô tả bên dưới.

Ghi chú sử dụng

Phần tử này dùng để trình bày ngày tháng và thời gian theo định dạng máy đọc được. Ví dụ, điều này có thể giúp tác nhân người dùng đề nghị thêm sự kiện vào lịch của người dùng.

Phần tử này không nên được dùng cho các ngày tháng trước khi lịch Gregory được giới thiệu (do sự phức tạp trong việc tính toán những ngày đó).

Giá trị datetime (giá trị máy đọc được của datetime) là giá trị của thuộc tính datetime của phần tử, phải ở định dạng phù hợp (xem bên dưới). Nếu phần tử không có thuộc tính datetime, nó không được có bất kỳ phần tử con nào, và giá trị datetime là nội dung văn bản con của phần tử.

Các giá trị datetime hợp lệ

Mô tả Microsyntax Ví dụ
Chuỗi tháng hợp lệ YYYY-MM 2011-11, 2013-05
Chuỗi ngày hợp lệ YYYY-MM-DD 1887-12-01
Chuỗi ngày không có năm hợp lệ MM-DD 11-12
Chuỗi thời gian hợp lệ HH:MM
HH:MM:SS
HH:MM:SS.mmm
23:59
12:15:47
12:15:52.998
Chuỗi ngày và giờ địa phương hợp lệ YYYY-MM-DD HH:MM
YYYY-MM-DD HH:MM:SS
YYYY-MM-DD HH:MM:SS.mmm
YYYY-MM-DDTHH:MM
YYYY-MM-DDTHH:MM:SS
YYYY-MM-DDTHH:MM:SS.mmm
2013-12-25 11:12
1972-07-25 13:43:07
1941-03-15 07:06:23.678
2013-12-25T11:12
1972-07-25T13:43:07
1941-03-15T07:06:23.678
Chuỗi độ lệch múi giờ hợp lệ Z
+HHMM
+HH:MM
-HHMM
-HH:MM
Z
+0200
+04:30
-0300
-08:00
Chuỗi ngày và giờ toàn cầu hợp lệ Bất kỳ sự kết hợp nào của chuỗi ngày và giờ địa phương hợp lệ theo sau bởi chuỗi độ lệch múi giờ hợp lệ 2013-12-25 11:12+0200
1972-07-25 13:43:07+04:30
1941-03-15 07:06:23.678Z
2013-12-25T11:12-08:00
Chuỗi tuần hợp lệ YYYY-WWW 2013-W46
Bốn hoặc nhiều chữ số ASCII YYYY 2013, 0001
Chuỗi khoảng thời gian hợp lệ PdDThHmMsS
PdDThHmMs.XS
PdDThHmMs.XXS
PdDThHmMs.XXXS
PThHmMsS
PThHmMs.XS
PThHmMs.XXS
PThHmMs.XXXS
ww dd hh mm ss
P12DT7H12M13S
P12DT7H12M13.3S
P12DT7H12M13.45S
P12DT7H12M13.455S
PT7H12M13S
PT7H12M13.2S
PT7H12M13.56S
PT7H12M13.999S
7d 5h 24m 13s

Ví dụ

Ví dụ cơ bản

HTML

html
<p>The concert starts at <time datetime="2018-07-07T20:00:00">20:00</time>.</p>

Kết quả

Ví dụ datetime

HTML

html
<p>
  The concert took place on <time datetime="2001-05-15T19:00">May 15</time>.
</p>

Kết quả

Tóm tắt kỹ thuật

Danh mục nội dung Nội dung luồng, nội dung cụm từ, nội dung rõ ràng.
Nội dung được phép Nội dung cụm từ.
Bỏ thẻ Không được phép, cả thẻ mở và thẻ đóng đều bắt buộc.
Phần tử cha được phép Bất kỳ phần tử nào chấp nhận nội dung cụm từ.
Vai trò ARIA ngầm định time
Vai trò ARIA được phép Bất kỳ
Giao diện DOM HTMLTimeElement

Đặc tả

Specification
HTML
# the-time-element

Tương thích trình duyệt

Xem thêm

  • Phần tử <data>, cho phép biểu thị các loại giá trị khác.