Diferencia entre revisiones de «Funciones de librería»

Revisión del 13:45 8 abr 2009

Conversión de tipos

$Texto(E: expresión): <code>texto</code>

• Descripción

  Convierte el resultado de una expresión a formato texto. El resultado de la expresión debe ser compatible con el tipo texto.

• Ejemplo

$Texto([Datos generales].[Nº de registro])

$Entero(E: expresión): <code>entero</code>

• Descripción

  Convierte el resultado de una expresión en un entero. El resultado de la expresión debe ser compatible con el tipo entero.

• Ejemplo

$Entero([&Dominio]->[Datos genereales].[Importe])

$Real(E: expresión): <code>real</code>

• Descripción

  Convierte el resultado de una expresión a número real. El resultado de la expresión debe ser compatible con el tipo real.

• Ejemplo

$Real(<code>"12,34")</code>

$Logico(E: expresión): <code>lógico</code>

• Descripción

  Convierte el resultado de una expresión a tipo lógico. El resultado de la expresión debe ser compatible con el campo lógico. Si la expresión devuelve verdadero, se activará el campo lógico; si retorna falso, la casilla del campo lógica permanecerá desactivada.

• Ejemplo

$Logico([Municipio]=<code>"Madrid")</code>

Indicadores de tipo

Indica el tipo del resultado de una expresión. El resultado de la expresión a de corresponder con el tipo a convertir. Muy útil cuando la expresión no es evaluada, por ejemplo por el acceso al dominio.

$Tabla(E: expresión): tabla

$Lista(E: expresión): lista_comprobacion

$Vinculo(E: expresión): vinculo

$Coleccion(E: expresión): coleccion

Tratamiento de textos

$CopiarTexto(T: <code>texto, Inicio: entero, Longitud: entero): texto</code>

• Descripción

  Devuelve una subristra de la ristra pasada como parámetro, indicando la posición de comienzo y el número de caracteres a devolver.

• Ejemplos

$CopiarTexto(<code>"Expediente de control",15,7) //devuelve la ristra "control"</code>

$CopiarTexto([Nombre],1,1) <code>//devuelve la inicial del nombre</code>

$LongitudTexto(T: <code>texto): entero</code>

• Descripción

  Devuelve el número de caracteres de un texto.

• Ejemplo

$LongitudTexto(<code>"Expediente de control") //devuelve 21</code>

Tratamiento de números

$Entero(E: expresión): <code>entero</code>

• Descripción

  Devuelve el resultado de una expresión convertido a su estado numérico. En este caso, un entero. Para ello, la expresión debe devolver un entero en formato texto.

• Ejemplo

$Entero([D.N.I.]) <code>//devuelve 45678123</code>

$Real(E: expresión): <code>real</code>

• Descripción

  Devuelve el resultado de una expresión convertido a su estado numérico. En este caso, un real. Para ello, la expresión debe devolver un real en formato texto.

• Ejemplo

$Real(<code>"1.400,23") //devuelve 1.400,23</code>

$ParteEntera(N: <code>real): entero</code>

• Descripción

  Devuelve el truncamiento de la parte entera de un real.

• Ejemplo

$ParteEntera($Real(<code>"22,64")) //devuelve 22</code>

$ParteEntera(N: <code>real): entero</code>

• Descripción

  Devuelve el truncamiento de la parte entera de un real.

• Ejemplo

$ParteEntera($Real(<code>"22,64")) //devuelve 22</code>

$ParteDecimal(N: <code>real): real</code>

• Descripción

  Devuelve la parte decimal de un real.

• Ejemplo

$ParteDecimal($Real(<code>"22,64")) //devuelve 0,64</code>

$Redondeo(N: <code>real): entero</code>

• Descripción

  Redondea un número real, devolviendo un entero.

• Ejemplos

$Redondeo($Real(<code>"22,5")) //devuelve 22</code>

$Redondeo($Real(<code>"5,6")) //devuelve 6</code>

$EsPar(N: <code>entero): lógico</code>

• Descripción

  Devuelve verdadero si el entero es par, falso en caso contrario.

• Ejemplo

$EsPar($Entero(<code>"3")) //devuelve falso</code>

$Max(Valor1: <code>real, Valor2: real {, V: real}): real</code>

• Descripción

  Devuelve el mayor número de los pasados por paráemtro.

• Ejemplo

$Max($Real(<code>"20,14"),$Real("7,56"),$Entero("2")) //devuelve 20,14</code>

$Min(Valor1: <code>real, Valor2: real {, V: real}): real</code>

