Navegação das docs

Referência / Bibliotecas

Biblioteca formato.php

Conversões entre o formato do banco e o brasileiro: datas, números com vírgula e milhar, e o despachante formato_dado().

Caminho no Gestor bibliotecas/formato.php

Converte valores entre o formato do banco (AAAA-MM-DD HH:MM:SS, ponto decimal) e o formato brasileiro (DD/MM/AAAA, vírgula decimal, ponto de milhar). Os formatos são fixos: não há variação por idioma. A interface.php a usa para exibir valores nas listagens e no histórico.

Datas

Função	Entrada → saída
`formato_data_from_datetime_to_text($dt)`	`2026-09-26 14:30:00` → `26/09/2026`
`formato_data_hora_from_datetime_to_text($dt, $formato = false)`	`2026-09-26 14:30:00` → `26/09/2026 14h30`
`formato_data_hora_padrao_datetime($br, $semHora = false)`	`26/09/2026 14:30` → `2026-09-26 14:30:00` (ou `2026-09-26`)
`formato_data_hora_br_para_datetime($s)`	Aceita `DD/MM/AAAA[ HH:MM[:SS]]`, `AAAA-MM-DD…` e o `T` do `datetime-local`; devolve `AAAA-MM-DD HH:MM:SS` ou `null`
`formato_data_hora_datetime_para_input($dt)`	`2026-09-26 14:30:00` → `2026-09-26T14:30` (valor de `<input type="datetime-local">`); `''` para vazio ou `0000-00-00`
`formato_data_hora_array($dt)`	Array com `dia`, `mes`, `ano` e, se houver hora, `hora`, `min`, `seg`

Em formato_data_hora_from_datetime_to_text(), o $formato troca os códigos D, ME, A, H, MI e S (padrão D/ME/A HhMI).

Só formato_data_hora_br_para_datetime() e formato_data_hora_datetime_para_input() validam a entrada. As demais partem a string por posição e geram warnings (e resultados sem sentido) com um valor fora do padrão esperado.

Números

Função	Exemplo
`formato_float_para_texto($f)`	`1234.5` → `1.234,50` (sempre 2 casas; o 2º parâmetro é ignorado)
`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, $digitos)`	`(7, 3)` → `007`
`formato_colocar_char_meio_numero($n, $char = '-')`	`123456` → `123-456`

formato_texto_para_float() trata todo ponto como separador de milhar: '10.5' vira 105.. Sem vírgula, gera warning e devolve o número com um ponto no fim ('10' → 10.).
formato_colocar_char_meio_numero() com um número de um só dígito termina em erro (str_split com tamanho 0).

`formato_dado()`

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

Tipos: float-para-texto, texto-para-float, int-para-texto, texto-para-int, data, dataHora, datetime e date. Um tipo desconhecido devolve o valor sem alteração; sem valor ou tipo, devolve ''.

Funções

Gerado a partir de gestor/bibliotecas/formato.php · 14 funções

14 de 14

formato_data_hora_array

ver no código · linha 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.

Parâmetros

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

Retorno

array

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

formato_data_hora_padrao_datetime

ver no código · linha 75 ↗

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

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

Parâmetros

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

Retorno

string

Data/hora no formato DATETIME ou DATE do MySQL.

formato_data_hora_br_para_datetime

ver no código · linha 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).

Parâmetros

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

Retorno

string|null

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

formato_data_hora_datetime_para_input

ver no código · linha 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).

Parâmetros

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

Retorno

string

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

formato_data_hora_from_datetime_to_text

ver no código · linha 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.

Parâmetros

$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).

Retorno

string

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

formato_data_from_datetime_to_text

ver no código · linha 196 ↗

formato_data_from_datetime_to_text(string $data_hora): string

Converte data do formato DATETIME do MySQL para formato brasileiro.

Parâmetros

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

Retorno

string

Data no formato DD/MM/AAAA.

formato_float_para_texto

ver no código · linha 219 ↗

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

Formata um número float para o formato brasileiro.

Parâmetros

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

Retorno

string

Número formatado no padrão brasileiro.

formato_texto_para_float

ver no código · linha 234 ↗

formato_texto_para_float(string $texto): string

Converte número do formato brasileiro para float.

Parâmetros

$textostring: Número no formato brasileiro.

Retorno

string

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

formato_int_para_texto

ver no código · linha 270 ↗

formato_int_para_texto(int $int): string

Formata um número inteiro para o formato brasileiro.

Parâmetros

$intint: O número a ser formatado.

Retorno

string

Número formatado com separadores de milhares.

formato_texto_para_int

ver no código · linha 284 ↗

formato_texto_para_int(string $texto): string

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

Parâmetros

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

Retorno

string

Número sem formatação.

