Utilisation des fonctions de date et d'heure AnalyticDB for MySQL - AnalyticDB

ADDDATE

ADDDATE(date,INTERVAL expr unit)
ADDDATE(expr,days)

Types de paramètres :

adddate(date, INTERVAL expr unit)
adddate(timestamp, INTERVAL expr unit)
adddate(datetime, INTERVAL expr unit)
adddate(varchar, INTERVAL expr unit)
adddate(date, varchar)
adddate(date, bigint)
adddate(datetime, bigint)
adddate(datetime, varchar)
adddate(timestamp, varchar)
adddate(timestamp, bigint)
adddate(varchar, bigint)
adddate(varchar, varchar)

Type de valeur de retour : DATE.
Description : cette fonction ajoute un intervalle de temps à la date spécifiée.
- Valeurs valides pour unit : second, minute, hour, day, month, year, minute_second, hour_second, hour_minute, day_second, day_minute, day_hour et year_month. La valeur par défaut de unit est day.
- days et expr : la fonction renvoie la somme de expr et de days.

Exemples :

Exemple 1

select adddate(date '2022-01-22',interval '3' day);

Le résultat suivant est renvoyé :

+----------------------------------------------+
| adddate(DATE '2022-01-22', INTERVAL  '3' DAY)|
+----------------------------------------------+
| 2022-01-25                                   |

Exemple 2

select adddate(timestamp '2022-01-22',interval '3' day);

Le résultat suivant est renvoyé :

+---------------------------------------------------+
| adddate(TIMESTAMP '2022-01-22', INTERVAL  '3' DAY)|
+---------------------------------------------------+
| 2022-01-25 00:00:00                               |

Exemple 3

select adddate(datetime '2022-01-22',interval '3' day);

Le résultat suivant est renvoyé :

+--------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' DAY |
+--------------------------------------------------+
| 2022-01-25 00:00:00                              |

Exemple 4

select adddate('2022-01-22',interval '3' day);

Le résultat suivant est renvoyé :

+-----------------------------------------+
| adddate('2022-01-22', INTERVAL  '3' DAY)|
+-----------------------------------------+
| 2022-01-25                              |

Exemple 5

select adddate(datetime '2022-01-22',interval '3' second);

Le résultat suivant est renvoyé :

+-----------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' SECOND)|
+-----------------------------------------------------+
|                                 2022-01-22 00:00:03 |

Exemple 6

select adddate(datetime '2022-01-22',interval '3' minute);

Le résultat suivant est renvoyé :

+-----------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' MINUTE)|
+-----------------------------------------------------+
|                                 2022-01-22 00:03:00 |

Exemple 7

select adddate(datetime '2022-01-22',interval '3' hour);

Le résultat suivant est renvoyé :

+---------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' HOUR |
+---------------------------------------------------+
|                               2022-01-22 03:00:00 |

Exemple 8

select adddate(datetime '2022-01-22',interval '3' month);

Le résultat suivant est renvoyé :

+----------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' MONTH)|
+----------------------------------------------------+
|                                2022-04-22 00:00:00 |

Exemple 9

select adddate(datetime '2022-01-22',interval '3' year);

Le résultat suivant est renvoyé :

+---------------------------------------------------+
| adddate(DATETIME '2022-01-22', INTERVAL  '3' YEAR)|
+---------------------------------------------------+
|                               2025-01-22 00:00:00 |

Exemple 10

select adddate(datetime '2022-01-22',interval '01:01:10' hour_second) as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-22 01:01:10 |

Exemple 11

select adddate(datetime '2022-01-22',interval '00:10' hour_minute) as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-22 00:10:00 |

Exemple 12

select adddate(datetime '2022-01-22',interval '1 01:01:10' day_second) as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-23 01:01:10 |

Exemple 13

select adddate(datetime '2022-01-22',interval '01:10' minute_second) as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-22 00:01:10 |

Exemple 14

select adddate(datetime '2022-01-22',interval '1 01:01' day_minute) as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-23 01:01:00 |

Exemple 15

select adddate(datetime '2022-01-22',interval '1 01' day_hour) as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-23 01:00:00 |

Exemple 16

select adddate(datetime '2022-01-22 12:32:1',interval '2 2' year_month) as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2024-03-22 12:32:01 |

Exemple 17

select adddate('2022-01-22','3');

Le résultat suivant est renvoyé :

+---------------------------+
| adddate('2022-01-22', '3')|
+---------------------------+
| 2022-01-25                |

Exemple 18

select adddate('2022-01-22',3);

Le résultat suivant est renvoyé :

+-------------------------+
| adddate('2022-01-22', 3)|
+-------------------------+
| 2022-01-25              |

Exemple 19

select adddate(datetime '2022-01-22 12:12:32',3);

Le résultat suivant est renvoyé :

+-------------------------------------------+
| adddate(DATETIME '2022-01-22 12:12:32', 3)|
+-------------------------------------------+
|                       2022-01-25 12:12:32 |

Exemple 20

select adddate(datetime '2022-01-22 12:12:32','3');

Le résultat suivant est renvoyé :

+---------------------------------------------+
| adddate(DATETIME '2022-01-22 12:12:32', '3')|
+---------------------------------------------+
|                         2022-01-25 12:12:32 |

Exemple 21

select adddate(timestamp '2022-01-22 12:12:32','3');

Le résultat suivant est renvoyé :

+----------------------------------------------+
| adddate(TIMESTAMP '2022-01-22 12:12:32', '3')|
+----------------------------------------------+
|                          2022-01-25 12:12:32 |

Exemple 22

select adddate(timestamp '2022-01-22 12:12:32',3);

Le résultat suivant est renvoyé :

+--------------------------------------------+
| adddate(TIMESTAMP '2022-01-22 12:12:32', 3)|
+--------------------------------------------+
|                        2022-01-25 12:12:32 |

Exemple 23

select adddate('2022-01-22 12:12:32',3);

Le résultat suivant est renvoyé :

+----------------------------------+
| adddate('2022-01-22 12:12:32', 3)|
+----------------------------------+
| 2022-01-25 12:12:32              |

Exemple 24

select adddate('2022-01-22 12:12:32','3');

Le résultat suivant est renvoyé :

+------------------------------------+
| adddate('2022-01-22 12:12:32', '3')|
+------------------------------------+
| 2022-01-25 12:12:32                |

ADDTIME

ADDTIME(expr1,expr2)

Description : cette fonction ajoute la durée spécifiée par expr2 à l'heure indiquée dans expr1 et renvoie le résultat.

Types de paramètres :

addtime(date,varchar)
addtime(time,varchar)
addtime(datetime,varchar)
addtime(timestamp,varchar)
addtime(varchar,varchar)

Type de données de la valeur de retour : VARCHAR.

Exemples :

Exemple 1

select addtime(date '2022-01-01','01:01:01');

Le système renvoie les informations suivantes :

+----------------------------------------+
| addtime(DATE '2022-01-01', '01:01:01') |
+----------------------------------------+
| 2022-01-01 01:01:01                    |

Exemple 2

select addtime(time '01:00:00','01:01:01');

Le système renvoie les informations suivantes :

+--------------------------------------+
| addtime(TIME '01:00:00', '01:01:01') |
+--------------------------------------+
| 02:01:01                             |

Exemple 3

select addtime(datetime '2022-01-22 00:00:00','01:01:01');

Le système renvoie les informations suivantes :

+----------------------------------------------------+
| addtime(DATETIME '2022-01-22 00:00:00', '01:01:01')|
+----------------------------------------------------+
| 2022-01-22 01:01:01                                |

Exemple 4

select addtime(timestamp '2022-01-22 00:00:00','01:01:01');

Le système renvoie les informations suivantes :

+-----------------------------------------------------+
| addtime(TIMESTAMP '2022-01-22 00:00:00', '01:01:01')|
+-----------------------------------------------------+
| 2022-01-22 01:01:01                                 |

Exemple 5

select addtime('2022-01-22 00:00:00','01:01:01');

Le système renvoie les informations suivantes :

+-------------------------------------------+
| addtime('2022-01-22 00:00:00', '01:01:01')|
+-------------------------------------------+
| 2022-01-22 01:01:01                       |

CONVERT_TZ

CONVERT_TZ(dt,from_tz,to_tz)

Description : cette fonction convertit une valeur datetime dt du fuseau horaire spécifié par from_tz vers le fuseau horaire indiqué dans to_tz et renvoie le résultat.

Types de paramètres :

convert_tz(varchar, varchar, varchar)

Type de données de la valeur de retour : DATETIME.

Exemples :

Exemple 1

select convert_tz('2022-01-01 12:00:00','+00:00','+10:00');

Le système renvoie les informations suivantes :

+-------------------------------------------------------+
| convert_tz('2022-01-01 12:00:00', '+00:00', '+10:00') |
+-------------------------------------------------------+
|                                   2022-01-01 22:00:00 |

Exemple 2

select convert_tz('2022-01-01 12:00:00','GMT','MET');

Le système renvoie les informations suivantes :

+-------------------------------------------------+
| convert_tz('2022-01-01 12:00:00', 'GMT', 'MET') |
+-------------------------------------------------+
|                             2022-01-01 13:00:00 |

CURDATE

CURDATE()

Description : cette fonction renvoie la date actuelle.
Type de données de la valeur de retour : DATE.

Exemple :

select curdate;

Le système renvoie les informations suivantes :

+------------+
| curdate()  |
+------------+
| 2022-01-01 |

CURTIME

CURTIME()

Description : cette fonction renvoie l'heure actuelle.
Type de données de la valeur de retour : TIME.

Exemple :

select curtime();

Le système renvoie les informations suivantes :

+--------------+
| curtime()    |
+--------------+
| 14:39:22.109 |

DATE

DATE(expr)

Description : cette fonction renvoie la partie date d'une expression de type date ou datetime.

Types de paramètres :

date(timestamp)
date(datetime)
date(varchar)

Type de données de la valeur de retour : DATE.

Exemples :

Exemple 1

select date(timestamp '2022-01-01 01:02:03');

