Funções Acos, Acot, Asin, Atan, Atan2, Cos, Cot, Degrees, Pi, Radians, Sin e Tan
Aplica-se a:
Aplicativos de tela Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI
Calcula valores trigonométricos.
Description
Funções principais
A função Cos retorna o cosseno do argumento, um ângulo especificado em radianos.
A função Cot retorna a cotangente do argumento, um ângulo especificado em radianos.
A função Sin retorna o seno do argumento, um ângulo especificado em radianos.
A função Tan retorna a tangente do argumento, um ângulo especificado em radianos.
Funções inversas
A função Acos retorna o arco cosseno ou o cosseno inverso do argumento. O arco cosseno é o ângulo cujo cosseno é o argumento. O ângulo retornado é fornecido em radianos no intervalo de 0 (zero) para π.
A função Acot retorna o valor principal do arco cotangente ou a cotangente inversa do seu argumento. O ângulo retornado é fornecido em radianos no intervalo de 0 (zero) para π.
A função Asin retorna o arco seno ou seno inverso de seu argumento. O arco seno é o ângulo cujo seno é o argumento. O ângulo retornado é fornecido em radianos no intervalo de -π/2 para π/2.
A função Atan retorna o arco tangente ou a tangente inversa de seu argumento. O arco tangente é o ângulo cuja tangente é o argumento. O ângulo retornado é fornecido em radianos no intervalo de -π/2 para π/2.
A função Atan2 retorna o arco tangente ou a tangente inversa de coordenadas x e y especificadas como argumentos. O arco tangente é o ângulo entre o eixo x para 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 no sentido anti-horário a partir do eixo x. Um resultado negativo apresenta um ângulo no sentido horário. Atan2(a,b) é igual a Atan(b/a), exceto que a pode ser igual a 0 (zero) com a função Atan2.
Funções auxiliares
A função Degrees converte radianos em graus. π radianos é igual a 180 graus.
A função Pi retorna o número transcendental π, que começa com 3,141592...
A função Radians converte graus em radianos.
Observações
Se você passar um número para essas funções, o valor de retorno será um resultado único. Se você passar uma tabela de coluna única que contenha números, o valor de retorno será uma tabela de coluna única de resultados com uma coluna Valor, um resultado para cada registro na tabela do argumento. Se você tiver uma tabela de várias colunas, é possível formatá-la como uma tabela de coluna única, como descrito em Trabalhando com tabelas.
Se um argumento resultar em um valor indefinido, o resultado ficará em branco. Isso pode acontecer, por exemplo, ao usar 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 com o qual operar.
Cos( SingleColumnTable )
Cot( SingleColumnTable )
Sin( SingleColumnTable )
Tan( SingleColumnTable )
- SingleColumnTable - obrigatório. Uma tabela de coluna única com ângulos para operar.
Funções inversas
Acos( Number )
Acot( Number )
Asin( Number )
Atan( Number )
- Number - obrigatório. Número a se operar.
Acos( SingleColumnTable )
Acot( SingleColumnTable )
Asin( SingleColumnTable )
Atan( SingleColumnTable )
- SingleColumnTable - obrigatório. Uma tabela de coluna única de números para operar.
Atan2( X, Y )
- X - obrigatório. Coordenadas do eixo X.
- Y - obrigatório. Coordenadas do eixoY.
Funções auxiliares
Degrees( Radians )
- Radians - obrigatório. Ângulo em radianos para converter em graus.
Pi()
Radians( Degrees )
- Degrees - obrigatório. Ângulo em graus para converter em radianos.
Exemplos
Número único
| Fórmula | Descrição | Resultado |
|---|---|---|
| Cos( 1.047197 ) | Retorna o cosseno de 1,047197 radianos ou 60 graus. | 0.5 |
| Cot( Pi()/4 ) | Retorna a cotangente de 0,785398... radianos ou 45 graus. | 1 |
| Sin( Pi()/2 ) | Retorna o seno de 1,570796... radianos ou 90 graus. | 1 |
| Tan( Radians(60) ) | Retorna a tangente de 1,047197... radianos ou 60 graus. | 1,732050... |
| Acos( 0.5 ) | Retorna o arco cosseno de 0,5, em radianos. | 1,047197... |
| Acot( 1 ) | Retorna o arco cotangente de 1, em radianos. | 0,785398... |
| Asin( 1 ) | Retorna o arco seno de 1, em radianos. | 1,570796... |
| Atan( 1.732050 ) | Retorna o arco tangente de 1,732050, em radianos. | 1,047197... |
| Atan2( 5, 3 ) | Retorna o arco tangente do ângulo do eixo x da linha que contém a origem (0,0) e a coordenada (5,3), que é aproximadamente 31 graus. | 0,540419... |
| Atan2( 4, 4 ) | Retorna o arco 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 ) | Retorna o número equivalente em graus para 1,047197 radianos. | 60 |
| Pi() | Retorna o número transcendental π. | 3,141592... |
| Radians( 15 ) | Retorna o número equivalente em radianos para 15 graus. | 0,261799... |
Tabela de coluna única
Os exemplos desta seção usam uma fonte de dados chamada ValueTable, que contém estes dados. O último registro na tabela é π/2 radianos ou 90 graus.
| Valor |
|---|
| 0.5 |
| -2 |
| 1,570796... |
| Fórmula | Description | Result |
|---|---|---|
| Cos( ValueTable ) | Retorna 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 ) | Retorna 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 ) | Retorna 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 ) | Retorna 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 ) | Retorna o arco cosseno de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 1,047197..., em branco (), em branco () |
| Acot( ValueTable ) | Retorna o arco cotangente 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 ) | Retorna o arco seno de cada número na tabela. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 0,523598..., em branco (), em branco () |
| Atan( ValueTable ) | Retorna o arco 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 ) | Retorna o número equivalente em graus para cada número na tabela, presumindo que os ângulos estejam em radianos. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 28,647889..., -114,591559..., 90 |
| Radians( ValueTable ) | Retorna o número equivalente em radianos para cada número na tabela, presumindo que os ângulos estejam em graus. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 0,008726..., -0,034906..., 0,027415... |