> For the complete documentation index, see [llms.txt](https://scenegroup.gitbook.io/cavalry/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scenegroup.gitbook.io/cavalry/nodes/utilities/local-time.md).

# Local Time

**Strength** - determine the strength of the Behaviour.

**Mode** - select the unit of time to output:

* Milliseconds through Second -&#x20;
* Seconds through Minute -&#x20;
* Seconds through Hour -&#x20;
* Seconds though  Day -&#x20;
* Seconds through Week -&#x20;
* Seconds through Month -&#x20;
* Seconds through Year -&#x20;
* Minutes through Hour -&#x20;
* Minutes though  Day -&#x20;
* Minutes through Week -&#x20;
* Minutes through Month -&#x20;
* Minutes through Year -&#x20;
* Day of the Week -&#x20;
* Day of the Month -&#x20;
* Day of the Year -&#x20;
* Month of the Year -&#x20;

**Output Mode** -&#x20;

* **Unit** - output the time as a unit/ value.
* **Ratio** - output the time as a ratio. e.g. if it's half way through the year output **Day of the Year** as 0.5.

**Offset** - add/subtract values \[x, y] to the output.

{% hint style="success" %}
Example usage:

1. Create a [Text Shape](/cavalry/nodes/shapes/text-shape.md).
2. Using the `+` to the right of the **Text** attribute add a [String Generator](/cavalry/nodes/utilities/string-generator.md).
3. Set the **Generator** to **Value**.
4. Add a **Local Time**.
5. Set **Mode** to **Day of the Month**.
6. Connect ***localTime.id > stringGenerator.number***.

If today is the 11th August the Text Shape will output 16.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://scenegroup.gitbook.io/cavalry/nodes/utilities/local-time.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
