Les fonctions MySQL

Sommaire du document

Fonction MySQL ABS

Type : Fonctions mathématiques
Syntaxe : ABS(X)

---

Retourne la valeur absolue de X.

Fonction MySQL ACOS

Type : Fonctions mathématiques
Syntaxe : ACOS(X)

---

Retourne l'arccosinus de X, c'est à dire, la valeur de l'angle dont X est la cosinus. Retourne NULL si X n'est pas dans l'intervalle -1 - 1.

Fonction MySQL ADDDATE

Type : Fonctions de dates et d'heures
Syntaxe : ADDDATE(date,INTERVAL expr type), ADDDATE(expr,days)

---

Lorsqu'elle est utilisée avec la forme INTERVAL, ADDDATE() est un synonyme de DATE_ADD(). La fonction complémentaire SUBDATE() est un synonyme DATE_SUB().
Depuis MySQL 4.1.1, la seconde syntaxe est utilisée si expr est une expression de type DATE ou DATETIME, et que days est un nombre de jour à ajouter à expr.

Fonction MySQL ADDTIME

Type : Fonctions de dates et d'heures
Syntaxe : ADDTIME(expr,expr2)

---

Ajoute expr2 à expr et retourne le résultat. expr est une expression de type DATE ou DATETIME, et expr2 est une expression de type TIME.

Fonction MySQL ASCII

Type : Fonctions de chaînes de caractères
Syntaxe : ASCII(str)

---

Retourne le code ASCII du premier caractère de la chaîne de caractères str. Retourne 0 si la chaîne de caractère str est vide. Retourne NULL si la chaîne de caractères str est NULL. ASCII() fonctionne avec des valeurs numériques entre 0 et 255.

Fonction MySQL ASIN

Type : Fonctions mathématiques
Syntaxe : ASIN(X)

---

Retourne l'arcsinus de X, c'est à dire, la valeur de l'angle dont le sinus est X. Retourne NULL si X n'est pas dans l'intervalle -1 - 1.

Fonction MySQL ATAN

Type : Fonctions mathématiques
Syntaxe : ATAN(X) ATAN(Y,X)

---

Retourne l'arctangente de X, c'est à dire, la valeur de l'angle dont la tangente est X.
Retourne l'arctangente des variables X et Y. Cela revient à calculer l'arctangente de Y / X, excepté que les signes des deux arguments servent à déterminer le quadrant du résultat

Fonction MySQL ATAN2

Type : Fonctions mathématiques
Syntaxe : ATAN2(Y,X)

---

Retourne l'arctangente des variables X et Y. Cela revient à calculer l'arctangente de Y / X, excepté que les signes des deux arguments servent à déterminer le quadrant du résultat

Fonction MySQL BIN

Type : Fonctions de chaînes de caractères
Syntaxe : BIN(N)

---

Retourne une chaîne de caractères représentant la valeur binaire de l'argument N, où l'argument N est un nombre de type BIGINT. Cette fonction est un équivalent de CONV(N,10,2). Retourne NULL si l'argument N est NULL.

Fonction MySQL BIT_LENGTH

Type : Fonctions de chaînes de caractères
Syntaxe : BIT_LENGTH(str)

---

Retourne le nombre de bits de la chaîne de caractères str.

Fonction MySQL CEIL

Type : Fonctions mathématiques
Syntaxe : CEIL(X)

---

Retourne la valeur entière supérieure de X.

Fonction MySQL CEILING

Type : Fonctions mathématiques
Syntaxe : CEILING(X)

---

Retourne la valeur entière supérieure de X.

Fonction MySQL CHAR

Type : Fonctions de chaînes de caractères
Syntaxe : CHAR(N,...)

---

La fonction CHAR() interprète les arguments comme des entiers et retourne une chaîne de caractères, constituée des caractères, identifiés par leur code ASCII. Les valeurs NULL sont ignorées.

Fonction MySQL CHARACTER_LENGTH

Type : Fonctions de chaînes de caractères
Syntaxe : CHARACTER_LENGTH(str)

---

synonyme de CHAR_LENGTH

Fonction MySQL CHAR_LENGTH

Type : Fonctions de chaînes de caractères
Syntaxe : CHAR_LENGTH(str)

---

Retourne le nombre de caractères de la chaîne str: Un caractère multi-octets compte comme un seul caractère. Cela signifie que pour une chaîne contenant 5 caractères de 2 octets, LENGTH() retournera 10, alors que CHAR_LENGTH() retournera 5.

Fonction MySQL COMPRESS

Type : Fonctions de chaînes de caractères
Syntaxe : COMPRESS(string_to_compress)

---

Compresse une chaîne. Cette fonction requiert la présence de la bibliothèque zlib. Sinon, la valeur retournée sera toujours NULL.

Fonction MySQL CONCAT

Type : Fonctions de chaînes de caractères
Syntaxe : CONCAT(str1,str2,...)

---

Retourne une chaîne représentant la concaténation des arguments. Retourne NULL si un des arguments est NULL. Cette fonction peut prendre plus de 2 arguments. Si un argument est un nombre, il sera converti en son équivalent sous forme de chaîne de caractères.

Fonction MySQL CONCAT_WS

Type : Fonctions de chaînes de caractères
Syntaxe : CONCAT_WS(separator, str1, str2,...)

---

La fonction CONCAT_WS() signifie CONCAT With Separator, c'est-à-dire "concaténation avec séparateur. Le premier argument est le séparateur utilisé pour le reste des arguments. Le séparateur peut être une chaîne de caractères, tout comme le reste des arguments. Si le séparateur est NULL, le résultat sera NULL. Cette fonction ignorera tous les arguments de valeur NULL et vides, hormis le séparateur. Le séparateur sera ajouté entre tous les arguments à concaténer.

