Formato (función, Format)

Devuelve un valor de tipo Variant (String) que contiene un expresión con formato según las instrucciones incluidas en una expresión de formato.

Aparecerá    Hay un problema con el uso de esta función. El último lunes de algunos años del calendario se puede devolver como semana 53 cuando debería ser la semana 1. Para obtener más información y una solución alternativa, consulte las funciones Format o DatePart pueden devolver un número de semana incorrecto por el último lunes del año.

Vea algunos ejemplos

Sintaxis

Format ( expr [, formato ] [, primer_día_semana ] [, primera_semana_año ] )

La sintaxis de la función Format tiene los siguientes argumentos:

argumento

Descripción

expresión

Obligatorio. Cualquier expresión válida.

formato

Opcional. Una expresión de formato válida definida por el usuario o con nombre.

primer_día_semana

Opcional. Un constante que especifica el primer día de la semana.

primera_semana_año

Opcional. Una constante que especifica la primera semana del año.


Configuración

El argumento Format puede usar diversas configuraciones, según el tipo de datos del argumento expresión . Consulte los artículos indicados en la tabla siguiente para obtener más información sobre las expresiones de formato válidas.

Para expresiones que usan este tipo de datos...

Consulte el artículo

Cualquier tipo

Format (propiedad)

Fecha y hora

Aplicar formato a un campo de fecha y hora

Numérico

Aplicar formato a un campo numérico o moneda

Texto y Memo

Aplicar formato a un campo de texto

Sí/No

Format (propiedad) - Tipo de datos Sí/No


El argumento FirstDayOfWeek tiene los siguientes valores:

Constante

Valor

Descripción

vbUseSystem

0

Usar la configuración de la API NLS.

VbSunday

1

Domingo (valor predeterminado)

vbMonday

2

Lunes

vbTuesday

3

Martes

vbWednesday

4

Miércoles

vbThursday

5

Jueves

vbFriday

6

Viernes

vbSaturday

7

Sábado


El argumento FirstWeekOfYear tiene los siguientes valores:

Constante

Valor

Descripción

vbUseSystem

0

Usar la configuración de la API NLS.

vbFirstJan1

1

Comienza con la semana en la que se produce el 1 de enero (predeterminado).

vbFirstFourDays

2

Comienza con la primera semana que tenga al menos cuatro días en el año.

vbFirstFullWeek

3

Comienza con la primera semana completa del año.


Observaciones

Para dar formato

Realice este procedimiento

Números

Use Formatos numéricos con nombre predefinidos o cree formatos numéricos definidos por el usuario.

Fechas y horas

Use formatos predefinidos de fecha y hora con nombre o cree formatos de fecha y hora definidos por el usuario.

Números de serie de fecha y hora

Use Formatos numéricos o de fecha y hora.

Cadena

Cree sus propios formatos de cadena definidos por el usuario.


Si intenta dar formato a un número sin especificar el formato, el formato proporciona una funcionalidad similar a la de la función Str , aunque es internacional. Sin embargo, los números positivos con formato como cadenas que usan el formato no incluyen un espacio inicial reservado para el signo del valor; los que se convierten mediante Str conservan el espacio inicial.

Si va a dar formato a una cadena numérica no localizada, debe usar un formato numérico definido por el usuario para asegurarse de que obtiene el aspecto que desea.

Nota: Si el valor de la propiedad Calendar es gregoriano y formato especifica el formato de fecha, la expresión proporcionada debe ser Gregoriana. Si el valor de la propiedad Calendar de Visual Basic es Hijri, la expresión proporcionada debe ser Hijri.

Si el calendario es gregoriano, el significado de los símbolos de la expresión de formato no cambia. Si el calendario es Hijri, todos los símbolos de formato de fecha (por ejemplo, dddd, mmmm, YYYY) tienen el mismo significado pero se aplican al calendario Hijri. Los símbolos de formato permanecen en inglés; los símbolos que tienen como resultado una presentación de texto (por ejemplo, AM y PM) muestran la cadena (inglés o árabe) asociada con ese símbolo. El intervalo de ciertos símbolos cambia cuando el calendario es Hijri.

Símbolo

Rango

d

1-30

dd

1-30

ww

1-51

mmm

Muestra los nombres de los meses completos (los nombres de los meses Hijri no tienen abreviaturas).

y

1-355

yyyy

100-9666

Ejemplos

