1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
---
mapped_pages:
- https://www.elastic.co/guide/en/elasticsearch/client/curator/current/fe_unit_count.html
---
# unit_count [fe_unit_count]
::::{note}
This setting is only used with the [age](/reference/filtertype_age.md) filtertype, or<br> with the [space](/reference/filtertype_space.md) filtertype if [use_age](/reference/fe_use_age.md) is set to `True`.
::::
```yaml
- filtertype: age
source: creation_date
direction: older
unit: days
unit_count: 3
```
The value of this setting will be used as a multiplier for [unit](/reference/fe_unit.md).
[unit](/reference/fe_unit.md), unit_count, and optionally, [epoch](/reference/fe_epoch.md), are used by Curator to establish the moment in time point of reference with this formula:
```sh
point_of_reference = epoch - ((number of seconds in unit) * unit_count)
```
[`units`](/reference/fe_unit.md) are calculated as follows:
| Unit | Seconds | Note |
| --- | --- | --- |
| `seconds` | `1` | One second |
| `minutes` | `60` | Calculated as 60 seconds |
| `hours` | `3600` | Calculated as 60 minutes (60*60) |
| `days` | `86400` | Calculated as 24 hours (24*60*60) |
| `weeks` | `604800` | Calculated as 7 days (7*24*60*60) |
| `months` | `2592000` | Calculated as 30 days (30*24*60*60) |
| `years` | `31536000` | Calculated as 365 days (365*24*60*60) |
If [epoch](/reference/fe_epoch.md) is unset, the current time is used. It is possible to set a point of reference in the future by using a negative value for unit_count.
This setting must be set by the user or an exception will be raised, and execution will halt.
If this setting is used in conjunction with [unit_count_pattern](/reference/fe_unit_count_pattern.md), the configured value will only be used as a fallback value in case the pattern could not be matched. The value *-1* has a special meaning in this case and causes the index to be ignored when pattern matching fails.
::::{tip}
See the [age filter documentation](/reference/filtertype_age.md) for more information about time calculation.
::::
|