Fonction MySQL CONV

Type : Fonctions de chaînes de caractères
Syntaxe : CONV(N,from_base,to_base)

---

Convertit des nombres entre différentes bases. Retourne une chaîne de caractères représentant le nombre N, convertit de la base from_base vers la base to_base. La fonction retourne NULL si un des arguments est NULL. L'argument N est interprété comme un entier, mais peut être spécifié comme un entier ou une chaîne de caractères. Le minimum pour la base est 2 et son maximum est 36. Si to_base est un nombre négatif, N sera considéré comme un nombre signé. Dans le cas contraire, N sera traité comme un nombre non-signé. La fonction CONV travaille avec une précision de 64 bits.

Fonction MySQL COS

Type : Fonctions mathématiques
Syntaxe : COS(X)

---

Retourne le cosinus de X, où X est donné en radians.

Fonction MySQL COT

Type : Fonctions mathématiques
Syntaxe : COT(X)

---

Retourne la cotangente de X.

Fonction MySQL COUNT

Type : Fonctions mathématiques
Syntaxe :

---

Fonction MySQL CRC32

Type : Fonctions mathématiques
Syntaxe : CRC32(expr)

---

Calcule la somme de contrôle et retourne un entier 32 bits non-signé. Le résultat est la valeur NULL si l'argument est NULL. L'argument attendu est une chaîne, et sera traité comme une chaîne s'il n'est pas du bon type.

Fonction MySQL CURDATE

Type : Fonctions de dates et d'heures
Syntaxe : CURDATE()

---

Retourne la date courante au format 'YYYY-MM-DD' ou YYYYMMDD, suivant le contexte numérique ou chaîne.

Fonction MySQL CURRENT_DATE

Type : Fonctions de dates et d'heures
Syntaxe : CURRENT_DATE CURRENT_DATE()

---

Synonymes de CURDATE().

Fonction MySQL CURRENT_TIME

Type : Fonctions de dates et d'heures
Syntaxe : CURRENT_TIME, CURRENT_TIME()

---

Synonymes de CURTIME().

Fonction MySQL CURRENT_TIMESTAMP

Type : Fonctions de dates et d'heures
Syntaxe : CURRENT_TIMESTAMP, CURRENT_TIMESTAMP()

---

Synonymes de NOW().

Fonction MySQL CURTIME

Type : Fonctions de dates et d'heures
Syntaxe : CURTIME()

---

Retourne l'heure courante au format 'HH:MM:SS' or HHMMSS suivant le contexte numérique ou chaîne.

Fonction MySQL DATE

Type : Fonctions de dates et d'heures
Syntaxe : DATE(expr)

---

Extrait la partie date de l'expression expr de type DATE ou DATETIME.

Fonction MySQL DATEDIFF

Type : Fonctions de dates et d'heures
Syntaxe : DATEDIFF(expr,expr2)

---

Retourne le nombre de jours entre la date de début expr et la date de fin expr2. expr et expr2 sont des expressions de type DATE ou DATETIME. Seule la partie DATE est utilisée dans le calcul.

Fonction MySQL DATE_ADD

Type : Fonctions de dates et d'heures
Syntaxe : DATE_ADD(date,INTERVAL expr type)

---

Ajouter à une valeur de type DATE ou DATETIME

Fonction MySQL DATE_FORMAT

Type : Fonctions de dates et d'heures
Syntaxe : DATE_FORMAT(date,format)

---

Formate la date date avec le format format. Les spécificateurs suivants peuvent être utilisé dans la chaîne format :

Option	Description
%%	Un signe pourcentage littéral ‘%’.
%a	Nom du jour de la semaine, en abrégé et en anglaisn (Sun..Sat)
%b	Nom du mois, en abrégé et en anglais (Jan..Dec)
%c	Mois, au format numérique (1..12)
%d	Jour du mois, au format numérique (00..31)
%D	Jour du mois, avec un suffixe anglais (1st, 2nd, 3rd, etc.)
%e	Jour du mois, au format numérique (0..31)
%f	Microsecondes (000000..999999)
%H	Heure (00..23)
%h	Heure (01..12)
%I	Heure (01..12)
%i	Minutes, au format numérique (00..59)
%j	Jour de l'année (001..366)
%k	Heure (0..23)
%l	Heure (1..12)
%m	Mois, au format numérique (01..12)
%M	Nom du mois (January..December)
%p	AM ou PM
%r	Heures, au format 12 heures (hh:mm:ss [AP]M)
%s	Secondes (00..59)
%S	Secondes (00..59)
%T	Heures, au format 24 heures (hh:mm:ss)
%U	Numéro de la semaine (00..53), où Dimanche est le premier jour de la semaine
%u	Numéro de la semaine (00..53), où Lundi est le premier jour de la semaine
%V	Numéro de la semaine (01..53), où Dimanche est le premier jour de la semaine, utilisé avec '%X'
%v	Numéro de la semaine (01..53), où Lundi est le premier jour de la semaine, utilisé avec '%x'
%W	Nom du jour de la semaine (Sunday..Saturday)
%w	Numéro du jour de la semaine (0=Sunday..6=Saturday)
%X	Année, pour les semaines qui commencent le Dimanche, au format numérique, sur 4 chiffres, utilisé avec '%V'
%x	Année, pour les semaines qui commencent le Lundi, au format numérique, sur 4 chiffres, utilisé avec '%v'
%y	Année, au format numérique, sur 2 chiffres
%Y	Année, au format numérique, sur 4 chiffres