Le système renvoie les informations suivantes :

+---------------------------------------+
| date(TIMESTAMP '2022-01-01 01:02:03') |
+---------------------------------------+
| 2022-01-01                            |

Exemple 2

select date(datetime '2022-01-01 01:02:03');

Le système renvoie les informations suivantes :

+--------------------------------------+
| date(DATETIME '2022-01-01 01:02:03') |
+--------------------------------------+
| 2022-01-01                           |

Exemple 3

select date('2022-01-01 01:02:03');

Le système renvoie les informations suivantes :

+-----------------------------+
| date('2022-01-01 01:02:03') |
+-----------------------------+
| 2022-01-01                  |

DATE_FORMAT

DATE_FORMAT(date,format)

Description : cette fonction renvoie une date sous forme de chaîne selon le format spécifié. Le tableau suivant décrit les spécificateurs de format.

%a	Nom abrégé du jour de la semaine. Valeurs valides : Sun à Sat.
%b	Nom abrégé du mois. Valeurs valides : Jan à Dec.
%c	Mois au format numérique. Valeurs valides : 0 à 12.
%d	Jour du mois au format numérique. Valeurs valides : 00 à 31.
%e	Jour du mois au format numérique. Valeurs valides : 0 à 31.
%f	Microsecondes. Valeurs valides : 000000 à 999999.
%H	Heure. Valeurs valides : 00 à 23.
%h	Heure. Valeurs valides : 01 à 12.
%I	Heure. Valeurs valides : 01 à 12.
%i	Minutes au format numérique. Valeurs valides : 00 à 59.
%j	Jour de l'année. Valeurs valides : 001 à 366.
%k	Heure. Valeurs valides : 0 à 23.
%l	Heure. Valeurs valides : 1 à 12.
%M	Nom du mois. Valeurs valides : January à December.
%m	Mois au format numérique. Valeurs valides : 00 à 12.
%p	Abréviation de la période de 12 heures de la journée. Valeurs valides : AM et PM.
%r	Heure au format 12 heures (hh:mm:ss AM ou hh:mm:ss PM).
%S	Seconde. Valeurs valides : 00 à 59.
%s	Seconde. Valeurs valides : 00 à 59.
%T	Heure au format 24 heures (hh:mm:ss).
%v	Numéro de la semaine dans l'année. Ce spécificateur s'applique au mode 3 de WEEK() et est utilisé avec %x. Remarque Le lundi est considéré comme le premier jour de la semaine.
%W	Nom du jour de la semaine. Valeurs valides : Sunday à Saturday.
%x	Année de la semaine au format numérique. Ce spécificateur est utilisé avec %v et la valeur contient quatre chiffres. Remarque Le lundi est considéré comme le premier jour de la semaine.
%Y	Année au format à quatre chiffres.
%y	Année au format à deux chiffres.
%%	Signe pourcentage (%).

Types de paramètres :

date_format(timestamp, varchar)
date_format(varchar, varchar) 
date_format(datetime, varchar)
date_format(date, varchar)

Type de données de la valeur de retour : VARCHAR.

Exemples :

Exemple 1

select date_format(timestamp '2022-01-27 13:23:00', '%W %M %Y')as result;

Le système renvoie les informations suivantes :

+-----------------------+
| result                |
+-----------------------+
| Thursday January 2022 |

Exemple 2

select date_format('2022-01-27 13:23:00', '%W %M %Y')as result;

Le système renvoie les informations suivantes :

+-----------------------+
| result                |
+-----------------------+
| Thursday January 2022 |

Exemple 3

select date_format(datetime '2022-01-27 13:23:00', '%W %M %Y')as result;

Le système renvoie les informations suivantes :

+-----------------------+
| result                |
+-----------------------+
| Thursday January 2022 |

Exemple 4

select date_format(date '2022-01-27', '%W %M %Y')as result;

Le système renvoie les informations suivantes :

+-----------------------+
| result                |
+-----------------------+
| Thursday January 2022 |

SUBDATE/DATE_SUB

DATE_SUB(date,INTERVAL expr unit)

description : Cette fonction soustrait l'intervalle spécifié par INTERVAL de la date indiquée par date.

Valeurs valides pour unit : second, minute, hour, day, month, year, minute_second, hour_second, hour_minute, day_second, day_minute, day_hour et year_month. La valeur par défaut de unit est day.

types de paramètres :

subdate(date, INTERVAL expr unit)
subdate(timestamp, INTERVAL expr unit)
subdate(datetime, INTERVAL expr unit)
subdate(varchar, INTERVAL expr unit)
subdate(date, bigint)
subdate(date, varchar)
subdate(datetime, bigint)
subdate(datetime, varchar)
subdate(timestamp, bigint)
subdate(timestamp, varchar)
subdate(varchar, bigint)
subdate(varchar, varchar)

type de données de la valeur renvoyée : DATE.

Exemples :

Exemple 1

select date_sub(date '2022-01-22',interval '3' day);

Les informations suivantes sont renvoyées :

+-----------------------------------------------+
| date_sub(DATE '2022-01-22', INTERVAL  '3' DAY)|
+-----------------------------------------------+
| 2022-01-19                                    |

Exemple 2

select date_sub(timestamp '2022-01-22 00:00:00',interval '3' day)as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2022-01-19 00:00:00 |

Exemple 3

select date_sub(datetime '2022-01-22 00:00:00',interval '3' day)as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2022-01-19 00:00:00 |

Exemple 4

select date_sub('2022-01-22 00:00:00',interval '3' day);

Les informations suivantes sont renvoyées :

+---------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' DAY)|
+---------------------------------------------------+
| 2022-01-19 00:00:00                               |

Exemple 5

select date_sub('2022-01-22 00:00:00',interval '3' second);

Les informations suivantes sont renvoyées :

+------------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' SECOND)|
+------------------------------------------------------+
| 2022-01-21 23:59:57                                  |

Exemple 6

select date_sub('2022-01-22 00:00:00',interval '3' minute);

Les informations suivantes sont renvoyées :

+------------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' MINUTE)|
+------------------------------------------------------+
| 2022-01-21 23:57:00                                  |

Exemple 7

select date_sub('2022-01-22 00:00:00',interval '3' hour);

Les informations suivantes sont renvoyées :

+----------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' HOUR)|
+----------------------------------------------------+
| 2022-01-21 21:00:00                                |

Exemple 8

select date_sub('2022-01-22 00:00:00',interval '3' month);

Les informations suivantes sont renvoyées :

+-----------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' MONTH)|
+-----------------------------------------------------+
| 2021-10-22 00:00:00                                 |

Exemple 9

select date_sub('2022-01-22 00:00:00',interval '3' year);

Les informations suivantes sont renvoyées :

+----------------------------------------------------+
| date_sub('2022-01-22 00:00:00', INTERVAL  '3' YEAR)|
+----------------------------------------------------+
| 2019-01-22 00:00:00                                |

Exemple 10

select date_sub('2022-01-22 00:00:00',interval '01:10' minute_second)as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2022-01-21 23:58:50 |

Exemple 11

select date_sub('2022-01-22 00:00:00',interval '01:01:10' hour_second)as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2022-01-21 22:58:50 |

Exemple 12

select date_sub('2022-01-22 00:00:00',interval '01:01' hour_minute)as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2022-01-21 22:59:00 |

Exemple 13

select date_sub('2022-01-22 00:00:00',interval '1 01:01:10' day_second)as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2022-01-20 22:58:50 |

Exemple 14

select date_sub('2022-01-22 00:00:00',interval '1 01:01' day_minute)as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2022-01-20 22:59:00 |

Exemple 15

select date_sub('2022-01-22 00:00:00',interval '1 01' day_hour)as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2022-01-20 23:00:00 |

Exemple 16

select date_sub('2022-01-22 00:00:00',interval '2 2' year_month)as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2019-11-22 00:00:00 |

Exemple 17

select date_sub(date '2022-01-22 00:00:00',3);

Les informations suivantes sont renvoyées :

+----------------------------------------+
| date_sub(DATE '2022-01-22 00:00:00', 3)|
+----------------------------------------+
| 2022-01-19                             |

Exemple 18

select date_sub(date '2022-01-22 00:00:00','3');

Les informations suivantes sont renvoyées :

+------------------------------------------+
| date_sub(DATE '2022-01-22 00:00:00', '3')|
+------------------------------------------+
| 2022-01-19                               |

Exemple 19

select date_sub(datetime '2022-01-22 00:00:00',3);

Les informations suivantes sont renvoyées :

+--------------------------------------------+
| date_sub(DATETIME '2022-01-22 00:00:00', 3)|
+--------------------------------------------+
|                        2022-01-19 00:00:00 |

Exemple 20

select date_sub(datetime '2022-01-22 00:00:00','3');

Les informations suivantes sont renvoyées :

+----------------------------------------------+
| date_sub(DATETIME '2022-01-22 00:00:00', '3')|
+----------------------------------------------+
|                          2022-01-19 00:00:00 |

Exemple 21

select date_sub(timestamp '2022-01-22 00:00:00',3);

Les informations suivantes sont renvoyées :

+---------------------------------------------+
| date_sub(TIMESTAMP '2022-01-22 00:00:00', 3)|
+---------------------------------------------+
|                         2022-01-19 00:00:00 |

Exemple 22

select date_sub(timestamp '2022-01-22 00:00:00','3');

Les informations suivantes sont renvoyées :

+-----------------------------------------------+
| date_sub(TIMESTAMP '2022-01-22 00:00:00', '3')|
+-----------------------------------------------+
|                           2022-01-19 00:00:00 |

Exemple 23

select date_sub('2022-01-22 00:00:00',3);

Les informations suivantes sont renvoyées :

+-----------------------------------+
| date_sub('2022-01-22 00:00:00', 3)|
+-----------------------------------+
| 2022-01-19 00:00:00               |

Exemple 24

select date_sub('2022-01-22 00:00:00','3');

Les informations suivantes sont renvoyées :

+-------------------------------------+
| date_sub('2022-01-22 00:00:00', '3')|
+-------------------------------------+
| 2022-01-19 00:00:00                 |

