• (before | after) datetime
• not within timespan

Purpose

Notes

“Before” and “after” require a specific date or date & time. “Before” warns if the certificate's validity starts after the named date & time. “After” warns if the certificate's validity starts before the specified date or date & time.

A datetime is a specific calendar date and, optionally, a time in 12-hour or 24-hour time. Many formats are accepted but it's recommended to spell out all the digits of the year: 21-november-2023, 21 nov 2023 3:12pm, and 21 nov 2023 15:12:35 are all accepted.

Certificate term expires not within requirement is meant to provide a warning that a certificate will soon expire. Therefore, not within will only generate warnings when the certificate has not yet expired but the current time/date is within the specified timespan. After the certificate has expired, not within will not generate a warning. If you want to be warned when and after a certificate expires, add a certificate term has not expired requirement in addition to certificate term expires not within in the same section.

A timespan is an expression of a length of time without a specific date. "4 days 2 hours 3 minutes" indicates a timespan of 4 days, 2 hours, and 3 minutes. Only the units with non-zero values need to be listed. A timespan unit is any combination of seconds, minutes, hours, days, weeks, and years. The trailing 's' on each timespan unit is optional. Weeks are defined as the given number of weeks × 7 days. Years are defined as the given number of years × 365 days.

Not within requirement requires a timespan.

Example configuration

# Warns when the currently-valid website certificate is within 8 weeks of expiring.
[certificate:https://superfunparty.illinois.edu]
certificate term expires not within 8 weeks

Example output