---
title: "date"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/filter/date'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/filter/date.md'
---

# date


    将日期字符串格式化为指定格式。  
可使用内置格式类型或使用占位符自定义输出格式。

    



    
`date_string | date(format=format)` 返回一个 string。
    



    
## 必选参数

        
             `date_string` `string`：日期字符串。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。例子：`2024-08-31T02:20:26+08:00`。
        
    



    
## 可选参数

        
             `format` `string`：目标输出格式。支持内置格式类型和自定义格式。关于更多如何使用占位符自定义输出格式信息，参考 [strftime reference and sandbox](https://www.strfti.me/)（日期时间格式化参考手册和交互沙箱）。如需使用内置格式类型，有效枚举值包含：
- `default`（默认值）：包含星期、日期、具体时间以及时区偏移的格式。例子：`Monday, December 31, 2018 at 1:00 pm -0500`。
- `abbreviated_date`：缩写日期。例子：`Dec 31, 2018`。
- `basic`：基础数字格式。例子：`12/31/2018`。
- `date`：完整日期。例子：`December 31, 2018`。
- `date_at_time`：带具体时间的日期。例子：`December 31, 2018 at 1:00 pm`。
- `on_date`：带介词的日期。例子：`on Dec 31, 2018`。
        
    



    
## 例子

        
            

            以下示例用于将日期字符串输出为三种不同格式。


            

            
<SlineExample path={'/'} objects={ 
    [""] 
}>
```sline
{{ "2022-04-14T16:56:02-04:00" | date() }}

{{ "2022-04-14T16:56:02-04:00" | date(format="basic") }}

{{ "2022-04-14T16:56:02-04:00" | date(format="%B %d, %Y") }}
```
</SlineExample>