Função ceil

  • Artigo

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime 11.3 LTS e superior

Devolve o menor número não inferior ao arredondado expr para targetScale algarismos em relação à vírgula decimal. Esta função é sinónimo de função de teto.

Sintaxe

ceil(expr [, targetScale])

Argumentos

  • expr: Uma expressão que é avaliada como numérica.
  • targetScale: Um literal inteiro opcional maior do que -38 especificar por quantos dígitos após as casas decimais arredondar para cima.

Devoluções

Em caso negativo targetScale :

  • Se expr for DECIMAL(p, s), retorna DECIMAL(p - s + 1, 0).
  • Para todos os outros casos, retorna um BIGINT.

Se targetScale é especificado e expr é um:

  • TINYINT

    Devolve um DECIMAL(p, 0) com p = max(3, -targetScale + 1).

  • SMALLINT

    Devolve um DECIMAL(p, 0) com p = max(5, -targetScale + 1).

  • INTEGER

    Devolve um DECIMAL(p, 0) com p = max(10, -targetScale + 1)).

  • BIGINT

    Devolve um DECIMAL(p, 0) com p = max(20, -targetScale + 1)).

  • FLOAT

    Devolve um DECIMAL(p, s) com p = max(14, -targetScale + 1)) e s = min(7, max(0, targetScale))

  • DOUBLE

    Devolve um DECIMAL(p, s) com p = max(30, -targetScale + 1)) e s = min(15, max(0, targetScale))

  • DECIMAL(p_in, s_in)

    Devolve um DECIMAL(p, s) com p = max(p_in - s_in + 1, -targetScale + 1)) e s = min(s_in, max(0, targetScale))

Se targetScale for negativo, o arredondamento ocorre para -targetScale algarismos à esquerda da vírgula decimal.

O padrão targetScale é 0, que arredonda para o próximo número integral maior.

Exemplos

> SELECT ceil(-0.1);
 0

> SELECT ceil(5);
 5

> SELECT ceil(5.4);
 6

> SELECT ceil(3345.1, -2);
 3400

> SELECT ceil(-12.345, 1);
 -12.3