Code Library

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

NomeTipoObrigatórioDescrição
pNumeroINT64 VALSimNúmero. O sinal é descartado.
pNumeroDeCaracteresINT64 VALSimTamanho 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.