The Mutt E-Mail Client : Advanced Usage : Patterns : Searching by Date
Previous: Complex Patterns
Next: Using Tags

4.2.3. Searching by Date

Mutt supports two types of dates, absolute and relative.

Absolute. Dates must be in DD/MM/YY format (month and year are optional, defaulting to the current month and year). An example of a valid range of dates is:

Limit to messages matching: ~d 20/1/95-31/10

If you omit the minimum (first) date, and just specify ``-DD/MM/YY'', all messages before the given date will be selected. If you omit the maximum (second) date, and specify ``DD/MM/YY-'', all messages after the given date will be selected. If you specify a single date with no dash (``-''), only messages sent on the given date will be selected.

Error Margins. You can add error margins to absolute dates. An error margin is a sign (+ or -), followed by a digit, followed by one of the following units:

y	years
m	months
w	weeks
d	days
As a special case, you can replace the sign by a ``*'' character, which is equivalent to giving identical plus and minus error margins.

Example: To select any messages two weeks around January 15, 2001, you'd use the following pattern:

 
Limit to messages matching: ~d 15/1/2001*2w

Relative. This type of date is relative to the current date, and may be specified as:

offset is specified as a positive number with one of the following units:

y       years
m       months
w       weeks
d       days

Example: to select messages less than 1 month old, you would use

Limit to messages matching: ~d <1m

Note: all dates used when searching are relative to the local time zone, so unless you change the setting of your $index_format to include a %[...] format, these are not the dates shown in the main index.


The Mutt E-Mail Client : Advanced Usage : Patterns : Searching by Date
Previous: Complex Patterns
Next: Using Tags