Funciones de Project para campos personalizados en el escritorio de Project

Estas funciones se utilizan dentro de fórmulas para calcular los valores de los campos personalizados.

Sugerencia: Para escribir una fórmula en un campo personalizado, haga clic en la pestaña Proyecto y, en el grupo Propiedades , haga clic en Campos personalizados. En el cuadro de diálogo Campos personalizados, haga clic en Fórmula.

Información general sobre funciones de Project

Al usar Microsoft Project, puede que necesite trabajar con valores que no residan directamente en campos. Las fórmulas le permiten trabajar con campos para crear estos valores nuevos.

Los siguientes ejemplos muestran cómo utilizar fórmulas con campos personalizados:

  • Cuando se añade a un campo numérico personalizado, la siguiente fórmula devuelve un valor numérico que indica el número de días que hay entre la fecha de hoy y la fecha de finalización de las tareas de su programación:

DateDiff("d",NOW(),[Finish])

  • Cuando se añade a un campo numérico personalizado, la siguiente fórmula devuelve un valor "Sin línea base", "Presupuesto sobrepasado en un 20% o más" o "Por debajo del presupuesto":

    Switch(Len(CStr([Baseline Finish]))<3, "No baseline", ([Cost]+1)/ ([Baseline Cost]+1)>1.2,"Overbudget by 20% or more", ([Cost]+1)/([Baseline Cost]+1)>1, "Overbudget",True,"Under budget")
     The CStr function in the above formula works only if the [Baseline Finish] field is defined.
    

Funciones de conversión

Asc

Devuelve un tipo de datos Integer que representa el código de carácter correspondiente a la primera letra de una cadena.

Sintaxis

Asc( cadena )

cadena  Cualquier expresión de cadena válida.

CBool

Convierte una expresión en tipo de datos Boolean.

Sintaxis

CBool( expr )

expr  Cualquier cadena o expresión numérica válida.

CByte

Convierte una expresión en tipo de datos Byte.

Sintaxis

CByte( expr )

expr  Cualquier valor Integer entre 0 y 255.

CCur

Convierte una expresión en tipo de datos Currency.

Sintaxis

CCur( expr )

expr  Cualquier expresión numérica entre -922.337.203.685.477,5808 y 922.337.203.685.477,5807.

CDate

Convierte una expresión en tipo de datos Date.

Sintaxis

CDate( expr )

expr  Cualquier expresión de fecha válida.

CDbl

Convierte una expresión en tipo de datos Double.

Sintaxis

CDbl( expr )

expr  Cualquier expresión numérica entre -1,79769313486232E308 y -4,94065645841247E-324 para valores negativos o entre 4,94065645841247E-324 y 1,79769313486232E308 para valores positivos.

CDec

Convierte una expresión en tipo de datos Decimal.

Sintaxis

CDec( expr )

expr  Cualquier expresión numérica a partir de +/-79.228.162.514,264.337.593.543.950.335 para números en escala de cero (es decir, sin decimales). Para números con 28 decimales, el intervalo es +/-7,9228162514264337593543950335. El número distinto de cero más pequeño posible es 0,0000000000000000000000000001.

Chr

Devuelve un tipo de datos String que contiene el carácter asociado con el código de carácter especificado.

Sintaxis

Chr( códcar )

códcar  Un tipo de datos Long que identifica un carácter.

CInt

Convierte una expresión en tipo de datos Integer.

Sintaxis

CInt( expr )

expresión  Cualquier expresión numérica entre -32.768 y 32.767; fracciones se redondea.

CLng

Convierte una expresión en tipo de datos Long.

Sintaxis

CLng( expr )

expresión  Cualquier expresión numérica entre -2.147.483.648 y 2.147.483.647; fracciones se redondea.

CSng

Convierte una expresión en tipo de datos Single.

Sintaxis

CSng( expr )

expr  Cualquier expresión numérica entre -3,402823E38 y -1,401298E-45 para valores negativos y entre 1,401298E-45 y 3,402823E38 para valores positivos.

CStr

Convierte una expresión en tipo de datos String.

Sintaxis

CStr( expr )

expr  Cualquier cadena o expresión numérica válida.

CVar

Convierte una expresión en tipo de datos Variant.

Sintaxis

CVar( expr )

Mismo intervalo que  Double para los valores numéricos. Mismo intervalo que String para los valores no numéricos.

DateSerial

Devuelve un tipo de dato Variant (Date) para un año, mes y día especificados.

Sintaxis

DateSerial( año, mes, día )

año  Obligatorio; Integer. Número entre 100 y 9999 (ambos inclusive) o una expresión numérica.

mes  Obligatorio; Integer. Cualquier expresión numérica.

día  Obligatorio; Integer. Cualquier expresión numérica.

DateValue

