Texto DAX - función FORMAT
Descripción
Convierte un valor en texto según el formato especificado.
Sintaxis
FORMAT (<value>, <format_string>)Parámetros
| No Señor. | Descripción de parámetros |
|---|---|
| 1 | value Un valor o expresión que se evalúa como un solo valor. |
| 2 | format_string Cadena que representa un estilo de formato.
Consulte las secciones que se encuentran al final de este capítulo: Formatos numéricos predefinidos y Formatos numéricos personalizados para la función FORMAT.
Consulte el tutorial: DAX en esta biblioteca de tutoriales para obtener detalles sobre el formato de fechas y horas. |
Valor devuelto
Una cadena que contiene un valor con el formato definido por format_string.
Observaciones
Si el valor es EN BLANCO (), la función FORMATO devuelve una cadena vacía.
Si format_string es EN BLANCO (), el valor se formatea con un formato de "Número general" o "Fecha general" (según el tipo de datos del valor).
Ejemplo
La siguiente tabla muestra los resultados de la función FORMAT con el primer valor de argumento dado en la primera fila y format_string dado en la primera columna. Consulte las secciones que se proporcionan a continuación de esta tabla para comprender las cadenas de formato.
| "5" | "-5" | "0.5" | "0" | |
| Cadena de longitud cero ("") | 5 | -5 | 0,5 | 0 |
| 0 | 5 | -5 | 1 | 0 |
| 0,00 | 5,00 | -5,00 | 0,50 | 0,00 |
| #, ## 0 | 5 | -5 | 1 | 0 |
| $ #, ## 0; ($ #, ## 0) | $ 5 | ($ 5) | $ 1 | $ 0 |
| $ #, ## 0.00; ($ #, ## 0.00) | $ 5,00 | ($ 5,00) | $ 0.50 | 0,00 $ |
| 0% | 500% | -500% | 50% | 0% |
| 0,00% | 500,00% | -500,00% | 50,00% | 0,00% |
| 0,00E + 00 | 5.00E + 00 | -5.00E + 00 | 5.00E-01 | 0,00E + 00 |
| 0.00E-00 | 5.00E00 | -5.00E00 | 5.00E-1 | 0.00E00 |
| "$ #, ## 0 ;; \ Z \ e \ r \ o" | $ 5 | $ -5 | $ 1 | Cero |
Formatos numéricos predefinidos para la función FORMAT
La siguiente tabla identifica los nombres de formato numérico predefinidos que se pueden usar por nombre para el argumento de estilo de formato de la función Format.
| No Señor. | Cadena de formato y descripción |
|---|---|
| 1 | "General Number" Muestra un número sin separadores de miles. |
| 2 | "Currency" Muestra el número con miles de separadores, si corresponde. Muestra dos dígitos a la derecha del separador decimal. La salida se basa en la configuración regional del sistema. |
| 3 | "Fixed" Muestra al menos un dígito a la izquierda y dos dígitos a la derecha del separador decimal. |
| 4 | "Standard" Muestra un número con separadores de miles, al menos un dígito a la izquierda y dos dígitos a la derecha del separador decimal. |
| 5 | "Percent" Muestra el número multiplicado por 100 con un signo de porcentaje (%) agregado inmediatamente a la derecha. Siempre muestra dos dígitos a la derecha del separador decimal. |
| 6 | "Scientific" Utiliza notación científica estándar, que proporciona dos dígitos significativos. |
| 7 | "Yes/No" Muestra No si el número es 0. De lo contrario, muestra Sí. |
| 8 | "True/False" Muestra Falso si el número es 0. De lo contrario, muestra Verdadero. |
| 9 | "On/Off" Aparece Apagado si el número es 0. De lo contrario, muestra Encendido. |
Formatos numéricos personalizados para la función FORMAT
Una expresión de formato definido por el usuario para números puede tener de una a tres secciones separadas por punto y coma.
Si el argumento format_string de la función Format contiene uno de los formatos numéricos predefinidos, solo se permite una sección.
La siguiente tabla muestra cómo se aplican las secciones durante el formateo.
| No Señor. | Número de sección y resultado de formato |
|---|---|
| 1 | One section only La expresión de formato se aplica a todos los valores. |
| 2 | Two sections La primera sección se aplica a valores positivos y ceros. El segundo se aplica a los valores negativos. |
| 3 | Three sections La primera sección se aplica a valores positivos. La segunda sección se aplica a los valores negativos. La tercera sección se aplica a los ceros. |
Si incluye punto y coma sin nada entre ellos, la sección que falta se imprime utilizando el formato del valor positivo.
La siguiente tabla identifica los caracteres que puede utilizar para crear formatos numéricos definidos por el usuario.
| No Señor. | Especificación y descripción del formato |
|---|---|
| 1 | None Muestra el número sin formato. |
| 2 | 0 (zero character) Marcador de posición de dígitos. 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, muestra el dígito. De lo contrario, muestra un cero en esa posición. Si el número tiene menos dígitos que ceros (a ambos lados del decimal) en la expresión de formato, muestra ceros al principio o al final. 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, redondea el número a tantos lugares decimales como ceros. Si el número tiene más dígitos a la izquierda del separador decimal que ceros a la izquierda del separador decimal en la expresión de formato, muestra los dígitos adicionales sin modificación.
Este símbolo funciona como el marcador de posición de 0 dígitos, excepto que los ceros iniciales y finales no se muestran si el número tiene menos dígitos que los caracteres # a cada lado del separador decimal en la expresión de formato. |
| 3 | . (dot character) Marcador de posición decimal. El marcador de posición decimal determina cuántos dígitos se muestran a la izquierda y a la derecha del separador decimal.
En algunas configuraciones regionales, se usa una coma como separador decimal. El carácter real utilizado como marcador de posición decimal en la salida formateada depende del formato de número reconocido por su sistema. Por lo tanto, debe usar el punto como marcador de posición decimal en sus formatos, incluso si se encuentra en una configuración regional que utiliza una coma como marcador de posición decimal. La cadena formateada aparecerá en el formato correcto para la configuración regional. |
| 4 | % Marcador de posición de porcentaje. Multiplica la expresión por 100. El carácter de porcentaje (%) se inserta en la posición donde aparece en la cadena de formato. |
| 5 | , (comma character) Separador de miles. El separador de miles separa miles de cientos dentro de un número que tiene cuatro o más lugares a la izquierda del separador decimal. El uso estándar del separador de miles se especifica si el formato contiene un separador de miles rodeado de marcadores de posición de dígitos (0 o #). Un separador de mil inmediatamente a la izquierda del separador decimal (ya sea que se especifique un decimal o no) o como el carácter más a la derecha en la cadena significa "escalar el número dividiéndolo por 1,000, redondeando según sea necesario".
En algunos lugares, se utiliza un punto como separador de miles. El carácter real utilizado como separador de miles en la salida formateada depende del formato de número reconocido por su sistema. Por lo tanto, debe usar la coma como separador de miles en sus formatos, incluso si se encuentra en una configuración regional que usa un punto como separador de miles. La cadena formateada aparecerá en el formato correcto para la configuración regional. Ejemplos:
|
| 6 | : (colon character) Separador de tiempo. El separador de hora separa horas, minutos y segundos cuando se formatea los valores de hora. En algunos lugares, se pueden usar otros caracteres para representar el separador de tiempo. El carácter real utilizado como separador de tiempo en la salida formateada lo determina la configuración del sistema. |
| 7 | / (forward slash character) Separador de fecha. El separador de fecha separa el día, mes y año en que se formatea los valores de fecha. En algunas configuraciones regionales, se pueden usar otros caracteres para representar el separador de fecha. El carácter real utilizado como separador de fecha en la salida formateada viene determinado por la configuración del sistema. |
| 8 | E- , E+ , e- , e+ Scientific format. Si la expresión de formato contiene al menos un marcador de posición de un dígito (0 o #) a la izquierda de E-, E +, e- o e +, el número se muestra en formato científico y E o e se inserta entre el número y su exponente .
|
| 9 | -+$() Caracteres literales. Estos caracteres se muestran exactamente como se escribieron en la cadena de formato. Para mostrar un carácter que no sea uno de los enumerados, precedalo con una barra invertida (\) o enciérrelo entre comillas dobles (""). |
| 10 | \ (backward slash character) Muestra el siguiente carácter en la cadena de formato. Para mostrar un carácter que tiene un significado especial como carácter literal, preceda con una barra invertida (\).
Sin embargo, algunos caracteres no se pueden mostrar como caracteres literales. Por ejemplo,
|
| 11 | "ABC" Muestra la cadena dentro de las comillas dobles (""). Para incluir una cadena en el argumento de estilo desde dentro del código, debe utilizar Chr (34) para encerrar el texto (34 es el código de carácter de las comillas (")). |