[API reference](https://evolu.dev/docs/api-reference) › [@evolu/common](https://evolu.dev/docs/api-reference/common) › Time

Time representations, durations, and scheduling utilities.

## Functions

| Function                                                                                         | Description                                                                                                                                  |
| ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [createTime](https://evolu.dev/docs/api-reference/common/Time/functions/createTime)                           | Creates a [Time](https://evolu.dev/docs/api-reference/common/Time/interfaces/Time) using `Date.now()` and `globalThis.setTimeout`.                        |
| [durationToMillis](https://evolu.dev/docs/api-reference/common/Time/functions/durationToMillis)               | Converts a duration to milliseconds.                                                                                                         |
| [formatMillisAsClockTime](https://evolu.dev/docs/api-reference/common/Time/functions/formatMillisAsClockTime) | Formats [Millis](https://evolu.dev/docs/api-reference/common/Time/variables/Millis) as `HH:MM:SS.mmm`.                                                    |
| [formatMillisAsDuration](https://evolu.dev/docs/api-reference/common/Time/functions/formatMillisAsDuration)   | Formats [Millis](https://evolu.dev/docs/api-reference/common/Time/variables/Millis) as a human-readable duration string.                                  |
| [millisToDateIso](https://evolu.dev/docs/api-reference/common/Time/functions/millisToDateIso)                 | Converts [Millis](https://evolu.dev/docs/api-reference/common/Time/variables/Millis) to [DateIso](https://evolu.dev/docs/api-reference/common/Type/variables/DateIso). |
| [setTimeout](https://evolu.dev/docs/api-reference/common/Time/functions/setTimeout)                           | Returns a Promise that resolves after the specified duration.                                                                                |
| [testCreateTime](https://evolu.dev/docs/api-reference/common/Time/functions/testCreateTime)                   | Creates a [TestTime](https://evolu.dev/docs/api-reference/common/Time/interfaces/TestTime) with controllable timers for testing.                          |

## Interfaces

| Interface                                                                 | Description                                                                                |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| [TestTime](https://evolu.dev/docs/api-reference/common/Time/interfaces/TestTime)       | Test [Time](https://evolu.dev/docs/api-reference/common/Time/interfaces/Time) with controllable timers. |
| [TestTimeDep](https://evolu.dev/docs/api-reference/common/Time/interfaces/TestTimeDep) | -                                                                                          |
| [Time](https://evolu.dev/docs/api-reference/common/Time/interfaces/Time)               | Time and timer operations.                                                                 |
| [TimeDep](https://evolu.dev/docs/api-reference/common/Time/interfaces/TimeDep)         | -                                                                                          |

## Type Aliases

| Type Alias                                                                                                  | Description                                                                                                                                                                                     |
| ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Duration](https://evolu.dev/docs/api-reference/common/Time/type-aliases/Duration)                                       | Duration can be either a [DurationLiteral](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteral) or milliseconds as [Millis](https://evolu.dev/docs/api-reference/common/Time/variables/Millis). |
| [DurationLiteral](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteral)                         | Duration literal with compile-time validation.                                                                                                                                                  |
| [DurationLiteralDays](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteralDays)                 | Days duration: `"1d"` to `"6d"` or `"1.1d"` to `"6.9d"`. See [DurationLiteral](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteral).                                               |
| [DurationLiteralHours](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteralHours)               | Hours duration: `"1h"` to `"23h"` or `"1.1h"` to `"23.9h"`. See [DurationLiteral](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteral).                                            |
| [DurationLiteralMilliseconds](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteralMilliseconds) | Milliseconds duration: `"1ms"` to `"999ms"`. See [DurationLiteral](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteral).                                                           |
| [DurationLiteralMinutes](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteralMinutes)           | Minutes duration: `"1m"` to `"59m"` or `"1.1m"` to `"59.9m"`. See [DurationLiteral](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteral).                                          |
| [DurationLiteralSeconds](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteralSeconds)           | Seconds duration: `"1s"` to `"59s"` or `"1.1s"` to `"59.9s"`. See [DurationLiteral](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteral).                                          |
| [DurationLiteralWeeks](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteralWeeks)               | Weeks duration: `"1w"` to `"51w"` or `"1.1w"` to `"51.9w"`. See [DurationLiteral](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteral).                                            |
| [DurationLiteralYears](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteralYears)               | Years duration: `"1y"` to `"99y"` or `"1.1y"` to `"99.9y"`. See [DurationLiteral](https://evolu.dev/docs/api-reference/common/Time/type-aliases/DurationLiteral).                                            |
| [Millis](https://evolu.dev/docs/api-reference/common/Time/type-aliases/Millis)                                           | Milliseconds timestamp, like `Date.now()`.                                                                                                                                                      |
| [TimeoutId](https://evolu.dev/docs/api-reference/common/Time/type-aliases/TimeoutId)                                     | Opaque type for timeout handles.                                                                                                                                                                |

## Variables

| Variable                                                               | Description                                                                   |
| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| [maxMillis](https://evolu.dev/docs/api-reference/common/Time/variables/maxMillis)   | Maximum [Millis](https://evolu.dev/docs/api-reference/common/Time/variables/Millis) value. |
| [Millis](https://evolu.dev/docs/api-reference/common/Time/variables/Millis)         | Milliseconds timestamp, like `Date.now()`.                                    |
| [minMillis](https://evolu.dev/docs/api-reference/common/Time/variables/minMillis)   | Minimum [Millis](https://evolu.dev/docs/api-reference/common/Time/variables/Millis) value. |
| [ms120fps](https://evolu.dev/docs/api-reference/common/Time/variables/ms120fps)     | Frame budget at 120fps (8ms).                                                 |
| [ms60fps](https://evolu.dev/docs/api-reference/common/Time/variables/ms60fps)       | Frame budget at 60fps (16ms).                                                 |
| [msLongTask](https://evolu.dev/docs/api-reference/common/Time/variables/msLongTask) | Long task threshold (50ms).                                                   |