Fonction MySQL DATE_SUB

Type : Fonctions de dates et d'heures
Syntaxe : DATE_SUB(date,INTERVAL expr type)

---

Soustraire à une valeur de type DATE ou DATETIME

Fonction MySQL DAY

Type : Fonctions de dates et d'heures
Syntaxe : DAY(date)

---

Synonyme de DAYOFMONTH().

Fonction MySQL DAYNAME

Type : Fonctions de dates et d'heures
Syntaxe : DAYNAME(date)

---

Retourne le nom du jour de la semaine de date.

Fonction MySQL DAYOFMONTH

Type : Fonctions de dates et d'heures
Syntaxe : DAYOFMONTH(date)

---

Retourne le jour de la date date, dans un intervalle de 1 à 31.

Fonction MySQL DAYOFWEEK

Type : Fonctions de dates et d'heures
Syntaxe : DAYOFWEEK(date)

---

Retourne l'index du jour de la semaine : pour date (1 = Dimanche, 2 = Lundi, ... 7 = Samedi). Ces index correspondent au standard ODBC

Fonction MySQL DAYOFYEAR

Type : Fonctions de dates et d'heures
Syntaxe : DAYOFYEAR(date)

---

Retourne le jour de la date date, dans un intervalle de 1 à 366.

Fonction MySQL DEGREES

Type : Fonctions mathématiques
Syntaxe : DEGREES(X)

---

Retourne l'argument X, convertit de radians en degrés.

Fonction MySQL ELT

Type : Fonctions de chaînes de caractères
Syntaxe : ELT(N,str1,str2,str3,...)

---

Retourne str1 si N = 1, str2 si N = 2, et ainsi de suite. Retourne NULL si N est plus petit que 1 ou plus grand que le nombre d'arguments. La fonction ELT() est un complément de la fonction FIELD().

Fonction MySQL ENCRYPT

Type : Fonctions de chiffrements
Syntaxe :

---

Fonction MySQL EXP

Type : Fonctions mathématiques
Syntaxe : EXP(X)

---

Retourne la valeur de e (la base des logarithmes naturels) élevé à la puissance X.

Fonction MySQL EXPORT_SET

Type : Fonctions de chaînes de caractères
Syntaxe : EXPORT_SET(bits,on,off,[séparateur,[nombre_de_bits]])

---

Fonction MySQL EXTRACT

Type : Fonctions de dates et d'heures
Syntaxe : EXTRACT(type FROM date)

---

La fonction EXTRACT() utilise les mêmes types d'intervalles que la fonction DATE_ADD() ou la fonction DATE_SUB(), mais extrait des parties de date plutôt que des opérations de date.

Fonction MySQL FIELD

Type : Fonctions de chaînes de caractères
Syntaxe : FIELD(str,str1,str2,str3,...)

---

Retourne l'index de la chaîne str dans la liste str1, str2, str3, .... Retourne 0 si str n'est pas trouvé. La fonction FIELD() est un complément de la fonction ELT()

Fonction MySQL FIND_IN_SET

Type : Fonctions de chaînes de caractères
Syntaxe : FIND_IN_SET(str,strlist)

---

Retourne une valeur de 1 à N si la chaîne str se trouve dans la liste strlist constituée de N chaînes. Une liste de chaîne est une chaîne composée de sous-chaînes séparées par une virgule ‘,’. Si le premier argument est une chaîne constante et le second, une colonne de type SET, la fonction FIND_IN_SET() est optimisée pour utiliser une recherche binaire très rapide. Retourne 0 si str n'est pas trouvé dans la liste strlist ou si la liste strlist est une chaîne vide. Retourne NULL si l'un des arguments est NULL. Cette fonction ne fonctionne pas correctement si le premier argument contient une virgule ‘,’

Fonction MySQL FLOOR

Type : Fonctions mathématiques
Syntaxe : FLOOR(X)

---

Retourne la valeur entière inférieure de X.

Fonction MySQL FROM_DAYS

Type : Fonctions de dates et d'heures
Syntaxe : FROM_DAYS(N)

---

Retourne la date correspondant au nombre de jours (N) depuis la date 0.
FROM_DAYS() n'est pas fait pour travailler avec des dates qui précèdent l'avènement du calendrier Grégorien (1582), car elle ne prend pas en compte les jours perdus lors du changement de calendrier.

Fonction MySQL FROM_UNIXTIME

Type : Fonctions de dates et d'heures
Syntaxe : FROM_UNIXTIME(unix_timestamp)

---

Retourne une représentation de l'argument unix_timestamp sous la forme 'YYYY-MM-DD HH:MM:SS' ou YYYYMMDDHHMMSS, suivant si la fonction est utilisé dans un contexte numérique ou de chaîne.
Si format est donné, le résultat est formaté en fonction de la chaîne format. format peut contenir les mêmes options de format que celles utilisées par DATE_FORMAT().

Fonction MySQL GET_FORMAT

Type : Fonctions de dates et d'heures
Syntaxe : GET_FORMAT(DATE | TIME | TIMESTAMP, 'EUR' | 'USA' | 'JIS' | 'ISO' | 'INTERNAL')

---

Retourne une chaîne de format.

Fonction MySQL HEX

Type : Fonctions de chaînes de caractères
Syntaxe : HEX(N_or_S)

---

Si l'argument N_OR_S est un nombre, cette fonction retournera une chaîne de caractère représentant la valeur hexadécimale de l'argument N, où l'argument N est de type BIGINT. Cette fonction est un équivalent de CONV(N,10,16). Si N_OR_S est une chaîne de caractères, cette fonction retournera une chaîne de caractères hexadécimale de N_OR_S où chaque caractère de N_OR_S est converti en 2 chiffres hexadécimaux. C'est l'inverse de la chaîne 0xff.

