# DATE\_ADD

Lägger till ett intervall av en angiven enhet till en given tidsmarkör. Subtraktion kan utföras genom att använda ett negativt intervallvärde.

## Syntax

```
DATE_ADD(UNIT, VALUE, TIMESTAMP)
```

## Argument

#### UNIT

Typ: `string`

Tidsenheten som ska läggas till.

Den kan vara någon av följande:

* `year`
* `quarter`
* `month`
* `week`
* `day`
* `hour`
* `minute`
* `second`
* `millisecond`

#### VALUE

Typ: `bigint`

Heltalsvärdet för `UNIT` som ska läggas till `TIMESTAMP`.

Kan vara positivt (för framtida tidpunkter) eller negativt (för tidigare tidpunkter).

#### TIMESTAMP

Typ: `timestamp`

Tidsmarkören som ska ändras.

## Returnerar

Typ: `timestamp`

Den `TIMESTAMP` med en `INTERVAL` av den angivna `NUMBER` tillagd.

***

## Exempel

| UNIT | VÄRDE | TIMESTAMP | Utdata |
| --- | --- | --- | --- |
| dag | 1 | `2001-08-22 03:04:05.321` | `2001-08-23 03:04:05.321` |
| år | 5 | `2001-08-22 03:04:05.321` | `2006-08-22 03:04:05.321` |
| andra | 30 | `2001-08-22 03:04:05.321` | `2001-08-22 03:04:35.321` |
| kvartal | 1 | `2001-08-22 03:04:05.321` | `2001-11-22 03:04:05.321` |
| kvartal | -1 | `2001-08-22 03:04:05.321` | `2001-05-22 03:04:05.321` |
| kvartal | 0 | `2001-08-22 03:04:05.321` | `2001-08-22 03:04:05.321` |
| år | 1 | `null` | `null` |