Información general de las expresiones de datos calculados

Añade el número de días a la fecha. El valor numérico puede incluir días parciales. Por ejemplo, 1,5 añade un día y medio a la fecha.

La expresión tiene el siguiente formato:

ADDDAYS(date, number)

Añade el número de días de la semana a la fecha. Esta expresión solo añade valores enteros a la fecha, redondeando hacia abajo.

La expresión tiene el siguiente formato:

ADDWEEKDAYS(date, number)

Añade el número de meses a la fecha y tiene el siguiente formato:

ADDMONTHS(date, number)

Añade el número de años a la fecha y tiene el siguiente formato:

ADDYEARS(date, number)

Añade el número de horas a la fecha y tiene el siguiente formato:

ADDHOUR(date, number)

Nota: Esta expresión no se admite en Workfront Planning.

Borra la parte de hora de una fecha y tiene el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

CLEARTIME({entryDate})

Convierte una cadena en una fecha y tiene el siguiente formato:

DATE(string)

Devuelve el número de días entre las dos fechas, teniendo en cuenta los días de inicio y de finalización del periodo seleccionado, así como las marcas de tiempo de esos días. Por ejemplo, si la hora de inicio de la fecha de inicio son las 15:00 h, el día de inicio no se cuenta como un día completo.

La expresión tiene el siguiente formato:

DATEDIFF(date1, date2)

Devuelve el día del mes de la fecha en forma de número, entre 1 y 31.

La expresión tiene el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

DAYOFMONTH({entryDate})

Devuelve el día de la semana de la fecha en forma de número, entre 1 (domingo) y 7 (sábado).

La expresión tiene el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

DAYOFWEEK({entryDate})

Devuelve el total de días del mes de la fecha en forma de número y tiene el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

DAYSINMONTH({entryDate})

Devuelve el total de días de la semana entre la fecha y el final de la semana o el final del mes, lo que se dé primero. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

La expresión tiene el siguiente formato:

DAYSINSPLITWEEK({entryDate})

Devuelve el total de días del año de la fecha en forma de número y tiene el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

DAYSINYEAR({entryDate})

Devuelve la fecha más reciente de la lista y tiene el siguiente formato:

DMAX(date1, date2, ...)

Devuelve la fecha más anterior de la lista y tiene el siguiente formato:

DMIN(date1, date2, ...)

Devuelve la hora de la fecha en forma de número entre 0 y 23.

La expresión tiene el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

HOUR({entryDate})

Devuelve el minuto de la fecha en forma de número entre 0 y 60, con el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

MINUTE({entryDate})

Devuelve el mes de la fecha en forma de número entre 1 y 12, con el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

MONTH({entryDate})

Devuelve el segundo de la fecha en forma de número entre 0 y 60, con el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

SECOND({entryDate})

Devuelve el número de días de la semana entre dos fechas, teniendo en cuenta los días de inicio y finalización del periodo seleccionado, así como las marcas de tiempo de esos días. Por ejemplo, si la hora de inicio de la fecha de inicio es 15:00, el día de inicio no se contará como un día completo.

La expresión tiene el siguiente formato:

WEEKDAYDIFF(date2, date1)

Devuelve la cantidad de minutos programados entre las dos fechas según el horario predeterminado.

La expresión tiene el siguiente formato:

WORKMINUTESDIFF(date1, date2)

Devuelve el año de la fecha en un número de 4 dígitos con el siguiente formato. En este ejemplo, la fecha es la fecha de entrada de un objeto de trabajo.

YEAR({entryDate})

Devuelve el valor absoluto del número y tiene el siguiente formato. En este ejemplo se utiliza el número de objetos situados debajo del objeto donde está adjunto el formulario personalizado.

ABS({numberOfChildren})

Devuelve el promedio de números y tiene el siguiente formato:

AVERAGE(number1, number2, ...)

Redondea un número hacia arriba hasta el entero más próximo y tiene el siguiente formato. En este ejemplo se utiliza el número de objetos situados debajo del objeto donde está adjunto el formulario personalizado.

CEIL({numberOfChildren})

Divide todos los números en el orden proporcionado y tiene el siguiente formato:

DIV(number1, number2, ...)

Redondea un número hacia abajo hasta el entero más próximo y tiene el siguiente formato. En este ejemplo se utiliza el número de objetos situados debajo del objeto donde está adjunto el formulario personalizado.

FLOOR({numberOfChildren})

Devuelve el valor de logaritmo natural del número y tiene el siguiente formato:

LN({numberOfChildren})

Devuelve el valor de logaritmo del número2 en base el número1 y tiene el siguiente formato:

LOG(number1, number2)

Devuelve el elemento más grande de la lista y tiene el siguiente formato:

MAX(item1, item2, ...)

Devuelve el elemento más pequeño de la lista y tiene el siguiente formato:

MIN(item1, item2, ...)

Convierte una cadena en un número y tiene el siguiente formato:

NUMBER(string)

Devuelve un número elevado a una potencia y tiene el siguiente formato:

POWER(number, power)

Multiplica todos los números y tiene el siguiente formato:

PROD(number1, number2, ....)

NOTA

Al multiplicar los campos que contienen horas, asegúrese de comprender si la base de datos guarda las horas de los campos seleccionados en minutos, horas o segundos. Si las horas se guardan en minutos o segundos, pero se muestran en horas en la interfaz de Workfront, es posible que deba tener en cuenta la conversión de minutos o segundos a horas al escribir una expresión con este cálculo.

Redondea el número hacia arriba para especificar los decimales de precisión y tiene el siguiente formato:

ROUND(number, precision)

Ordena los números en orden ascendente y tiene el siguiente formato:

SORTASCNUM(number1,number2, ...)

Ordena los números en orden descendente y tiene el siguiente formato:

SORTDESCNUM(number1, number2, ...)

Devuelve la raíz cuadrada de un número y tiene el siguiente formato. En este ejemplo se utiliza el número de objetos situados debajo del objeto donde está adjunto el formulario personalizado.

SQRT({numberOfChildren})

Resta todos los números en el orden proporcionado y tiene el siguiente formato:

SUB(number1, number2, ...)

Suma todos los números y tiene el siguiente formato:

SUM(number1, number2, ...)

Convierte una cadena en una matriz. El delimitador puede ser cualquier cadena.

La expresión tiene el siguiente formato:

ARRAY(string1, "delimiter")

Devuelve el número de elementos de la matriz con el siguiente formato:

ARRAYLENGTH(array)

Devuelve el elemento en el número especificado de la matriz. Si el índice está fuera de los límites, devuelve vacío.

La expresión tiene el siguiente formato:

ARRAYELEMENT(array, number)

Ordena los elementos de la matriz en orden ascendente y los convierte al tipo del primer elemento.

La expresión tiene el siguiente formato:

SORTASCARRAY(array)

Por ejemplo, ["-12,6", -13,0] se convierte en ["-12,6", "-13"].

Nota: Esta expresión no se admite en Workfront Planning.

Ordena los elementos de la matriz en orden descendente y los convierte al tipo del primer elemento.

La expresión tiene el siguiente formato:

SORTDESCARRAY(array)

Por ejemplo, ["-12,6", -13,0] se convierte en ["-13", "-12,6"].

Nota: Esta expresión no se admite en Workfront Planning.

Se utiliza con otras expresiones para elegir un valor de una lista según un número de índice.

Un número de índice es un campo o una función que devuelve un valor numérico (normalmente en un intervalo conocido).

La expresión tiene el siguiente formato:

CASE(indexNumber, value1, value2, ...)

Por ejemplo, la siguiente expresión devuelve el nombre del día de la semana, donde 1 = domingo, 2 = lunes, etc., en una columna calculada:

CASE(DAYOFWEEK({entryDate}),"Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday")

Funciona mejor con otras expresiones que devuelven un número, como DAYOFWEEK, DAYOFMONTH y MONTH.

Concatena la cadena y tiene el siguiente formato:

CONCAT(string1,"separator", string2)

Los siguientes son ejemplos de separadores que puede incluir:

• un espacio: " "
• un guión: "-"
• una barra diagonal: "/"
• una coma: ","
• una palabra: "o", "y"

Devuelve verdadero si la cadena findText se encuentra dentro de la cadena withinText y tiene el siguiente formato:

CONTAINS(findText, withinText)

Excluye cualquiera de los caracteres especiales de la cadena para ser incluidos en un argumento URL.

La expresión tiene el siguiente formato:

ENCODEURL(string)

Devuelve texto con formato. Las opciones de color son $$POSITIVE, $$INFORMATIVE, $$NEGATIVE, $$NOTICE y las demás opciones de formato son $$BOLD, $$ITALIC, $$UNDERLINE. Solo se puede utilizar una opción de color por función, junto con hasta tres opciones de formato más. Si no se especifica ninguna opción de color, se aplica el color predeterminado del sistema.

