# Rank by Recency

### Description
Rank objects by the value of a date property compared to a given value that represents "Today".

### Input
- `SOURCE [OBJ]`: the list of objects to rank

### Output
- `CLOSE [OBJ]`: ranked objects, closest to `Today` on top
- `FAR [OBJ]`: ranked objects, furthest from `Today` on top

### Parameters
- `Property`: the date property to check. Use `*` to consider all properties.
- `Use sub-properties`: when set to `true`, the values of all sub properties are also included. Sub-properties can be defined in the data with the `rdfs:subPropertyOf` relation.
- `Today`: the expression to be used to represent "Today", the date to use as a reference for "recency".
  - The predefined choice is `curdate()`, an internal function that returns the current date
  - Specific dates can also be used, as long as they are in the format `date("YYYY-MM-DD")`.
  - Simple date arithmetic can be used. For example, `curdate() + 1` to represent "tomorrow".
- `Unit`: What to compare - the full dates, or only one a specific part of dates (Year, Month, Day, ..)
- `Hard filter`: optional hard filters to apply before ranking
  - `No filter`
  - `Not later than Today`
  - `Not earlier than Today`
- `Slope`: positive value determining the slope of the ranking curve.
  The higher the slope, the closer together the resulting scores.