# set_next_block_time · Rell standard library · Chromia Docs (concept)

> function set_ next_ block_ time(time: integer ): unit Set the timestamp that the next block will have, once built, in milliseconds. time is a Unix epoch ti

Source: https://docs.chromia.com/pages/rell-stdlib/-rell-system-library/rell.test/set_next_block_time/

FUNCTION

# set\_next\_block\_time

```signature
function set_next_block_time(time: integer): unit
```

Set the timestamp that the next block will have, once built, in milliseconds.

`time` is a [Unix epoch timestamp](https://en.wikipedia.org/wiki/Unix_time), i.e. the number of
milliseconds that will have elapsed since midnight on 1st January 1970.

**Parameters**

* **time** — timestamp to use on next block

**Throws**

* `exception` — if `time` is in older than `rell.test.last_block_time`, or negative

**See Also**

1. [`rell.test.set_next_block_time_delta()` - Rell Standard Library](https://docs.chromia.com/pages/rell-stdlib/-rell-system-library/rell.test/set_next_block_time_delta/)
2. [`rell.test.block` - Rell Standard Library](https://docs.chromia.com/pages/rell-stdlib/-rell-system-library/rell.test/block/)

Since 0.13.3

[View this page on docs.chromia.com](https://docs.chromia.com/pages/rell-stdlib/-rell%20-system%20-library/rell.test/set_next_block_time.html)Generated API reference, mirrored from the live docs