La expresión tiene el siguiente formato:

FORMAT($$POSITIVE, $$BOLD, $$ITALIC)

Nota: Esta expresión no se admite en Workfront Planning.

Evalúa una condición que se haya especificado y devuelve el valor de trueExpression si es verdadero o el valor de falseExpression si es falsa.

La expresión tiene el siguiente formato:

IF(condition, trueExpression, falseExpression)

Por ejemplo, puede comparar dos campos de fecha diferentes seguidos de un resultado Verdadero/Falso como una cadena de datos:

IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","On Track")

En el discurso diario, esta instrucción significa: “Si la fecha proyectada de finalización de mi objeto es 'mayor que' que la fecha planificada de finalización de mi mismo objeto, entonces muestra las palabras 'Fuera de calendario' en este campo; de lo contrario, muestra las palabras 'Según lo planeado'”.

Si no desea etiquetar las expresiones verdadera o falsa, debe insertar una etiqueta en blanco en la instrucción, como:

IF({projectedCompletionDate}>{plannedCompletionDate},"","On Track")

O

IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","")

Para obtener más información acerca de la creación de instrucciones “IF”, vea Información general sobre instrucciones “IF”.

Permite buscar un valor específico en una cadena de valores posibles. Si el valor que busca es igual a uno de los valores proporcionados, la expresión devuelve trueExpression; de lo contrario, devuelve falseExpression.

La expresión tiene el siguiente formato:

IFIN(value, value1, value2,..., trueExpression, falseExpression)

Por ejemplo, puede encontrar un Propietario del proyecto específico y marcar esos proyectos con una etiqueta especificada en una vista del proyecto:

IFIN({owner}.{name},"Jennifer Campbell","Rick Kuvec","Marketing Team","Other Teams")

En el discurso diario, esta instrucción significa: “Si el propietario del proyecto es Jennifer Campbell o Rick Kuvec, marca este proyecto con 'Equipo de marketing'; de lo contrario, márcalo con 'Otros equipos'”.

Si no desea etiquetar las expresiones verdadera o falsa, debe insertar una etiqueta en blanco en la instrucción, como:

IFIN({owner}.{name},"Jennifer Campbell","Rick Kuvec","","Other Teams")

O

IFIN({owner}.{name},"Jennifer Campbell","Rick Kuvec","Marketing Team","")

Devuelve verdadero si el valor equivale a uno de los valores proporcionados; de lo contrario, la expresión devuelve falso.

La expresión tiene el siguiente formato:

IN(value, value1[, value2...])

Devuelve verdadero si el valor es nulo o está vacío; de lo contrario, la expresión devuelve falso.

La expresión tiene el siguiente formato:

ISBLANK(value)

Devuelve el número de caracteres especificado del lado izquierdo de una cadena y tiene el siguiente formato:

LEFT(string, length)

Devuelve la longitud de una cadena y tiene el siguiente formato:

LEN(string)

Devuelve la cadena en minúsculas y tiene el siguiente formato:

LOWER(string)

Reemplaza todas las ocurrencias de string2 por string3 en string1

La expresión tiene el siguiente formato:

REPLACE(string1, string2, string3)

Devuelve el número de caracteres especificado del lado derecho de una cadena y tiene el siguiente formato:

RIGHT(string, length)

Devuelve el índice de la primera ocurrencia de findText en la cadena withinText, comenzando en la posición de inicio dada o -1 si no se encuentra el texto.

La expresión tiene el siguiente formato:

SEARCH(findText, withinText, start)

Convierte un número en una cadena y tiene el siguiente formato:

STRING(number)

Ordena una lista de cadenas en orden ascendente y tiene el siguiente formato:

SORTASCSTRING(string1, string2, ...)

Ordena una lista de cadenas en orden descendente y tiene el siguiente formato:

SORTDESCSTRING(string1, string2, ...)

Devuelve los caracteres de una cadena en función del índice inicial y final especificado y tiene el siguiente formato:

SUBSTR({string}, number of start position, number of end position)

Evalúa la expresión frente a una lista de valores y devuelve el resultado correspondiente al primer valor coincidente.

La expresión tiene el siguiente formato:

SWITCH(expression, value1, result1, [value2, result2], ...)

Esta expresión no se admite en Workfront Planning.

Quita los espacios en blanco del principio y del final de una cadena y tiene el siguiente formato:

TRIM(string)

Devuelve una cadena en mayúsculas y tiene el siguiente formato:

UPPER(string)