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.