datetime_add()

  • Article

Calcule une nouvelle date/heure d’une période spécifiée multipliée par une quantité spécifiée, ajoutée à ou soustraite d’une dateheure spécifiée.

Syntax

datetime_add(Période,Montant,Datetime)

Découvrez les conventions de syntaxe.

Paramètres

Nom Type Obligatoire Description
Période string ✔️ Durée d’incrémentation.
Montant int ✔️ Nombre de périodes à ajouter ou à soustraire de datetime.
datetime datetime ✔️ Date à incrémenter en fonction du résultat du calcul du montantde la période x.

Valeurs possibles de point :

  • Year (Année)
  • Quarter (Trimestre)
  • Month
  • Semaine
  • Jour
  • Hour
  • Minute
  • Second
  • Milliseconde
  • Microseconde
  • Nanoseconde

Retours

Dateheure après l’ajout d’un certain intervalle d’heure/date.

Exemples

Période

Exécuter la requête

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

year quarter month week day hour 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

Montant

Exécuter la requête

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

year quarter month week
2012-01-01T00 :00 :00Z 2020-01-01T00 :00 :00Z 2015-10-01T00 :00 :00Z 2018-12-02T00 :00 :00Z