DATEDIFF

DATEDIFF(expr1,expr2)

description : Cette fonction calcule la différence entre la date spécifiée par expr2 et celle indiquée par expr1.

types de paramètres :

datediff(varchar, varchar) 
datediff(datetime, varchar)
datediff(varchar, datetime)
datediff(datetime, datetime)
datediff(varchar, timestamp)
datediff(timestamp, timestamp)
datediff(timestamp, varchar)
datediff(date, date)
datediff(date, varchar)
datediff(varchar, date)

type de données de la valeur renvoyée : BIGINT.

Exemples :

Exemple 1

select datediff('2022-01-22 23:59:59','2022-1-21');

Les informations suivantes sont renvoyées :

+-----------------------------------------------+
| datediff('2022-01-22 23:59:59','2022-1-21')   |
+-----------------------------------------------+
|                                             1 |

Exemple 2

select datediff(datetime '2022-01-22 23:59:59','2022-1-21')as result;

Les informations suivantes sont renvoyées :

+--------+
| result |
+--------+
|      1 |

Exemple 3

select datediff('2022-01-22 23:59:59',datetime '2022-1-21')as result;

Les informations suivantes sont renvoyées :

+--------+
| result |
+--------+
|      1 |

Exemple 4

select datediff(datetime '2022-01-22 23:59:59',datetime '2022-1-21')as result;

Les informations suivantes sont renvoyées :

+--------+
| result |
+--------+
|      1 |

Exemple 5

select datediff('2022-01-22 23:59:59',timestamp '2022-1-21')as result;

Les informations suivantes sont renvoyées :

+--------+
| result |
+--------+
|      1 |

Exemple 6

select datediff(timestamp '2022-01-22 23:59:59',timestamp '2022-1-21')as result;

Les informations suivantes sont renvoyées :

+--------+
| result |
+--------+
|      1 |

Exemple 7

select datediff(timestamp '2022-01-22 23:59:59','2022-1-21')as result;

Les informations suivantes sont renvoyées :

+--------+
| result |
+--------+
|      1 |

Exemple 8

select datediff(date '2022-01-22 23:59:59',date '2022-01-21')as result;

Les informations suivantes sont renvoyées :

+--------+
| result |
+--------+
|      1 |

Exemple 9

select datediff(date '2022-01-22 23:59:59','2022-01-21')as result;

Les informations suivantes sont renvoyées :

+--------+
| result |
+--------+
|      1 |

Exemple 10

select datediff('2022-01-22',date '2021-01-21');

Les informations suivantes sont renvoyées :

+-------------------------------------------+
| datediff('2022-01-22', DATE '2021-01-21') |
+-------------------------------------------+
|                                      366  |

DAY/DAYOFMONTH

DAY(date)
DAYOFMONTH(date)

description : Cette fonction renvoie le jour du mois correspondant à la date indiquée par date. Valeurs valides : 1 to 31.

types de paramètres :

dayofmonth(timestamp)
dayofmonth(datetime)
dayofmonth(date)
dayofmonth(time)
dayofmonth(varchar)

type de données de la valeur renvoyée : BIGINT.

Exemples :

Exemple 1

select dayofmonth(timestamp '2022-01-22 12:23:09');

Les informations suivantes sont renvoyées :

+---------------------------------------------+
| dayofmonth(TIMESTAMP '2022-01-22 12:23:09') |
+---------------------------------------------+
|                                          22 |

Exemple 2

select dayofmonth(date '2022-01-22');

Les informations suivantes sont renvoyées :

+-------------------------------+
| dayofmonth(DATE '2022-01-22') |
+-------------------------------+
|                            22 |

Exemple 3

select dayofmonth(time '17:01:10');

Les informations suivantes, qui affichent la date actuelle, sont renvoyées :

+-----------------------------+
| dayofmonth(TIME '17:01:10') |
+-----------------------------+
|                          22 |

Exemple 4

select dayofmonth(datetime '2022-01-22 00:00:00');

Les informations suivantes sont renvoyées :

+--------------------------------------------+
| dayofmonth(DATETIME '2022-01-22 00:00:00') |
+--------------------------------------------+
|                                         22 |

Exemple 5

select day('2022-01-22');

Les informations suivantes sont renvoyées :

+-------------------+
| day('2022-01-22') |
+-------------------+
|                22 |

DAYNAME

DAYNAME(date)

Description : cette fonction renvoie le jour de la semaine correspondant à une date, par exemple Monday.

Types de paramètres :

dayname(timestamp)
dayname(datetime)
dayname(date)
dayname(varchar)

Type de données de la valeur de retour : VARCHAR.

Exemples :

Exemple 1

select dayname(timestamp '2022-01-22 00:00:00');

Le résultat suivant est renvoyé :

+------------------------------------------+
| dayname(TIMESTAMP '2022-01-22 00:00:00') |
+------------------------------------------+
| Saturday                                 |

Exemple 2

select dayname(datetime '2022-01-22 00:00:00');

Le résultat suivant est renvoyé :

+-----------------------------------------+
| dayname(DATETIME '2022-01-22 00:00:00') |
+-----------------------------------------+
| Saturday                                |

Exemple 3

select dayname(date '2022-01-22');

Le résultat suivant est renvoyé :

+----------------------------+
| dayname(DATE '2022-01-22') |
+----------------------------+
| Saturday                   |

Exemple 4

select dayname('2022-01-22');

Le résultat suivant est renvoyé :

+-----------------------+
| dayname('2022-01-22') |
+-----------------------+
| Saturday              |

DAYOFWEEK

DAYOFWEEK(date)

Description : cette fonction renvoie le jour de la semaine sous forme de valeur numérique pour une date, où 1 correspond au dimanche, 2 au lundi et 7 au samedi.

Types de paramètres :

dayofweek(timestamp)
dayofweek(datetime)
dayofweek(date)
dayofweek(varchar)

Type de données de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select dayofweek(timestamp '2022-01-22 00:00:00');

Le résultat suivant est renvoyé :

+--------------------------------------------+
| dayofweek(TIMESTAMP '2022-01-22 00:00:00') |
+--------------------------------------------+
|                                          7 |

Exemple 2

select dayofweek(datetime '2022-01-22 00:00:00');

Le résultat suivant est renvoyé :

+-------------------------------------------+
| dayofweek(DATETIME '2022-01-22 00:00:00') |
+-------------------------------------------+
|                                         7 |

Exemple 3

select dayofweek(date '2022-01-22');

Le résultat suivant est renvoyé :

+------------------------------+
| dayofweek(DATE '2022-01-22') |
+------------------------------+
|                            7 |

Exemple 4

select dayofweek('2022-01-22');

Le résultat suivant est renvoyé :

+-------------------------+
| dayofweek('2022-01-22') |
+-------------------------+
|                       7 |

DAYOFYEAR

DAYOFYEAR(date)

Description : cette fonction renvoie le jour de l'année correspondant à une date. Valeurs valides : 1 to 366.

Types de paramètres :

dayofyear(timestamp)
dayofyear(datetime) 
dayofyear(date) 
dayofyear(varchar)

Type de données de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select dayofyear(timestamp '2022-02-01 00:12:12');

Le résultat suivant est renvoyé :

+--------------------------------------------+
| dayofyear(TIMESTAMP '2022-02-01 00:12:12') |
+--------------------------------------------+
|                                         32 |

Exemple 2

select dayofyear(datetime '2022-02-01 00:12:12');

Le résultat suivant est renvoyé :

+-------------------------------------------+
| dayofyear(DATETIME '2022-02-01 00:12:12') |
+-------------------------------------------+
|                                        32 |

Exemple 3

select dayofyear(date '2022-02-01');

Le résultat suivant est renvoyé :

+------------------------------+
| dayofyear(DATE '2022-02-01') |
+------------------------------+
|                           32 |

Exemple 4

select dayofyear('2022-02-01');

Le résultat suivant est renvoyé :

+-------------------------+
| dayofyear('2022-02-01') |
+-------------------------+
|                      32 |

EXTRACT

EXTRACT(unit FROM date)

Description : cette fonction renvoie une ou plusieurs parties distinctes d'une date ou d'une heure selon l'unit spécifiée. Par exemple, elle peut renvoyer l'année, le mois, le jour, l'heure ou la minute d'une date ou d'une heure.

Valeurs valides pour unit : second, minute, hour, day, month, year, minute_second, hour_second, hour_minute, day_second, day_minute, day_hour et year_month.
Types de paramètres d'entrée pris en charge : VARCHAR, TIMESTAMP, DATETIME et TIME.
Type de données de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select extract(second from '2022-01-22 00:12:34');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|    34 |

Exemple 2

select extract(minute from '2022-01-22 00:12:34');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|    12 |

Exemple 3

select extract(hour from '2022-01-22 00:12:34');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|     0 |

Exemple 4

select extract(day from '2022-01-22 00:12:34');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|    22 |

Exemple 5

select extract(month from '2022-01-22 00:12:34');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|     1 |

Exemple 6

select extract(year from timestamp '2022-01-22');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|  2022 |

Exemple 7

select extract(year from datetime  '2022-01-22');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|  2022 |

Exemple 8

select extract(year from time '15:23:22');

Le résultat suivant, qui indique l'année en cours, est renvoyé.

+-------+
| _col0 |
+-------+
|  2022 |

Exemple 9

select extract(minute_second from '2022-01-22 00:12:34');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|  1234 |

Exemple 10

select extract(hour_second from '2022-01-22 12:12:34');

Le résultat suivant est renvoyé :

+--------+
| _col0  |
+--------+
| 121234 |

Exemple 11

select extract(hour_minute from '2022-01-22 12:12:34');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|  1212 |

Exemple 12

select extract(day_second from '2022-01-22 12:12:34');

Le résultat suivant est renvoyé :

+----------+
| _col0    |
+----------+
| 22121234 |

Exemple 13

select extract(day_minute from '2022-01-22 00:12:34');

Le résultat suivant est renvoyé :

+--------+
| _col0  |
+--------+
| 220012 |

Exemple 14

