Formatos de campos

Los campos numéricos, de fecha y de tiempo se pueden visualizar de varias maneras diferentes. Esto puede ser controlado con los formatos de cadenas, los cuales representan de manera simbólica la salida formatada.

Campos numéricos:

Especificador Representa

0 Casillero digital. Si el valor a formatear tiene un dígito en la posición donde aparece el '0' en la cadena de formato, éste dígito será copiado a la cadena de salida. Si no fuera asi, un cero sería guardado en esa posición de la cadena de salida.

# Casillero digital. Si el valor a formatear tiene un dígito en la posición donde aparece el '#' en la cadena de formato, éste dígito será copiado a la cadena de salida. Si no fuera así, ningún dígito se almacenaría en esa posición de la cadena de salida

. Punto decimal. El primer carácter '.' en la cadena del formato determina la posición del separador decimal en el valor formatado; cualquier otro carácter '. ' será ignorado. El carácter que aparecerá como separador decimal en la cadena de salida está especificado en el formato de número de la sección Internacional del Panel de Control de Windows.

, Separador de miles. Si el formato de la cadena contiene uno o más caracteres ',' ,la salida tendrá separadores de miles insertados entre cada grupo de tres dígitos a partir de la izquierda del punto decimal. El lugar y el número de caracteres ',' en la cadena de formato no afecta a la salida, excepto para indicar los separadores de miles que son deseados. El carácter usado para especificar los separadores de miles en la salida está especificado en el Formato de Números de la sección Internacional del Panel de Control de Windows.

E+ Notación científica. Si una de estas cadenas 'E+', 'E-', 'e+', o 'e-' aparecen en la cadena de formato, el número será formatado usando la notación científica. Un grupo de hasta cuatro caracteres '0' pueden seguir al 'E+', 'E-', 'e+', o 'e-' para determinar el número mínimo de dígitos en el exponente. El formato 'E+' y 'e+' producen un signo '+' en la cadena de salida para los exponentes positivos y un signo '-' para los exponentes negativos. El formato 'E-' y 'e-' provocan un carácter de signo sólo para los exponentes negativos.

'xx'/"xx" Los caracteres encerrados entre comillas simples o entre dobles comillas saldrán tal como aparecen, y no afectará al formato de la cadena.

; Separa secciones para números positivos, negativos y ceros en la cadena de formato.

Los lugares más a la izquierda del '0' antes del punto decimal en la cadena de formato y los más a la derecha del '0' después del punto decimal en la cadena de formato determinan el rango de dígitos estarán siempre presentes en la cadena de salida.

El número que está siendo formatado es siempre redondeado al número de casillas que se indique por los casilleros digitales ('0' or '#') siempre a la derecha del punto decimal. Si el formato de la cadena no contiene punto decimal, el valor que se formata es redondeado al número entero más cercano.

Si el número ya formatado tiene más dígitos hacia la izquierda de la coma decimal que los que aparecen a la izquierda del '.' de la cadena de formato, los dígitos extra saldrán antes del primer dígito del casillero digital.

Para indicar diferentes formatos para valores positivos, negativos y ceros, la cadena de formato puede contener desde una a tres secciones separadas por ';'.

•	Una sección: La cadena de formato se aplicará a todos los valores.

•	Dos secciones: La primera sección se aplicará a los valores positivos y a los ceros, y la segunda será aplicable a los valores negativos.

•	Tres secciones: La primera sección se aplicará a los valores positivos, la segunda a los negativos, y la tercera al cero.

Si la sección para los valores negativos o la sección para valores de cero están vacías, es decir, si no hubiera nada entre los ';' que delimitan la sección, entonces se utilizará en su lugar la sección para los positivos.

Si la sección para valores negativos está vacía, o si la cadena de formato entera estuviera vacía, el valor sería formatado utilizando el formato para punto flotante con 15 dígitos significativos. Por lo general el formato de punto flotante es también usado si el valor tiene más de 18 dígitos a la izquierda del punto decimal siempre que el formato de cadena no especifique notación científica.

Fecha/Tiempo:

Las siguientes opciones de formato están disponibles para fechas y tiempos:

Especificador Mostrará

C Muestra la fecha utilizando el formato corto para fechas de Windows, seguido por el formato largo para tiempo. El tiempo no se mostrará si la parte fraccional del valor DateTime es cero.

D Muestra el día como un número sin ceros significativos (1-31).

Dd Muestra el día como un número con ceros significativos (01-31).

Ddd Muestra el día como una abreviatura (Lun-Dom).

Dddd Muestra el día con su nombre completo (Lunes-Domingo).

Ddddd Muestra la fecha en formato corto.

Dddddd Muestra la fecha en formato largo.

M Muestra el mes como un número sin ceros significativos (1-12). Si el especificador 'm' sigue inmediatamente al especificador 'h' o 'hh', se mostrará el minuto antes que el mes.

Mm Muestra el mes como un número con ceros significativos (01-12). Si el especificador 'mm' sigue inmediatamente al especificador 'h' o 'hh', se mostrará el minuto antes que el mes.

Mmm Muestra el mes como una abreviatura (Ene-Dic).

Mmmm Muestra el mes como un nombre completo (Enero-Diciembre).

Yy Muestra el año como un número de dos dígitos (00-99).

Yyy Muestra el año como un número de cuatro dígitos (0000-9999).

H Muestra la hora sin ceros significativos (0-23).

Hh Muestra la hora con ceros significativos (00-3).

N Muestra los minutos sin ceros significativos (0-59).

Nn Muestra los minutos con ceros significativos (00-59).

S Muestra los segundos sin ceros significativos (0-59).

Ss Muestra los segundos con ceros significativos (00-59).

T Muestra el tiempo utilizando el formato corto.

Tt Muestra el tiempo en formato largo.

am/pm Tiene en cuenta el mediodía (las 12 horas) para preceder a los especificadores 'h' o 'hh', y muestra 'am' para cualquier hora antes del mediodía, y 'pm' para cualquier hora después del mediodía. Dichos especificadores pueden ponerse en sólo mayúsculas, sólo minúsculas o de forma mezclada, y el resultado se mostrará de acuerdo con ello.

a/p Tiene en cuenta el mediodía (las 12 horas) para preceder a los especificadores 'h' o 'hh', y muestra 'a' para cualquier hora antes del mediodía, y 'p' para cualquier hora después del mediodía. Dichos especificadores pueden ponerse en sólo mayúsculas, sólo minúsculas o de forma mezclada, y el resultado se mostrará de acuerdo con ello.

Ampm Tiene en cuenta el mediodía (las 12 horas) para preceder a los especificadores 'h' o 'hh', y muestra el contenido de la variable global TimeAMString para cualquier hora antes del mediodía, y el contenido de la variable global TimePMString para cualquier hora después del mediodía.

/ Muestra el separador de fechas que aparece en los valores asignados al país en Windows.

: Muestra el separador de tiempo que aparece en los valores asignados al país en Windows.

'xx'/"xx" Los caracteres encerrados entre comillas simples o entre comillas dobles son mostrados tal cual, y no afectan al formato.

Los especificadores pueden ser escritos tanto en mayúsculas como en minúsculas ya que producen el mismo resultado excepto 'am/pm' y 'a/p'.