Devuelve un tipo de dato Variant (Date).

Sintaxis

DateValue(fecha)

fecha  Obligatorio; normalmente una expresión de cadena que representa una fecha entre el 1 de enero de 100 y el 31 de diciembre de 9999. Sin embargo, fecha también puede ser cualquier expresión que pueda representar una fecha, una hora o una fecha y una hora, en ese intervalo.

Day

Devuelve un tipo de dato Variant (Integer) que especifica un número completo entre 1 y 31, ambos inclusive, que representa el día del mes.

Sintaxis

Day( fecha)

fecha  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una fecha. Si fecha contiene un valor Null, se devolverá Null.

Hex

Devuelve un tipo de datos String que representa el valor hexadecimal de un número.

Sintaxis

Hex( número )

número  Obligatorio; cualquier cadena o expresión numérica válida.

Hour

Devuelve un tipo de datos Variant (Integer) que especifica un número entero entre 0 y 23 (ambos inclusive) y representa la hora del día.

Sintaxis

Hour( hora)

hora  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una hora. Si hora contiene un valor Null, se devolverá Null.

Minute

Devuelve un valor de tipo Variant (Integer) que especifica un número entero entre 0 y 59, ambos inclusive, que representa el minuto de la hora.

Sintaxis

Minute( hora)

hora  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una hora. Si hora contiene un valor Null, se devolverá Null.

Month

Devuelve un valor de tipo Variant (Integer) que especifica un número entero entre 1 y 12, ambos inclusive, y representa el mes del año.

Sintaxis

Month( fecha)

fecha  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una hora. Si fecha contiene un valor Null, se devolverá Null.

Oct

Devuelve un valor de tipo Variant (String) que representa el valor octal de un número.

Sintaxis

Oct( número )

número  Obligatorio; cualquier cadena o expresión numérica válida.

ProjDateConv

Convierte un valor en una fecha.

Sintaxis

ProjDateConv( expr, formato_fecha )

expresión  Obligatorio; Variant. La expresión que se va a convertir en una fecha.

formato_fecha  Opcional; Long. El formato de fecha predeterminado es pjDateDefault, pero puede sustituir una de las siguientes constantes pjDateFormat (formato de fecha aplicado 25/9/07 a las 12:33 p. m.):

  • pjDateDefault: el formato predeterminado. Se establece en la pestaña Vista del cuadro de diálogo Opciones (menú Herramientas).

  • pjDate_mm_dd_aa_hh_mmAM: 25/9/07 12:33 p. m.

  • pjDate_mm_dd_aa: 9/25/07

  • pjDate_mm_dd_aaaa: 9/25/2007

  • pjDate_mmmm_dd_aaaa_hh_mmAM: 25 de septiembre de 2007, 12:33 p. m.

  • pjDate_mmmm_dd_aaaa: 25 de septiembre de 2007

  • pjDate_mmm_dd_hh_mmAM: 25 sep, 12:33 p. m.

  • pjDate_mmm_dd_aaa: 25 sep '07

  • pjDate_mmmm_dd: 25 de septiembre

  • pjDate_mmm_dd: 25 sep

  • pjDate_ddd_mm_dd_aa_hh_mmAM: Mar 25/9/07, 12:33 p. m.

  • pjDate_ddd_mm_dd_aa: Mar 25/9/07

  • pjDate_ddd_mmm_dd_aaa: Mar 25 sep '07

  • pjDate_ddd_hh_mmAM: Mar 12:33 p. m.

  • pjDate_mm_dd: 25/9

  • pjDate_dd: 25

  • pjDate_hh_mmAM: 12:33 p. m.

  • pjDate_ddd_mmm_dd: Mar 25 sep

  • pjDate_ddd_mm_dd: Mar 25/9

  • pjDate_ddd_dd: Mar 25

  • pjDate_Www_dd: S40/2

  • pjDate_Www_dd_aa_hh_mmAM: S40/2/07, 12:33 p. m.

ProjDurConv

Convierte una expresión en un valor de duración en las unidades especificadas.

Sintaxis

ProjDurConv( expresión, unidades_duración )

expresión  Obligatorio; Variant. La expresión que se va a convertir en duración.

unidades_duración  Opcional; Long. Las unidades usadas para expresar la duración. Si no se especifica un valor para unidades_duración, el valor predeterminado será el tipo de unidades especificado en la opción Mostrar duración en de la pestaña Programación, en el cuadro de diálogo Opciones del menú Herramientas. El valor de unidades_duración puede ser una de las siguientes constantes de pjFormatUnit:

  • pjMinutes: pjElapsedMinutes

  • pjHours: pjElapsedHours

  • pjDays: pjElapsedDays

  • pjWeeks: pjElapsedWeeks

  • pjMonths: pjElapsedMonths

  • pjMinutesEstimated: pjElapsedMinutesEstimated

  • pjHoursEstimated: pjElapsedHoursEstimated

  • pjDaysEstimated: pjElapsedDaysEstimated

  • pjWeeksEstimated: pjElapsedWeeksEstimated

  • pjMonthsEstimated: pjElapsedMonthsEstimated

