> For the complete documentation index, see [llms.txt](https://docs.bravostudio.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bravostudio.app/bravo-tags/components/date-time-and-currency-formatter.md).

# Date, Time and Currency Formatter

When creating applications, it's often necessary to display dates, times and currencies to users in a format that's easily understandable. This feature allows us to convert dates and times from ISO format to a more human-readable format and converts numerical data into a currency format, ensuring that currency symbols, decimal separators match the conventions familiar to the user.

{% hint style="info" %}
**What is an ISO format?**\
\
**ISO 8601** is an international standard covering the worldwide exchange and communication of date and time-related data.

**ISO 4217:2015** specifies the structure for a three-letter alphabetic code and an equivalent three-digit numeric code for the representation of currencies.\
\
The most common ISO Date Format yyyy-MM-dd — for example, "2000-10-31". \
The most common ISO Date Time Format is yyyy-MM-dd'T'HH:mm:ss. SSSXXX — For example, "2000-10-31T01:30:00.000-05:00"\
An ISO currency example, The US dollar is represented as USD and Euro is represented as EUR.
{% endhint %}

## :point\_right: The tags

**📍 Where to add the tag:** A text element.

### Date and Time

Converts an IOS format to specific date and time formats.

```
[format:date:short:<value>] 31/01/2024
[format:date:medium:<value>] Jan 31, 2024
[format:date:long:<value>] January 31, 2024 at time X
[format:date:time:<value>] 11:30
```

If you're binding the text, use:

```
[format:date:short] 31/01/2024
[format:date:medium] Jan 31, 2024
[format:date:long] January 31, 2024 at time X
[format:date:time] 11:30
```

Example: \
\
For the date `2024-01-31` or `2024-01-31T10:30:00Z`, annotate it with <mark style="color:red;">`[format:date:medium:2024-01-31T10:30:00Z]`</mark> to display it as `Jan 31, 2024`.

### Currencies

Converts a number from API into a selected currency. All ISO currency format with 3 letters are supported.

```
[format:currency:<EUR|USD…>:] 
```

Example:&#x20;

For the amount 2500.5, annotate it with <mark style="color:red;">`[format:currency:USD]`</mark> to display it as `2.500,5 US$`

## :floppy\_disk: Example design file

{% embed url="<https://www.figma.com/community/file/1350143268643068761>" %}

Your feedback is valuable to us. If you have any suggestions or questions, please don't hesitate to reach out to us in the [community](https://community.bravostudio.app/home).


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.bravostudio.app/bravo-tags/components/date-time-and-currency-formatter.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
