---
title: "clock_time_set()"
description: "The clock_time_set() function is used to set the time of the specified clock."
url: "https://wasix.org/docs/api-reference/wasix/clock_time_set/"
markdown: "https://wasix.org/docs/api-reference/wasix/clock_time_set.md"
---

# `clock_time_set()`

Set the time of the specified clock.

## Description

The `clock_time_set()` function is used to set the time of the specified clock.

## Syntax

```ebnf
  ;;; Note: This is similar to `clock_settime` in POSIX.
  ;;; Sets the time value of a clock.
  (@interface func (export "clock_time_set")
    ;;; The clock for which to set the time.
    (param $id $clockid)
    ;;; The value of the time to be set.
    (param $timestamp $timestamp)
    ;;; The time value of the clock.
    (result $error (expected (error $errno)))
  )
```

## Parameters

- `ctx`: A mutable reference to the function environment.
- `clock_id`: The ID of the clock to query.
- `time`: The value of the clock in nanoseconds.

## Return Value

The function returns an `Errno` value indicating the success or failure of the operation.

## Logging

This function has been instrumented with trace-level logging. It will log the following information:

- `?clock_id`: The ID of the clock being queried.
- `%time`: The value of the clock being set.

## Note

The `clock_time_set()` function sets the time of the specified clock. The provided time value is in nanoseconds.

---

[Documentation index](https://wasix.org/llms.txt) · [HTML version](https://wasix.org/docs/api-reference/wasix/clock_time_set/)