Fonction MySQL HOUR

Type : Fonctions de dates et d'heures
Syntaxe : HOUR(time)

---

Retourne le nombre d'heures pour l'heure time, dans un intervalle de 0 à 23.
Cependant, l'intervalle des valeurs TIME est bien plus grand, et donc, HOUR peut retourner des valeurs plus grandes que 23.

Fonction MySQL INSERT

Type : Fonctions de chaînes de caractères
Syntaxe : INSERT(str,pos,len,newstr)

---

Retourne une chaîne de caractères str, après avoir remplacé la portion de chaîne commençant à la position pos et de longueur len caractères, par la chaîne newstr.

Fonction MySQL INSTR

Type : Fonctions de chaînes de caractères
Syntaxe : INSTR(str,substr)

---

Retourne la position de la première occurrence de la chaîne substr dans la chaîne de caractères str. Cette fonction est exactement la même que la fonction LOCATE(), à la différence que ces arguments sont inversés

Fonction MySQL LAST_DAY

Type : Fonctions de dates et d'heures
Syntaxe : LAST_DAY(date)

---

Prend une valeur de format DATE ou DATETIME, et retourne le dernier jour du mois correspondant. Retourne NULL si l'argument est invalide.

Fonction MySQL LAST_INSERT_ID

Type : Fonctions d'informations
Syntaxe :

---

Fonction MySQL LCASE

Type : Fonctions de chaînes de caractères
Syntaxe : LCASE(str)

---

synonyme de LOWER()

Fonction MySQL LEFT

Type : Fonctions de chaînes de caractères
Syntaxe : LEFT(str,len)

---

Retourne les len caractères les plus à gauche de la chaîne de caractères str.

Fonction MySQL LENGTH

Type : Fonctions de chaînes de caractères
Syntaxe : LENGTH(str)

---

Retourne la taille de la chaîne str, mesurée en octets. Un caractère multi-octets compte comme un seul caractère. Cela signifie que pour une chaîne contenant 5 caractères de 2 octets, LENGTH() retournera 10, alors que CHAR_LENGTH() retournera 5.

Fonction MySQL LN

Type : Fonctions mathématiques
Syntaxe : LN(X)

---

Retourne le logarithme naturel de X (népérien).

Fonction MySQL LOAD_FILE

Type : Fonctions de chaînes de caractères
Syntaxe : LOAD_FILE(file_name)

---

Lit le fichier file_name et retourne son contenu sous la forme d'une chaîne de caractères. Le fichier doit se trouver sur le serveur qui exécute MySQL, vous devez spécifier le chemin absolu du fichier et vous devez avoir les droits en lecture sur celui-ci. Le fichier doit pouvoir être lisible par tous et doit être plus petit que max_allowed_packet. Si ce fichier n'existe pas ou ne peut pas être lu pour différentes raisons, la fonction retourne NULL.

Fonction MySQL LOCALTIME

Type : Fonctions de dates et d'heures
Syntaxe : LOCALTIME, LOCALTIME()

---

Synonymes de NOW().

Fonction MySQL LOCALTIMESTAMP

Type : Fonctions de dates et d'heures
Syntaxe : LOCALTIMESTAMP, LOCALTIMESTAMP()

---

Synonymes de NOW().

Fonction MySQL LOCATE

Type : Fonctions de chaînes de caractères
Syntaxe : LOCATE(substr,str), LOCATE(substr,str,pos)

---

Retourne la position de la première occurrence de la chaîne substr dans la chaîne de caractères str. Retourne 0 si substr ne se trouve pas dans la chaîne de caractères str.

Fonction MySQL LOG

Type : Fonctions mathématiques
Syntaxe : LOG(X), LOG(B,X)

---

Appelée avec un seul paramètre, cette fonction retourne le logarithme naturel (népérien) de X.
Appelée avec deux paramètres, cette fonction retourne le logarithme naturel de X pour une base B arbitraire.

Fonction MySQL LOG10

Type : Fonctions mathématiques
Syntaxe : LOG10(X)

---

Retourne le logarithme en base 10 de X.

Fonction MySQL LOG2

Type : Fonctions mathématiques
Syntaxe : LOG2(X)

---

Retourne le logarithme en base 2 de X.

Fonction MySQL LOWER

Type : Fonctions de chaînes de caractères
Syntaxe : LOWER(str)

---

