This plugin supports the following range syntax:
Size range: /[S
smallest,
largest]
You may omit either smallest or
largest. You may qualify either with a trailing
letter: lowercase k
, m
, g
, etc.
to multiply by one thousand, one million, one billion, and so on; or
uppercase K
, M
, G
, etc. to
multiply by 210, 220, 230, and so on. If
largest begins with a +
sign, it is
an increment over smallest. Use
/![S
smallest,
largest]
to invert the test and return only files not in the given size range.
Date range: /[D
[acw]:
earliest,
latest]
You may omit either earliest or latest; either defaults to the current date. The optional [acw] argument selects the date stamp to check. (If you want to check more than one date stamp, you must supply more than one date range option.) The colon after the [acw] is optional.
Dates may be given in the local date format, or in
yyyy-
mm-
dd
format (with a four-digit year). You may also specify a date as an offset
preceded with a +
or -
sign; the offset is in days
relative to today’s date (for earliest) or
relative to earliest (in the case of
latest). If earliest
turns out to be later than latest then the two
are exchanged.
You may also give a specific time on either date, preceded
by an @
sign. The time may be in either 24-hour format, or 12-hour
format with a trailing A
or P
.
Use /![D
[acw]:
earliest,
latest]
to invert the test and return only files not in the given date range.
Time range: /[T
[acw]:
earliest,
latest]
You may omit either earliest or
latest.
The optional [acw]
argument selects the time stamp to check. (If you want to check more than one
time stamp, you must supply more than one time range option.) The colon after
the [acw]
is optional. Times may be in either 24-hour format, or 12-hour format with a
trailing A
or P
.
Use /![T
[acw]:
earliest,
latest]
to invert the test and return only files not in the given time range.
Exclusion range: /[!
wildspec]
Filenames matching the wildspec will be excluded. You can supply more than one wildspec by separating them with (unquoted) spaces.
Owner range: /[O
wildspec]
Files whose owners (in domain\
user
format) do not match the wildspec will be
skipped. Use /![O
wildspec]
to invert the test and return only files which do not match the owner
wildspec.
Description range: /I
wildspec or (alternate syntax) /[I
wildspec]
If a file’s description does not match the wildspec,
it will be skipped. Use /!I
wildspec
to invert the test, returning only files which do not match the description
wildspec.
Day-of-the-week range: /[W
[acw]:
days]
You may specify multiple days separated by commas, e.g.
/[W:MON,WED,FRI]
. You can also give a range, for example
/[W:TUE-FRI]
. WEEKENDS
is accepted as a synonym for
SAT,SUN
; WEEKDAYS
is a synonym for MON-FRI
.
The colon in this syntax is required.
You may supply multiple ranges. A file must match all given ranges or it will be skipped.