Second

Devuelve un valor de tipo Variant (Integer) que especifica un número entero entre 0 y 59, ambos inclusive, que representa el segundo del minuto.

Sintaxis

Second( hora)

hora  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una hora. Si hora contiene un valor Null, se devolverá Null.

Str

Devuelve un valor de tipo Variant (String) que representa un número.

Sintaxis

Str( número )

número  Obligatorio; tipo de datos Long que contiene cualquier expresión numérica válida.

StrConv

Devuelve un valor de tipo Variant (String) que se ha convertido según lo especificado.

Sintaxis

StrConv( cadena, conversión, código_idioma )

cadena  Obligatorio; expresión de cadena que se va a convertir.

conversión  Obligatorio; Entero. La suma de valores que especifican el tipo de conversión que se va a realizar.

código_idioma  Opcional; el identificador de configuración regional, si es diferente del identificador de configuración regional del sistema. (El del sistema es el predeterminado.)

TimeSerial

Devuelve un tipo de datos Variant (Date) que contiene la hora para una hora, minuto y segundo concretos.

Sintaxis

TimeSerial( hora, minuto, segundo)

Hora  Obligatorio; Variant (Integer). Número entre 0 (12:00 a.m.) y 23 (11:00 p.m.), ambos inclusive, o una expresión numérica.

minuto  Obligatorio; Variant (Integer). Cualquier expresión numérica.

segundo  Obligatorio; Variant (Integer). Cualquier expresión numérica.

TimeValue

Devuelve un tipo de datos Variant (Date) que contiene la hora.

Sintaxis

TimeValue( hora)

hora  Obligatorio; normalmente una expresión de cadena que representa una hora entre las 0:00:00 (12:00:00 a.m.) y las 23:59:59 (11:59:59 p.m.), ambos inclusive. Sin embargo, el tiempo también puede ser cualquier expresión que represente una hora de ese intervalo. Si hora contiene un valor Null, se devolverá Null.

Val

Devuelve los números incluidos en una cadena como un valor numérico del tipo apropiado.

Sintaxis

Val( cadena )

cadena  Obligatorio; cualquier expresión de cadena válida.

Weekday

Devuelve un valor de tipo Variant (Integer) que contiene un número entero que representa el día de la semana.

Sintaxis

Weekday( fecha[, primer_día_semana] )

fecha  Obligatorio; Variant, expresión numérica, expresión de cadena o cualquier combinación de ellas que pueda representar una fecha. Si fecha contiene un valor Null, se devolverá Null.

primer_día_semana  Opcional; una constante que especifica el primer día de la semana. Si no se especifica ningún valor, se supone que es el domingo.

Year

Devuelve un valor de tipo Variant (Integer) que contiene un número entero que representa el año.

Sintaxis

Year( fecha )

fecha  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una fecha. Si fecha contiene un valor Null, se devolverá Null.

Funciones de fecha y hora

CDate

Convierte una expresión en tipo de datos Date.

Sintaxis

CDate( expr )

expr  Cualquier expresión de fecha válida.

Date

Devuelve un tipo de dato Variant (Date) que contiene la fecha actual de sistema.

Sintaxis

Date

DateAdd

Devuelve un tipo de dato Variant (Date) que contiene una fecha a la que se ha agregado un intervalo de tiempo especificado.

Sintaxis

DateAdd( intervalo, número, fecha )

intervalo  Obligatorio; expresión de cadena que es el intervalo de tiempo que se desea agregar, como "m" o "d" .

número  Obligatorio; expresión numérica que es el número de intervalos que se desea agregar. Puede ser positivo (para obtener fechas en el futuro) o negativo (para obtener fechas en el pasado).

fecha  Obligatorio; Variant (Date) o texto literal que representa la fecha a la que se agrega el intervalo.

DateDiff

Devuelve un tipo de datos Variant (Long) que especifica el número de intervalos de tiempo entre las dos fechas especificadas.

Sintaxis

DateDiff( intervalo, fecha1, fecha2[, primer_día_semana[, primera_semana_año]] )

intervalo  Obligatorio; expresión de cadena que es el intervalo de tiempo empleado para calcular la diferencia entre fecha1 y fecha2.

fecha1, fecha2  Obligatorio; Variant (Date). Dos fechas que se desea utilizar en el cálculo.

primer_día_semana  Opcional; una constante que especifica el primer día de la semana. Si no se especifica ningún valor, se supone que es el domingo.