formato_zero_a_esquerda

ver no código · linha 300 ↗

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

Adiciona zeros à esquerda de um número.

Parâmetros

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

Retorno

string

Número com zeros à esquerda.

formato_colocar_char_meio_numero

ver no código · linha 328 ↗

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

Insere um caractere no meio de um número.

Parâmetros

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

Retorno

string

Número com caractere inserido no meio.

formato_dado_para

ver no código · linha 356 ↗

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

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

Parâmetros

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

Retorno

string

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

formato_dado

ver no código · linha 391 ↗

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

Formata um valor de acordo com o tipo especificado.

Parâmetros

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

Retorno

string

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

Verificado contra o código no commit 0ccf7099

Fontes:

# Biblioteca formato.php
Converte valores entre o formato do banco (`AAAA-MM-DD HH:MM:SS`, ponto decimal) e o formato **brasileiro** (`DD/MM/AAAA`, vírgula decimal, ponto de milhar). Os formatos são fixos: não há variação por idioma. A [interface.php](interface.md) a usa para exibir valores nas listagens e no histórico.
## Datas
| Função | Entrada → saída |
|---|---|
| `formato_data_from_datetime_to_text($dt)` | `2026-09-26 14:30:00` → `26/09/2026` |
| `formato_data_hora_from_datetime_to_text($dt, $formato = false)` | `2026-09-26 14:30:00` → `26/09/2026 14h30` |
| `formato_data_hora_padrao_datetime($br, $semHora = false)` | `26/09/2026 14:30` → `2026-09-26 14:30:00` (ou `2026-09-26`) |
| `formato_data_hora_br_para_datetime($s)` | Aceita `DD/MM/AAAA[ HH:MM[:SS]]`, `AAAA-MM-DD…` e o `T` do `datetime-local`; devolve `AAAA-MM-DD HH:MM:SS` ou `null` |
| `formato_data_hora_datetime_para_input($dt)` | `2026-09-26 14:30:00` → `2026-09-26T14:30` (valor de `<input type="datetime-local">`); `''` para vazio ou `0000-00-00` |
| `formato_data_hora_array($dt)` | Array com `dia`, `mes`, `ano` e, se houver hora, `hora`, `min`, `seg` |
Em `formato_data_hora_from_datetime_to_text()`, o `$formato` troca os códigos `D`, `ME`, `A`, `H`, `MI` e `S` (padrão `D/ME/A HhMI`).
> [!WARNING]
> Os códigos do `$formato` são trocados **em qualquer lugar do texto**, inclusive dentro de palavras: `'Data: D'` vira `'26ata: 26'`. Use só códigos e separadores no formato e monte o resto fora.
Só `formato_data_hora_br_para_datetime()` e `formato_data_hora_datetime_para_input()` validam a entrada. As demais partem a string por posição e geram *warnings* (e resultados sem sentido) com um valor fora do padrão esperado.
## Números
| Função | Exemplo |
|---|---|
| `formato_float_para_texto($f)` | `1234.5` → `1.234,50` (sempre 2 casas; o 2º parâmetro é ignorado) |
| `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, $digitos)` | `(7, 3)` → `007` |
| `formato_colocar_char_meio_numero($n, $char = '-')` | `123456` → `123-456` |
- `formato_texto_para_float()` trata todo ponto como separador de milhar: `'10.5'` vira `105.`. Sem vírgula, gera *warning* e devolve o número com um ponto no fim (`'10'` → `10.`).
- `formato_colocar_char_meio_numero()` com um número de um só dígito termina em erro (`str_split` com tamanho 0).
## `formato_dado()`
```php
formato_dado(['valor' => $v, 'tipo' => 'float-para-texto']);
formato_dado_para('dataHora', $v);   // atalho
```
Tipos: `float-para-texto`, `texto-para-float`, `int-para-texto`, `texto-para-int`, `data`, `dataHora`, `datetime` e `date`. Um tipo desconhecido devolve o valor sem alteração; sem `valor` ou `tipo`, devolve `''`.
## Funções
Referência gerada a partir de `gestor/bibliotecas/formato.php` por `c2f docs:extract` — 14 funções. Não edite dentro deste bloco.
- `formato_data_hora_array(string $data_hora_padrao_datetime_ou_padrao_date): array` — [linha 33](../../../../../gestor/bibliotecas/formato.php#L33)
  Converte uma data/hora no formato DATETIME ou DATE para array.
  Parâmetros:
  - `$data_hora_padrao_datetime_ou_padrao_date`: Data/hora no formato padrão do banco.
  Retorno: Array com as chaves: dia, mes, ano, hora (opcional), min (opcional), seg (opcional).
- `formato_data_hora_padrao_datetime(string $dataHora, bool $semHora = false): string` — [linha 75](../../../../../gestor/bibliotecas/formato.php#L75)
  Converte data/hora do formato brasileiro para formato DATETIME do MySQL.
  Parâmetros:
  - `$dataHora`: Data/hora no formato brasileiro (DD/MM/YYYY HH:MM).
  - `$semHora`: Se true, retorna apenas a data no formato DATE (YYYY-MM-DD).
  Retorno: Data/hora no formato DATETIME ou DATE do MySQL.
- `formato_data_hora_br_para_datetime(string $str): string|null` — [linha 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).
  Parâmetros:
  - `$str`: Data/hora (BR ou ISO/datetime-local).
  Retorno: DATETIME (YYYY-MM-DD HH:MM:SS) ou null quando vazio/inválido.
- `formato_data_hora_datetime_para_input(string $str): string` — [linha 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).
  Parâmetros:
  - `$str`: DATETIME (YYYY-MM-DD HH:MM:SS).
  Retorno: 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` — [linha 143](../../../../../gestor/bibliotecas/formato.php#L143)
  Converte data/hora do formato DATETIME do MySQL para texto formatado.
  Parâmetros:
  - `$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).
  Retorno: Data/hora formatada ou string vazia se $data_hora for vazia.
- `formato_data_from_datetime_to_text(string $data_hora): string` — [linha 196](../../../../../gestor/bibliotecas/formato.php#L196)
  Converte data do formato DATETIME do MySQL para formato brasileiro.
  Parâmetros:
  - `$data_hora`: Data/hora no formato DATETIME do MySQL.
  Retorno: Data no formato DD/MM/AAAA.
- `formato_float_para_texto(float $float, bool $sem_descimal = false): string` — [linha 219](../../../../../gestor/bibliotecas/formato.php#L219)
  Formata um número float para o formato brasileiro.
  Parâmetros:
  - `$float`: O número a ser formatado.
  - `$sem_descimal`: Parâmetro não utilizado atualmente.
  Retorno: Número formatado no padrão brasileiro.
- `formato_texto_para_float(string $texto): string` — [linha 234](../../../../../gestor/bibliotecas/formato.php#L234)
  Converte número do formato brasileiro para float.
  Parâmetros:
  - `$texto`: Número no formato brasileiro.
  Retorno: Número no formato float (ponto como decimal).
- `formato_int_para_texto(int $int): string` — [linha 270](../../../../../gestor/bibliotecas/formato.php#L270)
  Formata um número inteiro para o formato brasileiro.
  Parâmetros:
  - `$int`: O número a ser formatado.
  Retorno: Número formatado com separadores de milhares.
- `formato_texto_para_int(string $texto): string` — [linha 284](../../../../../gestor/bibliotecas/formato.php#L284)
  Remove formatação brasileira de um número inteiro.
  Parâmetros:
  - `$texto`: Número formatado no padrão brasileiro.
  Retorno: Número sem formatação.
- `formato_zero_a_esquerda(int|string $num, int $dig): string` — [linha 300](../../../../../gestor/bibliotecas/formato.php#L300)
  Adiciona zeros à esquerda de um número.
  Parâmetros:
  - `$num`: O número a ser formatado.
  - `$dig`: Quantidade total de dígitos desejada.
  Retorno: Número com zeros à esquerda.
- `formato_colocar_char_meio_numero(int|string $num, string $char = '-'): string` — [linha 328](../../../../../gestor/bibliotecas/formato.php#L328)
  Insere um caractere no meio de um número.
  Parâmetros:
  - `$num`: O número a ser processado.
  - `$char`: O caractere a ser inserido (padrão: '-').
  Retorno: Número com caractere inserido no meio.
- `formato_dado_para(string $tipo, mixed $valor): string` — [linha 356](../../../../../gestor/bibliotecas/formato.php#L356)
  Aplica formatação a um dado conforme o tipo especificado.
  Parâmetros:
  - `$tipo`: Tipo de formatação a ser aplicada.
  - `$valor`: Valor a ser formatado.
  Retorno: Valor formatado ou string vazia se parâmetros inválidos.
- `formato_dado(array|false $params = false): string` — [linha 391](../../../../../gestor/bibliotecas/formato.php#L391)
  Formata um valor de acordo com o tipo especificado.
  Parâmetros:
  - `$params`: Parâmetros da função.
  - `$params['valor']`: Valor a ser formatado (obrigatório).
  - `$params['tipo']`: Tipo de formatação (obrigatório).
  Retorno: Valor formatado ou string vazia se parâmetros inválidos.

Biblioteca formato.php

Datas

Números

formato_dado()

Funções

O Futuro é Híbrido: Humano + IA.

Sua privacidade

`formato_dado()`