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

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