Formatear valores
Dar formato a un valor para su visualización es una conversión de tipo particularmente importante. Hasta que no se convierta una variable Datetime, decimal o double en algún tipo de cadena, no podremos mostrarla al usuario. Dos de los métodos más útiles para formatear valores como cadenas son ToString y String. Métodos que se describen a continuación.
ToString
El objeto de la clase proporciona un método ToString que heredan todas las demás clases. De forma predeterminada, este método devuelve el nombre del tipo de un objeto como una cadena, pero la mayoría de las clases para las que tiene sentido anulan este método para devolver el valor del objeto como una cadena.
Por ejemplo, si una variable float tiene el valor 1,23, el método ToString devuelve el valor "1,23" como cadena. Por el contrario, si definimos una clase empleado, de forma predeterminada el método ToString devuelve el nombre de la clase, que es similar a WindowsFormsApplication1.Employee. Si utilizamos el método ToString de una variable sin parámetros, obtenemos una representación predeterminada de su valor. El método ToString también podemos tomar como parámetros un proveedor de formato, una cadena de formato o ambos. Al utilizar la cadena de formato, podemos personalizar el texto resultante. Por ejemplo, si la variable costo es un valor flotante (float), la declaración cost.ToString ("0.00") produce una cadena que contiene el valor del costo que se muestra con 2 posiciones decimales.
String.Format
El método ToString nos permite convertir el valor de una sola variable en una cadena. El método de formato estático de la clase String nos permite crear una cadena que puede contener los valores de muchas variables formateadas de diferentes maneras. El método String.Format tiene algunas versiones sobrecargadas, pero la más común toma como parámetros una cadena de formato y uno o más argumentos que se utilizan para completar elementos dentro de la cadena de formato. Cada elemento en la cadena de formato tiene la siguiente sintaxis de formato compuesto:
{index [,length] [:formatString]}
Aquí, índex es el índice de base cero de un parámetro que sigue a la cadena de formato que debe usarse para este elemento; length es la longitud mínima del resultado del elemento; y formatString es una cadena de formato estándar o personalizada para el elemento. Si la longitud es negativa, el valor se alinea a la izquierda dentro de su longitud.
Esto formalmente lo hace parecer confuso, pero en realidad no es tan mala. El siguiente código muestra un ejemplo sencillo.
int i = 163;
Console.WriteLine(string.Format("{0} = {1,4} or 0x{2:X}", (char)i, i, i));
Utilizamos string.Format para formatear una línea que escribe en la ventana de Salida.
La cadena de formato es {0} = {1,4} or 0x{2:X}. Esta cadena tiene tres elementos de formato que significan:
{0} muestra el argumento 0 como formato predeterminado
{1,4} muestra el argumento 1 en un campo de al menos cuatro caracteres de ancho
{2: X} muestra el argumento 2 con formato cadena X (que muestra un número entero en hexadecimal)
Los otros caracteres dentro de la cadena de formato (=, y or x) se incluyen en la salida tal como aparecen en la cadena de formato.
Los parámetros que vienen después de la cadena de formato son los argumentos que deben usarse con la cadena de formato. El primer argumento convierte el entero i en un carácter. El segundo y tercer argumento son simplemente la variable i. El resultado es que esta línea muestra el valor 163 convertido en un carácter, luego como un valor decimal y luego en hexadecimal. A continuación se muestra el resultado:
£ = 163 or 0xA3
No es necesario utilizar un argumento en la cadena de formato. Los argumentos también se pueden usar en cualquier orden y se pueden usar repetidamente, por lo que la siguiente declaración es válida:
string text = string.Format("{1} {4} {2} {1} {3}",
"quién", "yo", "luego", "soy", "pienso");
Si utilizamos String.Format para concatenar una serie de declaraciones y producir resultados es en gran parte una cuestión de preferencia personal.
Formateo de cadenas
Tanto los métodos ToString como String.Format pueden tomar cadenas de formato como parámetros para indicarles cómo formatear un valor. Para String.Format, esto se refiere a la cadena de formato dentro de los elementos de formato. Por ejemplo, en la declaración string.Format("0x{0:X}", 90) , la cadena de formato es la X dentro de las llaves. Las cadenas de formato se dividen en dos categorías generales:
Las cadenas de formato estándar permiten determinar cómo queremos que se muestre un valor en un nivel alto.
Las cadenas de formato estándar tienen en cuenta la configuración regional, por lo que permiten que el programa produzca una salida que sea apropiada para la configuración regional del ordenador. Por ejemplo, la cadena de formato de fecha "d" indica un patrón de fecha corto y produce un resultado similar al 4/7/2022 en los Estados Unidos o al 7/04/2022 en España.
Las cadenas de formato personalizadas nos permiten crear formatos que no son proporcionados por las cadenas de formato estándar. Por ejemplo, la siguiente declaración produce un resultado similar a: Son las 12 en punto.
Console.WriteLine(string.Format("Son las {0:HH} en punto",DateTime.Now));
Podemos usar cadenas de formato personalizadas para producir resultados que sean similares a los producidos por las cadenas estándar, pero debemos utilizar las cadenas estándar siempre que sea posible para obtener los cambios apropiados si nuestro programa se ejecuta en un ordenador que este configurada para una configuración local diferente.
Los métodos ToString y String.Format comprenden cientos de cadenas de formato estándar y personalizadas. La tabla siguiente enumera las cadenas de formato estándar más útiles para valores numéricos y Datetime.
Cadenas de formatos para números estándard
|
Formato |
Descripción |
Ejemplo |
|
C
o c |
Moneda |
12.345,67 € |
|
D
o d |
Decimal, sólo tipos enteros |
12345 |
|
E
o e |
Notación científica |
1.234567E+004 |
|
F
o f |
Punto fujo |
12345,67 |
|
G
o g |
General (punto fijo o científico, lo
que sea más corto) |
12345,67 |
|
N
o n |
Número con decimales y separadores
de miles |
12.345,67 |
|
P
o p |
Porcentaje (multiplicado por 100 y añadido
%) |
0,12 se convierte en 12 % |
|
X
o x |
Hexadecimal (sólo tipos integer) |
3039 |
Algunos de estos formatos pueden tener un especificador de precisión opcional que controla el número de dígitos desplegado. Para la mayoría de estos tipos, el especificador de precisión indica el número de dígitos que se mostrarán después de la coma. Por ejemplo, si el valor es 12345,67, value.ToString ("C4") produce 12.345,6700 €.
Para la notación científica, el especificador de precisión indica el número de dígitos después de la coma en la mantisa. Por ejemplo, si el valor es 12345,67, value.ToString ("E2") produce 1,23E + 004.
Cadenas de formato para Datetime
|
Formato |
Descripción |
Ejemplo |
|
d |
Fecha corta |
7/04/2022 |
|
D |
Fecha larga |
Jueves 7 de abril de 2022 |
|
f |
Completa con hora corta |
Jueves 7 de abril de 2022 14:23 |
|
F |
Completa con hora larga |
Jueves 7 de abril de 2022 14:23:16 |
|
g |
General con hora corta |
7/04/2022 14:23 |
|
G |
General con hora larga |
7/04/2022 14:23:16 |
|
m o M |
Dia/ mes |
7 /Abril |
|
t |
Hora corta |
14:23 |
|
T |
Hora larga |
14:23:16 |
|
y o Y |
Mes / año |
Abril 2022 |
Además de estos formatos estándar, la estructura DateTime proporciona cuatro métodos que producen una salida similar a los especificadores de formato d, D, t y T. Estos métodos son ToShortDateString, ToLongDateString, ToShortTimeString y ToLongTimeString.
Ejemplo Visualización de valores de moneda
Modificamos el formulario de entrada de pedidos que creamos para el Manejo Valores porcentuales para que muestre el precio extendido, el subtotal, el impuesto sobre las ventas y el total general en formato de moneda.
Solución: El programa ya usa el método ToString para mostrar esos valores. El único cambio necesario es pasar la cadena de formato de moneda "C" a esas llamadas a ToString. Por ejemplo, el siguiente código muestra cómo el programa muestra el Gran Total en formato de moneda:
txtTotal.Text = Total.ToString("C");
