DAX · UDF
String.FormatWithLeadingZeros
Completa um número inteiro com zeros à esquerda.
Categoria: TextoTipo: UDFVersão: v1.1.0Fonte: Paulo André Jesus — OfficeTuningAtualizado em: 25/09/2026
Documentação completa na Function Library →Sintaxe
String.FormatWithLeadingZeros ( pNumero, pNumeroDeCaracteres )Argumentos
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| pNumero | INT64 VAL | Sim | Número. O sinal é descartado. |
| pNumeroDeCaracteres | INT64 VAL | Sim | Tamanho final; mínimo 1. |
Retorno
Texto
Código completo
DEFINE
/// Completa um número inteiro com zeros à esquerda.
/// @param {INT64} pNumero - Número. O sinal é descartado.
/// @param {INT64} pNumeroDeCaracteres - Tamanho final (mínimo 1).
/// @returns Texto com zeros à esquerda.
FUNCTION String.FormatWithLeadingZeros =
( pNumero : INT64 VAL, pNumeroDeCaracteres : INT64 VAL ) =>
VAR vNumero = ABS ( pNumero )
VAR vNumeroDeCaracteres = MAX ( 1, ABS ( pNumeroDeCaracteres ) )
RETURN
FORMAT ( vNumero, REPT ( "0", vNumeroDeCaracteres ) )
EVALUATE
{ String.FormatWithLeadingZeros ( 42, 5 ), String.FormatWithLeadingZeros ( -7, 3 ) } // "00042" · "007"Exemplos
CodigoLoja = String.FormatWithLeadingZeros ( 'TabDimLoja'[ID Loja], 4 )
EVALUATE { String.FormatWithLeadingZeros ( 42, 5 ) }
// "00042"Dicas e observações
💡 Valor maior que o tamanho volta inteiro, sem corte. ⚠️ INT64 arredonda decimais: 42,7 vira 43. 💡 A versão Power Query é fnFormatWithLeadingZeros, em /m/udf/biblioteca.