DAX · UDF

String.FiveStars

Avaliação em estrelas: repete um símbolo de 0 a 5 vezes.

Categoria: TextoTipo: UDFVersão: v1.1.0Fonte: Paulo André Jesus — OfficeTuningAtualizado em: 25/09/2026

Documentação completa na Function Library →

Sintaxe

String.FiveStars ( pNumberOfStars [, pStarChar] )

Argumentos

Nome	Tipo	Obrigatório	Descrição
pNumberOfStars	INT64 VAL	Sim	Quantidade; abaixo de 0 vira 0, acima de 5 vira 5.
pStarChar	STRING VAL	Não	Símbolo. Padrão "⭐".

Retorno

Texto

Código completo

DEFINE
    /// Avaliação em estrelas: repete um símbolo de 0 a 5 vezes.
    /// @param {INT64} pNumberOfStars - Quantidade de estrelas; abaixo de 0 vira 0, acima de 5 vira 5.
    /// @param {STRING} [pStarChar] - Símbolo. Opcional; padrão "⭐".
    /// @returns Texto com os símbolos repetidos.
    FUNCTION String.FiveStars =
        ( pNumberOfStars : INT64 VAL, pStarChar : STRING VAL = "⭐" ) =>
        VAR vSymbol = IF ( ISBLANK ( pStarChar ), "⭐", pStarChar )
        VAR vNumberOfStars = MIN ( 5, MAX ( 0, pNumberOfStars ) )
        RETURN
            REPT ( vSymbol, vNumberOfStars )

EVALUATE
{ String.FiveStars ( 4 ), String.FiveStars ( 3, "★" ), String.FiveStars ( 9 ) }  // ⭐⭐⭐⭐ · ★★★ · ⭐⭐⭐⭐⭐

Exemplos

Avaliação = String.FiveStars ( ROUND ( [Nota Média], 0 ) )

EVALUATE { String.FiveStars ( 3, "★" ) }
// "★★★"

Dicas e observações

💡 pStarChar é opcional (valor padrão na definição da função). 💡 Em visual de tabela, alinhe a coluna à esquerda para as estrelas ficarem alinhadas.