select extract(day_hour from '2022-01-22 12:12:34');

Le résultat suivant est renvoyé :

+-------+
| _col0 |
+-------+
|  2212 |

Exemple 15

select extract(year_month from '2022-01-22 00:12:34');

Le résultat suivant est renvoyé :

+--------+
| _col0  |
+--------+
| 202201 |

FROM_DAYS

FROM_DAYS(N)

Description : cette fonction renvoie une valeur DATE basée sur le paramètre N qui spécifie le nombre de jours.
Types de paramètres :
```
from_days(varchar) 
from_days(bigint)
```
Type de données de la valeur de retour : DATE.

Exemples :

Exemple 1

select from_days(738565);

Le résultat suivant est renvoyé :

+-------------------+
| from_days(738565) |
+-------------------+
|  2022-02-14       |

Exemple 2

select from_days('738565');

Le résultat suivant est renvoyé :

+---------------------+
| from_days('738565') |
+---------------------+
|  2022-02-14         |

FROM_UNIXTIME

FROM_UNIXTIME(unix_timestamp[,format])

Description : cette fonction renvoie l'horodatage UNIX spécifié par unix dans le format indiqué.

Le paramètre format est conforme au format de la fonction DATE_FORMAT.

Types de paramètres :

from_unixtime(varchar, varchar)
from_unixtime(varchar)
from_unixtime(double, varchar)
from_unixtime(double)

Type de données de la valeur de retour : DATETIME.

Exemples :

Exemple 1

select from_unixtime('1647738565','%Y %M %h:%i:%s %x');

Le résultat suivant est renvoyé :

+--------------------------------------------------+
| from_unixtime('1647738565', '%Y %M %h:%i:%s %x') |
+--------------------------------------------------+
|    2022 March 09:09:25 2022                      |

Exemple 2

select from_unixtime('1647738565');

Le résultat suivant est renvoyé :

+-----------------------------+
| from_unixtime('1647738565') |
+-----------------------------+
|         2022-03-20 09:09:25 |

Exemple 3

select from_unixtime(1647738456);

Le résultat suivant est renvoyé :

+---------------------------+
| from_unixtime(1647738456) |
+---------------------------+
|       2022-03-20 09:07:36 |

Exemple 4

select from_unixtime(1647738456,'%Y %M %h:%i:%s %x');

Le résultat suivant est renvoyé :

+------------------------------------------------+
| from_unixtime(1647738456, '%Y %M %h:%i:%s %x') |
+------------------------------------------------+
|     2022 March 09:07:36 2022                   |

HOUR

HOUR(time)

Description : cette fonction renvoie la partie heure d'une heure.

Types de paramètres :

hour(timestamp)
hour(datetime)
hour(date)
hour(time)
hour(varchar)

Type de données de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select hour(timestamp '2022-01-22 10:05:03');

Le résultat suivant est renvoyé :

+---------------------------------------+
| hour(TIMESTAMP '2022-01-22 10:05:03') |
+---------------------------------------+
|                                    10 |

Exemple 2

select hour(datetime '2022-01-22 10:05:03');

Le résultat suivant est renvoyé :

+--------------------------------------+
| hour(DATETIME '2022-01-22 10:05:03') |
+--------------------------------------+
|                                   10 |

Exemple 3

select hour(date '2022-01-22');

Le résultat suivant est renvoyé :

+-------------------------+
| hour(DATE '2022-01-22') |
+-------------------------+
|                       0 |

Exemple 4

select hour(time '10:05:03');

Le résultat suivant est renvoyé :

+-----------------------+
| hour(TIME '10:05:03') |
+-----------------------+
|                    10 |

Exemple 5

select hour('10:05:03');

Le résultat suivant est renvoyé :

+------------------+
| hour('10:05:03') |
+------------------+
|       10         |

LAST_DAY

LAST_DAY(date)

Description : cette fonction renvoie le dernier jour du mois correspondant à une date ou à un horodatage.

Types de paramètres :

last_day(varchar)
last_day(timestamp)
last_day(datetime)
last_day(date)

Type de la valeur de retour : DATE.

Exemples :

Exemple 1

select last_day('2022-01-22');

Le résultat suivant est renvoyé :

+------------------------+
| last_day('2022-01-22') |
+------------------------+
| 2022-01-31             |

Exemple 2

select last_day(timestamp '2022-01-22 12:12:12');

Le résultat suivant est renvoyé :

+-------------------------------------------+
| last_day(TIMESTAMP '2022-01-22 12:12:12') |
+-------------------------------------------+
| 2022-01-31                                |

Exemple 3

select last_day(datetime '2022-01-22 12:12:12');

Le résultat suivant est renvoyé :

+------------------------------------------+
| last_day(DATETIME '2022-01-22 12:12:12') |
+------------------------------------------+
| 2022-01-31                               |

Exemple 4

select last_day(date '2022-01-22');

Le résultat suivant est renvoyé :

+-----------------------------+
| last_day(DATE '2022-01-22') |
+-----------------------------+
| 2022-01-31                  |

LOCALTIME/LOCALTIMESTAMP/NOW

localtime
localtime()
localtimestamp
localtimestamp()
now()

Description : cette fonction renvoie l'horodatage actuel.
Type de la valeur de retour : DATETIME.

Exemples :

Exemple 1

select now();

Le résultat suivant est renvoyé :

+---------------------+
| now()               |
+---------------------+
| 2022-01-22 16:28:37 |

Exemple 2

select localtime;

Le résultat suivant est renvoyé :

+---------------------+
| localtime()         |
+---------------------+
| 2022-01-22 16:28:37 |

Exemple 3

select localtime();

Le résultat suivant est renvoyé :

+---------------------+
| localtime()         |
+---------------------+
| 2022-01-22 16:28:37 |

Exemple 4

select localtimestamp;

Le résultat suivant est renvoyé :

+---------------------+
| localtimestamp()    |
+---------------------+
| 2022-01-22 17:28:37 |

Exemple 5

select localtimestamp();

Le résultat suivant est renvoyé :

+---------------------+
| localtimestamp()    |
+---------------------+
| 2022-01-22 17:38:13 |

MAKEDATE

MAKEDATE(year,dayofyear)

Description : cette fonction renvoie une date à partir des paramètres year et dayofyear.

Types de paramètres :

makedate(bigint, bigint)
makedate(varchar, varchar)

Type de la valeur de retour : DATE.

Exemples :

Exemple 1

select makedate(2022,31), makedate(2022,32);

Le résultat suivant est renvoyé :

+--------------------+--------------------+
| makedate(2022, 31) | makedate(2022, 32) |
+--------------------+--------------------+
| 2022-01-31         | 2022-02-01         |

Exemple 2

select makedate('2022','31'), makedate('2022','32');

Le résultat suivant est renvoyé :

+------------------------+------------------------+
| makedate('2022', '31') | makedate('2022', '32') |
+------------------------+------------------------+
| 2022-01-31             | 2022-02-01             |

MAKETIME

MAKETIME(hour,minute,second)

Description : cette fonction renvoie une heure à partir des paramètres hour, minute et second.

Types de paramètres :

maketime(bigint, bigint, bigint)
maketime(varchar, varchar, varchar)

Type de la valeur de retour : TIME.

Exemples :

Exemple 1

select maketime(12,15,30);

Le résultat suivant est renvoyé :

+----------------------+
| maketime(12, 15, 30) |
+----------------------+
| 12:15:30             |

Exemple 2

select maketime('12','15','30');

Le résultat suivant est renvoyé :

+----------------------------+
| maketime('12', '15', '30') |
+----------------------------+
| 12:15:30                   |

MINUTE

MINUTE(time)

Description : cette fonction renvoie la partie minute d'une heure.

Types de paramètres :

minute(timestamp)
minute(datetime)
minute(date)
minute(time)
minute(varchar)

Type de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select minute(timestamp '2022-02-03 10:05:03');

Le résultat suivant est renvoyé :

+-----------------------------------------+
| minute(TIMESTAMP '2022-02-03 10:05:03') |
+-----------------------------------------+
|                                       5 |

Exemple 2

select minute(datetime '2022-02-03 10:05:03');

Le résultat suivant est renvoyé :

+----------------------------------------+
| minute(DATETIME '2022-02-03 10:05:03') |
+----------------------------------------+
|                                      5 |

Exemple 3

select minute(date '2022-02-03');

Le résultat suivant est renvoyé :

+---------------------------+
| minute(DATE '2022-02-03') |
+---------------------------+
|                         0 |

Exemple 4

select minute(time '12:12:12');

Le résultat suivant est renvoyé :

+-------------------------+
| minute(TIME '12:12:12') |
+-------------------------+
|                      12 |

Exemple 5

select minute('2022-02-03 10:05:03');

Le résultat suivant est renvoyé :

+-------------------------------+
| minute('2022-02-03 10:05:03') |
+-------------------------------+
|                             5 |

MONTH

MONTH(date)

Description : cette fonction renvoie la partie mois d'une date.

Types de paramètres :

month(timestamp)
month(datetime)
month(date)
month(time)
month(varchar)

Type de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select month(timestamp '2022-02-03 00:00:00');

Le résultat suivant est renvoyé :

+----------------------------------------+
| month(TIMESTAMP '2022-02-03 00:00:00') |
+----------------------------------------+
|                                      2 |

Exemple 2

select month(datetime '2022-02-03 00:00:00');

Le résultat suivant est renvoyé :

+---------------------------------------+
| month(DATETIME '2022-02-03 00:00:00') |
+---------------------------------------+
|                                     2 |

Exemple 3

select month(date '2022-02-03');

Le résultat suivant est renvoyé :

+--------------------------+
| month(DATE '2022-02-03') |
+--------------------------+
|                        2 |

Exemple 4

La fonction MONTH peut également renvoyer le mois au moment de l'exécution d'une instruction SQL. Dans l'exemple suivant, la valeur 5 est renvoyée pour une instruction SQL exécutée en mai 2021.

select month(time '12:12:12');

Le résultat suivant est renvoyé :

