Funciones de campo

Contenido

calcDynamicFormula() decimales() formatValue() getDiskLen() getID() getName() isAlpha() isEmpty() isFormula() isImage() isModified() isNumber() isObject() isRichText() isSigned() maxValue() minValue()

Funciones de campo

Se trata de funciones que nos permiten conocer propiedades de un campo y aplicar un formato a su valor. Estas funciones podremos usarlas cuando insertamos un campo en una asistente para edición de fórmulas. Éstas habrá que escribirlas directamente en la fórmula, dado que en el asistente no existe un repositorio para este tipo de funciones.

Estas fórmulas siempre tendrán el mismo formato:

#CAMPO:Funcion()

El asistente de fórmulas es sensible a la diferencia entre mayúsculas y minúsculas, por tanto, debemos asegurarnos de escribir el nombre de las funciones tal y como se indica en la ayuda.

calcDynamicFormula()

Sintaxis

#CAMPO:calcDynamicFormula()

Permite calcular la fórmula declarada en un campo de tipo fórmula dinámica.

Esta función solamente puede ser usada sobre campos de la tabla en curso, no siendo posible, por tanto, usarla sobre campos de tablas enlazadas

decimales()

Sintaxis

#CAMPO:decimales()

Aplicada a un campo numérico, devuelve el número de decimales del campo.

formatValue()

Sintaxis

#CAMPO:formatValue(subcadenaFormato)

Devuelve el campo formateado según la subcadena de formato indicada.

Las subcadenas de formato disponibles según el tipo de campo son:

Subcadenas de formato para campos alfabéticos

Número: Permite recortar el campo al número de caracteres especificado.

Ejemplo: #NAME:formatValue(2): Nos devolverá los tres primeros caracteres del campo NAME.

Subcadenas de formato para campos numéricos

f ([-]9.9) e ([-]9.9e[+|-]999) E ([-]9.9E[+|-]999) g (Formato más conciso entre e ó f) G (Formato más conciso entre E ó f) L (Formato decimal con ajustes locales): Aplica la configuración local (separador decimal, separador de miles, mostrar/ocultar ceros a la izquierda) del sistema en el que es visualizado el dato.

Subcadenas de formato para campos fecha

Día

d: (1-31)

dd: (01-31)

ddd: (Lun-Dom)

dddd: (Lunes-Domingo)

Mes

M: (1-12)

MM: (01-12)

MMM: (Ene-Dic)

MMMM: (Enero-Diciembre)

Año

yy: (00-99)

yyyy: (0000-9999)

Subcadenas de formato para campos hora

Horas

h: (0-23, 1-12 AM/PM)

hh: (00-23, 01-12 AM/PM)

H: (0-23)

HH: (00-23)

Minutos

m: (0-59)

mm: (00-59)

Segundos

s: (0-59)

ss: (00-59)

z: (0-999) zzz (000-999)

Periodos

AP: (AM/PM)

ap: (am/pm)

getDiskLen()

Sintaxis

#CAMPO:getDiskLen()

Devuelve la longitud en disco del campo.

getID()

Sintaxis

#CAMPO:getID()

Devuelve el identificador del campo.

getName()

Sintaxis

#CAMPO:getName( “[Idioma-país]” )

Devuelve el valor de la propiedad nombre del campo, según el idioma y país especificados en el parámetro.

Si se deja vacío, devolverá el nombre en el idioma/país actual.

El Idioma y el país se identificarán con una cadena de dos caracteres, la primera en minúsculas y la segunda en mayúsculas, separadas por un guión.

Idioma: Se identifica con una cadena de dos dígitos, en minúsculas, según la norma ISO 639-1.

País: Se identifica con una cadena de dos dígitos, en mayúsculas, según la norma ISO 3166-1:

Ejemplo

#NAME:getName(“es-ES”)

isAlpha()

Sintaxis

#CAMPO:isAlpha()

Devuelve 1 si el campo es alfabético y y 0 si no lo es.

isEmpty()

Sintaxis

#CAMPO:isEmpty()

Devuelve true (1) si el campo está vacío y 0 si no lo está.

Nota

Si el campo es numérico devolverá true si el contenido de éste es 0.

isFormula()

Sintaxis

#CAMPO:isFormula()

Devuelve 1 si el campo es de tipo fórmula y 0 si no lo es.

isImage()

Sintaxis

#CAMPO:isImage()

Devuelve 1 si el campo es de tipo objeto dibujo y 0 si no lo es.

isModified()

Sintaxis

#CAMPO:isModified()

Devuelve 1 si el campo ha sido modificado y 0 si no lo ha sido.

isNumber()

Sintaxis

#CAMPO:isNumber()

Devuelve 1 si el campo es numérico y 0 si no lo es.

isObject()

Sintaxis

#CAMPO:isObject()

Devuelve 1 si el campo es de tipo objeto texto y 0 si no lo es.

isRichText()

Sintaxis

#CAMPO:isRichText()

Devuelve 1 si el campo es de tipo objeto texto enriquecido y 0 si no lo es.

isSigned()

Sintaxis

#CAMPO:isSigned()

Aplicada a un campo numérico, devuelve 1 si el campo tiene signo y 0 si no tiene.

maxValue()

Sintaxis

#CAMPO:maxValue()

Aplicada a un campo numérico, devuelve el rango máximo del mismo.

minValue()

Sintaxis

#CAMPO:minValue()

Aplicada a un campo numérico, devuelve el rango mínimo del mismo.