date_modify

加上或减去一个日期间隔。

语法

{{ value | date_modify:"+1 day" }}

用法

• 使用带正负号的整数数量，后接 year、month、week、day、hour、minute 或 second。单数和复数单位均受支持。
• 结果使用 YYYY-MM-DD。小时、分钟和秒在跨午夜时可能改变日期，但时间会被省略。
• 在 date_modify 之后链式调用 date 过滤器即可选择其他输出格式。

示例

增加时间

Data

{
  "published": "2024-12-01"
}

Template

{{ published | date_modify:"+1 year" }}

Output

2025-12-01

减少时间

Data

{
  "published": "2024-12-01"
}

Template

{{ published | date_modify:"-2 months" }}

Output

2024-10-01

跨午夜并格式化

Data

{
  "published": "2024-12-01T22:00:00"
}

Template

{{ published | date_modify:"+4 hours" | date:"MMMM D, YYYY" }}

Output

December 2, 2024

日期修改单位

用 + 表示增加，用 - 表示减少。这些是 Knap 接受的 Day.js 单位；不支持简写单位、季度、毫秒和小数数量。参见 Day.js 日期操作。

单位	复数	示例修改量
year	years	+1 year
month	months	-2 months
week	weeks	+1 week
day	days	-3 days
hour	hours	+4 hours
minute	minutes	-30 minutes
second	seconds	+90 seconds

相关过滤器

• date