> For the complete documentation index, see [llms.txt](https://gebra-it.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gebra-it.gitbook.io/wiki/client-api-reference/functions/getcalcdatetime.md).

# 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

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

## Example 2 calculation

```javascript
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.