Time functions

[zoe-codez]

Changes

1. renamed automation.utils to automation.time
2. updated solar.onEvent to work off scheduler.sliding
   • context is no longer required
   • new optional param: offset
3. added automation.time methods, which consume strings and return bool
   • isBetween
   • isBefore
   • isAfter

Offset

• (number) ms
• (tuple) [quantity, unit]
• (string) ISO 8601 partial duration string: (#H)(#M)(#S)
• (object) mapping of units to quantities
• (Duration) dayjs.duration object
• (function) a function that returns any of the above

Offset examples

automation.solar.onEvent({
  eventName: "dusk",
  exec() {
    logger.info("hour before dusk");
  },
  offset: "-1h",
});

automation.solar.onEvent({
  eventName: "dusk",
  exec() {
    logger.info("some random time within an hour after dusk");
  },
  offset: () => Math.random() * 60 * 60 * 1000,
});

Checklist

• [x] Read the contribution guide and accept the code of conduct
• [x] Readme and docs (updated or not needed)
• [x] Tests (added, updated or not needed)