Time zone support for masked date replacements

Current Situation

• Issue YADE-637 describes elements that support date substitution.
• Date substitution currently uses the Java default time zone.
• Note: In a JS7 Agent environment, the Java default time zone is typically set to UTC.
  • As a result, all date substitutions are evaluated using the UTC time zone.

Desired Behaviour

• The date format string should be extended to support explicit time zone specification.
• Syntax:

  [date:<date format> [timezone:<zone>]]

  • timezone:<zone> is optional.
  • If omitted, the Java system default time zone is used.
• Supported time zone specifications
  • The time zone can be specified in one of the following ways:
    1. Region ID
       • Examples: Europe/Berlin, Asia/Kolkata
       • Interpreted according to standard Java ZoneId rules, including daylight saving time where applicable.
    2. Time Zone Offset
       • ISO-8601 compliant formats
         • +02:00 - interpreted as offset +02:00
         • +05:30 - interpreted as offset +05:30
       • Supported non-standard shorthand formats
         • +2 - interpreted as offset +02:00
         • +5:30 - interpreted as offset +05:30
  • Notes
    • Region-based time zones (Europe/Berlin, etc.) reflect daylight saving time transitions.
    • Offset-based time zones represent a fixed offset and do not apply daylight saving time.
• Examples:
  • [date:yyyyMMddHHmmss] - current date using the Java default time zone.
  • [date:yyyyMMddHHmmss timezone:Europe/Berlin] - current date in the Europe/Berlin time zone.
  • [date:yyyyMMddHHmmss timezone:+02:00] - current date at fixed offset +02:00.
  • [date:yyyyMMddHHmmss timezone:+2] - current date at fixed offset +02:00.
  • [date:yyyyMMddHHmmss timezone:+05:30] - current date at fixed offset +05:30.
  • [date:yyyyMMddHHmmss timezone:+5:30] - current date at fixed offset +05:30.
  • [date:yyyyMMddHHmmss timezone:-02:00] - current date at fixed offset -02:00.
  • [date:yyyyMMddHHmmss timezone:-2] - current date at fixed offset -02:00.

Patch

• Use the cumulative patch provided with YADE-637.