Este documento te ayudará a crear fórmulas en el complemento Cálculos de WPForms. Para obtener información adicional y ayuda para crear fórmulas, consulta nuestra documentación del complemento Cálculos.
Reglas
- Números: El punto (.) es el único símbolo permitido como separador decimal (ej. 5.20). No uses coma (,) para los miles. (ej. 12999.45)
- Las cadenas deben ir entre comillas simples (') o dobles ("). Ejemplos: 'Hola, mundo!', "Mi nombre es Sullie".
- Añadir un punto y coma al final de la línea de la fórmula es opcional.
- Solo se permiten los operadores, variables, declaraciones condicionales y funciones que se enumeran a continuación.
Aritmética
| Operador | Descripción |
|---|---|
| + | Sumar |
| – | Restar |
| * | Multiplicar |
| / | Dividir |
| ( ) | Paréntesis; encierra partes de la fórmula que se calcularán primero |
| % | Módulo; devuelve el resto de una división |
Variables de campo
Usa valores de otros campos en tus cálculos.
Tipos de campo admitidos: Texto de una sola línea, Texto de párrafo, Menú desplegable, Opciones múltiples, Casillas de verificación, Número, Nombre, Correo electrónico, Control deslizante numérico, Teléfono, Dirección, Fecha / Hora, Sitio web / URL, Valoración, Oculto, Elementos de casilla de verificación, Elementos múltiples, Elementos de menú desplegable, Elemento único, Total
| Patrón de variable | Ejemplo de variable | Explicación | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $FX | $F1 | Valor del campo con ID #X (#1). Todos los campos permitidos proporcionan el valor principal del campo. Un campo simple proporciona el valor del elemento de entrada. Los campos combinados, como Nombre (pero no uno simple), Dirección, Casillas de verificación, etc., tendrán el valor combinado. Por ejemplo, el campo Nombre, su valor combinado es [nombre apellido] “John Smith”. Tenga en cuenta: el valor combinado almacenado en $FX tiene el mismo formato que el valor de entrada del campo principal visible en la página Vista de entrada. | ||||||||||
| $FX_subcampo | $F1_primero | El valor del subcampo del campo con ID #X. Esto se aplica a los campos combinados:
| ||||||||||
| $FX_n | $F1_n | El valor de la opción n del campo de casillas de verificación con ID #X. El valor:
Esto se aplica solo al campo Casillas de verificación y al campo Artículos de pago de casillas de verificación. Si las Opciones dinámicas están habilitadas, las variables de opción no estarán disponibles. | ||||||||||
| $FX_importe | $F12_importe | El valor del importe del campo de pago con ID #X. Siempre un número, como 9.99. Esto se aplica a todos los campos de pago que se pueden usar en cálculos: payment-checkbox, payment-multiple, payment-select, payment-single, payment-total |
Declaraciones condicionales
Utilice declaraciones condicionales para especificar diferentes fórmulas que se utilizarán cuando se cumplan ciertas condiciones.
si/sino
if ( $F1 > 10 ):
$F1 * 50
else:
0
endif;
si/sino si/sino
if ( $F1 < 5.2 ):
$F1 * 50
elseif ( $F1 >= 16 ):
F1 * 25
else:
0
endif;
Consejo
Puede utilizar tantas declaraciones elseif como sea necesario.
Operadores lógicos
| Operador | Descripción |
|---|---|
| && | Y lógico |
| || | O lógico |
| ! | NO lógico |
Operadores condicionales
| Operador | Descripción |
|---|---|
| == | Igual a |
| != | Distinto de |
| > | Mayor que |
| < | Menor que |
| >= | Mayor o igual que |
| <= | Menor o igual que |
Funciones
Funciones matemáticas
| Función/Uso | Descripción |
|---|---|
| abs( valor ) | Devuelve el valor absoluto de un número |
| average( valor1, [valor2, …] ) | Devuelve el valor promedio de los argumentos |
| ceil( valor ) | Redondea un número hacia arriba al entero más próximo |
| exp ( valor ) | Devuelve e^x, donde e es el número de Euler y x es el argumento proporcionado |
| floor( valor ) | Devuelve el entero más grande menor o igual que un número |
| ln( valor ) | Devuelve el logaritmo de un número, base e |
| log( valor ) | Devuelve el logaritmo de un número, base 10 |
| max( valor1, [valor2, …] ) | Devuelve el valor más grande de la lista de argumentos |
| min( valor1, [valor2, …] ) | Devuelve el valor más pequeño de la lista de argumentos |
| pi() | Devuelve pi (π) con 20 decimales |
| pow( base, exponente ) | Devuelve la base elevada a la potencia del exponente |
| rand( min, max ) | Genera un número entero aleatorio |
| round( valor, precisión ) | Redondea un número al entero más cercano |
| sqrt( valor ) | Devuelve la raíz cuadrada de un número |
Funciones de cadena
| Función/Uso | Descripción |
|---|---|
| num( cadena, precisión = 14 ) | Convierte una cadena en un número.
Si se proporciona la precisión, el valor resultante se redondeará al número dado de dígitos después del punto decimal. |
| trim( cadena ) | Elimina espacios en blanco (u otros caracteres) del principio y del final de la cadena |
| truncate( cadena, longitud ) | Devuelve los primeros longitud caracteres de la cadena |
| concat( cad1, [cad2, …] ) | Concatena todos los argumentos cad1, cad2 … cadN en una sola cadena |
| join( separador, cad1, [cad2, …] ) | Une los argumentos cad1, cad2 … cadN en una sola cadena usando el separador |
| format_amount( importe ) | Formatea el importe con un símbolo de moneda |
Funciones de fecha/hora
| Función/Uso | Descripción |
|---|---|
| now( formato = ‘ ‘ ) | Devuelve la fecha y hora actuales. El formato es el formato de cadena de fecha y hora de WPForms. Una cadena vacía (valor predeterminado) significa el formato predeterminado: d-m-y H:i. |
| date_diff( inicio, fin, unidades = ‘dias’, formato = ‘ ‘ ) | Calcula la duración del intervalo de tiempo en unidades. Unidades: años, meses, semanas, días, horas, minutos, segundos. El formato es el formato de cadena de fecha y hora de WPForms. Una cadena vacía significa que intentaremos determinar el formato correcto automáticamente. |
| años( inicio, fin, formato = ‘ ‘ ) | Calcula la duración del intervalo de tiempo en años. El formato es el formato de cadena de fecha y hora de WPForms. Una cadena vacía significa que intentaremos determinar el formato correcto automáticamente. |
| funciones meses(), semanas(), días(), horas(), minutos(), segundos() | Calcula la duración del intervalo de tiempo. Similar a años() anterior. |
Otras funciones
| Función/Uso | Descripción |
|---|---|
| depurar( valor1, [valor2, … ] ) | Muestra datos de depuración en el registro de depuración del servidor y en la consola del navegador cuando se ejecuta en el lado del cliente. |