+------------------------+
| month(TIME '12:12:12') |
+------------------------+
|                      5 |

Exemple 5

select month('2022-02-03');

Le résultat suivant est renvoyé :

+---------------------+
| month('2022-02-03') |
+---------------------+
|                   2 |

MONTHNAME

MONTHNAME(date)

Description : cette fonction renvoie le nom complet du mois correspondant à une date.

Types de paramètres :

monthname(timestamp)
monthname(datetime)
monthname(date)
monthname(varchar)

Type de la valeur de retour : VARCHAR.

Exemples :

Exemple 1

select monthname(timestamp '2022-02-03 00:00:00');

Le résultat suivant est renvoyé :

+--------------------------------------------+
| monthname(TIMESTAMP '2022-02-03 00:00:00') |
+--------------------------------------------+
| February                                   |

Exemple 2

select monthname(datetime '2022-02-03 00:00:00');

Le résultat suivant est renvoyé :

+-------------------------------------------+
| monthname(DATETIME '2022-02-03 00:00:00') |
+-------------------------------------------+
| February                                  |

Exemple 3

select monthname(date '2022-02-03');

Le résultat suivant est renvoyé :

+------------------------------+
| monthname(DATE '2022-02-03') |
+------------------------------+
| February                     |

Exemple 4

select monthname('2022-02-03');

Le résultat suivant est renvoyé :

+-------------------------+
| monthname('2022-02-03') |
+-------------------------+
| February                |

PERIOD_ADD

PERIOD_ADD(P,N)

Description : cette fonction ajoute un nombre de mois spécifié par N à la période spécifiée par P.

Types de paramètres :

period_add(bigint, bigint)
period_add(varchar, varchar) 
period_add(varchar, bigint)

Type de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select period_add(202201,2);

Le résultat suivant est renvoyé :

+-----------------------+
| period_add(202201, 2) |
+-----------------------+
|                202203 |

Exemple 2

select period_add('202201','2');

Le résultat suivant est renvoyé :

+---------------------------+
| period_add('202201', '2') |
+---------------------------+
|                    202203 |

Exemple 3

select period_add('202201',2);

Le résultat suivant est renvoyé :

+-------------------------+
| period_add('202201', 2) |
+-------------------------+
|                  202203 |

PERIOD_DIFF

PERIOD_DIFF(P1,P2)

Description : cette fonction renvoie le nombre de mois entre les deux périodes spécifiées par P1 et P2.

Types de paramètres :

period_diff(bigint, bigint)
period_diff(varchar, varchar)

Type de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select period_diff(202202,202103);

Le résultat suivant est renvoyé :

+----------------------------+
| period_diff(202202,202103) |
+----------------------------+
|                         11 |

Exemple 2

select period_diff('202202','202103');

Le résultat suivant est renvoyé :

+---------------------------------+
| period_diff('202202', '202103') |
+---------------------------------+
|                              11 |

QUARTER

QUARTER(date)

Description : cette fonction renvoie le trimestre de l'année correspondant à une date. Valeurs valides : 1 to 4.

Types de paramètres :

quarter(datetime)
quarter(varchar)
quarter(timestamp)
quarter(date)

Type de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select quarter(datetime '2022-04-01 12:12:12');

Le résultat suivant est renvoyé :

+-----------------------------------------+
| quarter(DATETIME '2022-04-01 12:12:12') |
+-----------------------------------------+
|                                       2 |

Exemple 2

select quarter('2022-04-01');

Le résultat suivant est renvoyé :

+-----------------------+
| quarter('2022-04-01') |
+-----------------------+
|                     2 |

Exemple 3

select quarter(timestamp '2022-04-01 12:12:12');

Le résultat suivant est renvoyé :

+------------------------------------------+
| quarter(TIMESTAMP '2022-04-01 12:12:12') |
+------------------------------------------+
|                                        2 |

Exemple 4

select quarter(date '2022-04-01');

Le résultat suivant est renvoyé :

+----------------------------+
| quarter(DATE '2022-04-01') |
+----------------------------+
|                          2 |

SEC_TO_TIME

SEC_TO_TIME(seconds)

description : Cette fonction convertit une quantité de secondes spécifiée par seconds en heure.

types de paramètre :

sec_to_time(bigint)
sec_to_time(varchar)

type de données de la valeur renvoyée : TIME.

Exemples :

Exemple 1

select sec_to_time(2378);

Les informations suivantes sont renvoyées :

+-------------------+
| sec_to_time(2378) |
+-------------------+
| 00:39:38          |

Exemple 2

select sec_to_time('2378');

Les informations suivantes sont renvoyées :

+---------------------+
| sec_to_time('2378') |
+---------------------+
| 00:39:38            |

SECOND

SECOND(time)

description : Cette fonction renvoie la partie seconde de l'heure spécifiée. Valeurs valides : 0 to 59.

types de paramètre :

second(timestamp)
second(datetime)
second(date)
second(time)
second(varchar)

type de données de la valeur renvoyée : BIGINT.

Exemples :

Exemple 1

select second(timestamp '2022-03-12 12:13:14');

Les informations suivantes sont renvoyées :

+-----------------------------------------+
| second(TIMESTAMP '2022-03-12 12:13:14') |
+-----------------------------------------+
|                                      14 |

Exemple 2

select second(datetime '2022-03-12 12:13:14');

Les informations suivantes sont renvoyées :

+----------------------------------------+
| second(DATETIME '2022-03-12 12:13:14') |
+----------------------------------------+
|                                     14 |

Exemple 3

select second(date '2022-03-12');

Les informations suivantes sont renvoyées :

+---------------------------+
| second(DATE '2022-03-12') |
+---------------------------+
|                         0 |

Exemple 3

select second(time '12:13:14');

Les informations suivantes sont renvoyées :

+-------------------------+
| second(TIME '12:13:14') |
+-------------------------+
|                      14 |

Exemple 4

select second('12:12:23');

Les informations suivantes sont renvoyées :

+--------------------+
| second('12:12:23') |
+--------------------+
|                 23 |

STR_TO_DATE

STR_TO_DATE(str,format)

description : Cette fonction convertit une chaîne en date ou datetime selon le format spécifié.

Le paramètre format est conforme au paramètre format de la fonction DATE_FORMAT.
types de paramètre :
```
str_to_date(varchar, varchar)
```
type de données de la valeur renvoyée : DATETIME.

Exemples :

Exemple 1

select str_to_date('2022-01-06 10:20:30','%Y-%m-%d %H:%i:%s') as result;

Les informations suivantes sont renvoyées :

+---------------------+
| result              |
+---------------------+
| 2022-01-06 10:20:30 |

SUBTIME

SUBTIME(expr1,expr2)

description : Cette fonction soustrait l'intervalle spécifié par expr2 de l'heure spécifiée par expr1.

types de paramètre :

subtime(date, varchar)
subtime(datetime, varchar)
subtime(timestamp, varchar)
subtime(time, varchar)
subtime(varchar, varchar)

type de données de la valeur renvoyée : DATETIME.

Exemples :

Exemple 1

select subtime(date '2022-10-31','0:1:1');

Les informations suivantes sont renvoyées :

+-------------------------------------+
| subtime(DATE '2022-10-31', '0:1:1') |
+-------------------------------------+
|                 2022-10-30 23:58:59 |

Exemple 2

select subtime(datetime '2022-10-31 12:12:12','0:1:1');

Les informations suivantes sont renvoyées :

+--------------------------------------------------+
| subtime(DATETIME '2022-10-31 12:12:12', '0:1:1') |
+--------------------------------------------------+
|                              2022-10-31 12:11:11 |

Exemple 3

select subtime(timestamp '2022-10-31 12:12:12','0:1:1');

Les informations suivantes sont renvoyées :

+---------------------------------------------------+
| subtime(TIMESTAMP '2022-10-31 12:12:12', '0:1:1') |
+---------------------------------------------------+
|                               2022-10-31 12:11:11 |

Exemple 4

select subtime(time '12:12:12','0:1:1');

Les informations suivantes sont renvoyées :

+-----------------------------------+
| subtime(TIME '12:12:12', '0:1:1') |
+-----------------------------------+
| 12:11:11                          |
+-----------------------------------+

Exemple 5

select subtime('2022-10-31 23:59:59','0:1:1');

Les informations suivantes sont renvoyées :

+-----------------------------------------+
| subtime('2022-10-31 23:59:59', '0:1:1') |
+-----------------------------------------+
| 2022-10-31 23:58:58                     |

SYSDATE

SYSDATE()

description : Cette fonction renvoie l'heure système.
type de données de la valeur renvoyée : DATETIME.

Exemples :

Exemple 1

select sysdate();

Les informations suivantes sont renvoyées :

+---------------------+
| sysdate()           |
+---------------------+
| 2022-02-26 00:47:21 |

TIME

TIME(expr)

description : Cette fonction renvoie la partie horaire de l'expression de date ou datetime spécifiée par expr sous forme de chaîne.

types de paramètre :

time(varchar)
time(datetime)
time(timestamp)

type de données de la valeur renvoyée : VARCHAR.

Exemples :

Exemple 1

select time('2022-01-31 01:02:03');

Les informations suivantes sont renvoyées :

+-----------------------------+
| time('2022-01-31 01:02:03') |
+-----------------------------+
| 01:02:03                    |

Exemple 2

select time(datetime '2022-01-31 01:02:03');

Les informations suivantes sont renvoyées :

+--------------------------------------+
| time(DATETIME '2022-01-31 01:02:03') |
+--------------------------------------+
| 01:02:03                             |

Exemple 3

select time(timestamp '2022-01-31 01:02:03');

Les informations suivantes sont renvoyées :

+---------------------------------------+
| time(TIMESTAMP '2022-01-31 01:02:03') |
+---------------------------------------+
| 01:02:03                              |

TIME_FORMAT

TIME_FORMAT(time,format)

description : Cette fonction renvoie l'heure spécifiée par time sous forme de chaîne dans le format spécifié.

Le paramètre format est conforme au paramètre format de la fonction DATE_FORMAT.

types de paramètre :

