# **EXTRACT()**

## **Function Description**

The EXTRACT() function extracts part of the content from a date. Returns NULL if the date is ``NULL``.

## **Function Syntax**

```text
> EXTRACT(unit FROM date)
```

## **Parameter definition**

| Parameters | Description |
| ---- | ---- |
| date| Required parameters. The date parameter is a legal date expression. |
| unit| Required parameters. The unit parameter can be the following values: <br>MICROSECOND <br>SECOND<br>MINUTE<br>HOUR<br>DAY<br>WEEK<br>MONTH<br>QUA<br>TER<br>YEAR<br>SECOND_MICROSECOND<br>MINUTE_MICROSECOND<br>MINUTE_MICROSECOND<br>MINUTE_SECOND<br>HOUR_MICROSECOND<br>HOUR_MICROSECOND<br>HOUR_SECOND<br>HOUR_SECOND<br>HOUR_SECOND<br>HOUR_MINUTE<br>DAY_MICROSECOND<br>DAY_MICROSECOND<br>DAY_MICROSECOND<br>DAY_MICROSECOND<br>DAY_MICROSECOND<br>YEAR_MONTH|

## **Example**

```text
create table t2(orderid int, productname varchar(20), orderdate datetime);
insert into t2 values ('1','Jarl','2008-11-11 13:23:44.657');

mysql> SELECT EXTRACT(YEAR FROM OrderDate) AS OrderYear, EXTRACT(MONTH FROM OrderDate) AS OrderMonth FROM t2 WHERE OrderId=1;
+------------------------------+
| orderyear | ordermonth |
+------------------------------+
| 2008 | 11 |
+------------------------------+
1 row in set (0.01 sec)
```

## **limit**

Currently, the date format only supports the data formats of `yyyy-mm-dd` and `yyyymmdd`.