Este documento le ayudará a crear fórmulas en el complemento WPForms Calculations. Para información adicional y ayuda en la creación de fórmulas, por favor vea nuestra documentación del complemento de Cálculos.
Reglas
- Números: El punto (.) es el único símbolo permitido como punto decimal (por ejemplo, 5,20). No utilice la coma (,) para los millares. (ejemplo: 12999.45)
- Las cadenas deben ir entre comillas (') o comillas dobles ("). Ejemplos: '¡Hola, mundo!', "Me llamo Sullie".
- Añadir un punto y coma al final de la línea de la fórmula es opcional.
- Sólo se permiten los operadores, variables, sentencias condicionales y funciones que se enumeran a continuación.
Aritmética
Operador | Descripción |
---|---|
+ | Añadir |
- | Resta |
* | Multiplique |
/ | Divide |
( ) | Paréntesis; encierre primero las partes de la fórmula que deben calcularse |
% | Modulo; devuelve el resto de una división |
Variables de campo
Utilice valores de otros campos en sus cálculos.
Tipos de campo admitidos: Single Line Text
, Paragraph Text
, Dropdown
, Multiple Choice
, Checkboxes
, Number
, Name
, Email
, Number Slider
, Phone
, Address
, Date / Time
, Website / URL
, Rating
, Hidden
, Checkbox Items
, Multiple Items
, Dropdown Items
, Single Item
, Total
Patrón variable | Variable Ejemplo | 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 [first last] "John Smith". Tenga en cuenta: el valor combinado almacenado en $FX tiene el mismo formato que el valor principal del campo de entrada 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 del elección n del campo de casilla de verificación con ID #X. El valor:
Esto sólo se aplica al campo Casillas de verificación y al campo Elementos de casilla de verificación de pago. Si las Opciones Dinámicas están activadas, las variables de elección no estarán disponibles. | ||||||||||
$Importe_FX | $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 pueden utilizarse en los cálculos: payment-checkbox , payment-multiple , payment-select , payment-single , payment-total |
Declaraciones condicionales
Utilice sentencias condicionales para especificar diferentes fórmulas que se utilizarán cuando se cumplan determinadas condiciones.
si/no
si ( $F1 > 10 ):
$F1 * 50
si no
0
endif;
if/elseif/else
if ( $F1 < 5.2 ):
$F1 * 50
elseif ( $F1 >= 16 ):
F1 * 25
else:
0
endif;
Consejo
Puede utilizar tantos elseif
en caso necesario.
Operadores lógicos
Operador | Descripción |
---|---|
&& | AND lógico |
|| | OR lógico |
! | Lógica NOT |
Operadores condicionales
Operador | Descripción |
---|---|
== | Igual a |
!= | No es igual a |
> | Mayor que |
< | Menos de |
>= | Mayor o igual que |
<= | Inferior o igual a |
Funciones
Funciones matemáticas
Función/Uso | Descripción |
---|---|
abs( valor ) | Devuelve el valor absoluto de un número |
promedio( valor1, [valor2, ...] ) | Devuelve el valor medio en args |
ceil( valor ) | Redondea el número al entero inmediatamente superior |
exp ( valor ) | Devuelve e^x, donde e son los números de Euler y x es el argumento proporcionado |
floor( valor ) | Devuelve el mayor número entero 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 mayor valor 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 próximo |
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 indica la precisión, el valor resultante se redondeará al número de dígitos indicado después del punto decimal. |
recortar( cadena ) | Elimina los espacios en blanco (u otros caracteres) del principio y el final de la cadena. |
truncar( cadena, longitud ) | Devuelve el primer length caracteres de la cadena |
concat( cadena1, [cadena2, ...] ) | Concatena todos los argumentos str1, str2 ... strN en una cadena |
join( separador, cadena1, [cadena2, ...] ) | Une los argumentos str1, str2 ... strN en una cadena utilizando el separador |
format_amount( importe ) | Formatear el importe con un símbolo de moneda |
Funciones de fecha y hora
Función/Uso | Descripción |
---|---|
now( formato = ' ' ) | Devuelve la fecha y hora actuales. La dirección format es el formato de la cadena datetime de WPForms. Una cadena vacía (valor por defecto) significa formato por defecto: d-m-y H:i . |
diferencia_fechas( inicio, fin, unidades = 'días', formato = ' ' ) | Calcula la longitud del intervalo de tiempo en unidades. Unidades: years , months , weeks , days , hours , minutes , seconds . En format es el formato de la cadena datetime de WPForms. Una cadena vacía significa que intentaremos determinar el formato correcto automáticamente. |
years( inicio, fin, formato = ' ' ) | Calcular la duración del intervalo de tiempo en años. En format es el formato de la cadena datetime de WPForms. Una cadena vacía significa que intentaremos determinar el formato correcto automáticamente. |
funciones meses(), semanas(), días(), horas(), minutos(), segundos() | Calcular la longitud del intervalo de tiempo. Similar a years() arriba. |
Otras funciones
Función/Uso | Descripción |
---|---|
debug( valor1, [valor2, ... ] ) | Envía datos de depuración al registro de depuración del servidor y a la consola del navegador cuando se ejecuta en el lado del cliente. |