Docs navigation

Reference / Libraries

formato.php library

Conversions between the database format and the Brazilian one: dates, numbers with decimal comma and thousands separator, and the formato_dado() dispatcher.

Path in the Gestor bibliotecas/formato.php

Converts values between the database format (YYYY-MM-DD HH:MM:SS, decimal point) and the Brazilian format (DD/MM/YYYY, decimal comma, dot as thousands separator). The formats are fixed: there is no per-language variation. interface.php uses it to display values in listings and in the history.

Dates

Function	Input → output
`formato_data_from_datetime_to_text($dt)`	`2026-09-26 14:30:00` → `26/09/2026`
`formato_data_hora_from_datetime_to_text($dt, $format = false)`	`2026-09-26 14:30:00` → `26/09/2026 14h30`
`formato_data_hora_padrao_datetime($br, $noTime = false)`	`26/09/2026 14:30` → `2026-09-26 14:30:00` (or `2026-09-26`)
`formato_data_hora_br_para_datetime($s)`	Accepts `DD/MM/YYYY[ HH:MM[:SS]]`, `YYYY-MM-DD…` and the `T` of `datetime-local`; returns `YYYY-MM-DD HH:MM:SS` or `null`
`formato_data_hora_datetime_para_input($dt)`	`2026-09-26 14:30:00` → `2026-09-26T14:30` (value for `<input type="datetime-local">`); `''` for empty or `0000-00-00`
`formato_data_hora_array($dt)`	Array with `dia`, `mes`, `ano` and, if there is a time, `hora`, `min`, `seg`

In formato_data_hora_from_datetime_to_text(), $format replaces the codes D, ME, A, H, MI and S (default D/ME/A HhMI).

Only formato_data_hora_br_para_datetime() and formato_data_hora_datetime_para_input() validate their input. The others split the string by position and raise warnings (and meaningless results) with a value outside the expected pattern.

Numbers

Function	Example
`formato_float_para_texto($f)`	`1234.5` → `1.234,50` (always 2 decimals; the 2nd parameter is ignored)
`formato_texto_para_float($t)`	`1.234,50` → `1234.50` (string)
`formato_int_para_texto($i)`	`1234567` → `1.234.567`
`formato_texto_para_int($t)`	`1.234.567` → `1234567` (string)
`formato_zero_a_esquerda($n, $digits)`	`(7, 3)` → `007`
`formato_colocar_char_meio_numero($n, $char = '-')`	`123456` → `123-456`

formato_texto_para_float() treats every dot as a thousands separator: '10.5' becomes 105.. Without a comma, it raises a warning and returns the number with a trailing dot ('10' → 10.).
formato_colocar_char_meio_numero() with a single-digit number ends in an error (str_split with length 0).

`formato_dado()`

formato_dado(['valor' => $v, 'tipo' => 'float-para-texto']);
formato_dado_para('dataHora', $v);   // shortcut

Types: float-para-texto, texto-para-float, int-para-texto, texto-para-int, data, dataHora, datetime and date. An unknown type returns the value unchanged; without valor or tipo, it returns ''.

Functions

Generated from gestor/bibliotecas/formato.php · 14 functions

14 of 14

formato_data_hora_array

view source · line 33 ↗

formato_data_hora_array(string $data_hora_padrao_datetime_ou_padrao_date): array

Converte uma data/hora no formato DATETIME ou DATE para array.

Parameters

$data_hora_padrao_datetime_ou_padrao_datestring: Data/hora no formato padrão do banco.

Returns

array

Array com as chaves: dia, mes, ano, hora (opcional), min (opcional), seg (opcional).

formato_data_hora_padrao_datetime

view source · line 75 ↗

formato_data_hora_padrao_datetime(string $dataHora, bool $semHora = false): string

Converte data/hora do formato brasileiro para formato DATETIME do MySQL.

Parameters

$dataHorastring: Data/hora no formato brasileiro (DD/MM/YYYY HH:MM).
$semHorabool: Se true, retorna apenas a data no formato DATE (YYYY-MM-DD).

Returns

string

Data/hora no formato DATETIME ou DATE do MySQL.

formato_data_hora_br_para_datetime

view source · line 96 ↗

formato_data_hora_br_para_datetime(string $str): string|null

Converte data/hora para DATETIME do MySQL (YYYY-MM-DD HH:MM:SS), COM validação: retorna null quando vazio ou em formato inválido. Aceita DUAS formas — o formato brasileiro (DD/MM/AAAA [HH:MM[:SS]]) e o ISO do <input type="datetime-local"> (AAAA-MM-DD[THH:MM]). Sem a hora, assume 00:00. Ideal para campos opcionais de agendamento e datas retroativas (BATCH-075 / Meta 5).

