Compartir a través de


Contenidos de FORMAT_STRING (MDX)

La propiedad de celda FORMAT_STRING da formato a la propiedad de celda VALUE, creando el valor de la propiedad de celda FORMATTED_VALUE. La propiedad de FORMAT_STRING celda maneja los valores sin procesar de cadena y numéricos, aplicando una expresión de formato al valor para devolver un valor con formato para la propiedad de FORMATTED_VALUE celda. En las tablas siguientes se detallan la sintaxis y los caracteres de formato que se usan para controlar los valores numéricos y de cadena.

Valores de cadena

Una expresión de formato para cadenas puede tener una sección o dos secciones separadas por un punto y coma (;).

Uso Resultado
Una sección El formato se aplica a todos los valores de cadena.
Dos secciones La primera sección se aplica a los datos de cadena, mientras que la segunda sección se aplica a valores NULL y cadenas de longitud cero ("").

Los caracteres descritos en la tabla siguiente pueden aparecer en la cadena de formato para las cadenas de caracteres.

Carácter Descripción
@ Representa un marcador de posición de caracteres que muestra un carácter o un espacio. Si la cadena tiene un carácter en la posición donde aparece el signo at (@) en la cadena de formato, la cadena con formato muestra el carácter. De lo contrario, la cadena con formato muestra un espacio en esa posición. Los marcadores de posición se rellenan de derecha a izquierda a menos que haya un signo de exclamación (!) en la cadena de formato.
y Representa un marcador de posición de caracteres que muestra un carácter o nada. Si la cadena tiene un carácter en la posición donde aparece el ampersand (&), la cadena formateada muestra el carácter. De lo contrario, la cadena con formato no muestra nada. Los marcadores de posición se rellenan de derecha a izquierda a menos que haya un signo de exclamación (!) en la cadena de formato.
< Fuerza el uso de minúsculas. La cadena formateada muestra todos los caracteres en minúsculas.
> Fuerza mayúsculas. La cadena formateada muestra todos los caracteres en mayúsculas completas.
! Fuerza el relleno de los marcadores de posición de izquierda a derecha. (El valor predeterminado es rellenar los marcadores de posición de derecha a izquierda).

Valores numéricos

Una expresión de formato definida por el usuario para números puede tener entre una y cuatro secciones separadas por punto y coma. Si el argumento format contiene uno de los formatos numéricos con nombre, solo se permite una sección.

Uso Resultado
Una sección La expresión de formato se aplica a todos los valores.
Dos secciones La primera sección se aplica a valores positivos y ceros, el segundo a valores negativos.
Tres secciones La primera sección se aplica a valores positivos, el segundo a valores negativos y el tercero a ceros.
Cuatro secciones La primera sección se aplica a valores positivos, el segundo a valores negativos, el tercero a ceros y el cuarto a valores NULL.

En el ejemplo siguiente se muestran dos secciones. La primera sección define el formato de valores positivos y ceros, y la segunda sección define el formato de los valores negativos.

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

Si incluye punto y coma sin nada entre ellos, la sección que falta se imprime con el formato del valor positivo. Por ejemplo, el siguiente formato muestra valores positivos y negativos con el formato en la primera sección y muestra "Cero" si el valor es cero:

"$#,##0;;\Z\e\r\o"  

En la tabla siguiente se identifican los caracteres que pueden aparecer en la cadena de formato para los formatos numéricos.

Carácter Descripción
Ninguno Muestra el número sin ningún formato.
0 Representa un marcador de posición de dígitos que muestra un dígito o un cero (0).

Si el número tiene un dígito en la posición donde aparece el cero en la cadena de formato, el valor con formato muestra el dígito. De lo contrario, el valor con formato muestra un cero en esa posición.

Si el número tiene menos dígitos de los que hay ceros (en cualquiera de los lados del decimal) en la cadena de formato, el valor con formato muestra ceros iniciales o finales.