time_format(varchar, varchar) 
time_format(timestamp, varchar)
time_format(datetime, varchar)
time_format(time, varchar) 
time_format(date, varchar)

type de données de la valeur renvoyée : VARCHAR.

Exemples :

Exemple 1

select time_format('12:00:00', '%H %k %h %I %l');

Les informations suivantes sont renvoyées :

+-------------------------------------------+
| time_format('12:00:00', '%H %k %h %I %l') |
+-------------------------------------------+
| 12 12 12 12 12                            |

Exemple 2

select time_format(timestamp '2022-01-22 23:00:00','%H %k %h %I %l')as result;

Les informations suivantes sont renvoyées :

+----------------+
| result         |
+----------------+
| 23 23 11 11 11 |

Exemple 3

select time_format(datetime '2022-01-22 23:00:00','%H %k %h %I %l')as result;

Les informations suivantes sont renvoyées :

+----------------+
| result         |
+----------------+
| 23 23 11 11 11 |

Exemple 4

select time_format(time '23:00:00','%H %k %h %I %l');

Les informations suivantes sont renvoyées :

+------------------------------------------------+
| time_format(TIME '23:00:00', '%H %k %h %I %l') |
+------------------------------------------------+
| 23 23 11 11 11                                 |

Exemple 5

select time_format(date '2022-01-22','%H %k %h %I %l');

Les informations suivantes sont renvoyées :

+--------------------------------------------------+
| time_format(DATE '2022-01-22', '%H %k %h %I %l') |
+--------------------------------------------------+
| 00 0 12 12 12                                    |

TIME_TO_SEC

TIME_TO_SEC(time)

description : Cette fonction convertit l'heure spécifiée par time en une quantité de secondes.

types de paramètre :

time_to_sec(varchar)
time_to_sec(datetime)
time_to_sec(timestamp)
time_to_sec(date)
time_to_sec(time)

type de données de la valeur renvoyée : BIGINT.

Exemples :

Exemple 1

select time_to_sec(datetime '2022-01-22 22:23:00');

Les informations suivantes sont renvoyées :

+---------------------------------------------+
| time_to_sec(DATETIME '2022-01-22 22:23:00') |
+---------------------------------------------+
|                                       80580 |

Exemple 2

select time_to_sec(timestamp '2022-01-22 22:23:00');

Les informations suivantes sont renvoyées :

+----------------------------------------------+
| time_to_sec(TIMESTAMP '2022-01-22 22:23:00') |
+----------------------------------------------+
|                                        80580 |

Exemple 3

select time_to_sec(date '2022-01-22');

Les informations suivantes sont renvoyées :

+--------------------------------+
| time_to_sec(DATE '2022-01-22') |
+--------------------------------+
|                              0 |

Exemple 4

select time_to_sec(time '12:12:12');

Les informations suivantes sont renvoyées :

+------------------------------+
| time_to_sec(TIME '12:12:12') |
+------------------------------+
|                        43932 |

Exemple 5

select time_to_sec('22:23:00');

Les informations suivantes sont renvoyées :

+-------------------------+
| time_to_sec('22:23:00') |
+-------------------------+
|                   80580 |

TIMEDIFF

TIMEDIFF(expr1,expr2)

description : Cette fonction soustrait l'heure spécifiée par expr2 de l'heure spécifiée par expr1. Cette fonction équivaut à la fonction SUBTIME.

types de paramètre :

timediff(time, varchar)
timediff(time, time)
timediff(varchar, varchar)

type de données de la valeur renvoyée : DATETIME.

Exemples :

Exemple 1

select timediff(time '12:00:00','10:00:00');

Les informations suivantes sont renvoyées :

+---------------------------------------+
| timediff(TIME '12:00:00', '10:00:00') |
+---------------------------------------+
| 02:00:00                              |

Exemple 2

select timediff('12:00:00','10:00:00');

Les informations suivantes sont renvoyées :

+----------------------------------+
| timediff('12:00:00', '10:00:00') |
+----------------------------------+
| 02:00:00                         |

Exemple 3

select timediff(time '12:00:00',time '10:00:00');

Les informations suivantes sont renvoyées :

+--------------------------------------------+
| timediff(TIME '12:00:00', TIME '10:00:00') |
+--------------------------------------------+
| 02:00:00                                   |

TIMESTAMP

TIMESTAMP(expr)

description : Cette fonction renvoie l'expression de date ou datetime spécifiée par expr sous forme de valeur datetime.

types de paramètre :

timestamp(date)
timestamp(varchar)

type de données de la valeur renvoyée : DATETIME.

Exemples :

Exemple 1

select timestamp(date '2022-01-22');

Les informations suivantes sont renvoyées :

+------------------------------+
| timestamp(DATE '2022-01-22') |
+------------------------------+
| 2022-01-22 00:00:00          |

Exemple 2

select timestamp('2022-01-22');

Les informations suivantes sont renvoyées :

+-------------------------+
| timestamp('2022-01-22') |
+-------------------------+
|     2022-01-22 00:00:00 |

TIMESTAMPADD

TIMESTAMPADD(unit,interval,datetime_expr)

Description : Cette fonction ajoute l'intervalle spécifié par interval à l'expression de date ou d'horodatage indiquée par datetime_expr. Le paramètre unit définit l'unité de l'interval.

Valeurs valides pour unit : second, minute, hour, day, week, month, quarter et year.

Types de paramètres :

timestampadd(varchar, varchar, timestamp) 
timestampadd(varchar, bigint, timestamp)
timestampadd(varchar, varchar, date)
timestampadd(varchar, bigint, date)
timestampadd(varchar, varchar, datetime)
timestampadd(varchar, bigint, datetime) 
timestampadd(varchar, varchar, varchar)
timestampadd(varchar, bigint, varchar)

Type de données de la valeur renvoyée : DATETIME.

Exemples :

Exemple 1

select timestampadd(second,'1',timestamp '2022-01-02 12:12:12')as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

Exemple 2

select timestampadd(second,1,timestamp '2022-01-02 12:12:12')as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

Exemple 3

select timestampadd(second,'1',date '2022-01-02 12:12:12')as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-02 00:00:01 |

Exemple 4

select timestampadd(second,1,date '2022-01-02 12:12:12')as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-02 00:00:01 |

Exemple 5

select timestampadd(second,'1',datetime '2022-01-02 12:12:12')as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

Exemple 6

select timestampadd(second,1,datetime '2022-01-02 12:12:12')as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

Exemple 7

select timestampadd(second,'1','2022-01-02 12:12:12')as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

Exemple 8

select timestampadd(second,1,'2022-01-02 12:12:12')as result;

Le résultat suivant est renvoyé :

+---------------------+
| result              |
+---------------------+
| 2022-01-02 12:12:13 |

Exemple 9

select timestampadd(second,1,'2022-01-02 12:12:12');

Le résultat suivant est renvoyé :

+--------------------------------------------------+
| timestampadd('second', 1, '2022-01-02 12:12:12') |
+--------------------------------------------------+
| 2022-01-02 12:12:13                              |

Exemple 10

select timestampadd(minute,8820,'2022-02-24 09:00:00');

Le résultat suivant est renvoyé :

+-----------------------------------------------------+
| timestampadd('MINUTE', 8820, '2022-02-24 09:00:00') |
+-----------------------------------------------------+
| 2022-03-02 12:00:00                                 |

Exemple 11

select timestampadd(hour,1,'2022-01-02 12:12:12');

Le résultat suivant est renvoyé :

+------------------------------------------------+
| timestampadd('hour', 1, '2022-01-02 12:12:12') |
+------------------------------------------------+
| 2022-01-02 13:12:12                            |

Exemple 12

select timestampadd(day,1,'2022-01-02 12:12:12');

Le résultat suivant est renvoyé :

+-----------------------------------------------+
| timestampadd('day', 1, '2022-01-02 12:12:12') |
+-----------------------------------------------+
| 2022-01-03 12:12:12                           |

Exemple 13

select timestampadd(week,1,'2022-01-02 12:12:12');

Le résultat suivant est renvoyé :

+------------------------------------------------+
| timestampadd('week', 1, '2022-01-02 12:12:12') |
+------------------------------------------------+
| 2022-01-09 12:12:12                            |

Exemple 14

select timestampadd(month,1,'2022-01-02 12:12:12');

Le résultat suivant est renvoyé :

+-------------------------------------------------+
| timestampadd('month', 1, '2022-01-02 12:12:12') |
+-------------------------------------------------+
| 2022-02-02 12:12:12                             |

Exemple 15

select timestampadd(year,1,'2022-01-02 12:12:12');

Le résultat suivant est renvoyé :

+------------------------------------------------+
| timestampadd('year', 1, '2022-01-02 12:12:12') |
+------------------------------------------------+
| 2023-01-02 12:12:12                            |

Exemple 16

select timestampadd(quarter,1,'2022-01-02 12:12:12');

Le résultat suivant est renvoyé :

+---------------------------------------------------+
| timestampadd('quarter', 1, '2022-01-02 12:12:12') |
+---------------------------------------------------+
| 2022-04-02 12:12:12                               |

TIMESTAMPDIFF

TIMESTAMPDIFF(unit,datetime_expr1,datetime_expr2)

Description : Cette fonction renvoie la différence entre deux expressions de date ou d'horodatage, en soustrayant celle spécifiée par datetime_expr1 de celle indiquée par datetime_expr2. Le paramètre unit définit l'unité du résultat.

Valeurs valides pour unit : second, minute, hour, day, week, month, quarter et year.

Cette fonction s'utilise de la même manière que TIMESTAMPADD.

Types de paramètres :

timestampdiff(varchar, timestamp, timestamp)
timestampdiff(varchar, date, date)
timestampdiff(varchar, datetime, datetime)
timestampdiff(varchar, varchar, varchar)

Type de données de la valeur renvoyée : BIGINT.

Exemples :

Exemple 1

select timestampdiff(second,datetime '2022-02-01 10:12:13',datetime '2022-03-01 10:12:13')as result;

Le résultat suivant est renvoyé :

+----------+
|  result  |
+----------+
|  2419200 |

