# DATE\_ADD

Fügt einem angegebenen Zeitstempel ein Intervall in einer angegebenen Einheit hinzu. Die Subtraktion kann durch die Verwendung eines negativen Intervallwerts durchgeführt werden.

## Syntax

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

## Argumente

#### UNIT

Typ: `string`

Die hinzuzufügende Zeiteinheit.

Dies kann einer der folgenden sein:

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

#### VALUE

Typ: `bigint`

Der Ganzzahlwert von `UNIT`, der zu `TIMESTAMP` hinzugefügt werden soll.

Er kann positiv (für zukünftige Zeitpunkte) oder negativ (für vergangene Zeitpunkte) sein.

#### TIMESTAMP

Typ: `timestamp`

Der zu ändernde Zeitstempel.

## Rückgaben

Typ: `timestamp`

Der `TIMESTAMP`, dem ein `INTERVAL` der angegebenen `NUMBER` hinzugefügt wird.

***

## Beispiele

| UNIT | VALUE | TIMESTAMP | Ausgabe |
| --- | --- | --- | --- |
| Tag | 1 | `2001-08-22 03:04:05.321` | `2001-08-23 03:04:05.321` |
| Jahr | 5 | `2001-08-22 03:04:05.321` | `2006-08-22 03:04:05.321` |
| second | 30 | `2001-08-22 03:04:05.321` | `2001-08-22 03:04:35.321` |
| Quartal | 1 | `2001-08-22 03:04:05.321` | `2001-11-22 03:04:05.321` |
| Quartal | -1 | `2001-08-22 03:04:05.321` | `2001-05-22 03:04:05.321` |
| Quartal | 0 | `2001-08-22 03:04:05.321` | `2001-08-22 03:04:05.321` |
| Jahr | 1 | `null` | `null` |