Parameters

$strstring: Data/hora (BR ou ISO/datetime-local).

Returns

string|null

DATETIME (YYYY-MM-DD HH:MM:SS) ou null quando vazio/inválido.

formato_data_hora_datetime_para_input

view source · line 124 ↗

formato_data_hora_datetime_para_input(string $str): string

Converte um DATETIME do MySQL para o valor de um <input type="datetime-local"> (Y-m-d\TH:i). Retorna '' quando vazio/nulo/zero (BATCH-075 / Meta 5 — pré-preencher as datas no formulário de edição).

Parameters

$strstring: DATETIME (YYYY-MM-DD HH:MM:SS).

Returns

string

Valor no formato Y-m-d\TH:i ou '' quando vazio.

formato_data_hora_from_datetime_to_text

view source · line 143 ↗

formato_data_hora_from_datetime_to_text(string $data_hora, string|false $format = false): string

Converte data/hora do formato DATETIME do MySQL para texto formatado.

Parameters

$data_horastring: Data/hora no formato DATETIME do MySQL.
$formatstring|false: Formato personalizado usando: D (dia), ME (mês), A (ano), H (hora), MI (minuto), S (segundo).

Returns

string

Data/hora formatada ou string vazia se $data_hora for vazia.

formato_data_from_datetime_to_text

view source · line 196 ↗

formato_data_from_datetime_to_text(string $data_hora): string

Converte data do formato DATETIME do MySQL para formato brasileiro.

Parameters

$data_horastring: Data/hora no formato DATETIME do MySQL.

Returns

string

Data no formato DD/MM/AAAA.

formato_float_para_texto

view source · line 219 ↗

formato_float_para_texto(float $float, bool $sem_descimal = false): string

Formata um número float para o formato brasileiro.

Parameters

$floatfloat: O número a ser formatado.
$sem_descimalbool: Parâmetro não utilizado atualmente.

Returns

string

Número formatado no padrão brasileiro.

formato_texto_para_float

view source · line 234 ↗

formato_texto_para_float(string $texto): string

Converte número do formato brasileiro para float.

Parameters

$textostring: Número no formato brasileiro.

Returns

string

Número no formato float (ponto como decimal).

formato_int_para_texto

view source · line 270 ↗

formato_int_para_texto(int $int): string

Formata um número inteiro para o formato brasileiro.

Parameters

$intint: O número a ser formatado.

Returns

string

Número formatado com separadores de milhares.

formato_texto_para_int

view source · line 284 ↗

formato_texto_para_int(string $texto): string

Remove formatação brasileira de um número inteiro.

Parameters

$textostring: Número formatado no padrão brasileiro.

Returns

string

Número sem formatação.

formato_zero_a_esquerda

view source · line 300 ↗

formato_zero_a_esquerda(int|string $num, int $dig): string

Adiciona zeros à esquerda de um número.

Parameters

$numint|string: O número a ser formatado.
$digint: Quantidade total de dígitos desejada.

Returns

string

Número com zeros à esquerda.

formato_colocar_char_meio_numero

view source · line 328 ↗

formato_colocar_char_meio_numero(int|string $num, string $char = '-'): string

Insere um caractere no meio de um número.

Parameters

$numint|string: O número a ser processado.
$charstring: O caractere a ser inserido (padrão: '-').

Returns

string

Número com caractere inserido no meio.

formato_dado_para

view source · line 356 ↗

formato_dado_para(string $tipo, mixed $valor): string

Aplica formatação a um dado conforme o tipo especificado.

Parameters

$tipostring: Tipo de formatação a ser aplicada.
$valormixed: Valor a ser formatado.

Returns

string

Valor formatado ou string vazia se parâmetros inválidos.

formato_dado

view source · line 391 ↗

formato_dado(array|false $params = false): string

Formata um valor de acordo com o tipo especificado.

Parameters

$paramsarray|false: Parâmetros da função.

Returns

string

Valor formatado ou string vazia se parâmetros inválidos.

Verified against the code at commit 0ccf7099

Sources:

# formato.php library
Converts values between the database format (`YYYY-MM-DD HH:MM:SS`, decimal point) and the **Brazilian** format (`DD/MM/YYYY`, decimal comma, dot as thousands separator). The formats are fixed: there is no per-language variation. [interface.php](interface.md) uses it to display values in listings and in the history.
## Dates
| Function | Input → output |
|---|---|
| `formato_data_from_datetime_to_text($dt)` | `2026-09-26 14:30:00` → `26/09/2026` |
| `formato_data_hora_from_datetime_to_text($dt, $format = false)` | `2026-09-26 14:30:00` → `26/09/2026 14h30` |
| `formato_data_hora_padrao_datetime($br, $noTime = false)` | `26/09/2026 14:30` → `2026-09-26 14:30:00` (or `2026-09-26`) |
| `formato_data_hora_br_para_datetime($s)` | Accepts `DD/MM/YYYY[ HH:MM[:SS]]`, `YYYY-MM-DD…` and the `T` of `datetime-local`; returns `YYYY-MM-DD HH:MM:SS` or `null` |
| `formato_data_hora_datetime_para_input($dt)` | `2026-09-26 14:30:00` → `2026-09-26T14:30` (value for `<input type="datetime-local">`); `''` for empty or `0000-00-00` |
| `formato_data_hora_array($dt)` | Array with `dia`, `mes`, `ano` and, if there is a time, `hora`, `min`, `seg` |
In `formato_data_hora_from_datetime_to_text()`, `$format` replaces the codes `D`, `ME`, `A`, `H`, `MI` and `S` (default `D/ME/A HhMI`).
> [!WARNING]
> The `$format` codes are replaced **anywhere in the text**, including inside words: `'Data: D'` becomes `'26ata: 26'`. Use only codes and separators in the format and build the rest outside.
Only `formato_data_hora_br_para_datetime()` and `formato_data_hora_datetime_para_input()` validate their input. The others split the string by position and raise warnings (and meaningless results) with a value outside the expected pattern.
## Numbers
| Function | Example |
|---|---|
| `formato_float_para_texto($f)` | `1234.5` → `1.234,50` (always 2 decimals; the 2nd parameter is ignored) |
| `formato_texto_para_float($t)` | `1.234,50` → `1234.50` (string) |
| `formato_int_para_texto($i)` | `1234567` → `1.234.567` |
| `formato_texto_para_int($t)` | `1.234.567` → `1234567` (string) |
| `formato_zero_a_esquerda($n, $digits)` | `(7, 3)` → `007` |
| `formato_colocar_char_meio_numero($n, $char = '-')` | `123456` → `123-456` |
- `formato_texto_para_float()` treats every dot as a thousands separator: `'10.5'` becomes `105.`. Without a comma, it raises a warning and returns the number with a trailing dot (`'10'` → `10.`).
- `formato_colocar_char_meio_numero()` with a single-digit number ends in an error (`str_split` with length 0).
## `formato_dado()`
```php
formato_dado(['valor' => $v, 'tipo' => 'float-para-texto']);
formato_dado_para('dataHora', $v);   // shortcut
```
Types: `float-para-texto`, `texto-para-float`, `int-para-texto`, `texto-para-int`, `data`, `dataHora`, `datetime` and `date`. An unknown type returns the value unchanged; without `valor` or `tipo`, it returns `''`.
## Functions
Reference generated from `gestor/bibliotecas/formato.php` by `c2f docs:extract` — 14 functions. Do not edit inside this block.
- `formato_data_hora_array(string $data_hora_padrao_datetime_ou_padrao_date): array` — [line 33](../../../../../gestor/bibliotecas/formato.php#L33)
  Converte uma data/hora no formato DATETIME ou DATE para array.
  Parameters:
  - `$data_hora_padrao_datetime_ou_padrao_date`: Data/hora no formato padrão do banco.
  Returns: Array com as chaves: dia, mes, ano, hora (opcional), min (opcional), seg (opcional).
- `formato_data_hora_padrao_datetime(string $dataHora, bool $semHora = false): string` — [line 75](../../../../../gestor/bibliotecas/formato.php#L75)
  Converte data/hora do formato brasileiro para formato DATETIME do MySQL.
  Parameters:
  - `$dataHora`: Data/hora no formato brasileiro (DD/MM/YYYY HH:MM).
  - `$semHora`: Se true, retorna apenas a data no formato DATE (YYYY-MM-DD).
  Returns: Data/hora no formato DATETIME ou DATE do MySQL.
- `formato_data_hora_br_para_datetime(string $str): string|null` — [line 96](../../../../../gestor/bibliotecas/formato.php#L96)
  Converte data/hora para DATETIME do MySQL (YYYY-MM-DD HH:MM:SS), COM validação: retorna null quando vazio ou em formato inválido. Aceita DUAS formas — o formato brasileiro (DD/MM/AAAA [HH:MM[:SS]]) e o ISO do <input type="datetime-local"> (AAAA-MM-DD[THH:MM]). Sem a hora, assume 00:00. Ideal para campos opcionais de agendamento e datas retroativas (BATCH-075 / Meta 5).
  Parameters:
  - `$str`: Data/hora (BR ou ISO/datetime-local).
  Returns: DATETIME (YYYY-MM-DD HH:MM:SS) ou null quando vazio/inválido.
- `formato_data_hora_datetime_para_input(string $str): string` — [line 124](../../../../../gestor/bibliotecas/formato.php#L124)
  Converte um DATETIME do MySQL para o valor de um <input type="datetime-local"> (Y-m-d\TH:i). Retorna '' quando vazio/nulo/zero (BATCH-075 / Meta 5 — pré-preencher as datas no formulário de edição).
  Parameters:
  - `$str`: DATETIME (YYYY-MM-DD HH:MM:SS).
  Returns: Valor no formato Y-m-d\TH:i ou '' quando vazio.
- `formato_data_hora_from_datetime_to_text(string $data_hora, string|false $format = false): string` — [line 143](../../../../../gestor/bibliotecas/formato.php#L143)
  Converte data/hora do formato DATETIME do MySQL para texto formatado.
  Parameters:
  - `$data_hora`: Data/hora no formato DATETIME do MySQL.
  - `$format`: Formato personalizado usando: D (dia), ME (mês), A (ano), H (hora), MI (minuto), S (segundo).
  Returns: Data/hora formatada ou string vazia se $data_hora for vazia.
- `formato_data_from_datetime_to_text(string $data_hora): string` — [line 196](../../../../../gestor/bibliotecas/formato.php#L196)
  Converte data do formato DATETIME do MySQL para formato brasileiro.
  Parameters:
  - `$data_hora`: Data/hora no formato DATETIME do MySQL.
  Returns: Data no formato DD/MM/AAAA.
- `formato_float_para_texto(float $float, bool $sem_descimal = false): string` — [line 219](../../../../../gestor/bibliotecas/formato.php#L219)
  Formata um número float para o formato brasileiro.
  Parameters:
  - `$float`: O número a ser formatado.
  - `$sem_descimal`: Parâmetro não utilizado atualmente.
  Returns: Número formatado no padrão brasileiro.
- `formato_texto_para_float(string $texto): string` — [line 234](../../../../../gestor/bibliotecas/formato.php#L234)
  Converte número do formato brasileiro para float.
  Parameters:
  - `$texto`: Número no formato brasileiro.
  Returns: Número no formato float (ponto como decimal).
- `formato_int_para_texto(int $int): string` — [line 270](../../../../../gestor/bibliotecas/formato.php#L270)
  Formata um número inteiro para o formato brasileiro.
  Parameters:
  - `$int`: O número a ser formatado.
  Returns: Número formatado com separadores de milhares.
- `formato_texto_para_int(string $texto): string` — [line 284](../../../../../gestor/bibliotecas/formato.php#L284)
  Remove formatação brasileira de um número inteiro.
  Parameters:
  - `$texto`: Número formatado no padrão brasileiro.
  Returns: Número sem formatação.
- `formato_zero_a_esquerda(int|string $num, int $dig): string` — [line 300](../../../../../gestor/bibliotecas/formato.php#L300)
  Adiciona zeros à esquerda de um número.
  Parameters:
  - `$num`: O número a ser formatado.
  - `$dig`: Quantidade total de dígitos desejada.
  Returns: Número com zeros à esquerda.
- `formato_colocar_char_meio_numero(int|string $num, string $char = '-'): string` — [line 328](../../../../../gestor/bibliotecas/formato.php#L328)
  Insere um caractere no meio de um número.
  Parameters:
  - `$num`: O número a ser processado.
  - `$char`: O caractere a ser inserido (padrão: '-').
  Returns: Número com caractere inserido no meio.
- `formato_dado_para(string $tipo, mixed $valor): string` — [line 356](../../../../../gestor/bibliotecas/formato.php#L356)
  Aplica formatação a um dado conforme o tipo especificado.
  Parameters:
  - `$tipo`: Tipo de formatação a ser aplicada.
  - `$valor`: Valor a ser formatado.
  Returns: Valor formatado ou string vazia se parâmetros inválidos.
- `formato_dado(array|false $params = false): string` — [line 391](../../../../../gestor/bibliotecas/formato.php#L391)
  Formata um valor de acordo com o tipo especificado.
  Parameters:
  - `$params`: Parâmetros da função.
  - `$params['valor']`: Valor a ser formatado (obrigatório).
  - `$params['tipo']`: Tipo de formatação (obrigatório).
  Returns: Valor formatado ou string vazia se parâmetros inválidos.

formato.php library

Dates

Numbers

formato_dado()

Functions

The Future is Hybrid: Human + AI.

Your privacy

`formato_dado()`