Si el número tiene más dígitos a la derecha del separador decimal que ceros a la derecha del separador decimal en la expresión de formato, el valor con formato redondea el número a tantas posiciones decimales como ceros.

Si el número tiene más dígitos a la izquierda del separador decimal que hay ceros a la izquierda del separador decimal en la expresión de formato, el valor con formato muestra los dígitos adicionales sin modificación.
# Representa un marcador de posición de dígitos que muestra un dígito o nada.

Si la expresión tiene un dígito en la posición donde aparece el signo de número (#) en la cadena de formato, el valor con formato muestra el dígito. De lo contrario, el valor con formato no muestra nada en esa posición.

El marcador de posición de signo de número (#) funciona como el marcador de posición de dígito cero (0), excepto que los ceros iniciales y finales no se muestran si el número tiene la misma o menor cantidad de dígitos que la cantidad de caracteres # a cada lado del separador decimal en la expresión de formato.
. Representa un marcador de posición decimal que determina cuántos dígitos se muestran a la izquierda y a la derecha del separador decimal.

Si la expresión de formato contiene solo caracteres de signo de número (#) a la izquierda del punto (.), los números menores que 1 se inician con un separador decimal. Para mostrar un cero inicial mostrado con números fraccionarios, use cero (0) como marcador de posición de primer dígito a la izquierda del separador decimal.

El carácter real que se utiliza como marcador decimal en la salida con formato depende del formato de número reconocido por el sistema informático.

Nota: En algunas configuraciones regionales, se usa una coma como separador decimal.
% Representa un marcador de posición de porcentaje. La expresión se multiplica por 100. El carácter de porcentaje (%) se inserta en la posición donde aparece el porcentaje en la cadena de formato.
, Representa un separador de miles que separa miles de cientos dentro de un número que tiene cuatro o más lugares a la izquierda del separador decimal.

Se especifica el uso estándar del separador de miles si el formato contiene un separador de miles incluido en marcadores de posición de dígitos (0 o #).

Dos separadores de miles adyacentes, o un separador de miles inmediatamente a la izquierda del separador decimal (si se especifica o no un decimal), significa "escalar el número dividiendo el número en 1000, redondeando según sea necesario". Por ejemplo, puede usar la cadena de formato "##0", para representar 100 millones como 100. Los números menores de 1 millón se muestran como 0. Dos separadores de miles adyacentes en cualquier posición que no esté inmediatamente a la izquierda del separador decimal se interpretan como que especifican el uso de un separador de mil.

El carácter real utilizado como separador de miles en el resultado formateado depende del formato de número reconocido por el sistema informático.

Nota: En algunas localidades, se usa un punto como separador de miles de unidades.
: Representa un separador de hora que separa horas, minutos y segundos cuando se da formato a los valores de hora.

Nota: En algunas configuraciones regionales, se pueden usar otros caracteres como separador de hora.

El carácter real que se usa como separador de hora en el formato de salida viene determinado por la configuración del sistema en el equipo.
/ Representa un separador de fecha que separa el día, mes y año en que se da formato a los valores de fecha.

El carácter real que se usa como separador de fecha en el formato de salida viene determinado por la configuración del sistema en el ordenador.

Nota: En algunas configuraciones regionales, otros caracteres pueden usarse como separador de fecha.
E- E+ e- e+ Representa el formato científico.

Si la expresión de formato contiene al menos un marcador de posición de dígito (0 o #) a la derecha de E-, E+, e-oe+, el valor con formato se muestra en formato científico y E o e se inserta entre el número y el exponente del número. El número de marcadores de posición de dígitos a la derecha determina el número de dígitos del exponente. Use E- o e- para incluir un signo menos junto a exponentes negativos. Use E+ o e+ para incluir un signo menos junto a exponentes negativos y un signo más junto a exponentes positivos.
- + $ ( ) Muestra un carácter literal.

Para mostrar un carácter distinto de uno de los enumerados, coloque una barra diagonal inversa (\) antes del carácter o encierre el carácter entre comillas dobles (" ").
\ Muestra el siguiente carácter en la cadena de formato.

Para mostrar un carácter que tiene un significado especial como carácter literal, coloque una barra diagonal inversa (\) antes del carácter. No se muestra la barra diagonal inversa. El uso de una barra diagonal inversa es el mismo que incluir el siguiente carácter entre comillas dobles. Para mostrar una barra diagonal inversa, use dos barras diagonales inversas (\\). Entre los ejemplos de caracteres que no se pueden mostrar como caracteres literales se incluyen los siguientes caracteres:

Los caracteres de formato de fecha y 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

Caracteres de formato de cadena-@, &, <, >y !
"ABC" Muestra la cadena entre comillas dobles (" ").

Para incluir una cadena en formato desde el código, use Chr(34) para incluir el texto. (El código de carácter de una comilla doble es 34).

Formatos numéricos con nombre

En la tabla siguiente se identifican los nombres de formato numérico predefinidos:

Nombre del formato Descripción
General Number Muestra el número sin separador de miles.
Currency Muestra el número con un separador de miles, si corresponde. Muestra dos dígitos a la derecha del separador decimal. La salida se basa en la configuración regional del sistema.
Fixed Muestra al menos un dígito a la izquierda y dos dígitos a la derecha del separador decimal.
Standard Muestra el número con separador de miles, al menos un dígito a la izquierda y dos dígitos a la derecha del separador decimal.
Percent Muestra el número multiplicado por 100 con un signo de porcentaje (%) anexado a la derecha. Siempre muestra dos dígitos a la derecha del separador decimal.
Scientific Usa notación científica estándar.
Yes/No Muestra No si el número es 0; de lo contrario, muestra Sí.
True/False Muestra False si el número es 0; de lo contrario, muestra True.
On/Off Muestra Desactivado si el número es 0; De lo contrario, se muestra Activado.

Valores de fecha

En la tabla siguiente se identifican los caracteres que pueden aparecer en la cadena de formato para formatos de fecha y hora.

Carácter Descripción
: Representa un separador de hora que separa horas, minutos y segundos cuando se da formato a los valores de hora.

El carácter real que se usa como separador de hora en la salida con formato viene determinado por la configuración del sistema del ordenador.

Nota: En algunas configuraciones regionales, otros caracteres pueden usarse como separador de hora.
/ Representa un separador de fecha que separa el día, mes y año en que se da formato a los valores de fecha.

El carácter real que se usa como separador de fecha en la salida con formato viene determinado por la configuración del sistema del equipo.

Nota: En algunas configuraciones regionales, se pueden usar otros caracteres para representar el separador de fecha.
C Muestra la fecha como dddddd y muestra la hora como ttttt, en ese orden.

Muestra solo la información de fecha si no hay ninguna parte fraccionaria en el número de serie de la fecha. Muestra solo la información de hora si no hay ninguna parte entera.
d Muestra el día como un número sin un cero a la izquierda (1-31).
Dd Muestra el día como un número con un cero a la izquierda (01-31).
dddd Muestra el día como una abreviatura (Sun-Sat).
dddd Muestra el día como un nombre completo (Sunday-Saturday).
ddddd Muestra la fecha como una fecha completa (incluido el día, el mes y el año), con formato según la configuración de formato de fecha corta del sistema.

Para Microsoft Windows, el formato de fecha corta predeterminado es m/d/yy.
ddddddd Muestra un número de serie de fecha como una fecha completa (incluido el día, el mes y el año), con formato según la configuración de fecha larga reconocida por el sistema informático.

Para Windows, el formato de fecha larga predeterminado es mmmm dd, aaaa.
w Muestra el día de la semana como un número (de 1 para domingo a 7 para sábado).
Ww Muestra la semana del año como un número (1-54).
m Muestra el mes como un número sin un cero a la izquierda (1-12).

Si m sigue inmediatamente después de h o hh, se muestra el minuto en lugar del mes.
milímetro Muestra el mes como un número con un cero a la izquierda (01-12).

Si m inmediatamente sigue a h o hh, se muestra el minuto en vez del mes.
Mmm Muestra el mes como abreviatura (Jan-Dec).
Mmmmm Muestra el mes como un nombre de mes completo (January-December).
q Muestra el trimestre del año como un número (1-4).
y Muestra el día del año como un número (1-366).
Yy Muestra el año como un número de dos dígitos (00-99).
aaaa Muestra el año como un número de cuatro dígitos (100-9999).
h Muestra la hora como un número sin ceros iniciales (0-23).
S.S Muestra la hora como un número con ceros a la izquierda (00-23).
n Muestra el minuto como un número sin ceros iniciales (0-59).
nn Muestra el minuto como un número con ceros iniciales (00-59).
s Muestra el segundo como un número sin ceros iniciales (0-59).
Ss Muestra el segundo como un número con ceros iniciales (00-59).
t t t t t Muestra la hora completa (incluyendo hora, minuto y segundo), con formato según el separador de hora definido por el formato de hora reconocido por el sistema informático.

Se muestra un cero inicial si la opción de cero inicial está seleccionada y la hora es anterior a las 10:00 en el período de la mañana o de la tarde. Por ejemplo, 09:59,

Para Windows, el formato de hora predeterminado es h:mm:ss.
AM/PM Muestra un AM en mayúsculas con cualquier hora de medianoche hasta el mediodía; muestra un PM en mayúsculas con cualquier hora desde el mediodía hasta la medianoche.

Nota: Usa el reloj de 12 horas.
am/pm Muestra una am minúscula con cualquier hora de medianoche hasta mediodía; muestra una p. m. minúscula con cualquier hora desde el mediodía hasta la medianoche.

Nota: Usa el reloj de 12 horas.
A/P Muestra una A mayúscula con cualquier hora de medianoche hasta el mediodía; muestra una P mayúscula con cualquier hora desde el mediodía hasta la medianoche.

Nota: Usa el reloj de 12 horas.
a/p Muestra una a en minúscula con cualquier hora de medianoche a mediodía; muestra una p minúscula con cualquier hora desde el mediodía hasta la medianoche.

Nota: Usa el reloj de 12 horas.
AMPM Muestra el literal de cadena AM tal y como define el sistema informático con cualquier hora de medianoche hasta mediodía; muestra el literal de cadena PM definido por el sistema informático con cualquier hora desde el mediodía hasta la medianoche.

Nota: Usa el reloj de 12 horas.

AMPM puede estar en mayúsculas o minúsculas, pero el caso de la cadena que se muestra coincide con la cadena definida por la configuración del sistema del equipo.

Para Windows, el formato predeterminado es AM/PM.

Formatos de fecha con nombre

En la tabla siguiente se identifican los nombres predefinidos de formato de fecha y hora:

Nombre de formato Descripción
General Date Muestra una fecha o hora. Para números reales, muestra una fecha y hora, por ejemplo, 4/3/93 05:34 p. m. Si no hay ninguna parte fraccionarcional, muestra solo una fecha, por ejemplo, 4/3/93. Si no hay ninguna parte entera, muestra una hora solo, por ejemplo, 05:34 p. m. El formato de la presentación de fecha viene determinado por la configuración del sistema.
Long Date Muestra una fecha según el formato de fecha larga del sistema.
Medium Date Muestra una fecha con el formato de fecha medio adecuado para la versión de idioma de la aplicación host.
Short Date Muestra una fecha con el formato de fecha corta del sistema.
Long Time Muestra una hora con el formato de tiempo largo del sistema; incluye horas, minutos y segundos.
Medium Time Muestra la hora en el formato de 12 horas, utilizando horas y minutos y el designador AM/PM.
Short Time Muestra una hora con el formato de 24 horas, por ejemplo, 17:45.

Véase también

IDIOMA y FORMAT_STRING en FORMATED_VALUE
Uso de propiedades de celda (MDX)
Creación y uso de valores de propiedad (MDX)
Aspectos básicos de la consulta MDX (Analysis Services)