s_skaidocsTài liệu

date & date_go

Có sẵn · Lingo core & Theme runtime

Dùng date với cú pháp PHP dễ nhớ. Dùng date_go để giữ định dạng Go của theme cũ. Không cần cài thêm thư viện.

date — Cú pháp PHP

LINGO
{{ article.published_at|date:"d/m/Y" }}
{{ article.published_at|date:"Y-m-d H:i:s" }}
{{ article.published_at|date:"c" }}
KÝ TỰÝ NGHĨAVÍ DỤ
Y / yNăm đầy đủ / hai chữ số2026 / 26
m / nTháng có / không có số 0 đầu09 / 9
d / jNgày có / không có số 0 đầu05 / 5
H / hGiờ 24h / 12h15 / 03
i / sPhút / giây04 / 05
l / DThứ đầy đủ / viết tắt, tiếng AnhThursday / Thu
F / MTháng đầy đủ / viết tắt, tiếng AnhSeptember / Sep
P / pĐộ lệch múi giờ; p dùng Z cho UTC+07:00 / Z
cISO 8601, phù hợp SEO2026-09-24T15:04:05+07:00
U / u / vUnix timestamp / microsecond / millisecondĐịnh dạng giá trị time.Time hiện tại

Các token khác: N S w z W t L o X x a A B g G e I O T Z r. Ký tự không phải token được giữ nguyên. Dấu backslash escape ký tự kế tiếp; trong chuỗi template cần escape chính backslash nếu muốn truyền nó vào formatter.

date_go — Tương thích Go cũ

LINGO
{{ article.published_at|date_go:"02/01/2006" }}
{{ article.published_at|date_go:"2006-01-02T15:04:05Z07:00" }}
Chuyển đổi theme cũĐổi date:"2006-01-02" thành date:"Y-m-d", hoặc chỉ đổi tên filter thành date_go:"2006-01-02". Engine không tự đoán hai loại định dạng. Release cũ cũng cần được cập nhật qua draft và publish release mới; không sửa trực tiếp release đã phát hành.

Dữ liệu và múi giờ

Cả hai filter nhận time.Time do resolver cung cấp, không tự parse chuỗi, Unix timestamp hoặc giá trị rỗng. Giữ nguyên múi giờ của dữ liệu; tên thứ/tháng không tự dịch theo locale. Tên múi giờ phản ánh location/zone trong Go. Token c dùng +00:00 cho UTC, còn Go RFC3339 có thể dùng Z; cả hai đều là ISO 8601 hợp lệ.

Filter time và tag now vẫn dùng định dạng Go như trước; thay đổi này chỉ chuyển date sang cú pháp PHP và thêm date_go.

Folio draft dùng date:"d/m/Y" để hiển thị ngày bài viết và date:"c" cho metadata cùng JSON-LD.