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 that determines the slope of the ranking curve. The higher the slope, the closer together the resulting scores.