doc: dates subtraction has two functionalities
(cherry picked from commit 54a0039c6468cbedd5d2eb449519b8ee40c6ec04)
doc: fix example
(cherry picked from commit 74260b94879dbe0d61d3b06b7b22ecf43b20eb22)