Retourne la chaîne str avec tous les caractères en minuscules, en fonction du jeu de caractères courant (par défaut, c'est le jeu ISO-8859-1 Latin1).

Fonction MySQL LPAD

Type : Fonctions de chaînes de caractères
Syntaxe : LPAD(str,len,padstr)

---

Retourne la chaîne de caractères str, complétée à gauche par la chaîne de caractères padstr jusqu'à ce que la chaîne de caractères str atteigne len caractères de long. Si la chaîne de caractères str est plus longue que len caractères, elle sera raccourcie de len caractères.

Fonction MySQL LTRIM

Type : Fonctions de chaînes de caractères
Syntaxe : LTRIM(str)

---

Retourne la chaîne de caractères str sans les espaces devant et derrière.

Fonction MySQL MAKEDATE

Type : Fonctions de dates et d'heures
Syntaxe : MAKEDATE(year,dayofyear), MAKETIME(hour,minute,second)

---

La syntaxe MAKEDATE(year,dayofyear) retourne une valeur de format DATE, à partir d'une année et du numéro de jour. dayofyear doit être plus grand que 0 ou le résultat sera NULL.
La syntaxe MAKETIME(hour,minute,second) retourne une valeur de format TIME, calculée à partir des arguments hour, minute et second.

Fonction MySQL MAKE_SET

Type : Fonctions de chaînes de caractères
Syntaxe : MAKE_SET(bits,str1,str2,...)

---

Retourne une liste (une chaîne contenant des sous-chaînes séparées par une virgule ‘,’) constituée de chaînes qui ont le bit correspondant dans la liste bits. str1 correspond au bit 0, str2 au bit 1, etc... Les chaînes NULL dans les listes str1, str2, ... sont ignorées.

Fonction MySQL MD5

Type : Fonctions de chiffrements
Syntaxe :

---

Fonction MySQL MICROSECOND

Type : Fonctions de dates et d'heures
Syntaxe : MICROSECOND(expr)

---

Retourne le nombre de microsecondes dans l'expression de type TIME ou DATETIME expr, sous la forme d'un nombre entre 0 et 999999.

Fonction MySQL MID

Type : Fonctions de chaînes de caractères
Syntaxe : MID(str,pos,len)

---

synonyme de SUBSTRING(str,pos,len)

Fonction MySQL MINUTE

Type : Fonctions de dates et d'heures
Syntaxe : MINUTE(time)

---

Retourne le nombre de minutes pour l'heure time, dans un intervalle de 0 à 59.

Fonction MySQL MOD

Type : Fonctions mathématiques
Syntaxe : MOD(N,M), N % M, N MOD M

---

Modulo (équivalent de l'opérateur % dans le langage C). Retourne le reste de la division de N par M.

Fonction MySQL MONTH

Type : Fonctions de dates et d'heures
Syntaxe : MONTH(date)

---

Retourne le numéro du mois de la date date, dans un intervalle de 1 à 12.

Fonction MySQL MONTHNAME

Type : Fonctions de dates et d'heures
Syntaxe : MONTHNAME(date)

---

Retourne le nom du mois de la date date.

Fonction MySQL NOW

Type : Fonctions de dates et d'heures
Syntaxe : NOW()

---

Retourne la date courante au format 'YYYY-MM-DD HH:MM:SS' ou YYYYMMDDHHMMSS, suivant le contexte numérique ou chaîne.

Fonction MySQL OCT

Type : Fonctions de chaînes de caractères
Syntaxe : OCT(N)

---

Retourne une chaîne de caractères représentant la valeur octal de l'argument N, où l'argument N est un nombre de type BIGINT. Cette fonction est un équivalent de CONV(N,10,8). Retourne NULL si l'argument N est NULL

Fonction MySQL OCTET_LENGTH

Type : Fonctions de chaînes de caractères
Syntaxe : OCTET_LENGTH(str)

---

OCTET_LENGTH() est un synonyme de LENGTH().

Fonction MySQL ORD

Type : Fonctions de chaînes de caractères
Syntaxe : ORD(str)

---

Si le premier caractère de la chaîne str est un caractère multi-octets, la fonction retourne le code de ce caractère, calculé à partir du code ASCII retourné par cette formule :
(1st octet * 256)
+ (2nd octet * 256^2)
+ (3rd octet * 256^3) ...
Si le premier caractère n'est pas un caractère multi-octet, la fonction retournera la même valeur que la fonction ASCII().

Fonction MySQL PASSWORD

Type : Fonctions de chiffrements
Syntaxe :

---

Fonction MySQL PERIOD_ADD

Type : Fonctions de dates et d'heures
Syntaxe : PERIOD_ADD(P,N)

---

Ajoute N mois à la période P (au format YYMM ou YYYYMM). Retourne une valeur dans le format YYYYMM.
Notez que l'argument P n'est pas de type date.

Fonction MySQL PERIOD_DIFF

Type : Fonctions de dates et d'heures
Syntaxe : PERIOD_DIFF(P1,P2)

---

Retourne le nombre de mois entre les périodes P1 et P2. P1 et P2 doivent être au format YYMM ou YYYYMM.
Notez que les arguments P1 et P2 ne sont pas de type date.

Fonction MySQL PI

Type : Fonctions mathématiques
Syntaxe : PI()

---

Retourne la valeur de pi. Par défaut, 5 décimales sont retournées, mais MySQL utilise la double précision pour pi.

Fonction MySQL POSITION

Type : Fonctions de chaînes de caractères
Syntaxe : POSITION(substr IN str)

---

synonyme de LOCATE(substr,str)

Fonction MySQL POW

Type : Fonctions mathématiques
Syntaxe : POW(X,Y)

---

Retourne la valeur de X élevée à la puissance Y.

Fonction MySQL POWER

Type : Fonctions mathématiques
Syntaxe : POWER(X,Y)

---

Retourne la valeur de X élevée à la puissance Y.

Fonction MySQL QUARTER

Type : Fonctions de dates et d'heures
Syntaxe : QUARTER(date)

---

Retourne le numéro du trimestre de la date date, dans un intervalle de 1 à 4.

Fonction MySQL QUOTE

Type : Fonctions de chaînes de caractères
Syntaxe : QUOTE(str)

---

Echappe les caractères d'une chaîne pour produire un résultat qui sera exploitable dans une requête SQL. Les caractères suivants seront précédés d'un anti-slash dans la chaîne retournée : le guillemet simple (‘'’), l'anti-slash (‘\’), ASCII NUL, et le Contrôle-Z. Si l'argument vaut NULL, la valeur retournée sera le mot NULL sans les guillemets simples. La fonction QUOTE a été ajoutée en MySQL version 4.0.3.

Fonction MySQL RADIANS

Type : Fonctions mathématiques
Syntaxe : RADIANS(X)

---

Retourne l'argument X, converti de degrés en radians.

Fonction MySQL RAND

Type : Fonctions mathématiques
Syntaxe : RAND(), RAND(N)

---

Retourne un nombre aléatoire à virgule flottante compris dans l'intervalle 0 - 1.0. Si l'argument entier N est spécifié, il est utilisé comme initialisation du générateur de nombres aléatoires.
Vous ne pouvez pas utiliser une colonne de valeur RAND() dans une clause ORDER BY, parce que ORDER BY va évaluer la colonne plusieurs fois.

Fonction MySQL REPEAT

Type : Fonctions de chaînes de caractères
Syntaxe : REPEAT(str,count)

---

Retourne une chaîne de caractères constituée de la répétition de count fois la chaîne str. Si count <= 0, retourne une chaîne vide. Retourne NULL si str ou count sont NULL

Fonction MySQL REPLACE

Type : Fonctions de chaînes de caractères
Syntaxe : REPLACE(str,from_str,to_str)

---

Retourne une chaîne de caractères str dont toutes les occurrences de la chaîne from_str sont remplacées par la chaîne to_str.

Fonction MySQL REVERSE

Type : Fonctions de chaînes de caractères
Syntaxe : REVERSE(str)

---

Retourne une chaîne dont l'ordre des caractères est l'inverse de la chaîne str

Fonction MySQL RIGHT

Type : Fonctions de chaînes de caractères
Syntaxe : RIGHT(str,len)

---

Retourne les len caractères les plus à droite de la chaîne de caractères str

Fonction MySQL ROUND

Type : Fonctions mathématiques
Syntaxe : ROUND(X), ROUND(X,D)

---

Retourne l'argument X, arrondi à un nombre à D décimales. Avec deux arguments, la valeur est arrondie avec D décimales.
Si D vaut 0, le résultat n'aura ni de partie décimale, ni de séparateur de décimal.
Notez que le comportement de l'opérateur ROUND(), lorsque l'argument est exactement entre deux entiers, dépend de la bibliothèque C active. Certaines arrondissent toujours à l'entier pair le plus proche, toujours vers le haut, toujours vers le bas, ou toujours vers zéro. Si vous avez besoin d'un certain type d'arrondissement, vous devez utiliser une fonction bien définie comme TRUNCATE() ou FLOOR().

Fonction MySQL RPAD

Type : Fonctions de chaînes de caractères
Syntaxe : RPAD(str,len,padstr)

---

Retourne la chaîne de caractères str, complétée à droite par la chaîne de caractères padstr jusqu'à ce que la chaîne de caractères str atteigne len caractères de long. Si la chaîne de caractères str est plus longue que len caractères, elle sera raccourcie de len caractères.

Fonction MySQL RTRIM

Type : Fonctions de chaînes de caractères
Syntaxe : RTRIM(str)

---

Retourne la chaîne de caractères str sans les espaces finaux.

Fonction MySQL SECOND

Type : Fonctions de dates et d'heures
Syntaxe : SECOND(time)

---

Retourne le nombre de secondes pour l'heure time, dans un intervalle de 0 à 59.

Fonction MySQL SEC_TO_TIME

Type : Fonctions de dates et d'heures
Syntaxe : SEC_TO_TIME(seconds)

---

Retourne l'argument seconds, convertit en heures, minutes et secondes au format 'HH:MM:SS' ou HHMMSS, suivant le contexte numérique ou chaîne.

Fonction MySQL SIGN

Type : Fonctions mathématiques
Syntaxe : SIGN(X)

---

Retourne le signe de l'argument sous la forme -1, 0, ou 1, selon que X est négatif, zéro, ou positif.

Fonction MySQL SIN

Type : Fonctions mathématiques
Syntaxe : SIN(X)

---

Retourne le sinus de X, où X est donné en radians.

Fonction MySQL SOUNDEX

Type : Fonctions de chaînes de caractères
Syntaxe : SOUNDEX(str)

---

Retourne la valeur Soundex de la chaîne de caractères str. Deux chaînes qui ont des sonorités proches auront des valeurs soundex proches. Une chaîne Soundex standard possède 4 caractères, mais la fonction SOUNDEX() retourne une chaîne de longueur arbitraire. Vous pouvez utiliser la fonction SUBSTRING() sur ce résultat pour obtenir une chaîne Soundex standard. Tout caractère non alpha-numérique sera ignoré. Tous les caractères internationaux qui ne font pas partie de l'alphabet de base (A-Z) seront considérés comme des voyelles.

Fonction MySQL SOUNDS

Type : Fonctions de chaînes de caractères
Syntaxe : expr1 SOUNDS LIKE expr2

---

Identique à SOUNDEX(expr1)=SOUNDEX(expr2) (disponible depuis la version 4.1).

Fonction MySQL SPACE

Type : Fonctions de chaînes de caractères
Syntaxe : SPACE(N)

---

Retourne une chaîne constituée de N espaces.

Fonction MySQL SQRT

Type : Fonctions mathématiques
Syntaxe : SQRT(X)

---

Retourne la racine carrée de X.

Fonction MySQL STR_TO_DATE

Type : Fonctions de dates et d'heures
Syntaxe : STR_TO_DATE(str,format)

---

Cette fonction est l'inverse de la fonction DATE_FORMAT(). Elle prend la chaîne str, et une chaîne de format format, puis retourne une valeur DATETIME.
Les valeurs de type DATE, TIME ou DATETIME contenues dans la chaîne str doivent être au format format. Pour les options qui sont utilisables dans la chaîne format, voyez la table dans la description de la fonction DATE_FORMAT(). Tous les autres caractères sont utilisés littéralement, et ne seront pas interprétés. Si str contient une valeur illégale, STR_TO_DATE() retourne NULL.

Fonction MySQL SUBDATE

Type : Fonctions de dates et d'heures
Syntaxe : SUBDATE(date,INTERVAL expr type), SUBDATE(expr,days)

---

Lorsqu'elle est utilisée avec la forme INTERVAL du second argument, SUBDATE() est synonyme DATE_SUB().

Fonction MySQL SUBSTRING

Type : Fonctions de chaînes de caractères
Syntaxe : SUBSTRING(str,pos), SUBSTRING(str FROM pos), SUBSTRING(str,pos,len), SUBSTRING(str FROM pos FOR len)

---

Retourne une chaîne de len caractères de long de la chaîne str, à partir de la position pos. La syntaxe ANSI SQL92 utilise une variante de la fonction FROM.

Fonction MySQL SUBSTRING_INDEX

Type : Fonctions de chaînes de caractères
Syntaxe : SUBSTRING_INDEX(str,delim,count)

---

Retourne une portion de la chaîne de caractères str, située avant count occurrences du délimiteur delim. Si l'argument count est positif, tout ce qui précède le délimiteur final sera retourné. Si l'argument count est négatif, tout ce qui suit le délimiteur final sera retourné

Fonction MySQL SUBTIME

Type : Fonctions de dates et d'heures
Syntaxe : SUBTIME(expr,expr2)

---

Soustrait expr2 de expr et retourne le résultat. expr est une expression de format DATE ou DATETIME et expr2 est une expression de type TIME.

Fonction MySQL SYSDATE

Type : Fonctions de dates et d'heures
Syntaxe : SYSDATE()

---

Synonyme de NOW().

Fonction MySQL TAN

Type : Fonctions mathématiques
Syntaxe : TAN(X)

---

Retourne la tangente de X, où X est donné en radians.

Fonction MySQL TIME

Type : Fonctions de dates et d'heures
Syntaxe : TIME(expr)

---

Extrait la partie horaire de l'expression expr, de type TIME ou DATETIME.

Fonction MySQL TIMEDIFF

Type : Fonctions de dates et d'heures
Syntaxe : TIMEDIFF(expr,expr2)

---

TIMEDIFF() retourne la durée entre l'heure de début expr et l'heure de fin expr2. expr et expr2 sont des expressions de type TIME ou DATETIME, et doivent être de même type.

Fonction MySQL TIMESTAMP

Type : Fonctions de dates et d'heures
Syntaxe : TIMESTAMP(expr), TIMESTAMP(expr,expr2)

---

Avec un seul argument, retourne l'expression expr de type DATE ou DATETIME sous la forme d'une valeur DATETIME. Avec deux arguments, ajouter l'expression expr2 à l'expression expr et retourne le résultat au format DATETIME.

Fonction MySQL TIMESTAMPADD

Type : Fonctions de dates et d'heures
Syntaxe : TIMESTAMPADD(interval,int_expr,datetime_expr)

---

Ajoute l'expression entière int_expr à l'expression datetime_expr au format DATE ou DATETIME. L'unité de int_expr est donnée avec l'argument interval, qui peut être l'une des valeurs suivantes : FRAC_SECOND, SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, QUARTER, ou YEAR.
La valeur interval peut être spécifiée, en utilisant un des mots-clé cités, ou avec le préfixe SQL_TSI_. Par exemple, DAY et SQL_TSI_DAY sont tous les deux valides.

Fonction MySQL TIMESTAMPDIFF

Type : Fonctions de dates et d'heures
Syntaxe : TIMESTAMPDIFF(interval,datetime_expr1,datetime_expr2)

---

Retourne la différence entière entre les expressions datetime_expr1 et datetime_expr2, de format DATE et DATETIME. L'unité du résultat est donné par l'argument interval. Les valeurs légales de interval sont les mêmes que pour la fonction TIMESTAMPADD().

Fonction MySQL TIME_FORMAT

Type : Fonctions de dates et d'heures
Syntaxe : TIME_FORMAT(time,format)

---

Utilisée exactement comme la fonction DATE_FORMAT() ci-dessus, mais la chaîne format ne doit utiliser que des spécificateurs d'heures, qui gèrent les heures, minutes et secondes. Les autres spécificateurs génèreront la valeur NULL ou 0.
Si la valeur time contient une valeur d'heure qui est plus grande que 23, les formats %H et %k produiront une valeur qui est hors de l'intervalle 0..23. L'autre format d'heure produira une heure modulo 12.

Fonction MySQL TIME_TO_SEC

Type : Fonctions de dates et d'heures
Syntaxe : TIME_TO_SEC(time)

---

Retourne l'argument time, convertit en secondes.

Fonction MySQL TO_DAYS

Type : Fonctions de dates et d'heures
Syntaxe : TO_DAYS(date)

---

Retourne le nombre de jours depuis la date 0 jusqu'à la date date.
TO_DAYS() n'est pas fait pour travailler avec des dates qui précèdent l'avènement du calendrier Grégorien (1582), car elle ne prend pas en compte les jours perdus lors du changement de calendrier.

Fonction MySQL TRIM

Type : Fonctions de chaînes de caractères
Syntaxe : TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str)

---

Retourne la chaîne de caractères str dont tous les préfixes et/ou suffixes remstr ont été supprimés. Si aucun des spécificateurs BOTH, LEADING ou TRAILING sont fournis, BOTH est utilisé comme valeur par défaut. Si remstr n'est pas spécifié, les espaces sont supprimés.

Fonction MySQL TRUNCATE

Type : Fonctions mathématiques
Syntaxe : TRUNCATE(X,D)

---

Retourne l'argument X, tronqué à D décimales. Si D vaut 0, le résultat n'aura ni séparateur décimal, ni partie décimale.

Fonction MySQL UCASE

Type : Fonctions de chaînes de caractères
Syntaxe : UCASE(str)

---

synonyme de UPPER().

Fonction MySQL UNCOMPRESS

Type : Fonctions de chaînes de caractères
Syntaxe : UNCOMPRESS(string_to_uncompress)

---

Décompresse une chaîne compressée avec COMPRESS(). Si l'argument n'est pas une valeur compressée, le résultat est NULL. Cette fonction requiert la bibliothèque zlib. Sinon, la valeur retournée est toujours NULL.

Fonction MySQL UNCOMPRESSED_LENGTH

Type : Fonctions de chaînes de caractères
Syntaxe : UNCOMPRESSED_LENGTH(compressed_string)

---

Retourne la taille de la chaîne avant compression.

Fonction MySQL UNHEX

Type : Fonctions de chaînes de caractères
Syntaxe : UNHEX(str)

---

Le contraire de HEX(string). C'est à dire, chaque pair de chiffres hexadécimaux sont interprétées comme des nombres, et sont convertis en un caractère représenté par le nombre. Le résultat est retournée sous forme de chaîne binaire.

Fonction MySQL UNIX_TIMESTAMP

Type : Fonctions de dates et d'heures
Syntaxe : UNIX_TIMESTAMP(), UNIX_TIMESTAMP(date)

---

Lorsqu'elle est appelé sans argument, cette fonction retourne un timestamp Unix (nombre de secondes depuis '1970-01-01 00:00:00' GMT). Si UNIX_TIMESTAMP() est appelé avec un argument date, elle retourne le timestamp correspondant à cette date. date peut être une chaîne de type DATE, DATETIME, TIMESTAMP, ou un nombre au format YYMMDD ou YYYYMMDD, en horaire local.

Fonction MySQL UPPER

Type : Fonctions de chaînes de caractères
Syntaxe : UPPER(str)

---

Retourne la chaîne str en majuscules, en fonction du jeu de caractères courant. Par défaut, c'est le jeu ISO-8859-1 Latin1

Fonction MySQL USER

Type : Fonctions d'informations
Syntaxe :

---

Fonction MySQL UTC_DATE

Type : Fonctions de dates et d'heures
Syntaxe : UTC_DATE, UTC_DATE()

---

Retourne la date UTC courante au format 'YYYY-MM-DD' ou YYYYMMDD suivant le contexte numérique ou chaîne.

Fonction MySQL UTC_TIME

Type : Fonctions de dates et d'heures
Syntaxe : UTC_TIME, UTC_TIME()

---

Retourne l'heure UTC courante au format 'HH:MM:SS' or HHMMSS suivant le contexte numérique ou chaîne.

Fonction MySQL UTC_TIMESTAMP

Type : Fonctions de dates et d'heures
Syntaxe : UTC_TIMESTAMP, UTC_TIMESTAMP()

---

Retourne l'heure et la date UTC courante au format 'YYYY-MM-DD HH:MM:SS' or YYYYMMDDHHMMSS suivant le contexte numérique ou chaîne.

Fonction MySQL WEEK

Type : Fonctions de dates et d'heures
Syntaxe : WEEK(date [,mode])

---

Avec un seul argument, retourne le numéro de la semaine dans l'année de la date date, dans un intervalle de 0 à 53 (oui, il peut y avoir un début de semaine numéro 53), en considérant que Dimanche est le premier jour de la semaine. Avec deux arguments, la fonction WEEK() vous permet de spécifier si les semaines commencent le Dimanche ou le Lundi et la valeur retournée sera dans l'intervalle 0-53 ou bien 1-52. Lorsque l'argument mode est omis, la valeur de la variable default_week_format (ou 0 en MySQL 4.0 ou plus ancien) est utilisé.

Fonction MySQL WEEKDAY

Type : Fonctions de dates et d'heures
Syntaxe : WEEKDAY(date)

---

Retourne l'index du jour de la semaine, avec la conversion suivante : date (0 = Lundi, 1 = Mardi, ... 6 = Dimanche).

Fonction MySQL WEEKOFYEAR

Type : Fonctions de dates et d'heures
Syntaxe : WEEKOFYEAR(date)

---

Retourne le numéro de semaine dans l'année, sous forme d'un nombre compris entre 1 et 53.

Fonction MySQL YEAR

Type : Fonctions de dates et d'heures
Syntaxe : YEAR(date)

---

Retourne l'année de la date date, dans un intervalle de 1000 à 9999.

Fonction MySQL YEARWEEK

Type : Fonctions de dates et d'heures
Syntaxe : YEARWEEK(date), YEARWEEK(date,start)

---

Retourne l'année et la semaine d'une date. L'argument start fonctionne exactement comme l'argument start de la fonction WEEK(). Notez que l'année dans le résultat peut être différente de l'année passée en argument, pour la première et la dernière semaine de l'année.

Références

1. MySQL 5.1 Reference Manual : dev.mysql, String Functions (version 20/02/10)
2. MySQL 5.1 Reference Manual : dev.mysql, Numeric Functions (version 20/02/10)
3. MySQL 5.1 Reference Manual : dev.mysql, Date and Time Functions (version 20/02/10)
4. MySQL 5.0 Reference Manual : dev.mysql, Fonctions de chaînes de caractères (version 20/02/10)

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Structure du document