Cálculos y decisiones

La manera recomendada de encontrar la diferencia entre dos fechas, horas o fechas y horas es restarlas

Por ejemplo, MakeDate(26,5,1999) – MakeDate(29,5,1968) arrojará un intervalo de tiempo de 11319.00:00:00

Cuando tiene que encontrar la diferencia en un intervalo de tiempo no fijo que puede variar según la época del año, la función DateDiff proporciona algunos intervalos útiles. Estos se enumeran en la tabla dentro de la función DateAdd que figura a continuación. Si fecha2 > fecha1, el número de la respuesta será positivo.

Si se utiliza Semana del año, el valor de la respuesta representa el número de semanas entre el primer día de la semana que contiene fecha1 y el primer día de la semana que contiene fecha2.

Cuando se utiliza el Día de la semana del intervalo 2, el valor de la respuesta representa la cantidad de semanas calendario completas entre las dos fechas (p. ej., si fecha1 es un lunes, cuenta la cantidad de lunes hasta fecha2 inclusive)

Por ejemplo, si fecha1 es el jueves 2/3/2017 y fecha2 es el martes 7/3/2017 siguiente, DateDiff(1, fecha1, fecha2) con Semana del año dará 1 porque los primeros días de las respectivas semanas calendario están separados por una semana.

Sin embargo, DateDiff(2, fecha1, fecha2) con Día de la semana dará 0, ya que no hay jueves entre fecha1 y fecha2.

Parámetros

Los tres parámetros son los siguientes:

Ejemplos

Para calcular la cantidad de semanas entre el 29/5/1968 y el 26/5/1999, use DateDiff(1, MakeDate(29,5,1968), MakeDate(26,5,1999)). Esto arrojará correctamente 1617.

La forma recomendada de agregar un intervalo a una fecha, hora o fecha y hora es agregar un intervalo de tiempo (TimeSpan)

Por ejemplo, MakeDate(26,5,1999) + MakeTimeSpan(3, 0, 0, 0) arrojaría 29/05/1999.

Por ejemplo, MakeTime(12,30,0) + MakeTimeSpan(0, 1, 5, 3) arrojaría 13:35:03.

Cuando tiene que agregar un intervalo de tiempo no fijo que puede variar según la época del año, la función DateAdd proporciona algunos intervalos útiles. Cada tipo de intervalo está representado por los números que se indican a continuación:

Como se indicó, algunos intervalos no se aplican a la función DateAdd, pero se eligieron para que se pueda usar el mismo conjunto de números para la función DateAdd y la función DateDiff

Por ejemplo, para agregar una cantidad de meses a una fecha, utilice el intervalo número 5. Para agregar 2 meses al 26/5/1999, use DateAdd(5, 2, MakeDate(26,5,1999)). Esto arrojaría correctamente 26/7/1999.

Los intervalos se restan de manera similar con un valor negativo para la cantidad de intervalos; es decir, DateAdd(5, -2, MakeDate(26,5,1999)) arroja 26/3/1999.

La función DateAdd no dará como respuesta una fecha no válida. Por ejemplo, si agregó 1 mes al 31 de enero de 2005 usando DateAdd(5,1,MakeDate(31,1,2005)) la función daría como respuesta 28/2/2005 (en lugar de 31/02/2005, una fecha que no existe).

Esta función se utiliza para dar formato a una fecha y hora de la forma deseada o para extraer un fragmento más pequeño de información (como el día de la semana) de una fecha y hora completa.

Parámetros

Los dos parámetros son los siguientes:

Ejemplos

• FormatDateTime("02-11-2016 09:23:43", "t") dará como resultado "09:23"
• FormatDateTime("02 Nov 2016 09:23:43","F") dará como resultado "02 de nov de 2016 09:23:43"
• FormatDateTime("02-11-2016 21:23:43", "h:m tt") dará como resultado "9:23 p. m."
• FormatDateTime("02-11-2016 21:23:43", "dd/MM/yy HH:m:s") dará como resultado "02/11/16 21:23:43"

Cadenas de formato

• Para obtener una lista completa de las cadenas de formato de fecha y hora estándar, consulte https://msdn.microsoft.com/en-us/library/az4se3k1(v=vs.110).aspx.
• Para obtener más información sobre cómo crear cadenas de formato personalizadas de fecha y hora, consulte https://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.110).aspx.

MakeDate() se utiliza para crear una fecha a partir de números.

Parámetros

Los tres parámetros son los siguientes:

Años de dos dígitos

