datediff(left, right, unit) returns datetime

Geeft het verschil tussen twee datum/tijd waarden terug, in de opgegeven eenheid.

Functie

Argument	Types	Omschrijving
left	datetime	Linker datum/tijd in het verschil left - right.
right	datetime	Rechter datum/tijd in het verschil left - right.
unit	string	Eenheid: "year", "quarter", "month", "day", "hour", "minute" of "second". De functie maakt voor de specificatie van de eenheid geen onderscheid tussen hoofdletters en kleine letters.
Result	integer	Het verschil left - right, in de opgegeven eenheid.

Omschrijving

Geeft het verschil left - right terug, als een geheel aantal maanden, of als een geheel aantal van een andere eenheid.

Het resultaat voor bijvoorbeeld maanden is het aantal maandovergangen tussen de de twee datum/tijd waarden. Bijvoorbeeld het verschil tussen 1 februari en 31 januari is 1 maand, en ook het verschil tussen 28 februari en 1 januari is 1 maand.

De eenheid is een jaar, kwartaal, maand, dag, uur, minuut of seconde.

Als de linkerdatum na de rechterdatum ligt dan is het resultaat 0 of positief. Als de linkerdatum voor de rechterdatum/tijd ligt dan is het resultaat 0 of negatief.

Voorbeelden

datediff(datetime(2016, 2, 2), datetime(2016, 2, 2), "year") = 0
datediff(datetime(2016, 2, 2), datetime(2017, 2, 2), "year") = -1
datediff(datetime(2016, 2, 2), datetime(2015, 2, 2), "year") = 1
datediff(datetime(2016, 12, 31, 23, 59, 59), datetime(2017, 1, 1, 0, 0, 0), "year") = -1
datediff(datetime(2016, 2, 2), datetime(2016, 2, 2), "quarter") = 0
datediff(datetime(2016, 2, 2), datetime(2016, 3, 2), "quarter") = 0
datediff(datetime(2016, 2, 2), datetime(2016, 4, 2), "quarter") = -1
datediff(datetime(2016, 2, 2), datetime(2016, 6, 2), "month") = -4
datediff(datetime(2017, 2, 2), datetime(2016, 6, 2), "month") = 8
datediff(datetime(2016, 1, 1), datetime(2000, 1, 1), "month") = 192
datediff(datetime(2016, 2, 2), datetime(2016, 2, 3), "day") = -1
datediff(datetime(2016, 2, 2), datetime(2016, 2, 1), "day") = 1
datediff(datetime(2016, 2, 1), datetime(2016, 3, 1), "day") = -29
datediff(datetime(2017, 2, 1), datetime(2017, 3, 1), "day") = -28
datediff(datetime(2016, 2, 2, 1, 0, 0), datetime(2016, 2, 2), "hour") = 1
datediff(datetime(2016, 2, 2), datetime(2016, 2, 2, 2, 0, 0), "hour") = -2
datediff(datetime(2016, 2, 2, 0, 3, 0), datetime(2016, 2, 2), "minute") = 3
datediff(datetime(2016, 2, 2), datetime(2016, 2, 2, 0, 4, 0), "minute") = -4
datediff(datetime(2016, 2, 2, 0, 0, 5), datetime(2016, 2, 2), "second") = 5
datediff(datetime(2016, 2, 2), datetime(2016, 2, 2, 0, 0, 6), "second") = -6
datediff(nil, datetime(2016, 2, 2), "year") = nil
datediff(datetime(2016, 2, 2), nil, "year") = nil
datediff(datetime(2016, 2, 2), datetime(2016, 2, 2), nil) = nil
datediff(datetime(2016, 2, 2), datetime(2016, 2, 2), "jaartje", error: 888) = 888