Fonctions communes DB2 DB2 add_months ( expression_date|expression_horodatage ; expression_entier ) Renvoie la date résultant de l'ajout de expression_entier mois à expression_date ou expression_horodatage. La valeur de expression_date et de expression_horodatage peut être une date, un horodatage ou une chaîne de caractères exprimant une date ou un horodatage. add_months ( date_courante ; 3 ) Résultat : Renvoie la date située trois mois après la date en cours. ascii ( expression_chaîne ) Renvoie la valeur de code ASCII du caractère le plus à gauche dans l'argument, sous la forme d'un entier. ascii ( a ) Résultat : Renvoie la valeur 65, qui correspond au code de la valeur ASCII "a". chr ( expression_entier ) Renvoie le caractère qui correspond au code ASCII indiqué par "expression_entier". La valeur de "expression_entier" doit être comprise entre 0 et 255. chr ( 65 ) Résultat : Renvoie le caractère "a", qui correspond au code de la valeur ASCII 65. char ( expression ) Autre syntaxe : char ( expression_chaîne , expression_entier ) Renvoie une représentation de l'entrée "expression_chaîne" sous la forme d'une chaîne d'une longueur fixe, avec une longueur correspondant à "expression_entier". Autre syntaxe 2: char ( expression_décimal , expression_caractère ) Renvoie une représentation de l'entrée "expression_décimal" sous la forme d'une chaîne avec le séparateur décimal "expression_caractère". Renvoie une représentation sous forme de chaîne d'une valeur date-heure ou d'un nombre décimal. ceiling ( expression_numérique ) Renvoie le plus petit entier supérieur ou égal à "expression_numérique". ceiling ( 0.75 ) Résultat : Renvoie 0.8 coalesce coalesce ( liste_expressions ) Renvoie le premier argument non nul (ou la valeur null si tous les arguments sont nuls). La fonction Coalesce accepte deux arguments ou plus. coalesce ( [Prix unitaire]; [Prix unitaire de vente] ) Résultat : Renvoie le prix unitaire, ou le prix unitaire de vente si le premier est nul. concat ( expression_chaîne1; expression_chaîne2 ) Renvoie une chaîne qui correspond à la concaténation des chaînes "expression_chaîne1" et "expression_chaîne2". concat ( [Objectif de ventes (requête)].[Equipe commerciale].[Prénom], [Objectif de ventes (requête)].[Equipe commerciale].[Nom de famille] ) Résultat : Renvoie le prénom et le nom, par exemple, Bob Smith. date ( expression ) Renvoie une date à partir d'une valeur d'entrée unique. L'élément "expression" peut être une date représentée sous forme d'une chaîne ou d'un entier. date ( '1998-01-08' ) Résultat : Renvoie 8 janvier 1998. day ( expression_date ) Renvoie le jour du mois (1-31) à partir de "expression_date". L'élément "expression_date" peut être une date représentée sous forme d'une chaîne ou d'une valeur. day ( '1998-01-08' ) Résultat : Renvoie la valeur 8. dayname ( expression_date ) Renvoie une chaîne de caractères contenant le nom du jour propre à la source de données (par exemple, Sunday à Saturday ou Sun. à Sat. pour une source de données qui utilise l'anglais, ou Sonntag à Samstag pour une source de données qui utilise l'allemand) pour la partie jour de "expression_date". L'élément "expression_date" peut être une date représentée sous forme d'une chaîne ou d'une valeur. dayname ( '1998-01-08' ) Résultat : Renvoie jeudi. dayofweek ( expression_date ) Renvoie le jour de la semaine contenu dans "expression_date" sous forme d'un entier compris entre 1 et 7, où 1 représente le dimanche. L'élément "expression_date" peut être une date représentée sous forme d'une chaîne ou d'une valeur. dayofweek ( '1998-01-08' ) Résultat : Renvoie 5 dayofweek_iso ( expression_date ) Renvoie le jour de la semaine contenu dans "expression_date" sous forme d'un entier compris entre 1 et 7, où 1 représente le lundi. L'élément "expression_date" peut être une date représentée sous forme d'une chaîne ou d'une valeur. dayofweek_iso ( '1998-01-08' ) Résultat : Renvoie la valeur 4. dayofyear ( expression_date ) Renvoie le jour de l'année contenu dans "expression_date" sous forme d'un entier compris entre 1 et 366. L'élément "expression_date" peut être une date représentée sous forme d'une chaîne ou d'une valeur. dayofyear ( current_date ) Résultat : Renvoie le jour de l'année correspondant à la date courante. Si par exemple la date est le 28 janvier, l'expression renvoie la valeur 28. days ( expression ) Renvoie un entier représentant une date. L'élément "expression" peut être une date représentée sous forme d'une chaîne ou d'une valeur. dec ( expression_chaîne [ ; entier_précision [ ; entier_échelle [ ; caractère_décimal ] ] ] ) Renvoie la représentation décimale de "string-expression" en fonction des valeurs de "precision-integer" et de "scale-integer". La valeur de "decimal-character" peut être utilisée pour définir le caractère à un octet de la constante utilisée pour délimiter les nombres décimaux dans "string-expression". La valeur de "expression_chaîne" doit être formatée en tant que constante entière ou décimale SQL. Autre syntaxe : dec ( expression_numérique [ ; entier_précision [ ; entier_échelle ] ] ) Renvoie la représentation décimale de "expression_numérique" en fonction des valeurs de "entier_précision" et de "entier_échelle". Autre syntaxe 2 : dec ( expression_dateheure [ , entier_précision [ , entier_échelle ] ] ) Renvoie la représentation décimale de "expression_dateheure" en fonction des valeurs de "entier_précision" et de "entier_échelle". decimal ( expression_chaîne [ ; entier_précision [ ; entier_échelle [ ; caractère_décimal ] ] ] ) Renvoie la représentation décimale de "string-expression" en fonction des valeurs de "precision-integer" et de "scale-integer". La valeur de "decimal-character" peut être utilisée pour définir le caractère à un octet de la constante utilisée pour délimiter les nombres décimaux dans "string-expression". La valeur de "expression_chaîne" doit être formatée en tant que constante entière ou décimale SQL. Autre syntaxe : decimal ( expression_numérique [ ; entier_précision [ ; entier_échelle ] ] ) Renvoie la représentation décimale de "expression_numérique" en fonction des valeurs de "entier_précision" et de "entier_échelle". Autre syntaxe 2 : decimal ( expression_dateheure [ , entier_précision [ , entier_échelle ] ] ) Renvoie la représentation décimale de "expression_dateheure" en fonction des valeurs de "entier_précision" et de "entier_échelle". difference ( expression_chaîne1 ; expression_chaîne2 ) Renvoie l'entier représentant la différence entre les valeurs de la fonction SOUNDEX spécifique de source de données pour les chaînes "string_expression1" et "string_expression2". La valeur renvoyée se situe entre 0 et 4, où 4 représente la meilleure correspondance. Une valeur de 4 ne signifie pas que les chaînes sont égales. Exemple : difference ([Objectif de ventes (requête)].[Equipe commerciale].[Prénom],[Ventes (requête)].[Détaillants].[Prénom du contact]) Résultat : 0 Exemple : difference ([Objectif de ventes (requête)].[Equipe commerciale].[Prénom], [Objectif de ventes (requête)].[Equipe commerciale].[Prénom]) Résultat : 4 digits ( expression_numérique ) Renvoie la représentation d'un nombre en virgule fixe sous forme de chaîne de caractères. double ( expression ) envoie la représentation en virgule flottante d'une expression. "Expression" peut correspondre à une expression numérique ou de chaîne. event_mon_state ( expression_chaîne ) Renvoie l'état de fonctionnement d'un moniteur d'état déterminé. float ( expression_numérique ) Renvoie la représentation d'un nombre en virgule flottante. hex ( expression ) Renvoie la représentation hexadécimale d'une valeur. hour ( expression_heure ) Renvoie l'heure contenue dans "expression_heure" sous la forme d'un entier compris entre 0 (minuit) et 23 (23:00). L'élément "expression_heure" peut être une heure représentée sous forme d'une chaîne ou d'une valeur. hour ( 01:22:45 ) Résultat : Renvoie la valeur 1. insert ( expression_chaîne1; expression_entier1; expression_entier2; expression_chaîne2 ) Renvoie une chaîne résultant de la suppression de "expression2_entier" caractères dans "expression1_chaîne" à partir de "expression1_entier" et de l'insertion de "expression2_chaîne" au début de "expression1_chaîne". Le premier caractère de la chaîne se trouve en position 1. integer ( expression ) Renvoie une expression sous forme d'un entier. L'élément "expression" peut être un nombre représenté sous forme de chaîne ou de valeur numérique. Exemple : integer ( 84,95 ) Résultat : 84 int ( expression ) Renvoie une expression sous forme d'un entier. L'élément "expression" peut être un nombre représenté sous forme de chaîne ou de valeur numérique. Exemple : int ( 84,95 ) Résultat : 84 julian_day ( expression ) Renvoie une valeur entière représentant le nombre de jours depuis le 1 janvier, 4712 Av.J-C (le début du calendrier julien) et la valeur de date spécifiée dans "expression". L'élément "expression" peut être une date représentée sous forme d'une chaîne ou d'une valeur. julian_day ( '2009-06-29' ) Résultat : 2455012.22130739595741034 lcase ( expression_chaîne ) Convertit en minuscules tous les caractères en majuscules de "expression_chaîne". lcase ( [Ventes (requête)].[Equipe commerciale].[Nom de famille] ) Résultat : Renvoie les noms de famille sans majuscules. left ( expression_chaîne; expression_entier ) Renvoie les "integer_expression" premiers caractères de "string_expression". left ( [Ventes (requête)].[Equipe commerciale].[Nom de famille] , 3 ) Résultat : Renvoie les trois premiers caractères de chaque nom de famille. length ( expression ) Renvoie la longueur de l'opérande, exprimée en octets. Exception : les types de chaîne sur deux octets renvoient la longueur en caractères. length ( [Ventes (requête)].[Equipe commerciale].[Date de début de l'enregistrement] ) Résultat : Renvoie la valeur 4, les dates renvoient toujours la valeur 4. locate ( expression_chaîne1; expression_chaîne2 [ ; expression_entier ] ) Renvoie la position de début de la première occurrence de "expression_chaîne1" dans "expression_chaîne2". La recherche débute à la position "expression_entier" de "expression_chaîne2". Le premier caractère dans une chaîne figure en position 1. Si "expression_chaîne1" est introuvable, la valeur zéro est renvoyée. locate ( A, [Ventes (requête)].[Equipe commerciale].[Nom de famille] , 2 ) Résultat : Renvoie la position du caractère A dans les noms de famille, en commençant par le deuxième caractère du nom. long_varchar ( expression_chaîne ) Renvoie une chaîne de type LONG. ltrim ( expression_chaîne ) Renvoie "expression_chaîne" après avoir supprimé les espaces à gauche. ltrim ( [Ventes (requête)].[Equipe commerciale].[Nom de famille] ) Résultat : Renvoie les noms de famille en supprimant les blancs de début. microsecond ( expression ) Renvoie la partie microsecondes (unité de temps) d'une valeur. La valeur de "expression" peut être un horodatage ou une chaîne de caractères exprimant un horodatage. microsecond ( 01:45:34.056 ) Résultat : Renvoie 056. midnight_seconds ( expression ) Renvoie une valeur entière comprise entre 0 et 86400 qui représente le nombre de secondes entre minuit et la valeur horaire indiquée dans l'argument. La valeur de "expression" peut être une valeur horaire, un horodatage ou une chaîne de caractères exprimant une heure. midnight_seconds ( 01:45:34.056 ) Résultat : Renvoie la valeur 6334. minute ( expression_heure ) Renvoie la minute (nombre entier compris entre 0 et 59) contenue dans "expression_heure". La valeur de "expression_heure" peut être une heure, un horodatage ou une chaîne de caractères exprimant une heure. minute ( 01:45:34.056 ) Résultat : Renvoie la valeur 45. month ( expression_date ) Renvoie le mois (entier compris entre 1 et 12) contenu dans "expression_date". month ( 2005-11-01 ) Résultat : Renvoie la valeur 11. monthname ( expression_date ) Renvoie une chaîne de caractères contenant le nom du mois propre à la source de données pour la partie mois de "expression_date" (par exemple, January à December ou Jan. à Dec. pour une source de données en anglais ou Janvier à Décembre pour une source de données en français). monthname ( 2005-11-01 ) Résultat : novembre quarter ( expression_date ) Renvoie le trimestre contenu dans "expression_date" sous forme d'un chiffre compris entre 1 et 4, où 1 représente les dates comprises entre le 1er janvier et le 31 mars. quarter ( 2005-11-01 ) Résultat : Renvoie la valeur 4. radians ( expression_numérique ) Renvoie "expression_numérique" degrés transformés en radians. repeat ( expression_chaîne; expression_entier ) Renvoie la chaîne "expression_chaîne" répétée le nombre de fois déterminé par "expression_entier". repeat ( XYZ; 3 ) Résultat : Renvoie XYZXYZXYZ. replace ( expression_chaîne1; expression_chaîne2; expression_chaîne3 ) Remplace toutes les occurrences de "expression_chaîne2" par "expression_chaîne3" dans "expression_chaîne1". replace ( [Ventes (requête)].[Equipe commerciale].[Code de position], A, a ) Résultat : Renvoie les codes de position comportant toutes les occurrences de "A" remplacées par "a". right ( expression_chaîne; expression_entier ) Renvoie les "integer_expression" derniers caractères de "string_expression". right ( [Ventes (requête)].[Equipe commerciale].[Code de position], 3 ) Résultat : Renvoie les 3 derniers caractères de chaque code de position. round ( expression_numérique; expression_entier ) Renvoie la valeur "expression_numérique" arrondie à "expression_entier" positions à droite du séparateur décimal. Si "expression_entier" est une valeur négative, "expression_numérique" est arrondi à la valeur absolue la plus proche avec "expression_entier" positions à gauche du séparateur décimal. L'arrondi est calculé avant que le formatage des données ne soit appliqué. round ( 3,14159265; 3 ) Résultat : Renvoie 3,142 rtrim ( expression_chaîne ) Renvoie "expression_chaîne" après avoir supprimé les espaces de fin de chaîne. rtrim ( [Ventes (requête)].[Equipe commerciale].[Nom de famille] ) Résultat : Renvoie les noms de famille en supprimant les espaces blancs éventuels à la fin du nom. second ( expression_heure ) Renvoie la seconde (entier compris entre 0 et 59) contenue dans "expression_heure". second ( 01:45:34.056 ) Résultat : Renvoie la valeur 34. sign ( expression_numérique ) Renvoie un indicateur du signe de la chaîne "expression_numérique" : +1 si "expression_numérique" est positive, 0 si elle est nulle et -1 si elle est négative. sign ( [Revenus] ) Résultat : Renvoie + pour les valeurs positives et - pour les valeurs négatives. smallint ( expression ) Renvoie un nombre de type smallint. soundex ( expression_chaîne ) Renvoie un code composé d'une chaîne de 4 caractères correspondant à une abréviation phonétique de "expression_chaîne". Cette fonction permet de déterminer si deux chaînes sont phonétiquement semblables. Par exemple, est-ce que ('SMITH') = ('SMYTH') phonétiquement parlant. space ( expression_entier ) Renvoie une chaîne composée de "expression_entier" espaces. space ( 5 ) Résultat : Renvoie 5 espaces. substr ( expression_chaîne , expression_entier1 [ , expression_entier2 ] ) Renvoie la sous-chaîne de "string_expression" qui commence à la position "integer_expression1" et dont la longueur est "integer_expression2". Le premier caractère de "expression_chaîne" occupe la position 1. substr ( [Ventes (requête)].[Equipe commerciale].[Code de position], 3 , 5 ) Résultat : Renvoie les caractères 3 à 7 des codes de position. table_name ( expression_chaîne1 [ ; expression_chaîne2 ] ) Renvoie un nom non qualifié d'une table ou d'une vue basé sur le nom de l'objet dans "expression_chaîne1" et le nom du schéma dans "expression_chaîne2". Cette fonction sert à résoudre les alias. table_schema ( expression_chaîne1 [ ; expression_chaîne2 ] ) Renvoie la partie nom du schéma de la table en deux parties ou le nom de vue basé sur le nom d'objet dans "expression_chaîne1" et le nom de schéma dans "expression_chaîne2". Cette fonction sert à résoudre les alias. time ( expression ) Renvoie une heure à partir d'une valeur. timestamp ( expression1 [ ; expression2 ] ) Renvoie un horodatage à partir d'une valeur ou d'une paire de valeurs. La valeur de "expression1" doit être une date et la valeur de "expression2" doit être une heure. timestamp ( 11 novembre 2005 ; 12:00:00.000000 ) Résultat : Renvoie 2005-11-11-12:00:00.000000. timestamp_iso ( expression ) Renvoie une date au format ISO (aaaa-mm-jj hh:mm:ss.nnnnnn) convertie à partir du format IBM (aaaa-mm-jj-hh.mm.ss.nnnnnn). Si "expression" correspond à une valeur d'heure, la fonction insère la valeur de la DATE DU JOUR pour les éléments de date et des zéros pour les subdivisions de l'heure. timestamp_iso ( 11 novembre 2005 ; 12:00:00.000000 ) Résultat : Renvoie 2005-11-11 12:00:00.000000. timestampdiff ( expression1; expression2 ) Renvoie un nombre approximatif d'intervalles de type "expression1" en fonction de la différence entre deux horodatages. "expression2" est le résultat de la soustraction de deux types d'horodatage et de la conversion du résultat en expression de type CHAR. Les valeurs valides pour "expression1" sont les suivantes : 1 fraction d'une seconde, 2 secondes, 4 minutes, 8 heures, 16 jours, 32 semaines, 64 mois, 128 trimestres et 256 années. to_char ( expression_horodatage, chaîne_format ) Renvoie la représentation sous forme de chaîne d'un horodatage au format "chaîne_format". to_char ( expression_numérique, chaîne_format ) Renvoie la représentation sous forme de chaîne d'une valeur numérique au format "chaîne_format". to_char ( expression_caractère ) Renvoie la représentation sous forme de chaîne varchar d'une expression de type caractère. to_date ( expression1 ; expression_chaîne2 ) Convertit "expression1" en une valeur date-heure de type "expression_chaîne2". Le premier argument "expression1" peut être de type chaîne ou numérique. to_date ( '2013-02-27 15:13:14' ; 'AAAA-MM-JJ HH24:MI:SS' ) Résultat : Renvoie une date et une heure avec la valeur '2013-02-27 15:13:14'. translate ( expression_chaîne1 [ ; expression_chaîne2; expression_chaîne3 [ ; expression_chaîne4 ] ] ) Renvoie la chaîne "expression_chaîne1" dans laquelle des caractères de "expression_chaîne3" ont été remplacés par des caractères équivalents de "expression_chaîne2". "expression_chaîne4" est un caractère unique utilisé pour compléter la chaîne "expression_chaîne2" si celle-ci est plus courte que "expression_chaîne3". Si seule la chaîne "expression_chaîne1" est présente, cette fonction la convertit en majuscules. translate ( 'abcdefg' ) Résultat : Renvoie ABCDEFG. translate ( 'mnlop' ; n; m ; - ) Résultat : Renvoie n-nlop. trunc ( expression_numérique1, expression_numérique2 ) Renvoie l'expression "expression_numérique1" tronquée à "expression_numérique2" positions à droite du séparateur décimal. Si "expression_numérique2" est négative, "expression_numérique1" est tronquée à la valeur absolue de "expression_numérique2" positions à gauche du séparateur décimal. Exemple : trunc ( 3.14159265, 3 ) Résultat : 3.141. trunc ( expression_date-heure [, chaîne_format [, nom_paramètres-régionaux ] ] ) Renvoie l'expression "expression_date-heure" arrondie à l'unité spécifiée par "chaîne_format". Si "chaîne_format" n'est pas spécifié, "expression_date-heure" est arrondie au jour le plus proche comme si 'DD' était spécifié pour chaîne_format. "nom_paramètres-régionaux" est une constante de type chaîne qui spécifie les paramètres régionaux utilisés pour déterminer le premier jour de la semaine. Si "nom_paramètres-régionaux" n'est pas spécifié,la valeur de CURRENT LOCALE LC_TIME est utilisée. Exemple : trunc ( TIMESTAMP('2000-07-31 15:05:05.123456'), 'DD' ) Résultat : 2000-07-31 00:00:00.0 truncate ( expression_numérique1, expression_numérique2 ) Renvoie l'expression "expression_numérique1" tronquée à "expression_numérique2" positions à droite du séparateur décimal. Si "expression_numérique2" est négative, "expression_numérique1" est tronquée à la valeur absolue de "expression_numérique2" positions à gauche du séparateur décimal. Exemple : truncate ( 3141.59265, -3 ) Résultat : 3. truncate ( expression_date-heure [, chaîne_format [, nom_paramètres-régionaux ] ] ) Renvoie l'expression "expression_date-heure" arrondie à l'unité spécifiée par "chaîne_format". Si "chaîne_format" n'est pas spécifié, "expression_date-heure" est arrondie au jour le plus proche comme si 'DD' était spécifié pour chaîne_format. "nom_paramètres-régionaux" est une constante de type chaîne qui spécifie les paramètres régionaux utilisés pour déterminer le premier jour de la semaine. Si "nom_paramètres-régionaux" n'est pas spécifié,la valeur de CURRENT LOCALE LC_TIME est utilisée. Exemple : truncate ( TIMESTAMP('2000-07-31 15:05:05.123456'), 'DD' ) Résultat : 2000-07-31 00:00:00.0 ucase ( expression_chaîne ) Renvoie "expression_chaîne" après avoir converti tous les caractères minuscules en majuscules. ucase ( XY896Zbced789 ) Résultat : Renvoie la valeur XY896ZBCED789. value ( liste_expressions ) Renvoie le premier argument non nul (ou la valeur null si tous les arguments sont nuls). La fonction Value accepte au moins deux arguments. value ( [Prix unitaire]; [Prix unitaire]; [Prix unitaire de vente] ) Résultat : Renvoie la première valeur non nulle. varchar ( expression [ ; expression_numérique ] ) Renvoie "expression" sous forme de chaîne de type VARCHAR et de longueur égale à expression_numérique. week ( expression_date ) Renvoie la semaine de l'année contenue dans "expression_date" sous forme d'un entier compris entre 1 et 53. week ( 11 novembre 2005 ) Résultat : Renvoie la valeur 45. year ( expression_date ) Renvoie l'année contenue dans "expression_date". year ( 11 novembre 2005 ) Résultat : Renvoie la valeur 2005.