---
title: "format · RUAL Documentation"
description: "Format the given date, e.g., DD/MM/YYYY HH:mm"
canonical: https://docs.rual.nl/block-types/date,timezone/date_format
language: en
---

# format

This block is part of the [`date`](https://docs.rual.nl/block-types/date) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

Format the given date, e.g., DD/MM/YYYY HH:mm

- date required `date` The date to be formatted.

- format required `value` The format string to specify how the date should be formatted (e.g., DD/MM/YYYY HH:mm).

- value `value` The formatted date value.

| `convert to value` |
| --- |
| `string` |

A typical wiring for [format](https://docs.rual.nl/block-types/date/date_format): [date now](https://docs.rual.nl/block-types/date/date_currentdate) feeds the `date` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `format` pin; the `value` out pin feeds [convert to uppercase](https://docs.rual.nl/block-types/value/value_to_uppercase).

![Studio canvas example for the format block: typical wiring for format.](https://docs.rual.nl/canvas-examples/date_format.png)

### Commonly used with

In production blueprints, this block is most often wired together with:

- [date now](https://docs.rual.nl/block-types/date/date_currentdate): feeds into this block. Gives you the current date based on your timezone.

- [value](https://docs.rual.nl/block-types/value/value_default): feeds into this block. Simply returns the provided value.

- [fields](https://docs.rual.nl/block-types/query/query_bool_term_fields): this block feeds into it.

- [execute](https://docs.rual.nl/block-types/function%20execution/function_custom_execute_from_trigger): this block feeds into it. Executes the given funcion and waits for it to be executed.

### Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

### Service documentation