primera_semana_año  Opcional; una constante que especifica la primera semana del año. Si no se especifica, se entiende que la primera semana es aquella que contiene el día 1 de enero.

DatePart

Devuelve un tipo de dato Variant (Integer) que contiene la parte especificada de una fecha dada.

Sintaxis

DatePart( intervalo, fecha[, primer_día_semana[, primera_semana_año]] )

intervalo  Obligatorio; expresión de cadena que es el intervalo de tiempo que se desea devolver.

fecha  Obligatorio; valor Variant (Date) que se desea evaluar.

primer_día_semana  Opcional; una constante que especifica el primer día de la semana. Si no se especifica ningún valor, se supone que es el domingo.

primera_semana_año  Opcional; una constante que especifica la primera semana del año. Si no se especifica, se entiende que la primera semana es aquella que contiene el día 1 de enero.

DateSerial

Devuelve un tipo de dato Variant (Date) para un año, mes y día especificados.

Sintaxis

DateSerial( año, mes, día )

año  Obligatorio; Integer. Número entre 100 y 9999 (ambos inclusive) o una expresión numérica.

mes  Obligatorio; Integer. Cualquier expresión numérica.

día  Obligatorio; Integer. Cualquier expresión numérica.

DateValue

Devuelve un tipo de dato Variant (Date).

Sintaxis

DateValue( fecha)

fecha  Obligatorio; normalmente una expresión de cadena que representa una fecha entre el 1 de enero de 100 y el 31 de diciembre de 9999. Sin embargo, fecha también puede ser cualquier expresión que pueda representar una fecha, una hora o una fecha y una hora, en ese intervalo.

Day

Devuelve un tipo de dato Variant (Integer) que especifica un número completo entre 1 y 31, ambos inclusive, que representa el día del mes.

Sintaxis

Day( fecha)

fecha  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una fecha. Si fecha contiene un valor Null, se devolverá Null.

Hour

Devuelve un tipo de datos Variant (Integer) que especifica un número entero entre 0 y 23 (ambos inclusive) y representa la hora del día.

Sintaxis

Hour( hora)

hora  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una hora. Si hora contiene un valor Null, se devolverá Null.

IsDate

Devuelve un valor de tipo Boolean que indica si una expresión puede convertirse en una fecha.

Sintaxis

IsDate( expr )

expr  Obligatorio; cualquier tipo de datos Variant que contenga una expresión de fecha o de cadena reconocible como una fecha o una hora.

Minute

Devuelve un valor de tipo Variant (Integer) que especifica un número entero entre 0 y 59, ambos inclusive, que representa el minuto de la hora.

Sintaxis

Minute( hora)

hora  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una hora. Si hora contiene un valor Null, se devolverá Null.

Month

Devuelve un valor de tipo Variant (Integer) que especifica un número entero entre 1 y 12, ambos inclusive, y representa el mes del año.

Sintaxis

Month( fecha)

fecha  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una hora. Si fecha contiene un valor Null, se devolverá Null.

Now

Devuelve un valor de tipo Variant (Date) que especifica la fecha y la hora actuales conforme a la fecha y la hora del sistema del equipo.

Sintaxis

Now

ProjDateAdd

Agrega una duración a una fecha y devuelve una nueva fecha.

Sintaxis

ProjDateAdd( fecha, duración, calendario )

fecha  Obligatorio; Variant. La fecha original a la que se agrega la duración.

duración  Obligatorio; Variant. La duración que se agrega a una fecha.

calendario  Opcional; String. El calendario que se utiliza al calcular la nueva fecha. Si no se especifica calendario, el valor predeterminado para el recurso actual será el calendario del recurso, y para la tarea actual, el calendario de la tarea o el calendario estándar si no hay ningún calendario. En Project Server se utilizará el calendario estándar independientemente de qué calendario se especifique en la cadena calendario. Si utiliza esta función en una fórmula creada en Project Web App y la compara con la misma fórmula creada en Project Professional, deberá hacer pruebas para comprobar si obtiene los resultados esperados.

ProjDateConv

Convierte un valor en una fecha.

Sintaxis

ProjDateConv( expr, formato_fecha )

expresión  Obligatorio; Variant. La expresión que se va a convertir en una fecha.