Por cuestiones de compatibilidad con procesos anteriores, donde estaba permitido, la función MakeDate aceptará años de dos dígitos y los interpretará con la regla 2029. Sin embargo, se recomienda enfáticamente no utilizar nunca esta funcionalidad. Siempre utilice un año completo, incluido el siglo. En el caso de que el año se recupere de otro sistema en dos dígitos, averigüe qué convención está usando ese sistema y aplíquelo en cuanto lea los datos.

Ejemplos

• MakeDate(21,6,2005) dará como resultado la fecha 21 de junio de 2005
• MakeDate(21,6,1995) dará como resultado la fecha 21 de junio de 1995
• MakeDate(5,12,29) dará como resultado la fecha 5 de diciembre de 2029
• MakeDate(5,12,30) dará como resultado la fecha 5 de diciembre de 1930

Sugerencias

La función MakeDate es la forma preferida de formar una nueva fecha, en lugar de usar una cadena como "02/03/2007", que tiene un valor ambiguo según la ubicación actual (es decir, un estadounidense probablemente interpretaría esta fecha de manera diferente a un británico).

Mid() se utiliza para reducir una cadena más larga (es decir, una secuencia de letras) en una cadena más corta contenida en esa cadena (es decir, una subcadena). Por ejemplo, Mid() puede utilizarse para reducir la cadena "Nombre del cliente: John Smith", a la subcadena "John Smith".

Parámetros

Los tres parámetros son:

Sugerencias

Cuando la longitud máxima especificada por el usuario excede la longitud de la cadena suministrada, Blue Prism reducirá esta longitud a la longitud de la cadena suministrada. Por lo tanto, para ahorrarse contar demasiadas letras, a menudo es conveniente escribir un número alto en el último argumento: Mid("Nombre del cliente: John Smith", 16, 100). La cadena "John" se puede obtener usando Mid("Nombre del cliente: John Smith",16,4). Nota: Los argumentos se redondean a números enteros, por lo que Mid("abcdefg", 1.2, 1.8) daría como resultado "ab".

Ejemplos

Mid("Nombre del cliente: John Smith", 16, 25): arroja "John Smith"

Left() se utiliza para devolver las primeras letras de una cadena de letras más larga.

Parámetros

Los dos parámetros son los siguientes:

Sugerencias

Si el valor de caracteres máximos excede el número de caracteres (o es igual a este) en la cadena, la función simplemente arrojará la cadena sin modificar. El valor suministrado a los caracteres máximos puede ser cero si se desea (arroja una cadena vacía), pero no puede ser un número negativo.

Ejemplos

Left("Blue Prism permite a los usuarios empresariales lograr más en menos tiempo", 10) arroja "Blue Prism"

Right() se comporta exactamente igual a Left(), pero arroja la cadena final (con la longitud especificada) en lugar de la cadena inicial.

Instr() comprueba si la subcadena de la cadena más pequeña está incluida en la cadena más larga. Si es así, Instr() arroja el número de caracteres desde la izquierda donde se puede encontrar el primer caso de la subcadena.

Parámetros

Los dos parámetros son los siguientes:

Ejemplos

Instr("Los cálculos son mucho más rápidos con Blue Prism que con un ábaco", "son") arrojará 14 porque la palabra "son" primero ocurre en el decimocuarto carácter.

Sugerencias

Si no se encuentra la subcadena en la cadena, Instr() arrojará cero. Por lo tanto, Instr() es una forma útil de probar la presencia de una cadena más pequeña en una cadena más grande: por ejemplo, Instr("Manzanas", "Bananas") > 0 arrojará FALSO.

Esta función agregará una cierta cantidad de días a una fecha elegida.

Parámetros

Los dos parámetros son los siguientes:

Ejemplos

AddDays("01/01/2006", 10) arrojará la fecha "11/01/2006".

Sugerencias

Al igual que con la función DateAdd(), solo arrojará fechas válidas. Por ejemplo, en un año bisiesto, agregar un día al 28 de febrero dará como resultado el 29 de febrero, mientras que durante cualquier otro año dará como resultado el 1 de marzo.

Esta función agregará una cierta cantidad de meses a una fecha elegida.

Parámetros

Los dos parámetros son los siguientes:

Ejemplos

AddMonths("01/01/2006", 10) arrojará la fecha "01/11/2006".

Sugerencias

Al igual que con la función DateAdd(), solo arrojará fechas válidas. Por ejemplo, si se agrega 1 mes al 31 de enero de 2005 usando AddMonths("31/01/2005",1), arrojaría "28/2/2005" (en lugar de arrojar "31/02/2005", una fecha que no existe).

