Función FORMATEX

Devuelve el resultado de la expresión evaluada en srcUnit como una cadena con formato según el formato expresado en dstUnit.

Sintaxis

FORMATEX(expression," format ",[ srcUnit ],[ dstUnit ],[ langID ][, calID ])

Parameters

Name Necesario/Opcional Tipo de datos Descripción
expresión
Obligatorio
 String
Combinación de constantes, operadores, funciones y referencias a celdas de ShapeSheet que da como resultado un valor.
format
Obligatorio
 String
Imagen de formato usada para dar formato a la cadena. Para obtener más información sobre las imágenes de formato, vea Acerca de las imágenes de formato.
srcUnit
Opcional
 String
Unidades usadas para evaluar expresión (pda, cm, etc.).
dstUnit
Opcional
 String
Unidades usadas para el resultado de expresión (pda, cm, etc.).
langID
Opcional
 Number
El idioma utilizado para dar formato a las imágenes de fecha y hora de Microsoft Office System.
calID
Opcional
 Number
El calendario usado para dar formato a las imágenes de fecha y hora de Microsoft Office System.

Valor devuelto

Cadena

Comentarios

El tipo de la expresión y el especificado en el formato de imagen controlan el comportamiento de la cadena devuelta. El valor de formato debe ser adecuado para el tipo de expresión.

El argumento unidadesDeOrigen se utiliza para dar la escala adecuada a los resultados de la expresión que carecen de tipo, por ejemplo 3 + 4. Si el resultado de expresión tiene un tipo explícito, como 3 m + 8 m, no se tiene en cuenta el valor de unidadesDeOrigen.

El argumento unidadesDeDestino se utiliza para especificar las unidades que se usan en el resultado con formato. Si no se especifican las unidadesDeDestino, se utilizan las unidades del resultado de la expresión.

Devuelve un error si el resultado de la expresión y el tipo esperado en formato son distintos, si hay errores de sintaxis en formato o si no se reconocen las unidades especificadas como unidadesDeOrigen o unidadesDeDestino.

Ejemplo

FORMATEX(5,5; "0,00 u", "cm", "ft")

Devuelve 0,18 pies.

  • Last updated on