# DATE

> StackQL 中的 DATE 函数：根据时间值和可选的修饰符，以 YYYY-MM-DD 字符串形式返回日期。

Source: https://stackql.io/zh-hans/language-spec/functions/datetime/date

返回格式为 YYYY-MM-DD 的日期字符串。  

另请参阅：  
[[` SELECT `]](/language-spec/select) [[ 日期修饰符 ]](/language-spec/functions/datetime/date_modifiers) 

* * * 

## 语法

```sql
SELECT DATE(datetime_expression [, modifier, ...]) FROM <multipartIdentifier>;
```

## 参数

__*datetime_expression*__  
日期时间值。

__*modifier*__  
应用于 *datetime_expression* 的零个或多个修饰符。有关修饰符的更多信息，请参阅[**日期修饰符**](/language-spec/functions/datetime/date_modifiers)。

## 返回值

返回一个字符串，表示应用 *modifier* 后输入 *datetime_expression* 的日期部分。

* * *

## 示例

### 返回日期时间值的日期部分

```sql
SELECT name, timeCreated,
date(timeCreated) as date_only
FROM google.storage.buckets WHERE project = 'stackql';
```

### 返回日期时间值的本地日期部分

```sql
SELECT name, timeCreated,
date(timeCreated, 'localtime') as local_date
FROM google.storage.buckets WHERE project = 'stackql';
```

有关更多信息，请参阅 [https://www.sqlite.org/lang_datefunc.html](https://www.sqlite.org/lang_datefunc.html)。