• Descripción

  Devuelve el menor número de los pasados por parámetro.

• Ejemplo

$Min($Real(<code>"20,14"),$Real("7,56"),$Entero("2")) //devuelve 2,00</code>

Tratamiento de horas y fechas

$Fecha(E: expresión): <code>fecha</code>

• Descripción

  Convierte el resultado de una expresión a tipo fecha. El resultado de la expresión debe ser compatible con el campo fecha. El formato a seguir debe ser el siguiente dd/mm/aaaa. Si se dan los formatos dd/mm o dd se rellena con la fecha del sistema.

• Ejemplos

$Fecha(<code>"23/04/2003") //devuelve 23/04/2003</code>

$Fecha(<code>"5/7/04") //devuelve 05/07/2004</code>

$Fecha(<code>"23/4") //devuelve 23/04/2005</code>

$Fecha(<code>"15") //devuelve 15/01/2005</code>

$Hoy: <code>fecha</code>

• Descripción

  Devuelve la fecha del sistema.

• Ejemplo

$Hoy <code>//devuelve 13/04/2005 por ejemplo</code>

$Año(F: <code>fecha): entero</code>

• Descripción

  Devuelve el año de una fecha dada.

• Ejemplo

$Año($Fecha(<code>"13/04/2002")) //devuelve 2002</code>

$Mes(F: <code>fecha): entero</code>

• Descripción

  Devuelve el mes de una fecha dada.

• Ejemplo

$Mes($Fecha(<code>"13/04/2002")) //devuelve 4</code>

$Dia(F: <code>fecha): entero</code>

• Descripción

  Devuelve el día del mes de una fecha dada.

• Ejemplo

$Dia($Fecha(<code>"13/04/2002")) //devuelve 13</code>

$DiferenciaFechas(Fin: <code>fecha, Inicio: fecha): texto</code>

• Descripción

  Calcula la diferencia entre dos fechas dadas en días, meses y años. La fecha Fin debe ser estrictamente mayor que la fecha Inicio para que la función pueda devolver un valor.

• Ejemplos

$DiferenciaFechas($Fecha(<code>"20/04/2002"), $Fecha("13/04/2002")) //devuelve "7 días"</code>

$DiferenciaFechas($Fecha(<code>"20/05/2003"), $Fecha("13/11/2002")) //devuelve "6 meses y 7 días"</code>

$DiferenciaFechas($Fecha(<code>"30/08/2007"), $Fecha("13/04/2002")) //devuelve "5 años, 4 meses y 17 días"</code>

$DiferenciaDias(Fin: <code>fecha, Inicio: fecha): entero</code>

• Descripción

  Calcula la diferencia en días de dos fechas dadas. La fecha Fin ha de ser estrictamente mayor que la fecha Inicio. Se devolverá un valor entero.

• Ejemplo

$DiferenciaDias($Fecha(<code>"20/04/2002"),$Fecha("13/04/2002")) //devuelve 7</code>

$CalculaFecha(Inicio: <code>fecha, NDias: entero, Hábil: lógico): fecha</code>

• Descripción

  Calcula una fecha a partir de una fecha inicio que introducimos como parámetro de entrada, indicando el número de días a contar y si éstos deben ser días hábiles (verdadero) o naturales (falso). El valor devuelvo será un valor tipo fecha con la nueva fecha calculada.

• Ejemplos

$CalculaFecha($Fecha(<code>"19/04/2002"),2,verdadero) //devuelve 23/04/2002</code>

$CalculaFecha($Fecha(<code>"21/04/2002"),2,verdadero) //devuelve 23/04/2002</code>

$CalculaFecha($Fecha(<code>"20/04/2002"),2,falso) //devuelve 22/04/2002</code>

Manejo de listas de comprobación

$Lista(E: expresión): <code>lista_comprobacion</code>

• Descripción

  Indica que el resultado de una expresión es una lista de comprobación. Muy útil cuando la expresión no es evaluada, por ejemplo por el acceso al dominio.

• Ejemplo

$Lista([&Dominio]->[Revisión].[Documentación a requerir])

$InvertirSeleccion(L: <code>lista_comprobacion): lista_comprobacion</code>

$InvertirSeleccion(M: <code>matriz): matriz</code>

</code>

• Descripción

  Cambia el valor de selección de todas las filas de una lista de comprobación. En realidad de cualquier matriz de dos columnas: «descripción» y «seleccionado», en ese orden.

• Ejemplo

$Lista([&Dominio]->[Revisión].[Documentación a requerir])