getCalcDateTime

Gets a DateTime as a compareable number with a given accuracy.

Parameters

1. dateTime value or controlId

2. accuracy - "seconds" (default), "minutes" or "hours"

Example Usages

app.getCalcDateTime(myDateTimeControl);
app.getCalcDateTime(myDateTimeControl, "minutes");
app.getCalcDateTime(myDateTimeControl, "hours");

Example 2 calculation

let durationInSeconds =
  app.getCalcDateTime(myDateTimeEnd) - app.getCalcDateTime(myDateTimeStart);
let durationInMinutes =
  app.getCalcDateTime(myDateTimeEnd, "minutes") -
  app.getCalcDateTime(myDateTimeStart, "minutes");
let durationInHours =
  app.getCalcDateTime(myDateTimeEnd, "hours") -
  app.getCalcDateTime(myDateTimeStart, "hours");

Return Values

If accuracy is "minutes" the result is divided by 60 to convert from seconds to minutes. If accuracy is "hours" the result is further divided by 3600 (60 seconds * 60 minutes) to convert from seconds to hours. The calculated result is rounded to the nearest integer using Math.round. The final rounded result is returned.