datetime_add()
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Berechnet eine neue Datumszeit aus einem angegebenen Zeitraum, multipliziert mit einem angegebenen Betrag, hinzugefügt oder von einer angegebenen Datetime subtrahiert.
Syntax
datetime_add(Zeitraum datumstime,,)
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| period | string |
✔️ | Die Zeitdauer, um die erhöht werden soll. |
| Menge | int |
✔️ | Die Anzahl der Perioden , die von datetime addiert oder subtrahiert werden sollen. |
| datetime | datetime |
✔️ | Das Datum, das durch das Ergebnis der Berechnung des Zeitraums x erhöht wird. |
Mögliche Werte des Zeitraums:
- Jahr
- Quarter
- Monat
- Woche
- Tag
- Stunde
- Minute
- Second
- Millisekunde
- Mikrosekunde
- Nanosekunde
Gibt zurück
Ein Datum, nach dem ein bestimmtes Zeit-/Datumsintervall hinzugefügt wurde.
Beispiele
Zeitraum
print year = datetime_add('year',1,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',1,make_datetime(2017,1,1)),
month = datetime_add('month',1,make_datetime(2017,1,1)),
week = datetime_add('week',1,make_datetime(2017,1,1)),
day = datetime_add('day',1,make_datetime(2017,1,1)),
hour = datetime_add('hour',1,make_datetime(2017,1,1)),
minute = datetime_add('minute',1,make_datetime(2017,1,1)),
second = datetime_add('second',1,make_datetime(2017,1,1))
Output
| year | quarter | month | week | day | Stunde | Minute | second |
|---|---|---|---|---|---|---|---|
| 2018-01-01 00:00:00.0000000 | 2017-04-01 00:00:00.0000000 | 2017-02-01 00:00:00.0000000 | 2017-01-08 00:00:00.0000000 | 2017-01-02 00:00:00.0000000 | 2017-01-01 01:00:00.0000000 | 2017-01-01 00:01:00.0000000 | 2017-01-01 00:00:01.0000000 |
Betrag
print year = datetime_add('year',-5,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',12,make_datetime(2017,1,1)),
month = datetime_add('month',-15,make_datetime(2017,1,1)),
week = datetime_add('week',100,make_datetime(2017,1,1))
Output
| year | quarter | month | week |
|---|---|---|---|
| 2012-01-01T00:00:00Z | 2020-01-01T00:00:00Z | 2015-10-01T00:00:00Z | 2018-12-02T00:00:00Z |