Esta función mostrará un formato de fecha y hora en formato UTC estandarizado como un elemento de datos de fecha y hora.

Sugerencias

Si desea saber la fecha de hoy, debe usar la función Today(). Para obtener más información, consulte este artículo de la base de conocimientos.

Esta función arrojará la fecha actual como un elemento de datos de fecha.

Sugerencias

Si desea conocer la hora actual junto a la fecha de hoy, debe usar la función Now().

Esta función representará un número en formato de texto. Esto suele ser útil cuando se trata de monedas, cuando los números como el número 1 se representan con más frecuencia como "1.00".

Parámetros

Los dos parámetros son los siguientes:

Ejemplos

• DecPad(1.296,2) arrojará el texto "1.30"
• DecPad(1.1111,2) arrojará el texto "1.11"

Sugerencias

Si la representación natural tiene demasiados decimales, entonces se eliminará el número correspondiente de decimales, mientras se redondea el número a la precisión adecuada.

Esta función redondeará un número hacia abajo al número deseado de posiciones decimales. El tipo de datos del valor obtenido es el número.

Parámetros

Los dos parámetros son los siguientes:

Ejemplos

• RndDn(9.19996,3) arrojará el número 9.199
• RndDn(9.1345,2) arrojará el número 9.13
• RndDn(3.14159,10) arrojaría 3.14159 (el número no cambia)

Sugerencias

Si el número ya está dentro del nivel de precisión deseado, permanecerá sin cambios y, en particular, no se reformateará (como lo haría con la función DecPad). Consulte también las funciones Round y RndUp.

Esta función redondeará un número hacia arriba al número deseado de posiciones decimales; se comporta de manera análoga a la función RndDn().

Parámetros

Los dos parámetros son los siguientes:

Ejemplos

• RndUp(9.19996,3) arrojará el número 9.200
• RndUp(9.1345,2) arrojará el número 9.14
• RndUp(3.14159,10) arrojaría 3.14159 (el número no cambia)

Sugerencias

Si el número ya está dentro del nivel de precisión deseado, permanecerá sin cambios y, en particular, no se reformateará (como lo haría con la función DecPad). Consulte también las funciones Round y RndDn.

Esta función redondeará un número al número más cercano que tenga la cantidad deseada de posiciones decimales.

Parámetros

Los dos parámetros son los siguientes:

Ejemplos

• Round(9.1345,2) arrojará el número 9.13
• Round(9.19996,3) arrojará el número 9.200
• Round(3.14159,10) arrojaría 3.14159 (el número no cambia)

Sugerencias

Si el número ya está dentro del nivel de precisión deseado, permanecerá sin cambios y, en particular, no se reformateará (como lo haría con la función DecPad). Consulte también las funciones RndUp y RndDn.

Esta función arrojará la raíz cuadrada del número suministrado. La raíz cuadrada de un número es el número positivo único que, cuando se multiplica por sí mismo, da como resultado el número con el que comenzó.

Ejemplos

• Sqrt(100) arroja el número 10
• Sqrt(2) arroja 1.4142135623731

Calcula el logaritmo del número para el valor base especificado. Para un valor v y una base b, el logaritmo v para la base b – Log(v, b) escrito – responde la pregunta "¿cuál es el valor x que corresponde a b^x = v?".

Ejemplos

• Log(1000, 10) = 3 porque 10³ = 1000.
• Log(1/4, 2) = -2 porque 2^-2 = 1/4

Esta función arrojará el carácter que representa el código ASCII suministrado.

Ejemplos

• Chr(65) arroja el texto "A"

Sugerencias

Para acceder a una introducción completa al código ASCII, consulte una referencia externa. En la página Código ASCII de Blue Prism, se proporciona una guía rápida.

Esta función arrojará la representación en mayúsculas del texto suministrado. Todas las letras del texto suministrado que ya estén en mayúscula no se modificarán, mientras que las que no estén en mayúscula se cambiarán.

Ejemplos

• Upper("software") arrojará el texto "SOFTWARE"
• Upper("aBcDeFg") arrojará el texto "ABCDEFG"

Sugerencias

Consulte también la función Lower().

Esta función arrojará la representación en minúsculas del texto suministrado. Todas las letras en el texto suministrado que ya estén en minúscula no se modificarán, mientras que aquellas que no estén en minúscula se cambiarán.

Ejemplos

• Lower("SOFTWARE") arrojará el texto "software"
• Lower("aBcDeFg") arrojará el texto "abcdefg"

Sugerencias

Consulte también la función Upper().