CBO

Valida um código CBO (Classificação Brasileira de Ocupações) contra a tabela oficial da CBO 2002.

• Aceita uma string com os 6 dígitos ou com a máscara NNNN-NN, ou um número.
• Uma string mascarada pode ter qualquer sequência de separadores (espaço, ., - ou /) entre os grupos. Qualquer outra string é rejeitada, em vez de ter seus dígitos extraídos.
• Dígitos sem máscara são completados com zeros à esquerda até 6, como string ou como número. Um valor mascarado é lido como foi escrito.

import { isValidCbo } from '@brazilian-utils/brazilian-utils';

isValidCbo('2124-05'); // true
isValidCbo('212405'); // true
isValidCbo(212405); // true
isValidCbo(10205); // true (completado para 6 dígitos, ou seja, '010205')
isValidCbo('10205'); // true (completado do mesmo jeito que um número)
isValidCbo('000000'); // false
isValidCbo('2124abc05'); // false (não é uma forma documentada)
isValidCbo(-212405); // false (não é um inteiro seguro não negativo)

Fonte: tabelas da CBO 2002 publicadas pelo MTE ("Estrutura CBO (CSV)", arquivos de 10/07/2026, 2.725 ocupações).

Formata um código CBO (Classificação Brasileira de Ocupações) na máscara NNNN-NN. Só a estrutura muda; use isValidCbo para conferir um código com a tabela.

• Opções (FormatCboOptions): pad (padrão false) completa antes o valor com zeros à esquerda até os 6 dígitos de um código completo. Sem ele a máscara é aplicada até onde o valor vai. Um valor vazio, ou sem dígitos, devolve '' mesmo com pad.
• Caracteres fora da máscara são descartados, e um número só é lido como a string dos seus dígitos quando é um inteiro seguro não negativo: um número negativo, fracionário ou inseguro retorna ''. Retorna '' quando não há dígito algum.

import { formatCbo } from '@brazilian-utils/brazilian-utils';

formatCbo('212405'); // 2124-05
formatCbo('21240'); // 2124-0 (máscara aplicada até onde o valor vai)
formatCbo('10205', { pad: true }); // 0102-05 (completado até 6 dígitos antes)
formatCbo('abc212405'); // 2124-05 (só os dígitos são lidos)
formatCbo(-212405); // '' (não é um inteiro seguro não negativo)

Fonte: tabelas da CBO 2002 publicadas pelo MTE, que imprimem os códigos como NNNN-NN.

Remove a formatação do CBO (Classificação Brasileira de Ocupações), mantém apenas os dígitos e limita o resultado a 6 dígitos.

• Nada é completado com zeros à esquerda: o zero inicial de um código como 010205 precisa ser escrito. Use getCbo ou isValidCbo para consultar uma ocupação.

import { parseCbo } from '@brazilian-utils/brazilian-utils';

parseCbo('2124-05'); // '212405'

Consulta um código CBO (Classificação Brasileira de Ocupações) e retorna o título oficial da ocupação. O resultado é um registro Cbo: { code, description }.

• Mesmas regras de isValidCbo. Retorna null quando o código é desconhecido ou o valor não está em uma forma documentada.

import { getCbo } from '@brazilian-utils/brazilian-utils';

getCbo('2124-05'); // { code: '212405', description: 'Analista de desenvolvimento de sistemas' }
getCbo(10205); // { code: '010205', description: 'Oficial da aeronáutica' } (completado para 6 dígitos)
getCbo('10205'); // { code: '010205', description: 'Oficial da aeronáutica' } (completado do mesmo jeito)
getCbo('000000'); // null
getCbo('2124abc05'); // null (não é uma forma documentada)

Fonte: tabelas da CBO 2002 publicadas pelo MTE ("Estrutura CBO (CSV)", arquivos de 10/07/2026, 2.725 ocupações).