Exemple 2

select timestampdiff(minute,datetime '2022-02-01 10:12:13',datetime '2022-03-01 10:12:13')as result;

Le résultat suivant est renvoyé :

+---------+
|  result |
+---------+
|  40320  |

Exemple 3

select timestampdiff(hour,datetime '2022-02-01 10:12:13',datetime '2022-03-01 10:12:13')as result;

Le résultat suivant est renvoyé :

+--------+
| result |
+--------+
|   672  |

Exemple 4

select timestampdiff(day,timestamp '2022-02-01',timestamp '2022-03-01')as result;

Le résultat suivant est renvoyé :

+--------+
| result |
+--------+
|    28  |

Exemple 5

select timestampdiff(day,date '2022-02-01',date '2022-03-01');

Le résultat suivant est renvoyé :

+------------------------------------------------------------+
| timestampdiff('day', DATE '2022-02-01', DATE '2022-03-01') |
+------------------------------------------------------------+
|                                                         28 |

Exemple 6

select timestampdiff(day,datetime '2022-02-01 10:12:13',datetime '2022-03-01 10:12:13')as result;

Le résultat suivant est renvoyé :

+--------+
| result |
+--------+
|    28  |

Exemple 7

select timestampdiff(day,'2022-02-01','2022-03-01');

Le résultat suivant est renvoyé :

+--------------------------------------------------+
| timestampdiff('day', '2022-02-01', '2022-03-01') |
+--------------------------------------------------+
|                                              28  |

Exemple 8

select timestampdiff(week,'2022-02-01','2022-03-01');

Le résultat suivant est renvoyé :

+---------------------------------------------------+
| timestampdiff('week', '2022-02-01', '2022-03-01') |
+---------------------------------------------------+
|                                                4  |

Exemple 9

select timestampdiff(quarter,'2022-02-01','2022-03-01');

Le résultat suivant est renvoyé :

+------------------------------------------------------+
| timestampdiff('quarter', '2022-02-01', '2022-03-01') |
+------------------------------------------------------+
|                                                   0  |

Exemple 10

select timestampdiff(month,'2022-02-01','2022-03-01');

Le résultat suivant est renvoyé :

+----------------------------------------------------+
| timestampdiff('month', '2022-02-01', '2022-03-01') |
+----------------------------------------------------+
|                                                 1  |

Exemple 11

select timestampdiff(year,datetime '2022-02-01 10:12:13',datetime '2020-05-01 10:12:13')as result;

Le résultat suivant est renvoyé :

+--------+
| result |
+--------+
|     -1 |

TO_DAYS

TO_DAYS(date)

Description : Cette fonction renvoie le nombre de jours écoulés depuis l'année 0 à partir de la date spécifiée par date.

Types de paramètres :

to_days(date)
to_days(time)
to_days(varchar)
to_days(timestamp)
to_days(datetime)

Type de données de la valeur renvoyée : BIGINT.

Exemples :

Exemple 1

select to_days(date '2022-02-12');

Le résultat suivant est renvoyé :

+----------------------------+
| to_days(DATE '2022-02-12') |
+----------------------------+
|                     738563 |

Exemple 2

select to_days(time '12:12:12');

Le système renvoie les informations suivantes, qui indiquent le nombre de jours écoulés depuis l'année 0 à partir de la date actuelle :

+--------------------------+
| to_days(TIME '12:12:12') |
+--------------------------+
|                   738563 |

Exemple 3

select to_days(now());

Le résultat suivant est renvoyé :

+----------------+
| to_days(now()) |
+----------------+
|         738563 |

Exemple 4

Remarque

Cet exemple équivaut à l'exemple 3.

select to_days(curdate());

Le résultat suivant est renvoyé :

+--------------------+
| to_days(curdate()) |
+--------------------+
|             738563 |

Exemple 5

select to_days(datetime '2022-02-12 12:12:12');

Le résultat suivant est renvoyé :

+-----------------------------------------+
| to_days(DATETIME '2022-02-12 12:12:12') |
+-----------------------------------------+
|                                  738563 |

Exemple 6

select to_days('2022-02-12 12:12:12');

Le résultat suivant est renvoyé :

+--------------------------------+
| to_days('2022-02-12 12:12:12') |
+--------------------------------+
|                         738563 |

Exemple 7

select to_days(timestamp '2022-02-12 12:12:12');

Le résultat suivant est renvoyé :

+------------------------------------------+
| to_days(TIMESTAMP '2022-02-12 12:12:12') |
+------------------------------------------+
|                                   738563 |

TO_SECONDS

TO_SECONDS(expr)

Description : Cette fonction renvoie le nombre de secondes écoulées depuis l'année 0 à partir de l'heure spécifiée par expr.

Types de paramètres :

to_seconds(date)
to_seconds(datetime)
to_seconds(timestamp)
to_seconds(varchar)
to_seconds(time)

Type de données de la valeur renvoyée : BIGINT.

Exemples :

Exemple 1

select to_seconds(date '2022-02-02');

Le résultat suivant est renvoyé :

+-------------------------------+
| to_seconds(DATE '2022-02-02') |
+-------------------------------+
|                   63810979200 |

Exemple 2

select to_seconds(datetime '2022-02-02 09:09:00');

Le résultat suivant est renvoyé :

+--------------------------------------------+
| to_seconds(DATETIME '2022-02-02 09:09:00') |
+--------------------------------------------+
|                                63811012140 |

Exemple 3

select to_seconds(timestamp '2022-02-02 09:09:00');

Le résultat suivant est renvoyé :

+---------------------------------------------+
| to_seconds(TIMESTAMP '2022-02-02 09:09:00') |
+---------------------------------------------+
|                                 63811012140 |

Exemple 4

Lorsque vous exécutez l'instruction SQL suivante, le système ajoute la valeur de curdate() à '09:09:00'.

select to_seconds(time '09:09:00');

Le résultat suivant est renvoyé :

+-----------------------------+
| to_seconds(TIME '09:09:00') |
+-----------------------------+
|                 63811012140 |

Exemple 5

select to_seconds('2022-02-02');

Le résultat suivant est renvoyé :

+--------------------------+
| to_seconds('2022-02-02') |
+--------------------------+
|              63810979200 |

UNIX_TIMESTAMP

UNIX_TIMESTAMP([date])

description : La fonction UNIX_TIMESTAMP() renvoie le nombre de secondes écoulées entre 00:00:00 January 1, 1970 in UTC et l'heure actuelle. La fonction UNIX_TIMESTAMP(date) renvoie le nombre de secondes écoulées entre 00:00:00 January 1, 1970 in UTC et la date spécifiée.

Types de paramètres :

unix_timestamp()
unix_timestamp(varchar)
unix_timestamp(timestamp)
unix_timestamp(date)
unix_timestamp(datetime)

Type de données de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select unix_timestamp();

Le résultat suivant est renvoyé :

+------------------+
| unix_timestamp() |
+------------------+
|       1654759686 |

Exemple 2

select unix_timestamp(timestamp '2022-02-08 12:12:12');

Le résultat suivant est renvoyé :

+-------------------------------------------------+
| unix_timestamp(TIMESTAMP '2022-02-08 12:12:12') |
+-------------------------------------------------+
|                                      1644293532 |

Exemple 3

select unix_timestamp(date '2022-02-08');

Le résultat suivant est renvoyé :

+-----------------------------------+
| unix_timestamp(DATE '2022-02-08') |
+-----------------------------------+
|                        1644249600 |

Exemple 4

select unix_timestamp(datetime '2022-02-08 12:12:12');

Le résultat suivant est renvoyé :

+------------------------------------------------+
| unix_timestamp(DATETIME '2022-02-08 12:12:12') |
+------------------------------------------------+
|                                     1644293532 |

Exemple 5

select unix_timestamp('2022-02-08 12:12:12');

Le résultat suivant est renvoyé :

+---------------------------------------+
| unix_timestamp('2022-02-08 12:12:12') |
+---------------------------------------+
|                            1644293532 |

UTC_DATE

UTC_DATE()

description : Cette fonction renvoie la date UTC.
Type de données de la valeur de retour : VARCHAR.

Exemple :

select utc_date();

Le résultat suivant est renvoyé :

+------------+
| utc_date() |
+------------+
| 2022-05-27 |

UTC_TIME

UTC_TIME()

description : Cette fonction renvoie l'heure UTC.
Type de données de la valeur de retour : VARCHAR.

Exemple :

select utc_time();

Le résultat suivant est renvoyé :

+------------+
| utc_time() |
+------------+
| 05:53:19   |

UTC_TIMESTAMP

utc_timestamp()

description : Cette fonction renvoie l'horodatage UTC.
Type de données de la valeur de retour : VARCHAR.

Exemple :

select utc_timestamp();

Le résultat suivant est renvoyé :

+---------------------+
| utc_timestamp()     |
+---------------------+
| 2022-05-27 15:55:15 |

WEEK

WEEK(date[,mode])

description : Cette fonction renvoie le numéro de semaine pour la date spécifiée par date, c'est-à-dire la semaine de l'année à laquelle appartient cette date.

date spécifie la date dont vous souhaitez obtenir le numéro de semaine.
mode est un paramètre facultatif qui définit le mode de calcul du numéro de semaine. Par défaut, le premier jour de la semaine est le dimanche. Vous pouvez également indiquer si la semaine commence le lundi ou le dimanche. Le tableau suivant décrit les formats pris en charge par le paramètre mode.

mode

Premier jour de la semaine

Valeurs valides pour le numéro de semaine

description

0

Dimanche

0 à 53

La première semaine de l'année commence le premier dimanche de l'année. La semaine contenant les jours précédant le premier dimanche de l'année est considérée comme la semaine 0.

1

Lundi

0 à 53

Si le nombre de jours entre le 1er janvier et le premier lundi dépasse trois jours, la semaine contenant les jours précédant le premier lundi de l'année est considérée comme la première semaine de l'année. Sinon, elle est considérée comme la semaine 0.

2

Dimanche

1 à 53

