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

OperadorDescripció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 variableVariable EjemploExplicación
$FX$F1Valor 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_primeroEl valor del subcampo del campo con ID #X.
Esto se aplica a los campos combinados:
Tipo de campo Subcampos
nombre nombre, medio, apellido
correo electrónico primario, secundario
dirección dirección1, dirección2, ciudad, estado, código postal, país
fecha-hora fecha, hora
$FX_n$F1_nEl valor del elección n del campo de casilla de verificación con ID #X.
El valor:
  • false - Opción no marcada.
  • la etiqueta de elección (valor) - Elección marcada.

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_importeEl 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

OperadorDescripción
&&AND lógico
||OR lógico
!Lógica NOT

Operadores condicionales

OperadorDescripció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/UsoDescripció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/UsoDescripció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/UsoDescripció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/UsoDescripció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.