Merge branch 'main' into blockly_http

concepts/items.md

@@ -61,13 +61,16 @@ For available Group functions and examples see [Configuration Guide](../configur
 
 ### DateTimeType
 
-`DateTimeType` objects are parsed using Java's `SimpleDateFormat.parse()` using the first matching pattern:
-
-1. `yyyy-MM-dd'T'HH:mm:ss.SSSZ`
-1. `yyyy-MM-dd'T'HH:mm:ss.SSSz`
-1. `yyyy-MM-dd'T'HH:mm:ss.SSSX`
-1. `yyyy-MM-dd'T'HH:mm:ssz`
-1. `yyyy-MM-dd'T'HH:mm:ss`
+`DateTimeType` objects are parsed using Java's `DateTimeFormatter` with the first matching pattern:
+
+1. `yyyy-MM-dd'T'HH:mm[:ss[.SSS]]Z` or `yyyy-MM-dd HH:mm[:ss[.SSS]]Z`
+1. `yyyy-MM-dd'T'HH:mm[:ss[.SSS]]X` or `yyyy-MM-dd HH:mm[:ss[.SSS]]X`
+1. `yyyy-MM-dd'T'HH:mm[:ss[.SSS]]z` or `yyyy-MM-dd HH:mm[:ss[.SSS]]z`
+1. `yyyy-MM-dd'T'HH:mm[:ss[.SSS]]` or `yyyy-MM-dd HH:mm[:ss[.SSS]]`
+1. `HH:mm[:ss[.SSS]]` with or without a timezone
+1. A string of fewer than 12 digits as epoch in seconds
+1. A string of 12 digits of more as epoch in milliseconds
+1. `yyyy-MM-dd` with or without a timezone
 
 | Literal | Standard           | Example                               |
 |---------|--------------------|---------------------------------------|

configuration/rules-dsl.md

@@ -173,7 +173,7 @@ You can either use some pre-defined expressions for timers or use a [cron expres
 ```java
 Time is midnight
 Time is noon
-Time is <item> [timeOnly]
+Time is <item> [timeOnly] [offset=N]
 Time cron "<cron expression>"
 ```
 
@@ -190,6 +190,7 @@ A cron expression takes the form of six or optionally seven fields:
 You may use the generator at [FreeFormatter.com](https://www.freeformatter.com/cron-expression-generator-quartz.html) to generate your cron expressions.
 
 When using an item and you want to ignore the date-portion of that item the `timeOnly` option can be used.
+A positive or negative offset in seconds, relative to the date/time of the given item can be specified.
 
 ### System-based Triggers