Date parameters

A date parameter is a string consisting of two parts: a prefix and date to check certificate ValidTo against. Multiple values are supported for this parameter. Each of which will be handled separately (sequentially). The order does not matter. This date parameter follows the HL7 FHIR specification for date parameters.

Date intervals

All date parameters are interpreted as date time intervals depending on the precision of the date. For instance 2020-01-01 is more precise/specific than 2020 and thus will give a smaller date interval. The server tries to interpret the largest date interval possible based on the input and its precision. If several dates are provided, these will be interpreted independently from on another and the certificates will be filtered sequentially through them.

Here are some examples of how a date input will be interpreted as intervals:

Date input	Interval	Description
`2020`	`2020-01-01T00:00:00` to `2020-12-31T23:59:59`	Whole year
`2020-01`	`2020-01-01T00:00:00` to `2020-01-31T23:59:59`	Whole month
`2020-01-01`	`2020-01-01T00:00:00` to `2020-01-01T23:59:59`	Whole day
`2020-01-03T20`	`2020-01-03T20:00:00` to `2020-01-03T20:59:59`	Whole hour
`gt2020-03-01T20`	`2020-03-01T21:00:00` to `9999-12-31T23:59:59`	End of hour to DateTime.Max

Prefixes

The date parameters support a range of prefixes that describe how the date is to be interpreted.

Prefix	Description	Supported
`eq`	Equals to. Gives results that are exactly like the input date range, based on the precision of the input. Default prefix used if none is specified	true
`gt`	Greater than. Gives results that are after the input date range, not including the input itself	true
`ge`	Greater or equal to. Gives results that are after the input date range as well as including the input itself	true
`lt`	Less than. Gives results that are before the input date range, not including the input itself	true
`le`	Less than or equal to. Gives results that are before the input date range, as well as including the input itself	true
`ne`	Not equal to	false
`sa`	Starts after	false
`eb`	Ends before	false
`ap`	Approximately (10% precision)	false

Valid date formats

We follow the ISO 8601 standard for dates

Format	Precision
`yyyy-MM-ddTHH:mm:ssz`	Seconds (with UTC offset)
`yyyy-MM-ddTHH:mm:ss`	Seconds
`yyyy-MM-ddTHH:mmz`	Minutes (with UTC offset)
`yyyy-MM-ddTHH:mm`	Minutes
`yyyy-MM-ddTHHz`	Hours (with UTC offset)
`yyyy-MM-ddTHH`	Hours
`yyyy-MM-dd`	Days
`yyyy-MM`	Months
`yyyy`	Year