Si la propiedad Format no comienza con un signo de porcentaje (%) y no contiene ningún símbolo (@), el formato será según códigos de formato de número. Este formato espera la Cadena sea un valor de punto flotante. Los especificadores de formato siguientes se admiten en la propiedad Format:
|
El especificador de |
Descripción |
|---|---|
|
Un espacio reservado de dígito ‘0’ |
Si el valor a ser formateado tiene un dígito en la posición donde aparece el '0' en la cadena de formato, entonces, ese dígito se copia a la cadena de salida. De lo contrario, un ‘0’ se almacena en la cadena de salida. |
|
# Marcador de posición de dígito |
Si el valor a ser formateado tiene un dígito en la posición donde aparece el '#' en la cadena de formato, entonces, ese dígito se copia a la cadena de salida. De lo contrario, no se almacena nada en esa posición en la cadena de salida. |
|
. Punto decimal |
El primer caracter '.' en la cadena de formato determina la posición del separador decimal del valor formateado; cualquier caracter adicional '.' se ignora. |
|
, Separador de miles |
Si la cadena de formato contiene uno o más caracteres ',' el resultado tendrá mil separadores insertados entre cada grupo de tres dígitos a la izquierda del punto decimal. La colocación y el número de caracteres ',' en la cadena de formato no afectan la salida, salvo para indicar que se utilizan esos separadores de miles. |
|
E+ Notación científica |
Si algunas de las cadenas "E+', 'E', 'e+', o 'e' están contenida en la cadena de formato, el número está formateado utilizando la notación científica. Un grupo de hasta cuatro caracteres '0' puede seguir inmediatamente la 'E', 'E+-+', 'e', o 'e' para determinar el número mínimo de dígitos del exponente. Los formatos 'E+' y 'e+' causan un signo más den salida para exponentes positivos y un signo menos para den salida a los exponentes negativos. Los formatos 'E-'' o 'e-” sacan un caracter de signo solamente para exponentes negativos. |
|
"Xx"/"xx" |
Los caracteres entre comillas simples o dobles se sacan tal cual, y no afecta el formateo. |
|
; |
Este caracter separa los números positivos, negativos y el cero en la cadena de formato. |
Las ubicaciones del ‘0’ más a la izquierda antes del punto decimal en la cadena de formato y el '0' a la derecha después del punto decimal en la cadena de formato determinan el rango de dígitos que están siempre presentes en la cadena de salida.
El número a ser formateado siempre se redondeará para que tenga tantos decimales como espacios reservados de dígitos ('0' o '#') a la derecha del punto decimal. Si la cadena de formato no contiene ningún punto decimal, el valor formateado se redondea al número entero más cercano.
Si el número a ser formateado tiene más dígitos a la izquierda del separador decimal que hay espacios reservados para dígitos a la izquierda del carácter '.' en la cadena de formato, los dígitos adicionales se sacan antes del espacio reservado de dígito.
Para permitir diferentes formatos para valores positivos, negativos y cero, la cadena de formato puede contener entre una y tres secciones separadas por signos de punto y coma:
- Una sección: La cadena de formato se aplica a todos los valores.
- Dos secciones: la primera sección se aplica a valores positivos y ceros, y la segunda sección se aplica a valores negativos.
- Tres secciones: la primera sección se aplica a valores positivos, la segunda se aplica a valores negativos, y la tercera se aplica a los ceros.
Si la sección para valores negativos o la sección de los valores cero está vacía, es decir, no hay nada entre el punto y coma que delimita la sección, la sección de valores positivos se usa en su lugar.
Si la sección para valores positivos está vacía o si la totalidad de la cadena de formato está vacía, el valor se formatea usando el formateo de punto flotante con 15 dígitos significativos. El formateo de punto flotante general también se utiliza si el valor tiene más de 18 dígitos a la izquierda del punto decimal y la cadena de formato no especifica la notación científica.
En la siguiente tabla lista los ejemplos de los valores que se introducen en la las Propiedades Format y String.
|
Propiedad Format |
Propiedad de cadena: 1234 |
Propiedad de cadena: -1234 |
Propiedad de cadena: 0.5 |
Propiedad de cadena: 0 |
|---|---|---|---|---|
|
0 |
1234 |
-1234 |
0.5 |
0 |
|
0.00 |
1234.00 |
-1234.00 |
0.50 |
0.00 |
|
#.## |
1234 |
-1234 |
0.5 |
|
|
#,##0.00 |
1.234.00 |
-1.234.00 |
0.50 |
0.00 |
|
#,##0.00;(#,##0.00) |
1.234.00 |
(1,234.00) |
0.50 |
0.00 |
|
#,##0.00;;Cero |
1.234.00 |
-1.234.00 |
0.50 |
Cero |
|
0.000E+00 |
0.000E+03 |
-1.234E+03. |
5.000E-01 |
0.000E+00 |
|
#.###E-0 |
1.234E3 |
-1.234E3 |
5E-1 |
0E0 |