[[time-unit]]
== --time-unit


[float]
Summary
~~~~~~~

IMPORTANT: This flag only functions within the scope of <<index-selection,index selection>> or <<snapshot-selection,snapshot selection>>.

As a part of index selection or snapshot selection you can filter
indices or snapshots <<older-than>> or <<newer-than>> a given point in time. The
`--time-unit` flag is required when using <<older-than,--older-than>> or
<<newer-than,--newer-than>> to help determine _how many_ `days`, `hours`,
`weeks`, and `months`. The value you provide to `--older-than` or `--newer-than`
will be multiplied by the <<time-unit,--time-unit>>: 5 `days`, 3 `hours`, etc. A
<<timestring>> is also required in order for Curator to recognize the date
pattern in your index or snapshot names.

[float]
Flags
~~~~~

* `--time-unit` The time interval between indices, e.g. `hours`, `days`,
`weeks`, or `months`(default: `days`)

[float]
Example
~~~~~~~

Show indices older than 5 days:

----------------------------------------------------------------------------
curator show indices --older-than 5 --time-unit days --timestring '%Y.%m.%d'
----------------------------------------------------------------------------