Add feature to query the Zeebe engine's current time

[jasoncwik]

Description

When writing tests, the Zeebe engine has an existing API to increaseTime but there isn't a way to query the engine's current time. We have events that occur at specific times of the day and it's hard to calculate how much time to add if you don't know the current time (especially when writing multiple tests and calling increaseTime multiple times.

Looking at the code, the engine does have a clock object that could be used to query the existing time and return it to the client.

[saig0]

Note

Heads up! We are building a new Java testing library for Camunda 8.6. The new library will replace Zeebe Process Test.
Read more about upcoming changes here and stay tuned for updates. 🚀