formato_fecha  Opcional; Long. El formato de fecha predeterminado es pjDateDefault, pero puede sustituir una de las siguientes constantes pjDateFormat (formato de fecha aplicado 25/9/07 a las 12:33 p. m.):

  • pjDateDefault: el formato predeterminado. Se establece en la pestaña Vista del cuadro de diálogo Opciones (menú Herramientas).

  • pjDate_mm_dd_aa_hh_mmAM: 25/9/07 12:33 p. m.

  • pjDate_mm_dd_aa: 9/25/07

  • pjDate_mm_dd_aaaa: 9/25/2007

  • pjDate_mmmm_dd_aaaa_hh_mmAM: 25 de septiembre de 2007, 12:33 p. m.

  • pjDate_mmmm_dd_aaaa: 25 de septiembre de 2007

  • pjDate_mmm_dd_hh_mmAM: 25 sep, 12:33 p. m.

  • pjDate_mmm_dd_aaa: 25 sep '07

  • pjDate_mmmm_dd: 25 de septiembre

  • pjDate_mmm_dd: 25 sep

  • pjDate_ddd_mm_dd_aa_hh_mmAM: Mar 25/9/07, 12:33 p. m.

  • pjDate_ddd_mm_dd_aa: Mar 25.09.03

  • pjDate_ddd_mmm_dd_aaa: Mar 25 sep '07

  • pjDate_ddd_hh_mmAM: Mar 12:33 p. m.

  • pjDate_mm_dd: 25/9

  • pjDate_dd: 25

  • pjDate_hh_mmAM: 12:33 p. m.

  • pjDate_ddd_mmm_dd: Mar 25 sep

  • pjDate_ddd_mm_dd: Mar 25/9

  • pjDate_ddd_dd: Mar 25

  • pjDate_Www_dd: S40/2

  • pjDate_Www_dd_aa_hh_mmAM: S40/2/07, 12:33 p. m.

ProjDateDiff

Devuelve la duración entre dos fechas en minutos.

Sintaxis

ProjDateDiff( fecha1, fecha2, calendario)

fecha1  Obligatorio; Variant. La fecha que se utiliza como comienzo de la duración.

fecha2  Obligatorio; Variant. La fecha que se utiliza como final de la duración.

