Formatos numéricos definidos por el usuario (Función Format)

Actualización: noviembre 2007

La siguiente tabla identifica caracteres que puede usar para crear formatos de número definidos por el usuario. Éstos pueden usarse para generar el argumento Style correspondiente a la función Format:

Carácter

Descripción

Ninguna

Muestra el número sin formato alguno.

(0)

Marcador de posición de dígito. Muestra un dígito o un cero. Si la expresión tiene un dígito en la posición donde aparece el cero en la cadena de formato, éste se mostrará así; de lo contrario, aparecerá un cero en esa posición.

Si el número tiene menos dígitos que ceros (a cualquier lado del separador decimal) en la expresión de formato, se mostrarán ceros iniciales o finales. Si el número tiene más dígitos a la derecha del separador decimal que ceros en la expresión de formato, se redondeará el número a tantos decimales como ceros haya. Si el número tiene más dígitos a la derecha del separador decimal que ceros en la expresión de formato, se redondeará el número a tantos decimales como ceros haya.

(#)

Marcador de posición de dígito. Muestra un dígito o nada. Si la expresión tiene un dígito en la posición donde aparece el carácter # en la cadena de formato, se muestra; de lo contrario, no aparece nada en esa posición.

Este símbolo funciona como el marcador de posición de dígito 0, salvo que los ceros iniciales y finales no se mostrarán si el número contiene menos dígitos que caracteres # a cualquiera de los lados del separador decimal en la expresión de formato.

(.)

Marcador de posición decimal. El marcador de posición decimal determina cuántos dígitos se mostrarán a la izquierda y derecha del separador decimal. Si la expresión de formato sólo contiene caracteres # a la izquierda de este símbolo, los números inferiores a 1 empezarán con un separador decimal. Par mostrar un cero inicial con números fraccionarios, use el cero como el primer marcador de posición digital a la izquierda del separador decimal. El uso del punto o la coma como separador decimal depende de la configuración regional en cada caso. El mismo carácter utilizado como marcador decimal en virtud del formato de salida dependerá del formato de número reconocido por su sistema. Por tanto, deberá usar el punto como marcador decimal en sus formatos, incluso aunque su configuración regional utilice la coma como separador decimal. La cadena con formato se mostrará con el formato correcto para la configuración regional correspondiente.

(%)

Marcador de posición de porcentaje. Multiplica la expresión por 100. El carácter de porcentaje (%) se inserta en la misma posición en la que aparece en la cadena de formato.

(,)

Separador de miles. El separador de miles separa las unidades de millar de las centenas con un número que presente cuatro o más dígitos a la izquierda del separador decimal. Se especificará un uso estándar del separador de miles si el formato contiene un separador de miles rodeado de marcadores de posición de dígito (0 o #).

Un separador de miles situado inmediatamente a la izquierda del separador decimal (se especificará si se trata de un decimal o no) o como el carácter más a la derecha de la cadena significa "reducir el número dividiéndolo por 1000 y redondeándolo en caso necesario". Los números menores que 1,000 pero mayores o iguales que 500 se muestran como 1; los números menores que 500 se muestran como 0. Dos separadores de miles adyacentes en esta posición se reducen por un factor de 1 millón, más otro factor adicional de 1000 por cada separador adicional.

En el caso de los separadores múltiples en cualquier posición que no sea inmediatamente a la izquierda del separador decimal o la posición más a la derecha de la cadena, se interpretará que simplemente especifican el uso de un separador de miles. El uso del punto o la coma como separador de miles depende de la configuración regional en cada caso. El mismo carácter utilizado como separador de miles en virtud del formato de salida dependerá del formato de número reconocido por su sistema. Por tanto, deberá usar la coma como marcador de miles en sus formatos, incluso aunque su configuración regional utilice el punto como marcador de miles. La cadena con formato se mostrará con el formato correcto para la configuración regional correspondiente.

Por ejemplo, considere las tres cadenas de formato siguientes:

  • "#,0.", que utiliza el separador de miles para dar formato al número 100 millones como la cadena "100,000,000".

  • "#0,.", que ajusta la escala en un factor de mil para dar formato al número 100 millones como la cadena "100000".

  • "#,0,.", que utiliza el separador de miles y el ajuste de la escala en un factor de mil para dar formato al número 100 millones como la cadena "100,000".

(:)

Separador de hora. En ciertas configuraciones regionales, pueden usarse otros caracteres para representar el separador de hora. Este separador horario separa horas, minutos y segundos cuando se da formato a valores horarios. El carácter real utilizado es el especificado como separador de hora en la configuración de su sistema.

(/)

Separador de fecha. En ciertas configuraciones regionales, pueden usarse otros caracteres para representar el separador de fecha. Este separador separa el día, mes y año cuando se da formato a los valores de fecha. El carácter real utilizado es el especificado como separador de fecha en la configuración de su sistema.

(E-E+e-e+)

Formato científico. Si la expresión de formato contiene al menos un marcador de posición de dígito (0 o #) a la izquierda de E-, E+, e- o e+, el número se muestra en formato científico, y se inserta E o e entre el número y su exponente. El número de marcadores de posición digitales a la izquierda determina el número de dígitos en el exponente. Use E- o e- para colocar un signo menos junto a los exponentes negativos. Utilice E+ o e+ para colocar un signo menos junto a los exponentes negativos y un signo más junto a los positivos. También deberá incluir marcadores de posición digitales a la derecha de este símbolo para obtener un formato correcto.

-+$ ( )

Caracteres literales. Estos caracteres se mostrarán exactamente como se escriben en la cadena de formato. Para mostrar un carácter distinto de los listados, se hace preceder de una barra invertida (\) o se escribe entre comillas (" ").

(\)

Muestra el siguiente carácter de una cadena de formato. Para mostrar un carácter dotado de un significado especial como carácter literal, éste debe ir precedido de una barra invertida (\). La barra invertida en sí no aparecerá. El uso de una barra invertida equivale a incluir el siguiente carácter entre comillas. Para mostrar una barra invertida, se utilizan dos (\\).

Ejemplos de caracteres que no se pueden mostrar cuando los caracteres literales son caracteres de formato de fecha y de formato de hora (a, c, d, h, m, n, p, q, s, t, w, y, / y :), caracteres de formato numérico (#, 0, %, E, e, coma y punto) y caracteres de formato de cadenas (@, &, <, > y !).

("ABC")

Muestra la cadena entre comillas (" "). Si se desea insertar una cadena en el argumento de estilo desde el código, debe usar Chr(34) para incluir el texto (34 es el código de caracteres correspondiente a las comillas dobles (")).

Ejemplo

La tabla siguiente contiene algunas muestras de expresiones de formato correspondientes a números. En estos ejemplos se presupone que la configuración regional del sistema es Inglés (Estados Unidos). La primera columna contiene las cadenas de formato correspondientes al argumento Style de la función Format; las otras columnas contienen el formato de salida resultante si los datos con formato contienen el valor asignado en los encabezados de columna.

Formato (Style)

"5" con formato como

"-5" con formato como

"0.5" con formato como

Zero-length string ("")

5

-5

0.5

0

5

-5

1

0.00

5.00

-5.00

0.50

#,##0

5

-5

1

$#,##0;($#,##0)

$5

($5)

$1

$#,##0.00;($#,##0.00)

$5.00

($5.00)

$0.50

0%

500%

-500%

50%

0.00%

500.00%

-500.00%

50.00%

0.00E+00

5.00E+00

-5.00E+00

5.00E-01

0.00E-00

5.00E00

-5.00E00

5.00E-01

Requisitos   

Espacio de nombres:Microsoft.VisualBasic

**Módulo:**Strings

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Vea también

Referencia

Resumen de manipulación de cadenas

Resumen de conversión

Diferentes formatos para diferentes valores numéricos (Función Format)

Format (Función)

Formatos numéricos predefinidos (Función Format)

Formatos de fecha y hora definidos por el usuario (Función Format)