unit
editunit
editThis setting must be one of seconds
, minutes
, hours
, days
, weeks
,
months
, or years
.
unit, unit_count, and optionally, epoch, are used by Curator to establish the moment in time point of reference with this formula:
point_of_reference = epoch - ((number of seconds in unit) * unit_count)
The following table helps to illustrate this:
Table 1. Time unit reference
Unit | Seconds | Note |
---|---|---|
|
|
One second |
|
|
Calculated as 60 seconds |
|
|
Calculated as 60 minutes (60 * 60) |
|
|
Calculated as 24 hours (24 * 3600) |
|
|
Calculated as 7 days (7 * 86400) |
|
|
Calculated as 30 days (30 * 86400) |
|
|
Calculated as 365 days (365 * 86400) |
If epoch 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.