date

v1.9.1

把时间戳转换为字符串。LiquidJS 尝试跟 Shopify/Liquid 保持一致，它用的是 Ruby 核心的 Time#strftime(string)。此外 LiquidJS 会先通过 new Date() 尝试把输入转换为 Date 对象。

输入

{{ article.published_at | date: "%a, %b %d, %y" }}

输出

Fri, Jul 17, 15

时区

日期在输出时会转换为当地时区，设置 timezoneOffset LiquidJS 参数可以指定一个不同的时区。或者设置 preserveTimezones 为 true 来保持字面量时间戳的时区，数据中的日期对象不受此参数的影响。

输入

{{ article.published_at | date: "%Y" }}

输出

2015

对于包含格式正确的字符串也好使：

输入

{{ "March 14, 2016" | date: "%b %d, %y" }}

输出

Mar 14, 16

时间戳字符串

LiquidJS 使用 JavaScript [Date][newDate] 来解析输入字符串，意味着支持 IETF-compliant RFC 2822 时间戳 和 特定版本的 ISO8601。

可以用特殊值 "now"（或"today"）来获取当前时间：

输入

This page was last updated at {{ "now" | date: "%Y-%m-%d %H:%M" }}.

输出

This page was last updated at 2020-03-25 15:57.

当前时间

注意得到的当前时间是模板渲染时的时间，如果你在用静态站点生成器或者模板有被缓存这一时间可能与用户看到的时间不同。