From 690ed731d83e393a93d5dea1e892d79a7c557578 Mon Sep 17 00:00:00 2001 From: Adrian Sampson Date: Fri, 16 Jun 2017 11:07:24 -0400 Subject: [PATCH] Move the relative date docs downward It's important to introduce the .. syntax before we get here. --- docs/reference/query.rst | 44 ++++++++++++++++++++-------------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/reference/query.rst b/docs/reference/query.rst index bb14f3cd27..4eba910ca5 100644 --- a/docs/reference/query.rst +++ b/docs/reference/query.rst @@ -164,28 +164,6 @@ Dates are written separated by hyphens, like ``year-month-day``, but the month and day are optional. If you leave out the day, for example, you will get matches for the whole month. -You can also use relative dates to the current time. -It looks like ``-3w``, ``2m`` or ``-4d`` which means the date 3 weeks ago, -the date 2 months from now and the date 4 days ago. -A relative date consists of three parts: -- ``+`` or ``-`` sign is optional and defaults to ``+``. The ``+`` sign will -add a time quantity to the current date while the ``-`` sign will do the -opposite -- a number follows and indicates the amount to add or substract -- a final letter ends and represents the amount in either days, weeks, months or -years (``d``, ``w``, ``m`` or ``y``) - -Please note that this relative calculation makes the assumption of 30 days per -month and 365 days per year. - -Here is an example that finds all the albums added between now and last week:: - - $ beet ls -a 'added:-1w..' - -Find all items added in a 2 weeks period 4 weeks ago:: - - $ beet ls -a 'added:-6w..-4w' - Date *intervals*, like the numeric intervals described above, are separated by two dots (``..``). You can specify a start, an end, or both. @@ -239,6 +217,28 @@ queries do the same thing:: $ beet ls 'added:2008-12-01t22:45:20' $ beet ls 'added:2008-12-01 22:45:20' +You can also use relative dates to the current time. +It looks like ``-3w``, ``2m`` or ``-4d`` which means the date 3 weeks ago, +the date 2 months from now and the date 4 days ago. +A relative date consists of three parts: +- ``+`` or ``-`` sign is optional and defaults to ``+``. The ``+`` sign will +add a time quantity to the current date while the ``-`` sign will do the +opposite +- a number follows and indicates the amount to add or substract +- a final letter ends and represents the amount in either days, weeks, months or +years (``d``, ``w``, ``m`` or ``y``) + +Please note that this relative calculation makes the assumption of 30 days per +month and 365 days per year. + +Here is an example that finds all the albums added between now and last week:: + + $ beet ls -a 'added:-1w..' + +Find all items added in a 2 weeks period 4 weeks ago:: + + $ beet ls -a 'added:-6w..-4w' + .. _not_query: Query Term Negation