Funciones comunes de DB2 DB2 add_months ( expresión_fecha|expresión_fechayhora ; expresión_entero ) Devuelve la fecha que resulta de añadir expresión_entero meses a expresión_fecha o expresión_fechayhora. Expresión_fecha y expresión_fechayhora pueden tener valor de fecha o fecha y hora o una representación en forma de cadena de una fecha o una fecha y hora. add_months ( fecha_actual ; 3 ) Resultado: Devuelve la fecha que es tres meses posterior a la fecha actual. ascii ( expresión_cadena ) Devuelve el valor del código ASCII del carácter situado en el extremo izquierdo del argumento como un entero. ascii ( a ) Resultado: Devuelve 65, el valor del código ASCII de "a". chr ( expresión_entero ) Devuelve el carácter que se corresponde con el valor del código ASCII especificado en "expresión_entero". El valor de "expresión_entero" debe estar comprendido entre 0 y 255. chr ( 65 ) Resultado: Devuelve un carácter, el carácter del valor del código ASCII correspondiente a 65. char ( expresión ) Sintaxis alternativa: char ( expresión_cadena , expresión_entero ) Devuelve una representación de cadena de "expresión_cadena" de longitud fija con una longitud de "expresión_entero". Sintaxis alternativa 2: char ( expresión_decimal , expresión_carácter ) Devuelve una representación de cadena de "expresión_decimal" utilizando el separador decimal "expresión_carácter". Devuelve una representación en forma de cadena del valor de fecha/hora o un número decimal. ceiling ( expresión_numérica ) Devuelve el entero más pequeño igual o mayor que "expresión_numérica". ceiling ( 0.75 ) Resultado: Devuelve 0.8. coalesce coalesce ( lista_expresiones ) Devuelve el primer argumento no nulo (o nulo si todos los argumentos son nulos). La función Coalesce requiere dos o más argumentos. coalesce ( [Precio unitario]; [Precio de venta unitario] ) Resultado: Devuelve el precio unitario o el precio de venta unitario si el precio unitario es un valor nulo. concat ( expresión_cadena1; expresión_cadena2 ) Devuelve una cadena que es el resultado de la concatenación de "expresión_cadena1" con "expresión_cadena2". concat ( [Objetivo ventas (consulta)].[Personal de ventas].[Nombre], [Objetivo de ventas (consulta)].[Personal de ventas].[Apellido] ) Resultado: Devuelve el nombre y el apellido; por ejemplo, Roberto Rodríguez. date ( expresión ) Devuelve una fecha a partir de un valor de entrada único. "Expresión" puede ser la representación de una fecha en forma de cadena o de entero. date ( '1998-01-08' ) Resultado: Devuelve 8 enero 1998. day ( expresión_fecha ) Devuelve el día del mes (1-31) indicado en "expresión_fecha". "Expresión_fecha" puede ser un valor de fecha o la representación de una fecha en forma de cadena. day ( '1998-01-08' ) Resultado: Devuelve 8. dayname ( expresión_fecha ) Devuelve una cadena de caracteres con el nombre específico del origen de datos correspondiente al día (por ejemplo, de Sunday a Saturday o Sun. a Sat. para un origen de datos que utilice el idioma inglés. O de Sonntag a Samstag para un origen de datos que utilice alemán) para la parte de día indicada en "expresión_fecha". "Expresión_fecha" puede ser un valor de fecha o la representación de una fecha en forma de cadena. dayname ( '1998-01-08' ) Resultado: Devuelve Jueves. dayofweek ( expresión_fecha ) Devuelve el día de la semana de "expresión_fecha" como un entero comprendido entre el 1 y el 7, donde el 1 representa el domingo. "Expresión_fecha" puede ser un valor de fecha o la representación de una fecha en forma de cadena. dayofweek ( '1998-01-08' ) Resultado: Devuelve 5. dayofweek_iso ( expresión_fecha ) Devuelve el día de la semana de "expresión_fecha" como un entero comprendido entre el 1 y el 7, donde el 1 representa el lunes. "Expresión_fecha" puede ser un valor de fecha o la representación de una fecha en forma de cadena. dayofweek_iso ( '1998-01-08' ) Resultado: Devuelve 4. dayofyear ( expresión_fecha ) Devuelve el día del año de "expresión_fecha" como un entero comprendido entre el 1 y el 366. "Expresión_fecha" puede ser un valor de fecha o la representación de una fecha en forma de cadena. dayofyear ( current_date ) Resultado: Devuelve el día del año de la fecha actual; por ejemplo, si fuera el 28 de enero, la expresión devolvería 28. days ( expresión ) Devuelve la representación de una fecha en forma de entero. "Expresión" puede ser un valor de fecha o la representación de una fecha en forma de cadena. dec ( expresión-cadena [ ; entero-precisión [ ; entero-escala [ ; carácter-decimal ] ] ] ) Devuelve la representación decimal de "expresión-cadena" utilizando "entero-precisión" y "entero-escala". El "carácter decimal" puede utilizarse para especificar la constante de carácter de un solo byte utilizada para limitar los dígitos decimales en "expresión-cadena". La "expresión-cadena" debe formatearse como una constante entera o decimal de SQL. Sintaxis alternativa: dec ( expresión-numérica [ ; entero-precisión [ ; entero-escala ] ] ) Devuelve la representación decimal de "expresión-numérica" utilizando "entero-precisión" y "entero-escala". Sintaxis alternativa 2: dec ( expresión-fecha-hora [ , entero-precisión [ , entero-escala ] ] ) Devuelve la representación decimal de "expresión-fecha-hora" utilizando "entero-precisión" y "entero-escala". decimal ( expresión-cadena [ ; entero-precisión [ ; entero-escala [ ; carácter-decimal ] ] ] ) Devuelve la representación decimal de "expresión-cadena" utilizando "entero-precisión" y "entero-escala". El "carácter decimal" puede utilizarse para especificar la constante de carácter de un solo byte utilizada para limitar los dígitos decimales en "expresión-cadena". La "expresión-cadena" debe formatearse como una constante entera o decimal de SQL. Sintaxis alternativa: decimal ( expresión-numérica [ ; entero-precisión [ ; entero-escala ] ] ) Devuelve la representación decimal de "expresión-numérica" utilizando "entero-precisión" y "entero-escala". Sintaxis alternativa 2: decimal ( expresión-fecha-hora [ , entero-precisión [ , entero-escala ] ] ) Devuelve la representación decimal de "expresión-fecha-hora" utilizando "entero-precisión" y "entero-escala". difference ( exp_cadena1 ; exp_cadena2 ) Devuelve un valor entero que representa la diferencia entre los valores calculados por la función específica del origen de datos soundex para "expresión_cadena1" y "expresión_cadena2". El valor devuelto está comprendido entre 0 y 4, donde 4 indica la mejor coincidencia. No obstante, el valor 4 no significa que las cadenas sean idénticas. Ejemplo: difference ([Objetivo de ventas (consulta)].[Personal de ventas].[Nombre], [Ventas (consulta)].[Minoristas].[Nombre del contacto]) Resultado: 0 Ejemplo: difference ([Objetivo de ventas (consulta)].[Personal de ventas].[Nombre], [Objetivo de ventas (consulta)].[Personal de ventas].[Nombre del contacto]) Resultado: 4 digits ( expresión_numérica ) Devuelve la representación en forma de cadena de caracteres de un número sin coma flotante. double ( expresión ) Devuelve la representación decimal flotante de una expresión. "Expresión" puede ser una expresión numérica o una cadena. event_mon_state ( expresión_cadena ) Devuelve el estado de funcionamiento de un supervisor de estado concreto. float ( expresión_numérica ) Devuelve la representación decimal flotante de un número. hex ( expresión ) Devuelve la representación hexadecimal de un valor. hour ( expresión_hora ) Devuelve la hora, un entero comprendido entre 0 (medianoche) y 23 (11:00 pm), a partir de "expresión_hora". "Expresión_hora" puede ser un valor de hora o la representación de una hora en forma de cadena. hour ( 01:22:45 ) Resultado: Devuelve 1. insert ( expresión_cadena1; expresión_entero1; expresión_entero2; expresión_entero2 ) Devuelve una cadena en la que los caracteres de "expresión_entero2" se han suprimido de "expresión_cadena1" a partir de la posición "expresión_entero1", y en donde "expresión_cadena2" se ha insertado al principio de "expresión_cadena1". El primer carácter de la cadena se encuentra en la posición 1. integer ( expresión ) Devuelve la representación de una expresión en forma de entero. "Expresión" puede ser un valor numérico o la representación de un número en forma de cadena. Ejemplo: integer ( 84.95 ) Resultado: 84 int ( expresión ) Devuelve la representación de una expresión en forma de entero. "Expresión" puede ser un valor numérico o la representación de un número en forma de cadena. Ejemplo: int ( 84.95 ) Resultado: 84 julian_day ( expresión ) Devuelve un valor entero que representa el número de días desde el 1 de enero de 4712 AC (fecha de inicio del calendario juliano) hasta el valor de fecha que se ha especificado en "expresión". "Expresión" puede ser un valor de fecha o la representación de una fecha en forma de cadena. julian_day ( '2009-06-29' ) Resultado: 2455012.22130739595741034 lcase ( expresión_cadena ) Devuelve la "expresión_cadena" con todos los caracteres en mayúsculas convertidos en minúsculas. lcase ( [Ventas (consulta)].[Personal de ventas].[Apellido] ) Resultado: Devuelve los apellidos sin ninguna letra en mayúsculas. left ( expresión_cadena; expresión_entero ) Devuelve los "expresión_entero" primeros caracteres del extremo izquierdo de "expresión_cadena". left ( [Ventas (consulta)].[Personal de ventas].[Apellido] , 3 ) Resultado: Devuelve los tres primeros caracteres de cada apellido. length ( expresión ) Devuelve la longitud del operando, en bytes. Excepción: Los tipos de cadena de doble byte devuelven la longitud en caracteres. length ( [Ventas (consulta)].[Personal de ventas].[Fecha de inicio de registro] ) Resultado: Devuelve 4; las fechas siempre devuelven un valor de 4. locate ( expresión_cadena1; expresión_cadena2 [ ; expresión_entero ] ) Devuelve la posición inicial de la primera aparición de "expresión_cadena1" en "expresión_cadena2". La búsqueda comienza a partir de la posición inicial "expresión_entero" de "expresión_cadena2". El primer carácter de una cadena se encuentra en la posición 1. Si no se encuentra "expresión_cadena1", el valor devuelto es cero. locate ( A, [Ventas (consulta)].[Personal de ventas].[Apellido] , 2 ) Resultado: Devuelve la posición del carácter A en los apellidos, empezando por el segundo carácter del apellido. long_varchar ( expresión_cadena ) Devuelve una cadena larga. ltrim ( expresión_cadena ) Devuelve "expresión_cadena" con los espacios iniciales eliminados. ltrim ( [Ventas (consulta)].[Personal de ventas].[Apellido] ) Resultado: Devuelve los apellidos con los espacios iniciales eliminados. microsecond ( expresión ) Devuelve en microsegundos (unidad de tiempo) la parte de un valor. "Expresión" puede ser una indicación de fecha y hora o una representación de una indicación de fecha y hora en forma de cadena. microsecond ( 01:45:34.056 ) Resultado: Devuelve 056. midnight_seconds ( expresión ) Devuelve un valor entero comprendido en el rango de 0 a 86.400 que representa el número de segundos entre medianoche y el valor de tiempo especificado en el argumento. "Expresión" puede ser un valor de hora, una indicación de fecha y hora o una representación de una hora en forma de cadena. midnight_seconds ( 01:45:34.056 ) Resultado: Devuelve 6334. minute ( expresión_hora ) Devuelve los minutos (un entero de 0 a 59) a partir de "expresión_hora". "Expresión_hora" puede ser un valor de hora, una indicación de fecha y hora o una representación de tiempo en forma de cadena. minute ( 01:45:34.056 ) Resultado: Devuelve 45. month ( expresión_fecha ) Devuelve el mes (un entero de 1 a 12) a partir de "expresión_fecha". month ( 2005-11-01 ) Resultado: Devuelve 11. monthname ( expresión_fecha ) Devuelve una cadena de caracteres con el nombre del mes específico del origen de datos (por ejemplo, de January a December o de Jan. a Dec. para un origen de datos en inglés, o de Januar a Dezember para un origen de datos en alemán) para la parte de mes indicada en "expresión_fecha". monthname ( 2005-11-01 ) Resultado: Noviembre quarter ( expresión_fecha ) Devuelve el trimestre indicado en "expresión_fecha" como un número comprendido entre 1 y 4, donde 1 corresponde al intervalo del 1 de enero al 31 de marzo. quarter ( 2005-11-01 ) Resultado: Devuelve 4. radians ( expresión_numérica ) Devuelve el número de radianes convertido a partir de los grados indicados en "expresión_numérica". repeat ( expresión_cadena; expresión_entero ) Devuelve una cadena compuesta de "expresión_cadena" repetida "expresión_entero" veces. repeat ( XYZ; 3 ) Resultado: Devuelve XYZXYZXYZ. replace ( expresión_cadena1; expresión_cadena2; expresión_cadena3 ) Sustituye todas las apariciones de "expresión_cadena2" en "expresión_cadena1" por "expresión_cadena3". replace ( [Ventas (consulta)].[Personal de ventas].[Código de posición], A, a ) Resultado: Devuelve los códigos de cargo con todas las apariciones de "A" sustituidas por "a". right ( expresión_cadena; expresión_entero ) Devuelve el número de caracteres indicado por "expresión_entero" situados más a la derecha de "expresión_cadena". right ( [Ventas (consulta)].[Personal de ventas].[Código de cargo], 3 ) Resultado: Devuelve los 3 caracteres situados más a la derecha de cada código de cargo. round ( expresión_numérica; expresión_entero ) Devuelve el valor de "expresión_numérica" redondeado "expresión_entero" dígitos a la derecha del separador decimal. Si el valor de "expresión_entero" es negativo, el valor de "expresión_numérica" se redondea al valor absoluto más cercano "expresión_entero" dígitos a la izquierda del separador decimal. El redondeo se debe realizar antes de aplicar el formateo de datos. round ( 3,14159265; 3 ) Resultado: Devuelve 3.142. rtrim ( expresión_cadena ) Devuelve "expresión_cadena" sin los espacios del final. rtrim ( [Ventas (consulta)].[Personal de ventas].[Apellido] ) Resultado: Devuelve los apellidos sin espacios al final del nombre eliminado. second ( expresión_hora ) Devuelve los segundos (un entero comprendido entre el 0 y el 59) de "expresión_hora". second ( 01:45:34.056 ) Resultado: Devuelve 34. sign ( expresión_numérica ) Devuelve un indicador del signo de "expresión_numérica": +1 si el valor de "expresión_numérica" es positivo, 0 si es cero o -1 si es negativo. sign ( [Ingresos] ) Resultado: Devuelve + para los valores positivos y - para los valores negativos. smallint ( expresión ) Devuelve la representación Small Integer de un número. soundex ( expresión_cadena ) Devuelve un código de cadena de 4 caracteres obtenido al abreviar sistemáticamente las palabras y los nombres indicados en "expresión_cadena" conforme a la fonética. Puede utilizarse para determinar si dos cadenas suenan igual. Por ejemplo, el sonido de ('BACA') es igual al de ('VACA'). space ( expresión_entero ) Devuelve una cadena de "expresión_entero" espacios. space ( 5 ) Resultado: Devuelve 5 espacios. substr ( expresión_cadena ; expresión_entero1 [ ; expresión_entero2 ] ) Devuelve la subcadena de "expresión_cadena" que comienza en la posición indicada por "expresión_entero1" y tiene una longitud de "expresión_entero2" caracteres. El primer carácter de "expresión_cadena" corresponde a la posición 1. substr ( [Ventas (consulta)].[Personal de ventas].[Código de cargo], 3 , 5 ) Resultado: Devuelve los caracteres 3 a 7 de los códigos de cargo. table_name ( expresión_cadena1 [ ; expresión_cadena2 ] ) Devuelve un nombre no calificado de una tabla o de una vista en función del nombre de objeto indicado en "expresión_cadena1" y el nombre de esquema indicado en "expresión_cadena2". Se utiliza para resolver los alias. table_schema ( expresión_cadena1 [ ; expresión_cadena2 ] ) Devuelve la parte correspondiente al nombre del esquema de un nombre de tabla o de vista compuesto por dos partes en función del nombre de objeto indicado por "expresión_cadena1" y el nombre del esquema indicado por "expresión_cadena2". Se utiliza para resolver los alias. time ( expresión ) Devuelve un horario de un valor. timestamp ( expresión1 [ ; expresión2 ] ) Devuelve una indicación de fecha y hora a partir de un valor o de un par de valores. "Expresión1" debe representar un valor de fecha y "expresión2" debe representar un valor de hora. timestamp ( 11 de noviembre de 2005 ; 12:00:00.000000 ) Resultado: Devuelve 2005-11-11-12:00:00.000000. timestamp_iso ( expresión ) Devuelve un valor fecha y hora en formato ISO (aaaa-mm-dd hh:mm:ss.nnnnnn) convertido a partir del formato de IBM (aaaa-mm-dd-hh.mm.ss.nnnnnn). Si "expresión" es un valor de hora, inserta el valor de la FECHA ACTUAL para los elementos de fecha y cero para el elemento de fracción horaria. timestamp_iso ( 11 de noviembre de 2005 ; 12:00:00.000000 ) Resultado: Devuelve 2005-11-11 12:00:00.000000. timestampdiff ( expresión1; expresión2 ) Devuelve un número estimado de intervalos de tipo "expresión1" en función de la diferencia entre dos indicaciones de fecha y hora. "Expresión2" es el resultado de restar dos tipos de indicación de fecha y hora y convertir el resultado a CHAR. Los valores válidos de "expresión1" son: 1 fracciones de segundo; 2 segundos; 4 minutos; 8 horas; 16 días; 32 semanas; 64 meses; 128 trimestres; 256 años. to_char ( timestamp_expression , format_string ) Devuelve la representación de serie de una indicación de fecha y hora con el formato "format_string". to_char ( numeric_expression , format_string ) Devuelve la representación de serie de un valor numérico con el formato "format_string". to_char ( character_expression ) Devuelve la representación de serie varchar de character_expression. to_date ( expresión1 , expresión_serie2 ) Convierte "expresión1" en un valor de fecha y hora con el formato especificado por "expresión_cadena2". El primer argumento "expresión1" puede ser de tipo cadena o numérico. to_date ( '2013-02-27 15:13:14' , 'AAAA-MM-DD HH24:MI:SS' ) Resultado: Devuelve el valor de fecha y hora '2013-02-27 15:13:14'. translate ( expresión_cadena1 [ ; expresión_cadena2; expresión_cadena3 [ ; expresión_cadena4 ] ] ) Devuelve "expresión_cadena1", en la que los caracteres de "expresión_cadena3" se han convertido en los caracteres equivalentes de "expresión_cadena2". "Expresión_cadena4" es un único carácter que se utiliza para rellenar "expresión_cadena2" si es más corta que "expresión_cadena3". Si sólo está presente "expresión_cadena1", esta función la convertirá a caracteres en mayúsculas. translate ( 'abcdefg' ) Resultado: Devuelve ABCDEFG. translate ( 'mnlop' ; n; m ; - ) Resultado: Devuelve n-nlop. trunc ( numeric_expression1, numeric_expression2 ) Devuelve el valor de "numeric_expression1" truncado en el número de posiciones indicado en "numeric_expression2" a la derecha del separador decimal. Si el valor de "numeric_expression2" es negativo, "numeric_expression1" se trunca según el valor absoluto de posiciones de "numeric_expression2" a la izquierda del separador decimal. Ejemplo: trunc ( 3.14159265, 3 ) Resultado: 3.141. trunc ( datetime_expression [, format_string [, locale_name ] ] ) Devuelve "datetime_expression" redondeada a la unidad especificada mediante format_string. Si no se especifica format_string, se redondea datetime_expression al día más aproximado, como si se hubiera especificado 'DD' para format_string. locale_name es una constante de serie que especifica el entorno local utilizado para determinar el primer día de la semana. Si no se especifica locale_name, se utiliza el valor de CURRENT LOCALE LC_TIME. Ejemplo: trunc ( TIMESTAMP('2000-07-31 15:05:05.123456'), 'DD' ) Resultado: 2000-07-31 00:00:00.0 truncate ( numeric_expression1, numeric_expression2 ) Devuelve el valor de "numeric_expression1" truncado en el número de posiciones indicado en "numeric_expression2" a la derecha del separador decimal. Si el valor de "numeric_expression2" es negativo, "numeric_expression1" se trunca según el valor absoluto de posiciones de "numeric_expression2" a la izquierda del separador decimal. Ejemplo: truncate ( 3141.59265, -3 ) Resultado: 3. truncate ( datetime_expression [, format_string [, locale_name ] ] ) Devuelve "datetime_expression" redondeada a la unidad especificada mediante format_string. Si no se especifica format_string, se redondea datetime_expression al día más aproximado, como si se hubiera especificado 'DD' para format_string. locale_name es una constante de serie que especifica el entorno local utilizado para determinar el primer día de la semana. Si no se especifica locale_name, se utiliza el valor de CURRENT LOCALE LC_TIME. Ejemplo: truncate ( TIMESTAMP('2000-07-31 15:05:05.123456'), 'DD' ) Resultado: 2000-07-31 00:00:00.0 ucase ( expresión_cadena ) Devuelve la "expresión_cadena" con todos los caracteres en minúsculas convertidos en mayúsculas. ucase ( XY896Zbced789 ) Resultado: Devuelve XY896ZBCED789. value ( lista_expresiones ) Devuelve el primer argumento no nulo (o nulo si todos los argumentos son nulos). La función Value requiere dos o más argumentos. value ( [Coste unitario]; [Precio unitario]; [Precio de venta unitario] ) Resultado: Devuelve el primer valor no nulo. varchar ( expresión [ ; expresión_numérica ] ) Devuelve una representación de tipo VARCHAR de la expresión, con la longitud indicada en expresión_numérica. week ( expresión_fecha ) Devuelve la semana del año de "expresión_fecha" como un valor entero comprendido entre el 1 y el 53. week ( 11 de noviembre de 2005 ) Resultado: Devuelve 45. year ( expresión_fecha ) Devuelve el año de "expresión_fecha". year ( 11 de noviembre de 2005 ) Resultado: Devuelve 2005.