Specifying an Interval

Added by Edwin Dawson [Atlassian], last edited by Edwin Dawson [Atlassian] on Apr 09, 2008
Clover 2.1 Documentation

Index

The interval type is used to specify a period of time. It consists of a value and a unit specifier, eg. "3 days". The interval type is very flexible about how it interprets the time unit. In general, the first letter is sufficient to indicate the interval unit. For example, the previous example could be written as "3 d". The time ranges supported are specified in the following table:

Unit specifier Abbreviation Example Values
second s 3 seconds
20s
minute m 5 minute
7 min, 11m
hour h 4 hours
2h
day d 7 days
365d
week w 4 weeks
10w
month mo 5.6 months
24mo
year y 100 years
5y

If no time unit is provided, the default unit of "days" is used. A numeric value must always be provided or an exception will be thrown. Numeric values may be fractional (e.g. 5.6).

Note
Due to the variable lengths of months and years, approximations are used for these values within Clover. A month is considered to be 30.346 days and a year is considered to be 365.232 days. All other units are exact.

Labels:

interval interval Delete
clover clover Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.