La première semaine de l'année commence le premier dimanche de l'année. La semaine contenant les jours précédant le premier dimanche de l'année est considérée comme la dernière semaine de l'année précédente.

3

Lundi

1 à 53

Si le nombre de jours entre le 1er janvier et le premier lundi dépasse trois jours, la semaine contenant les jours précédant le premier lundi de l'année est considérée comme la première semaine de l'année. Sinon, elle est considérée comme la dernière semaine de l'année précédente.

4

Dimanche

0 à 53

Si le nombre de jours entre le 1er janvier et le premier dimanche dépasse trois jours, la semaine contenant les jours précédant le premier dimanche de l'année est considérée comme la première semaine de l'année. Sinon, elle est considérée comme la semaine 0.

5

Lundi

0 à 53

La première semaine de l'année commence le premier lundi de l'année. La semaine contenant les jours précédant le premier lundi de l'année est considérée comme la semaine 0.

6

Dimanche

1 à 53

Si le nombre de jours entre le 1er janvier et le premier dimanche dépasse trois jours, la semaine contenant les jours précédant le premier dimanche de l'année est considérée comme la première semaine de l'année. Sinon, elle est considérée comme la dernière semaine de l'année précédente.

7

Lundi

1 à 53

La première semaine de l'année commence le premier lundi de l'année. La semaine contenant les jours précédant le premier lundi de l'année est considérée comme la dernière semaine de l'année précédente.

Types de paramètres :

week(varchar)
week(varchar, bigint)
week(date)
week(date, bigint)
week(datetime)
week(datetime, bigint)
week(timestamp)
week(timestamp, bigint)

Type de données de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select week('2022-02-27');

Le résultat suivant est renvoyé :

+--------------------+
| week('2022-02-27') |
+--------------------+
|                 9  |

Exemple 2

select week('2022-02-20',1);

Le résultat suivant est renvoyé :

+-----------------------+
| week('2022-02-20', 1) |
+-----------------------+
|                     7 |

Exemple 3

select week(date '2022-02-20');

Le résultat suivant est renvoyé :

+-------------------------+
| week(DATE '2022-02-20') |
+-------------------------+
|                       8 |

Exemple 4

select week(date '2022-02-20',1);

Le résultat suivant est renvoyé :

+----------------------------+
| week(DATE '2022-02-20', 1) |
+----------------------------+
|                          7 |

Exemple 5

select week(datetime '2022-02-20 00:00:00',1);

Le résultat suivant est renvoyé :

+-----------------------------------------+
| week(DATETIME '2022-02-20 00:00:00', 1) |
+-----------------------------------------+
|                                       7 |

Exemple 6

select week(datetime '2022-02-20 00:00:00');

Le résultat suivant est renvoyé :

+--------------------------------------+
| week(DATETIME '2022-02-20 00:00:00') |
+--------------------------------------+
|                                    8 |

Exemple 7

select week(timestamp '2022-02-20 00:00:00');

Le résultat suivant est renvoyé :

+---------------------------------------+
| week(TIMESTAMP '2022-02-20 00:00:00') |
+---------------------------------------+
|                                     8 |

Exemple 8

select week(timestamp '2022-02-20 00:00:00',1);

Le résultat suivant est renvoyé :

+------------------------------------------+
| week(TIMESTAMP '2022-02-20 00:00:00', 1) |
+------------------------------------------+
|                                        7 |

WEEKDAY

WEEKDAY(date)

description : Cette fonction renvoie le jour de la semaine correspondant à la date spécifiée par date. Le résultat est un entier indiquant le jour de la semaine selon la correspondance suivante : 0 = lundi, 1 = mardi, 2 = mercredi, 3 = jeudi, 4 = vendredi, 5 = samedi et 6 = dimanche.

Types de paramètres :

weekday(timestamp)
weekday(datetime)
weekday(date)
weekday(varchar)

Type de données de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select weekday(timestamp '2022-02-20 00:09:00');

Le résultat suivant est renvoyé :

+------------------------------------------+
| weekday(TIMESTAMP '2022-02-20 00:09:00') |
+------------------------------------------+
|                                        6 |

Exemple 2

select weekday(datetime '2022-02-20 00:09:00');

Le résultat suivant est renvoyé :

+-----------------------------------------+
| weekday(DATETIME '2022-02-20 00:09:00') |
+-----------------------------------------+
|                                       6 |

Exemple 3

select weekday(date '2022-02-20 00:09:00');

Le résultat suivant est renvoyé :

+-------------------------------------+
| weekday(DATE '2022-02-20 00:09:00') |
+-------------------------------------+
|                                   6 |

Exemple 4

select weekday('2022-02-20');

Le résultat suivant est renvoyé :

+-----------------------+
| weekday('2022-02-20') |
+-----------------------+
|                     6 |

WEEKOFYEAR

WEEKOFYEAR(date)

description : Cette fonction renvoie le numéro de semaine calendaire pour la date spécifiée par date. Valeurs valides : 1 to 53.

Types de paramètres :

weekofyear(timestamp)
weekofyear(datetime)
weekofyear(date)
weekofyear(varchar)

Type de données de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select weekofyear(timestamp '2022-02-27 09:00:00');

Le résultat suivant est renvoyé :

+---------------------------------------------+
| weekofyear(TIMESTAMP '2022-02-27 09:00:00') |
+---------------------------------------------+
|                                          8  |

Exemple 2

select weekofyear(datetime '2022-02-27 09:00:00');

Le résultat suivant est renvoyé :

+--------------------------------------------+
| weekofyear(DATETIME '2022-02-27 09:00:00') |
+--------------------------------------------+
|                                         8  |

Exemple 3

select weekofyear(date '2022-02-27');

Le résultat suivant est renvoyé :

+-------------------------------+
| weekofyear(DATE '2022-02-27') |
+-------------------------------+
|                            8  |

Exemple 4

select weekofyear('2022-02-27');

Le résultat suivant est renvoyé :

+--------------------------+
| weekofyear('2022-02-27') |
+--------------------------+
|                       8  |

YEAR

YEAR(date)

description : Cette fonction renvoie l'année de la date spécifiée par date.

Types de paramètres :

year(timestamp)
year(datetime)
year(date)
year(time)
year(varchar)

Type de données de la valeur de retour : BIGINT.

Exemples :

Exemple 1

select year(timestamp '2022-02-27 00:00:00');

Le résultat suivant est renvoyé :

select year(timestamp '2019-05-27 00:00:00');
+---------------------------------------+
| year(TIMESTAMP '2022-02-27 00:00:00') |
+---------------------------------------+
|                                  2022 |

Exemple 2

select year(datetime '2022-02-27 00:00:00')

Le résultat suivant est renvoyé :

+--------------------------------------+
| year(DATETIME '2022-02-27 00:00:00') |
+--------------------------------------+
|                                 2022 |

Exemple 3

select year(date '2022-02-27');

Le résultat suivant est renvoyé :

+-------------------------+
| year(DATE '2022-02-27') |
+-------------------------+
|                    2022 |

Exemple 4

Si vous exécutez l'instruction SQL suivante, le système ajoute la valeur de curdate() à '00:00:00' et renvoie le résultat sous forme de chaîne.

select year(time '00:00:00');

Le résultat suivant est renvoyé :

+-----------------------+
| year(TIME '00:00:00') |
+-----------------------+
|                  2022 |

Exemple 5

select year('2022-02-27');

Le résultat suivant est renvoyé :

+--------------------+
| year('2022-02-27') |
+--------------------+
|               2022 |

YEARWEEK

YEARWEEK(date)
YEARWEEK(date,mode)

description : Cette fonction renvoie l'année et la semaine d'une date.

L'année dans le résultat peut différer de l'année du paramètre de date pour les premières et dernières semaines de l'année.

Le paramètre mode de cette fonction fonctionne de la même manière que le paramètre mode de la fonction WEEK. Pour la syntaxe à un seul paramètre, la valeur de mode est 0. Types de paramètres : Type de données de la valeur de retour : BIGINT. Exemples : Exemple 1

yearweek(timestamp)
yearweek(timestamp, bigint)
yearweek(datetime)
yearweek(datetime, bigint)
yearweek(date, bigint) 
yearweek(date) 
yearweek(varchar)
yearweek(varchar, bigint)

select yearweek(timestamp '2022-02-27 00:00:00');

Le résultat suivant est renvoyé :

+-------------------------------------------+
| yearweek(TIMESTAMP '2022-02-27 00:00:00') |
+-------------------------------------------+
|                                    202209 |

Exemple 2

select yearweek(timestamp '2022-02-27 00:00:00',1);

Le résultat suivant est renvoyé :

+----------------------------------------------+
| yearweek(TIMESTAMP '2022-02-27 00:00:00', 1) |
+----------------------------------------------+
|                                       202208 |

Exemple 3

select yearweek(datetime '2022-02-27 00:00:00');

Le résultat suivant est renvoyé :

+------------------------------------------+
| yearweek(DATETIME '2022-02-27 00:00:00') |
+------------------------------------------+
|                                   202209 |

Exemple 4

select yearweek(datetime '2022-02-27 00:00:00',1);

Le résultat suivant est renvoyé :

+---------------------------------------------+
| yearweek(DATETIME '2022-02-27 00:00:00', 1) |
+---------------------------------------------+
|                                      202208 |

Exemple 5

select yearweek(date '2022-02-27',1);

Le résultat suivant est renvoyé :

+--------------------------------+
| yearweek(DATE '2022-02-27', 1) |
+--------------------------------+
|                         202208|

Exemple 6

select yearweek(date '2022-02-27');

Le résultat suivant est renvoyé :

+-----------------------------+
| yearweek(DATE '2022-02-27') |
+-----------------------------+
|                      202209 |

Exemple 7

select yearweek('2022-02-27');

Le résultat suivant est renvoyé :

+------------------------+
| yearweek('2022-02-27') |
+------------------------+
|                 202209 |

Exemple 8

select yearweek('2022-02-27',1);

Le résultat suivant est renvoyé :

+---------------------------+
| yearweek('2022-02-27', 1) |
+---------------------------+
|                    202208 |