Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Calcule une nouvelle datetime à partir d’une période spécifiée multipliée par une quantité spécifiée, ajoutée ou soustraite d’une datetime spécifiée.
Syntaxe
datetime_add(
,
,
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Catégorie | Requise | Descriptif |
|---|---|---|---|
| période | string |
✔️ | Durée d’incrémentation. |
| quantité | int |
✔️ | Nombre de périodes à ajouter ou soustraire de datetime. |
| datetime | datetime |
✔️ | Date à incrémenter par le résultat du calcul de la quantité de période x. |
Valeurs possibles de période :
- Année
- Quarter (Trimestre)
- Mois
- Semaine
- Jour
- Heure
- Minute
- Deuxième
- Milliseconde
- Microseconde
- Nanoseconde
Retours
Retourne une datetime après l’ajout d’un certain intervalle d’heure/date.
Exemples
L’exemple suivant montre comment ajouter un point à une valeur datetime avec la datetime_add fonction.
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))
Sortie
| année | quartier | mois | semaine | jour | heure | minute | deuxième |
|---|---|---|---|---|---|---|---|
| 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 |
L’exemple suivant montre comment utiliser la datetime_add fonction pour ajouter ou soustraire des intervalles de temps à partir d’une date spécifique.
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))
Sortie
| année | quartier | mois | semaine |
|---|---|---|---|
| 2012-01-01T00:00:00Z | 2020-01-01T00:00:00Z | 2015-10-01T00:00:00Z | 2018-12-02T00:00:00Z |