Skip to content

Commit

Permalink
Move the relative date docs downward
Browse files Browse the repository at this point in the history
It's important to introduce the .. syntax before we get here.
  • Loading branch information
sampsyo committed Jun 16, 2017
1 parent eaae3fb commit 690ed73
Showing 1 changed file with 22 additions and 22 deletions.
44 changes: 22 additions & 22 deletions docs/reference/query.rst
Expand Up @@ -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.

Expand Down Expand Up @@ -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
Expand Down

0 comments on commit 690ed73

Please sign in to comment.