Funções Acos, Acot, Asin, Atan, Atan2, Cos, Cot, Degrees, Pi, Radians, Sin e Tan
Aplica-se a:
Aplicações de tela Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI
Calcula valores trigonométricos.
Descrição
Funções principais
A função Cos devolve o cosseno do argumento, um ângulo especificado nos radianos.
A função Cot devolve a cotangente do argumento, um ângulo especificado nos radianos.
A função Sin devolve o seno do argumento, um ângulo especificado nos radianos.
A função Tan devolve a tangente do argumento, um ângulo especificado nos radianos.
Funções inversas
A função Acos devolve o arco de cosseno, ou cosseno inverso, do argumento. O arco de cosseno é o ângulo do qual o cosseno é o argumento. O ângulo devolvido é fornecido em radianos no intervalo de 0 (zero) a π.
A função Acot devolve o valor principal do arco tangente, ou cotangente inversa, do argumento. O ângulo devolvido é fornecido em radianos no intervalo de 0 (zero) a π.
A função Asin devolve o arco do seno, ou seno inverso, do argumento. O arco do seno é o ângulo do qual o seno é o argumento. O ângulo devolvido é fornecido em radianos no intervalo -π/2 a π/2.
A função Atan devolve o arco de tangente, ou tangente inversa, do respetivo argumento. O arco de tangente é o ângulo do qual a tangente é o argumento. O ângulo devolvido é fornecido em radianos no intervalo -π/2 a π/2.
A função Atan2 devolve o arco de tangente, ou tangente inversa, das coordenadas x e y especificadas como argumentos. O arco de tangente é o ângulo desde o eixo x até uma linha que contém a origem (0,0) e um ponto com coordenadas (x, y). O ângulo é fornecido em radianos entre -π e π, excluindo -π. Um resultado positivo representa um ângulo a mover-se para a esquerda a partir do eixo x; um resultado negativo representa um ângulo a mover-se para a direita. Atan2(a,b) é igual a Atan(b/a), exceto que a pode ser igual a 0 (zero) com a função Atan2.
Funções de auxílio
A função Degrees converte radianos em graus. π radianos igual a 180 graus.
A função Pi obtém o número transcendental π, que começa por 3,141592...
A função Radians converte graus em radianos.
Notas
Se transmitir um único número a estas funções, o valor devolvido será um único resultado. Se transmitir uma tabela de coluna única que contenha números, o valor devolvido é uma tabela de coluna única de resultados com uma coluna Valor, um resultado para cada registo na tabela do argumento. Se tiver uma tabela com várias colunas, pode formatá-las para uma tabela com uma única coluna, conforme descrito em trabalhar com tabelas.
Se um argumento resultar num valor indefinido, o resultado ficará blank. Tal pode acontecer, por exemplo, quando utilizar funções inversas com argumentos que estão fora do intervalo.
Sintaxe
Funções Principais
Cos( Radians )
Cot( Radians )
Sin( Radians )
Tan( Radians )
- Radians – Obrigatório. Ângulo em que operar.
Cos( SingleColumnTable )
Cot( SingleColumnTable )
Sin( SingleColumnTable )
Tan( SingleColumnTable )
- TabelaComUmaÚnicaColuna – Obrigatório. Uma tabela de coluna única dos ângulos a trabalhar.
Funções Inversas
Acos( Number )
Acot( Number )
Asin( Number )
Atan( Number )
- Número – Obrigatório. Número a trabalhar.
Acos( SingleColumnTable )
Acot( SingleColumnTable )
Asin( SingleColumnTable )
Atan( SingleColumnTable )
- TabelaComUmaÚnicaColuna – Obrigatório. Uma tabela de coluna única de números a trabalhar.
Atan2( X, Y )
- X – Obrigatório. Coordenada do eixo X.
- Y – Obrigatório. Coordenada do eixo Y.
Funções de Auxílio
Degrees( Radians )
- Radians – Obrigatório. Ângulo em radianos a converter em graus.
Pi()
Radians( Degrees )
- Degrees – Obrigatório. Ângulo em graus a converter em radianos.
Exemplos
Número único
| Fórmula | Descrição | Resultado |
|---|---|---|
| Cos( 1,047197 ) | Devolve o cosseno de 1,047197 radianos ou 60 graus. | 0.5 |
| Cot( Pi()/4 ) | Devolve a cotangente de 0,785398 radianos ou 45 graus. | 1 |
| Sin( Pi()/2 ) | Devolve o seno de 1,570796 radianos ou 90 graus. | 1 |
| Tan( Radians(60) ) | Devolve a tangente de 1,047197 radianos ou 60 graus. | 1,732050... |
| Acos( 0,5 ) | Devolve o arco de cosseno de 0,5, em radianos. | 1,047197... |
| Acot( 1 ) | Devolve o arco tangente de 1, em radianos. | 0,785398... |
| Asin( 1 ) | Devolve o arco de seno de 1, em radianos. | 1,570796... |
| Atan( 1,732050 ) | Devolve o arco de tangente de 1,732050, em radianos. | 1,047197... |
| Atan2( 5, 3 ) | Devolve o arco de tangente do ângulo do eixo x da linha que contém a origem (0,0) e a coordenada (5,3), que é de aproximadamente 31 graus. | 0,540419... |
| Atan2( 4, 4 ) | Devolve o arco de tangente do ângulo do eixo x da linha que contém a origem (0,0) e a coordenada (4,4), que é exatamente π/4 radianos ou 45 graus. | 0,785398... |
| Degrees( 1,047197 ) | Devolve o número equivalente de graus para 1,047197 radianos. | 60 |
| Pi() | Obtém o número transcendental π. | 3,141592... |
| Radians( 15 ) | Devolve o número equivalente de radianos para 15 graus. | 0,261799... |
Tabela com uma única coluna
Os exemplos nesta secção utilizam uma origem de dados denominada ValueTable que contém os seguintes dados. O último registo na tabela é π/2 radianos ou 90 graus.
| valor |
|---|
| 0.5 |
| -2 |
| 1,570796... |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Cos( ValueTable ) | Devolve o cosseno de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 0.877582..., -0.416146..., 0 |
| Cot( ValueTable ) | Devolve a cotangente de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 1.830487..., 0.457657..., 0 |
| Sin( ValueTable ) | Devolve o seno de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 0.479425, -0.909297..., 1 |
| Tan( ValueTable ) | Devolve a tangente de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 0.546302..., 2.185039..., 3060023.306952... |
| Acos( ValueTable ) | Devolve o arco de cosseno de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 1.047197..., Blank(), Blank() |
| Acot( ValueTable ) | Devolve o arco tangente de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 1.107138..., 2.677945..., 0.566911... |
| Asin( ValueTable ) | Devolve o arco de seno de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 0.523598..., Blank(), Blank() |
| Atan( ValueTable ) | Devolve o arco de tangente de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 0.463647..., -1.107148..., 1.00388... |
| Degrees( ValueTable ) | Devolve o número equivalente de graus para cada número na tabela, assumindo que são ângulos em radianos. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 28.647889..., -114.591559..., 90 |
| Radians( ValueTable ) | Devolve o número equivalente de radianos para cada número na tabela, assumindo que são ângulos em graus. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 0.008726..., -0.034906..., 0.027415... |