calendario  Opcional; Cadena. El calendario que se usará al calcular la duración. Si no se especifica calendario , el valor predeterminado para el recurso actual es el calendario de recursos, o para la tarea actual, el calendario de tareas (o el calendario estándar si no hay ningún calendario de tareas para Project Server, se usará el calendario estándar, independientemente del calendario especificado en la cadena de calendario . Si utiliza esta función en una fórmula creada en Project Web App y la compara con la misma fórmula creada en Project Professional, deberá hacer pruebas para comprobar si obtiene los resultados esperados.

ProjDateSub

Devuelve la fecha que precede a otra fecha con una duración especificada.

Sintaxis

ProjDateSub( fecha, duración, calendario )

fecha  Obligatorio; Variant. La fecha original de la que se resta la duración.

duración  Obligatorio; Variant. La duración que se resta de la fecha.

calendario  Opcional; Cadena. El calendario que se utiliza al calcular la diferencia entre fechas. Si no se especifica calendario, el valor predeterminado para el recurso actual será el calendario del recurso y, para la tarea actual, el calendario de la tarea (o el calendario estándar si no hay ningún calendario de tareas). En Project Server se utilizará el calendario estándar independientemente de qué calendario se especifique en la cadena calendario. Si utiliza esta función en una fórmula creada en Project Web App y la compara con la misma fórmula creada en Project Professional, deberá hacer pruebas para comprobar si obtiene los resultados esperados.

ProjDateValue

Devuelve el valor de fecha de una expresión.

Sintaxis

ProjDateValue( expr)

expr  Obligatorio; Variant. La expresión que se representará como fecha.

ProjDurConv

Convierte una expresión en un valor de duración en las unidades especificadas.

Sintaxis

ProjDurConv( expresión, unidades_duración )

expresión  Obligatorio; Variant. La expresión que se va a convertir en duración.

unidades_duración  Opcional; Long. Las unidades usadas para expresar la duración. Si no se especifica un valor para unidades_duración, el valor predeterminado será el tipo de unidades especificado en la opción Mostrar duración en de la pestaña Programación, en el cuadro de diálogo Opciones del menú Herramientas. El valor de unidades_duración puede ser una de las siguientes constantes de pjFormatUnit:

  • pjMinutes: pjElapsedMinutes

  • pjHours: pjElapsedHours

  • pjDays: pjElapsedDays

  • pjWeeks: pjElapsedWeeks

  • pjMonths: pjElapsedMonths

  • pjMinutesEstimated: pjElapsedMinutesEstimated

  • pjHoursEstimated: pjElapsedHoursEstimated

  • pjDaysEstimated: pjElapsedDaysEstimated

  • pjWeeksEstimated: pjElapsedWeeksEstimated

  • pjMonthsEstimated: pjElapsedMonthsEstimated

ProjDurValue

Devuelve el número de minutos de una duración.

Sintaxis

ProjDurValue( duración)

duración  Obligatorio; Variant. La duración que se expresará en minutos.

Second

Devuelve un valor de tipo Variant (Integer) que especifica un número entero entre 0 y 59, ambos inclusive, que representa el segundo del minuto.

Sintaxis

Second( hora)

hora  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una hora. Si hora contiene un valor Null, se devolverá Null.

Time

Devuelve un valor de tipo Variant (Fecha) que indica la hora actual del sistema.

Sintaxis

Time

Timer

Devuelve un valor de tipo Single que representa el número de segundos transcurridos desde la medianoche.

Sintaxis

Cronómetro

TimeSerial

Devuelve un tipo de datos Variant (Date) que contiene la hora para una hora, minuto y segundo concretos.

Sintaxis

TimeSerial( hora, minuto, segundo)

Hora  Obligatorio; Variant (Integer). Número entre 0 (12:00 a.m.) y 23 (11:00 p.m.), ambos inclusive, o una expresión numérica.

minuto  Obligatorio; Variant (Integer). Cualquier expresión numérica.

segundo  Obligatorio; Variant (Integer). Cualquier expresión numérica.

TimeValue

Devuelve un tipo de datos Variant (Date) que contiene la hora.

Sintaxis

TimeValue( hora)

hora  Obligatorio; normalmente una expresión de cadena que representa una hora entre las 0:00:00 (12:00:00 a.m.) y las 23:59:59 (11:59:59 p.m.), ambos inclusive. Sin embargo, el tiempo también puede ser cualquier expresión que represente una hora de ese intervalo. Si hora contiene un valor Null, se devolverá Null.

Weekday

Devuelve un valor de tipo Variant (Integer) que contiene un número entero que representa el día de la semana.

Sintaxis

Weekday( fecha[, primer_día_semana] )

fecha  Obligatorio; Variant, expresión numérica, expresión de cadena o cualquier combinación de ellas que pueda representar una fecha. Si fecha contiene un valor Null, se devolverá Null.

primer_día_semana  Opcional; una constante que especifica el primer día de la semana. Si no se especifica ningún valor, se supone que es el domingo.

Year

Devuelve un valor de tipo Variant (Integer) que contiene un número entero que representa el año.

Sintaxis

Year( fecha )

fecha  Obligatorio; cualquier tipo de datos Variant, expresión numérica, expresión de cadena o combinación de ellas que pueda representar una fecha. Si fecha contiene un valor Null, se devolverá Null.

Funciones generales

Choose

Selecciona y devuelve un valor de una lista de argumentos.

Sintaxis

Choose( índice, opción-1[, opción-2, ... [, opción-n]])

índice  Obligatorio; campo o expresión numérica que da como resultado un valor entre 1 y el número de opciones disponibles.

opción  Obligatorio; expresión de tipo Variant que contiene una de las posibles opciones.

IIf

Devuelve una de dos partes dependiendo de la evaluación de una expresión.

Sintaxis

IIf( expr, parte_verdadera, parte_falsa )

expr  Obligatorio; expresión tipo Variant que se desea evaluar.

parte_verdadera  Obligatorio; valor o expresión que se devolverá si la expresión correspondiente tiene un valor True.

parte_falsa  Obligatorio; valor o expresión que se devolverá si la expresión correspondiente tiene un valor False.

IsNumeric

Devuelve un valor Boolean que indica si una expresión puede evaluarse como número.

Sintaxis

IsNumeric( expr)

expresión  Obligatorio; Variant que contiene una expresión numérica o de cadena.

IsNull

Devuelve un valor Boolean que indica si una expresión no contiene datos válidos (Null).

Sintaxis

IsNull( expresión )

expresión  Obligatorio; Variant que contiene una expresión numérica o de cadena.

Switch

Evalúa una lista de expresiones y devuelve un tipo de datos Variant o una expresión asociada con la primera expresión de la lista que tenga el valor True.

Sintaxis

Switch( expr-1, valor-1[, expr-2, valor-2, ... [, expr-n,valor-n]] )

Funciones matemáticas

Abs

Devuelve un valor del mismo tipo que se le haya pasado y que especifica el valor absoluto de un número.

Sintaxis

Abs( número )

número  Obligatorio; cualquier expresión numérica válida. Si número contiene Null, se devolverá Null; si es una variable no inicializada, se devolverá el valor cero.

Atn

Devuelve un valor Double que especifica el arco tangente de un número.

Sintaxis

Atn( número )

número  Obligatorio; tipo de datos Double o cualquier expresión numérica válida.

Cos

Devuelve un tipo de dato Double que especifica el coseno de un ángulo.

Sintaxis

Cos( número )

número  Obligatorio; Double o cualquier expresión numérica válida que exprese un ángulo en radianes.

Exp

Devuelve un tipo de dato Double que especifica el número e (base de los logaritmos naturales) elevado a una potencia.

Sintaxis

Exp( número )

número  Obligatorio; tipo de datos Double o cualquier expresión numérica válida.

Fix

Devuelve la parte entera de un número. Si el número es negativo, devuelve el primer entero negativo igual o mayor a número.

Sintaxis

Fix( número )

número  Obligatorio; tipo de datos Double o cualquier expresión numérica válida. Si número contiene Null, se devolverá Null.

Int

Devuelve la parte entera de un número. Si número es negativo, devuelve el primer entero negativo menor o igual a número.

Sintaxis

Int( número )

número  Obligatorio; tipo de datos Double o cualquier expresión numérica válida. Si número contiene Null, se devolverá Null.

Log

Devuelve un tipo de datos Double que especifica el logaritmo natural de un número.

Sintaxis

Log( número )

número  Obligatorio; tipo de datos Double o cualquier expresión numérica mayor que cero.

Rnd

Devuelve un tipo de datos Single que contiene un número aleatorio.

Sintaxis

Rnd( número )

número  Obligatorio; tipo de datos Single o cualquier expresión numérica válida.

Sgn

Devuelve un valor de tipo Variant (Integer) que indica el signo de un número.

Sintaxis

Sgn( número )

número  Obligatorio; cualquier expresión numérica válida.

Los valores devueltos son los siguientes:

  • Si el número es mayor que cero, Sgn devuelve 1.

  • Si el número es igual a cero, Sgn devuelve 0.

  • Si el número es menor que cero, Sgn devuelve -1.

Sin

Devuelve un tipo de datos Double que especifica el seno de un número.

Sintaxis

Sin( número )

número  Obligatorio; tipo de datos Double o cualquier expresión numérica válida que exprese un ángulo en radianes.

Sqr

Devuelve un tipo de datos Double que especifica la raíz cuadrada de un número.

Sintaxis

Sqr( número )

número  Obligatorio; tipo de datos Double o cualquier expresión numérica igual o mayor que cero.

Tan

Devuelve un tipo de valor Double que especifica la tangente de un número.

Sintaxis

Tan( número )

número  Obligatorio; tipo de datos Double o cualquier expresión numérica válida que exprese un ángulo en radianes.

Funciones de texto

Asc

Devuelve un tipo de datos Integer que representa el código de carácter correspondiente a la primera letra de una cadena.

Sintaxis

Asc( cadena )

Cadena  Cualquier expresión de cadena válida.

Chr

Devuelve un tipo de datos String que contiene el carácter asociado con el código de carácter especificado.

Sintaxis

Chr( códcar )

códcar  Un tipo de datos Long que identifica un carácter.

Format

Devuelve un tipo de dato Variant (String) que contiene una expresión con formato conforme a las indicaciones incluidas en una expresión de formato.

Sintaxis

Format( expresión[, formato[, primer_día_semana[, primera_semana_año]]] )

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; una Constant que especifica el primer día de la semana.

primera_semana_año  Opcional; una Constant que especifica la primera semana del año.

Instr

Devuelve un valor de tipo Variant (Long) que especifica la posición de la primera aparición de una cadena dentro de otra.

Sintaxis

Instr( [inicio, ]cadena1, cadena2[, comparar] )

inicio  Opcional; expresión numérica que establece la posición de inicio de cada búsqueda. Si se omite, la búsqueda comienza en la posición del primer carácter. Si inicio contiene Null, se producirá un error. El argumento inicio es necesario si se especifica comparar.

cadena1  Obligatorio; la expresión de cadena que se está buscando.

cadena2  Obligatorio; la expresión de cadena en la que se está haciendo la búsqueda.

comparar  Opcional; especifica el tipo de comparación de cadena. Si comparar es Null, se producirá un error. Si comparar se omite, el valor Opcióncomparar determinará el tipo de comparación.

LCase

Devuelve un tipo de datos String que se ha convertido a minúsculas.

Sintaxis

LCase( cadena )

cadena   Obligatorio; cualquier expresión de cadena válida. Si cadena contiene Null, se devolverá Null.

Left

Devuelve un valor de tipo Variant (String) que contiene un número específico de caracteres a partir del lado izquierdo de una cadena.

Sintaxis

Left( cadena, largo )

cadena  Obligatorio. Expresión de cadena de la cual se devuelven los caracteres situados más a la izquierda. Si cadena contiene Null, se devolverá Null.

longitud  Obligatorio; tipo de datos Variant (Long). Expresión numérica que indica cuántos caracteres devolver. Si es 0, se devolverá una cadena de longitud cero (""). Si es mayor o igual que el número de caracteres de cadena, se devolverá toda la cadena.

Len

Devuelve un tipo de datos Long que contiene el número de caracteres de una cadena o el número de bytes necesarios para almacenar una variable.

Sintaxis

Len( cadena, nombrevar )

cadena  Cualquier expresión de cadena válida. Si cadena contiene Null, se devolverá Null.

nombrevar  Cualquier nombre de variable válido. Si nombrevar contiene Null, se devolverá Null. Si nombrevar es un tipo de datos Variant, Len lo tratará como si fuera un tipo de datos String y devolverá siempre el número de caracteres que contenga.

LTrim

Devuelve un tipo de datos Variant (String) que contiene una copia de una cadena especificada sin espacios a la izquierda.

Sintaxis

LTrim( cadena )

cadena  Obligatorio; cualquier expresión de cadena válida. Si cadena contiene un valor Null, se devolverá Null.

Mid

Devuelve un valor de tipo Variant (String) que contiene un número especificado de caracteres de una cadena.

Sintaxis

Mid( cadena, inicio[, largo] )

cadena  Obligatorio; expresión de cadena de la cual se devuelven caracteres. Si cadena contiene un valor Null, se devolverá Null.

inicio  Obligatorio; Largo. Posición del carácter de la cadena donde comienza la parte que se desea seleccionar. Si inicio es mayor que el número de caracteres de cadena, Mid devolverá una cadena de longitud cero ("").

largo  Opcional; tipo de datos Variant (Largo). Número de caracteres que se va a devolver. Si se omite o en el texto hay menos caracteres que los de largo (incluyendo el carácter de inicio), se devolverán todos los caracteres desde la posición inicio hasta el final de la cadena.

Right

Devuelve un valor de tipo Variant (String) que contiene un número especificado de caracteres del lado derecho de una cadena.

Sintaxis

Right( cadena, largo )

cadena  Obligatorio; expresión de cadena de la cual se devuelven los caracteres situados más a la derecha. Si cadena contiene un valor Null, se devolverá Null.

longitud  Obligatorio; tipo de datos Variant (Long). Expresión numérica que indica cuántos caracteres devolver. Si es 0, se devolverá una cadena de longitud cero (""). Si es mayor o igual que el número de caracteres de cadena, se devolverá toda la cadena.

RTrim

Devuelve un tipo de datos Variant (String) que contiene una copia de una cadena especificada sin espacios finales.

Sintaxis

RTrim( cadena )

cadena  Obligatorio; cualquier expresión de cadena válida. Si cadena contiene Null, se devolverá Null.

Space

Devuelve un valor de tipo Variant (String) que se compone del número especificado de espacios.

Sintaxis

Space( número )

número  Obligatorio; número de espacios que se desea en la cadena.

StrComp

Devuelve un valor de tipo Variant (Integer) que indica el resultado de una comparación de cadena .

Sintaxis

StrComp( cadena1, cadena2[, comparar] )

cadena1  Obligatorio; cualquier expresión de cadena válida.

cadena2  Obligatorio; cualquier expresión de cadena válida.

comparar  Opcional; especifica el tipo de comparación de cadena. Si el argumento comparar es Null, se producirá un error.

StrConv

Devuelve un valor de tipo Variant (String) que se ha convertido según lo especificado.

Sintaxis

StrConv( cadena, conversión, código_idioma )

cadena  Obligatorio; expresión de cadena que se va a convertir.

conversión  Obligatorio; Entero. La suma de valores que especifican el tipo de conversión que se va a realizar.

código_idioma  Opcional; el identificador de configuración regional, si es diferente del identificador de configuración regional del sistema. (El del sistema es el predeterminado.)

String

Devuelve un valor de tipo Variant (String) que contiene una cadena de caracteres repetidos con la longitud especificada.

Sintaxis

String( número, carácter )

número  Obligatorio; tipo de datos Long. Longitud de la cadena devuelta. Si el número contiene Null, se devolverá Null.

character  Obligatorio; tipo de datos Variant. Código de carácter que especifica el carácter o expresión de cadena cuyo primer carácter se utiliza para crear la cadena devuelta. Si carácter contiene Null, se devolverá Null.

Trim

Devuelve un tipo de datos Variant (String) que contiene una copia de una cadena especificada sin espacios a la izquierda ni finales.

Sintaxis

Trim( cadena )

cadena  Obligatorio; cualquier expresión de cadena válida. Si cadena contiene Null, se devolverá Null.

UCase

Devuelve un tipo de datos Variant (String) que contiene la cadena especificada, convertida a mayúsculas.

Sintaxis

UCase( cadena )

cadena  Obligatorio; cualquier expresión de cadena válida. Si cadena contiene Null, se devolverá Null.

¿Necesita más ayuda?

¿Quiere más opciones?

Explore las ventajas de las suscripciones, examine los cursos de aprendizaje, aprenda a proteger su dispositivo y mucho más.

Las comunidades le ayudan a formular y responder preguntas, enviar comentarios y leer a expertos con conocimientos extensos.