MONTH |
Mois |
|---|---|
| MySQL |
Syntaxe
| Month(Date) |
Paramètres
| Nom | Description |
|---|---|
| Date | Ce paramètre permet d'indiquer la date contenant l'expression à traiter |
Retour
| Valeur | Description |
|---|---|
| NULL | Cette valeur permet d'indiquer qu'il est impossible de déterminer le mois |
| 1 | Cette valeur permet d'indiquer qu'il s'agit du mois de janvier. |
| 2 | Cette valeur permet d'indiquer qu'il s'agit du mois de février. |
| 3 | Cette valeur permet d'indiquer qu'il s'agit du mois de mars. |
| 4 | Cette valeur permet d'indiquer qu'il s'agit du mois d'avril. |
| 5 | Cette valeur permet d'indiquer qu'il s'agit du mois de mai. |
| 6 | Cette valeur permet d'indiquer qu'il s'agit du mois de juin. |
| 7 | Cette valeur permet d'indiquer qu'il s'agit du mois de juillet. |
| 8 | Cette valeur permet d'indiquer qu'il s'agit du mois d'août. |
| 9 | Cette valeur permet d'indiquer qu'il s'agit du mois de septembre. |
| 10 | Cette valeur permet d'indiquer qu'il s'agit du mois d'octobre. |
| 11 | Cette valeur permet d'indiquer qu'il s'agit du mois de novembre. |
| 12 | Cette valeur permet d'indiquer qu'il s'agit du mois de décembre. |
Description
Cette fonction retourne le mois de la date spécifié.
Remarques
- Cette fonction permet de retourner le mois d'une date contenu dans une chaine de caractères, un type de données DATE ou un type de données DATETIME.
- Cette fonction existe afin de facilité la manipulation des dates dans des requêtes SQL ainsi qu'une compatibilité avec le logiciel Microsoft Access de Microsoft (MONTH), cependant si vous utilisez d'autres serveurs de base de données que MySQL, il peut être préférable d'utiliser la fonction «DATE_FORMAT» car il n'est pas certain que la fonction MONTH existera dans l'autre serveur de base de données.
- Utiliser la fonction «DATE_FORMAT» si vous souhaitez plus de flexibilité dans le résultat retourné.
- Si vous passez par un ORM afin d'utiliser cette fonction, vous n'aurez peut-être pas le choix de la passer par un objet de WHERE comme «queryString.extra(where=["MONTH(...)"])» pour un cadre d'application Django de Python, «$events->where('MONTH(...)', '=', $month)» avec Doctrine pour PHP,... dépendamment des langages de programmation et des cadres d'application.
Exemples
Voici un exemple montrant une utilisation plus classique de cette fonction :
on obtiendra le résultat suivant :
| Text | Result |
| 2000-01-01 = | 1 |
| 08-01-01 = | 1 |
| 74-01-01 = | 1 |
| 02-02-2001 = |
Prenons pour acquis la table «matable» avec les données suivantes :
| id | id_foreign | dateAjout |
| 365 | 80165 | 2013-01-18 09:14:31 |
| 364 | 80162 | 2013-01-18 08:23:01 |
| 363 | 79706 | 2013-01-14 13:56:29 |
| 362 | 78549 | 2013-01-02 14:50:50 |
| 361 | 77798 | 2012-12-21 11:18:11 |
| 360 | 77597 | 2012-12-19 09:51:19 |
| 359 | 77448 | 2012-12-17 14:24:07 |
| 358 | 77075 | 2012-12-12 23:56:05 |
| 357 | 76163 | 2012-12-03 00:00:24 |
| 356 | 75948 | 2012-11-29 05:42:23 |
| 353 | 75406 | 2012-11-21 18:41:34 |
| 352 | 74531 | 2012-11-12 13:51:10 |
| 351 | 74330 | 2012-11-08 13:15:42 |
| 350 | 74167 | 2012-11-06 15:52:41 |
| 349 | 73785 | 2012-11-02 06:40:18 |
| 348 | 73739 | 2012-11-01 11:45:15 |
| 347 | 73689 | 2012-10-31 16:57:01 |
| 345 | 73687 | 2012-10-31 16:38:54 |
| 344 | 73247 | 2012-10-26 13:27:38 |
| 343 | 73066 | 2012-10-24 12:37:57 |
| 342 | 72366 | 2012-10-18 14:11:44 |
| 341 | 71959 | 2012-10-14 14:31:28 |
| 340 | 71936 | 2012-10-13 10:16:00 |
| 339 | 71653 | 2012-10-11 14:09:01 |
| 337 | 71321 | 2012-10-08 03:24:31 |
L'exemple suivant permet de compter le nombre de date qu'il contient par mois :
on obtiendra le résultat suivant :
| Nombre | Mois | Annee |
| 4 | 1 | 2013 |
| 5 | 12 | 2012 |
| 7 | 11 | 2012 |
| 9 | 10 | 2012 |
Voir également
Article - Les géants de l'informatique - Oracle
Références
MySQL: The definitive guide to using, programming, and administering MySQL 4 databases - Second Edition, Paul Dubois, 2003, ISBN: 0-7357-1212-3, page 826
Dernière mise à jour : Mercredi, le 29 avril 2015