# Números e unidades

## Escreva de zero a nove por extenso

Escreva `zero` até `nove` por extenso, e `10` em diante com algarismos.

- Correto: `Crie três regras.`
- Correto: `A conta permite 100 buckets.`

Três casos usam algarismo em qualquer valor: uma medida, uma versão e tudo o que o leitor digita ou lê na tela. `Defina o TTL em 5 segundos`, não `cinco segundos`.

## Use vírgula para decimais e ponto para milhares

| Regra                              | Exemplo                |
| ---------------------------------- | ---------------------- |
| Vírgula como separador decimal     | `9,5`, `3,14159`       |
| Ponto para milhares                | `10.000`, `25.456.990` |
| Zero antes da vírgula abaixo de um | `0,5`, nunca `,5`      |

O inglês inverte os dois separadores e escreve `10,000` e `9.5`. Um número copiado de um par para o outro sem conversão fica errado em um dos idiomas, e essa é a falha mais comum em uma tradução.

## Escreva a unidade junto do número

- Coloque um espaço entre o algarismo e a unidade: `20 MB`, `60 segundos`.
- Use hífen quando a medida modifica um substantivo em inglês: `a 60-second TTL`.
- Abrevie apenas ao lado de um número, e nunca coloque ponto depois da abreviação: `20 MB`, não `20 MB.` nem `vinte MB`.

Todo valor em uma tabela carrega sua unidade. Uma célula com `100` deixa o leitor escolhendo entre megabytes, segundos e requisições. [Referência](/pt-br/documentacao/guia-de-estilo/conteudo/referencia/) trata um limite sem unidade como um fato incompleto.

`MB` e `MiB` são números diferentes. Escreva a unidade que o produto declara e nunca converta entre as formas decimais (`kB`, `MB`, `GB`) e binárias (`KiB`, `MiB`, `GiB`). O mesmo vale para taxas: `Gbps` conta bits e `MB/s` conta bytes, oito vezes de diferença, então mantenha a forma que o produto usa.

Um limite é exato e nunca é arredondado. Arredonde apenas um número ilustrativo, e marque: `cerca de 200 ms`.

## Use traço médio em um número negativo

Escreva `–40` com traço médio, não com hífen. A regra vale para a prosa: em código, comandos e qualquer valor que o leitor copia, mantenha o hífen ASCII — um `–40` colado não é interpretado. [Pontuação](/pt-br/documentacao/guia-de-estilo/formatacao/pontuacao/) cobre as demais regras de traços.

## Escreva um ordinal sem sufixo além do número

Escreva `primeiro` e `segundo` por extenso. Em algarismo, escreva `1º`, nunca `1ºmente`.

## Formate uma data apenas onde uma data cabe

Datas aparecem em changelogs e em nenhum outro lugar, o que [Escolha de palavras](/pt-br/documentacao/guia-de-estilo/escrita/escolha-de-palavras/) declara como regra. Uma data em qualquer outro lugar envelhece a página.

Onde a data é permitida, escreva o mês por extenso: `10 de julho de 2026`. O inglês usa a ordem mês, dia, ano: `July 10, 2026`.

- Incorreto: `10/07/2026`
- Correto: `10 de julho de 2026`

Uma data numérica é lida como mês primeiro nos Estados Unidos e como dia primeiro em quase todo o resto, então ela significa duas coisas ao mesmo tempo.

## Escreva um horário no formato de 24 horas

Em português, use o formato de 24 horas: `10:45` e `18:30`. Em inglês, escreva `AM` e `PM` em maiúsculas, com um espaço antes: `10:45 AM`.

Não escreva `24/7`. Escreva `o tempo todo` ou nomeie a disponibilidade real.

## Formate moeda apenas na página de pricing

Um preço, uma cota vendida por unidade e uma métrica de cobrança vivem só na página de pricing. [Referência](/pt-br/documentacao/guia-de-estilo/conteudo/referencia/) proíbe repetir qualquer um deles em uma página de produto.

Onde o valor é permitido, o símbolo vem antes do número, sem espaço: `$1.000`.