FORMULA LANGUAGE


@Text
Ejemplo

Convierte cualquier valor en una cadena de texto.

Sintaxis

@Text( valor ; cadena-con-formato )

Parámetros

valor


Nota La conversión de texto enriquecido es una novedad de la Versión 6.

cadena-con-formato


Resultado

texto


@Text con componentes de fecha-hora

Existen cuatro categorías diferentes de componentes de cadenas con formato de fecha-hora. Podrá incluir hasta cuatro componentes, pero sólo uno por cada categoría.
SímboloSignificado
D0Mes, día y año
D1Mes y día; año si no es el actual
D2Mes y día
D3Mes y año
T0Hora, minuto y segundo
T1Hora y minuto
Z0Siempre cambia la hora a esta zona
Z1Muestra la zona sólo cuando no es esta zona
Z2Siempre muestra la zona
S0Fecha
S1Hora
S2Fecha y hora
S3Fecha, hora, hoy o ayer
Sx Úselo cuando no pueda predecir el formato exacto del valor, pero sabe que puede ser una hora, una fecha o ambas.

@Text con valores numéricos

Para determinar valores numéricos, componga una cadena con formato combinando cualquiera de los siguientes componentes dentro de una cadena.
SímboloSignificado
GGeneral (sólo los dígitos significativos)
FFijo (determine el número de decimales)
SCientífico (formato potencial)
CMonetario (dos decimales)
,Puntuación en los miles (formato EE.UU.)
%Porcentaje
()Paréntesis en números negativos
númeroNúmero de dígitos de precisión

Uso

Una vez que un valor numérico se convierte en texto, no podrá utilizar el número para cálculos aritméticos.

La conversión de texto enriquecido no conserva los anexos ni las opciones de formato, excepto los tabuladores y los espacios. Cuando se convierte texto enriquecido en un documento, éste debe guardarse antes de que la conversión sea visible.

La conversión de texto enriquecido no funciona en fórmulas de columna. Utilice @Abstract para convertir el contenido de un campo de texto enriquecido en texto sin formato. A continuación, cree una referencia al campo de texto sin formato en la vista. Por ejemplo, si agrega el siguiente código a un campo calculado oculto denominado txtSinFormato, puede definir el valor predeterminado de la columna de la vista como "txtSinFormato" para mostrar el contenido de campoRTF:

@Abstract([TextOnly];15360;"";"campoRTF")

Tenga cuidado al usar @Text para convertir números o fechas de una columna. En las bases de datos situadas en un servidor, los números y fechas siempre se ven con los parámetros de formato del sistema operativo del servidor. Además, si los parámetros de formato de fechas y números del cliente que accede a la base de datos o del servidor que la alberga cambian, tendrá que reconstruir la vista completamente.

Equivalencias en otros lenguajes

Función CStr del lenguaje LotusScript

Método GetFormattedText de la clase NotesRichTextItem de LotusScript

Método getFormattedText de la clase RichTextItem de Java

Ejemplo
Véase también