🛠️Sintaxis

Descripción general de la sintaxis para componer fórmulas

Las fórmulas se crean en Zinkee mediante un lenguaje propio, similar al de los software de hoja de cálculo. Al crear fórmulas en Zinkee es importante seguir ciertas reglas de sintaxis para asegurar que la fórmula funcione correctamente. A continuación te explico cómo se estructuran las fórmulas:

Nombres de Campos

• Sintaxis: Los nombres de campos deben ir entre corchetes [ ].

• Ejemplo: [Horas Trabajadas], [Precio Hora].

Valores Literales

• Sintaxis: Los valores numéricos se escriben tal cual, mientras que los valores de texto deben ir entre comillas dobles " ".

• Ejemplo: "Cumplido", "No Cumplido", 40, > 4.

Operadores Matemáticos y Lógicos

• Operadores Matemáticos:

  • Suma (+): Para sumar valores o campos.

  • Resta (-): Para restar valores o campos.

  • Multiplicación (*): Para multiplicar valores o campos.

  • División (/): Para dividir valores o campos.

• Operadores Lógicos:

  • Igual (=): Compara si dos valores son iguales.

  • Mayor que (>): Compara si un valor es mayor que otro.

  • Menor que (<): Compara si un valor es menor que otro.

  • Mayor o igual (>=): Compara si un valor es mayor o igual que otro.

  • Menor o igual (<=): Compara si un valor es menor o igual que otro.

  • No es mayor que (!>): Compara si un valor es menor o igual que otro.

  • No es menor que (!<): Compara si un valor es mayor o igual que otro.

  • No es mayor o igual (!>=): Compara si un valor es menor que otro.

  • No es menor o igual (!<=): Compara si un valor es mayor que otro.

  • Diferente (!=): Compara si dos valores son diferentes.

• Ejemplo:

  • Sumar dos campos: ([Horas Trabajadas]) + ([Horas Extras]).

  • Condición lógica: if([Horas Trabajadas] >= 40,"Cumplido","No Cumplido").

Funciones

• Sintaxis: Las funciones predefinidas, como if, sumifs, lookup, entre otras, requieren paréntesis ( ) para encerrar sus argumentos.

• Ejemplo:

  • =if([Horas Trabajadas] >= 40,"Cumplido","No Cumplido")

Fechas

Las expresiones para generar fórmulas admiten distintos formatos de fecha y hora, que permiten también utilizar distintas zonas horarias.

Todas las fechas en Zinkee se guardan en la base de datos en formato UTC aunque siempre se mostrarán por pantalla en el horario local del navegador. Si al configurar una expresión de un campo de tipo fórmula, no se especifica ninguna zona horaria, Zinkee asumirá que está expresada en el huso horario del navegador, transformándola automáticamente a UTC para su almacenamiento. De esta manera los usuarios sólo deben pensar en las fechas en su huso local.

Formato	Ejemplo de uso
2025-06-17	if([fecha] = 2025-06-17, 1, 0)
2025-06-16T22:00:00.000Z	if([fecha] = 2025-06-16T22:00:00.000Z, 1, 0)
2025-06-17T00:00:00.000+02:00	if([fecha] = 2025-06-17T00:00:00.000+02:00, 1, 0)
11/06/2025	if([fecha] = 17/06/2025, 1, 0)

Tipo de resultado de una fórmula

El resultado de una fórmula en Zinkee puede adoptar distintos tipos de datos según el contexto y la configuración que elijas. Esto te permite ajustar el comportamiento y las propiedades del resultado para que se adapte mejor al uso que quieras darle.

• Texto → ideal para mostrar etiquetas, estados o descripciones (por ejemplo: "Aprobado", "Pendiente").

• Número → útil para cálculos, métricas o valores cuantitativos, con posibilidad de definir el formato numérico, porcentaje o duración.

• Fecha → permite obtener resultados basados en operaciones con fechas, como sumar días o calcular diferencias, con las propiedades correspondientes de formato de fecha y hora.

Gracias a esta flexibilidad, puedes usar fórmulas tanto para cálculos analíticos como para generar información descriptiva o temporal, todo dentro del mismo entorno.

Resumen Práctico

Cuando formes una fórmula, sigue estos principios:

1. Utiliza corchetes [ ] para referirte a nombres de campos.

2. Enciérralos valores de texto entre comillas dobles " ".

3. Utiliza operadores como +, -, *, / para cálculos matemáticos y >, <, = para comparaciones lógicas.

4. Enciérralos argumentos de las funciones entre paréntesis ( ).

5. Utiliza las fechas en uno de los siguientes formatos: 2025-06-10 2025-06-10T22:00:00.000Z 2025-06-10T22:00:00.000+02:00 11/06/2025

Con estas reglas básicas, podrás crear fórmulas que sean claras, precisas, y funcionales en el contexto de hojas de cálculo o software de gestión.