Usar la función Format en una expresión    Puede usar Format en cualquier lugar en el que pueda usar expresiones. Por ejemplo, puede usarlo en una consulta como parte de un alias de campo o en la propiedad origen del control de un cuadro de texto en un formulario o informe. En los siguientes ejemplos se muestra una expresión que se puede usar en la propiedad Filter de un informe para limitar el resultado a los registros de la semana anterior.

Format ([fecha], "WW") = Format (Now (), "WW")-1

En este ejemplo, el origen de registros del informe tiene un campo denominado Date, que contiene la fecha en la que se modificó cada registro en particular y que se usa en el informe. Al ejecutar el informe, se filtran los resultados para mostrar solo los registros en los que la semana para el valor del campo de fecha (Format ([fecha], "WW")) es igual a la semana anterior (Format (Now (), "WW")-1).

Usar la función Format en código de VBA    

Nota: En los siguientes ejemplos se muestra el uso de esta función en un módulo de Visual Basic para aplicaciones (VBA). Para obtener más información sobre cómo trabajar con VBA, seleccione Referencia del programador en la lista desplegable situada junto a Buscar y escriba uno o más términos en el cuadro de búsqueda.

Este ejemplo muestra diversos usos de la función Format para dar formato a valores usando tanto formatos con nombre como formatos definidos por el usuario. Para el separador de fecha (/), el separador de hora (:) y el literal de AM/PM, el resultado con formato real que muestra el sistema depende de la configuración regional del equipo en el que se está ejecutando el código. Cuando se muestran las horas y fechas en el entorno de desarrollo, se usan el formato de fecha corta y el formato de fecha corta de la configuración regional del código. Cuando se muestra ejecutando código, se usan el formato de hora corta y el formato de fecha corta de la configuración regional del sistema, que puede diferir de la configuración regional del código. Para este ejemplo, se presupone la configuración regional de Inglés de Estados Unidos.

MyTime y MyDate se muestran en el entorno de desarrollo con la configuración de fecha corta del sistema actual y la configuración de fecha corta.

Dim MyTime, MyDate, MyStr
MyTime = #17:04:23#
MyDate = #January 27, 1993#
' Returns current system time in the system-defined long time format.
MyStr = Format(Time, "Long Time")
' Returns current system date in the system-defined long date format.
MyStr = Format(Date, "Long Date")
MyStr = Format(MyTime, "h:m:s") ' Returns "17:4:23".
MyStr = Format(MyTime, "hh:mm:ss AMPM") ' Returns "05:04:23 PM".
MyStr = Format(MyDate, "dddd, mmm d yyyy") ' Returns "Wednesday,
' Jan 27 1993".
' If format is not supplied, a string is returned.
MyStr = Format(23) ' Returns "23".
' User-defined formats.
MyStr = Format(5459.4, "##,##0.00") ' Returns "5,459.40".
MyStr = Format(334.9, "###0.00") ' Returns "334.90".
MyStr = Format(5, "0.00%") ' Returns "500.00%".
MyStr = Format("HELLO", "<") ' Returns "hello".
MyStr = Format("This is it", ">") ' Returns "THIS IS IT".


Usar el formato con cadenas de longitud cero

En Microsoft Access versión 2,0 y anteriores, puede usar la función Format para devolver un valor para un cadena de longitud cero y otro para un valor. Por ejemplo, puede usar una expresión de formato como la siguiente con la función Format para devolver el valor de cadena correspondiente del código:

Dim varX As Variant
Dim varStrX As Variant
' Assign some value to varStrX and pass to Format function.
varX = Format(varStrX, "@;ZLS;Null")

En Microsoft Access versiones 97 y posteriores, debe comprobar por separado si el caso es null y, a continuación, devolver el valor apropiado basado en el resultado. Por ejemplo, puede usar la función IIf en una expresión con la función Format , como la siguiente:

varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))

Este cambio solo se aplica cuando se usa la función formato para dar formato a una cadena que depende de si se trata de una cadena de longitud cero o de un valor nulo. Otras expresiones de formato usadas con la función Format siguen funcionando como en versiones anteriores.

Si convierte una base de datos de Microsoft Access versión 2,0 o anterior a Microsoft Access 2002 o posterior, debe cambiar el código para comprobar por separado el uso de mayúsculas y minúsculas.

Vea también

Funciones de cadena y cómo usarlas

Ampliar sus conocimientos de Office
Explorar los cursos
Obtener nuevas características primero
Únase a los participantes de Office Insider

¿Le ha sido útil esta información?

¡Gracias por sus comentarios!

Gracias por sus comentarios. Quizá le interese ponerse en contacto con uno de nuestros agentes de soporte de Office.

×