Premiers Pas : Restez à l'heure

Transcription

1 En complément de l'article du numéro précédent traitant de la gestion du temps avec MySQL, nous allons voir dans cet article comment gérer le temps avec PHP, et mettre en relation les gestions de PHP et de MySQL. Timestamp Au cours de cet article, nous parlerons souvent du timestamp. Le timestamp est un moyen de représenter par un nombre une. Par exemple, le 20 mai 2002 à 12h 30m 5s sera représenté par le nombre en utilisant le timestamp unix. Il existe plusieurs type de timestamp, mais celui qui nous intéressera est le timestamp unix car c'est celui que PHP utilise. Le timestamp unix représente en fait le nombre de secondes qui se sont écoulées depuis le début de l'ère unix, c'est à dire depuis le 1 janvier 1970 à minuit. Les fonctions de Gestion du Temps check get Valide une /heure. Formate une /heure locale Retourne la /heure gettimeofday Retourne l'heure actuelle gm gmmktime microtime mktime strtotime time check check ( mois, jour, année) Formate une /heure GMT/CUT. Retourne le timestamp UNIX d'une GMT. Retourne le timestamp UNIX actuel avec microsecondes. Retourne le timestamp UNIX d'une. Transforme un texte anglais en timestamp Retourne le timestamp UNIX actuel. Cette fonction permet de valider une. On lui fournit en paramètre le mois, le jour et l'année de la, sous forme numérique. La fonction renvoie true si la est valide, false sinon. Pour que la soit valide, l'année doit être comprise entre 1 et inclu, le mois entre 1 et 12 inclu, et le jour doit être validé pour le mois et l'année donnés (le calcul tient compte des années bisextiles). if (check(10,23,2001)) { echo 'la première est valide'; } if (check(02,29,2001)) { echo 'la deuxième est valide'; } la première est valide ( format [, timestamp]) La fonction permet de formater un timestamp (autrement dit, de lui donner une forme plus compréhensible pour un humain). Le premier paramètre est la chaine de format, le second, optionnel, est le timestamp. Si celui ci est omis, la fonction utilisera le timestamp courant (de la actuelle). La chaine de format se compose de caractères de format ayant chacun une signification particulière. Si l'on désire mettre dans la chaine de format un caractère de format sans que celui ci soit interprèté, il faut mettre un \ devant celui ci. Voici les caractères de format possibles : a am (matin) ou pm (après midi) A AM (matin) ou PM (après midi) B Heure Internet Swatch d Jour du mois, sur 2 chiffres i.e. 01 à 31 D Jour de la semaine, en trois lettres (et en anglais) : par exemple "Fri" (pour Vendredi) F Mois, textuel, version longue; en anglais, i.e. January (pour Janvier) g Heure, au format 12h, sans les zéros initiaux i.e. 1 à 12 G Heure, au format 24h, sans les zéros initiaux i.e. 0 à 23 h Heure, au format 12h, 01 à 12 H heure, au format 24h, 00 à 23 i Minutes; 00 à 59 I (i majuscule) "1" si l'heure d'été est activée, 0 si l'heure d'hiver. j Jour du mois sans les zéros initiaux: 1 à 31 l (L minuscule) Jour de la semaine, textuel, version longue; en anglais, i.e. Friday (pour Vendredi) L Booléen pour savoir si l'année est bissextile (1) ou pas (0) m Mois; i.e. 01 à 12 M Mois, en trois lettres (et en anglais) : par exemple Apr (pour Avril) 06/13/02 1

2 les caractères de format (suite) : n Mois sans les zéros initiaux; i.e. 1 à 12 O Différence d'heures avec l'heure de Greenwich, exprimée en heures; i.e. "+0200" r Format de RFC 822; i.e. "Thu, 21 Dec :01: " s Secondes; i.e. 00 à 59 S Suffixe ordinal d'un nombre, en anglais, sur deux lettres : i.e. th, nd t Nombre de jours dans le mois donné, i.e. 28 à 31 T Fuseau horaire de la machine ; i.e. MET U Secondes depuis une époque w Jour de la semaine, numérique, i.e. 0 (Dimanche) to 6 (Samedi) Y Année, 4 chiffres; i.e y Année, 2 chiffres; i.e. 99 z Jour de l'année; i.e. 0 à 365 Z Décalage horaire en secondes (i.e à 43200) echo ('d m Y h:s', ); echo ('D m F', ); :05 Wed 09 September print_r(get( )); Array ( [seconds] => 5 [minutes] => 34 [hours] => 15 [mday] => 5 [wday] => 3 [mon] => 6 [year] => 2002 [yday] => 155 [weekday] => Wednesday [month] => June [0] => ) gettimeofday gettimeofday () Cette fonction renvoit un tableau associatif contenant les informations retournées par la fonction système gettimeofday, c'est à dire : secondes [sec], microsecondes [usec], minutes de décalage par rapport à Greenwich en partant vers l'ouest [minuteswest], type de correction d'heure d'hiver [dsttime]. get get ( [timestamp]) echo gettimeofday(); Get retourne un tableau associatif contenant les informations de et d'heure correspondant au timestamp passé en paramètre. Si celui ci est omis, le timestamp courant sera utilisé. Le tableau contiendra les informations suivantes : secondes [seconds], minutes [minutes], heures [hours], jour du mois [mday], jour de la semaine [wday], mois [mon], année [year], jour de l'année [yday], jour de la semaine au format texte [weekday], mois au format texte [month], timestamp [0] Array ( [sec] => [usec] => [minuteswest] => 60 [dsttime] => 0 ) gm gm ( format [, timestamp]) Cette fonction fonctionne comme la fonction, si ce n'est qu'elle retourne ses informations en temps GMT. L'exemple montre la différence en utilisant un serveur à l'heure française. 06/13/02 2

3 echo ('d m Y h:s', ); echo gm('d m Y h:s', ); : :05 gmmktime gmmktime ( heure, minute, seconde, mois, jour, année [, heurehiver]) gmmktime fonctionne comme mktime sauf qu'elle considère que les paramètres passés sont en temps GMT. L'exemple montre la différence en utilisant un serveur à l'heure française. echo mktime ( 12, 30, 05, 5, 20,2002); echo gmmktime ( 12, 30, 05, 5, 20,2002); mktime mktime ( heure, minute, seconde, mois, jour, année [, heurehiver]) mktime retourne le timestamp unix correspondant aux informations qui lui sont passées en paramètres. Les paramètres peuvent être omis de gauche à droite, ceux qui sont omis seront remplacés par les informations de la actuelle, mais il est quand même préférable de mettre tous les paramètres pour plus de fiabilité dans les résultats. Combiné à la fonction, il devient facile de savoir quel jour correspond à quelle, et de manipuler des s futures et passées. echo mktime ( 12, 30, 05, 5, 20,2002); echo mktime ( 5, 20,2002); echo ('l', mktime ( 5, 20,1998)); echo ('t', mktime ( 12, 30, 05, 2, 21,1996)); Wednesday strtotime strtotime ( chaineheure, timestamp) microtime microtime ( ) Cette fonction retourne une chaine contenant le nombre de microsecondes de la seconde courante et le timestamp, ces deux chiffres étant séparés par un espace. echo microtime(); Cette fonction permet de convertir une au format textuel (en anglais) en timestamp. Si la conversion de la chaine échoue, la fonction renvoie 1. echo strtotime("now"); echo strtotime("06 march 2000"); echo strtotime("+1 week 2 days 4 hours 2 seconds"); /13/02 3

4 time time ( ) localtime localtime ([timestamp [, associatif]]) Time retourne le timestamp du moment actuel. echo time(); Localisation La localisation permet d'avoir une adaptée aux spécificités locales. Quand on compare une anglaise et une française, on se retrouve devant deux façons différentes d'afficher une. Pour prendre en compte ces spécificités en utilisant les fonctions de s classiques, il faut faire un test pour déterminer la langue du visiteur, puis utiliser le format approprié dans la chaine de format de la fontion. Avec la localisation, il suffit de tester une fois pour toute la langue du visiteur, puis de changer la localisation avec setlocale. Les s (et autre tel que monnaie, etc...) seront alors directement présentées dans le bon format. Les fonctions le localisation gmstrftime Formate une /heure GMT/CUT en fonction des paramétrages locaux. localtime setlocale strftime gmstrftime Lit l'heure locale Change les informations locales. Formate une /heure locale avec les options locales. gmstrftime ( format [, timestamp]) Cette fonction fonctionne comme strftime hormis que l'heure utilisée est GMT echo strftime("%c", mktime (20,0,0,12,31,98)); echo gmstrftime("%c", mktime (20,0,0,12,31,98)); jeu 31 déc :00:00 CET jeu 31 déc :00:00 GMT Localtime retourne un tableau contenant les informations de et d'heure correspondant à ceux de la fonction C localtime. Le premier paramètre est le timestamp d'où l'on désire tirer ses informations, s'il est omis le timestamp courant sera utilisé. Le deuxième paramètre précise si le tableau sera associatif (paramètre mis à 1) ou non. S'il est omis ou mis à 0, le tableau ne sera pas associatif. On retrouve les informations suivantes : secondes [tm_sec], minutes [tm_min], heures [tm_hour], jour du mois [tm_mday], mois, années depuis l'an 1900 [tm_year], jour de la semaine [tm_wday], jour de l'année [tm_yday], prise en compte de l'heure d'hiver [tm_isdst]. print_r(localtime(time(),1); Array ( [tm_sec] => 4 [tm_min] => 20 [tm_hour] => 16 [tm_mday] => 5 [tm_mon] => 5 [tm_year] => 102 [tm_wday] => 3 [tm_yday] => 155 [tm_isdst] => 1) setlocale setlocale ( categorie, zone) Setlocale permet de changer les informations sur la localisation. Le premier paramètre est une constante correspondant à la catégorie d'informations qui sera affectée. Les catégories possibles sont : LC_COLLATE pour les comparaisons de chaînes, LC_CTYPE pour la classification de caractères et les conversions, LC_MONETARY pour les monnaies (en cours d'implémentation), LC_NUMERIC pour les séparateurs décimaux, LC_TIME pour le format des s et heures, LC_ALL pour toutes les fonctions déjà cités. Le second spécifie la zone, généralement en anglais, par exemple french pour spécifier la zone française. setlocale(lc_time,'french'); echo strftime("%c", mktime (20,0,0,12,31,98)); jeu 31 déc :00:00 CET 06/13/02 4

5 strftime strftime ( format [, timestamp]) Tout comme, la fonction strftime permet de formatter un timestamp grâce à la chaine de format. Les options possibles pour le format sont : setlocale(lc_time,'french'); echo strftime("%a %x", mktime (20,0,0,12,31,98)); %a nom abrégé du jour de la semaine %A nom complet du jour de la semaine %b nom abrégé du mois %B nom complet du mois %c représentation préférée pour les s et heures %C numéro de siècle (l'année, divisée par 100 et arrondie entre 00 et 99) %d jour du mois en numérique de 01 à 31 %D identique à %m/%d/%y %e numéro du jour du mois. Les chiffres sont précédés d'un espace de 1 à 31 %h identique à %b %H heure de la journée en numérique, et sur 24 heures de de 00 à 23 %I heure de la journée en numérique, et sur 12 heures de 01 à 12 %j jour de l'année, en numérique de 001 à 366 %m mois en numérique de 1 à 12 %M minute en numérique %n newline character %p soit `am' ou `pm' en fonction de l'heure absolue, ou en fonction des valeurs enregistrées en local. %r l'heure au format a.m. et p.m. %R l'heure au format 24h %S secondes en numérique %t tabulation %T l'heure actuelle (égale à %H:%M:%S) %u le numéro de jour dans la semaine, de 1 à 7. (1 représente Lundi) %U numéro de semaine dans l'année, en considérant le premier dimanche de l'année comme le premier jour de la première semaine. %V le numéro de semaine comme défini dans l'iso 8601:1988, sous forme décimale, de 01 à 53. La semaine 1 est la première semaine qui a plus de 4 jours dans l'année courante, et dont Lundi est le premier jour. %W numéro de semaine dans l'année, en considérant le premier lundi de l'année comme le premier jour de la première semaine %w jour de la semaine, numérique, avec Dimanche = 0 %x format préféré de représentation de la sans l'heure %X format préféré de représentation de l'heure sans la %y l'année, numérique, sur deux chiffres de 00 à 99 %Y l'année, numérique, sur quatre chiffres %Z fuseau horaire, ou nom ou abréviation %% un caractère `%' littéral jeudi Relation avec MySQL La relation des s entre MySQL et PHP est importante, car on se sert souvent de MySQL pour faire les tris et de PHP pour faire la présentation de la. Il existe des solutions simples pour convertir les s de l'un vers l'autre. Le cas le plus simple est certainement le timestamp. En effet, il suffit d'utiliser la fonction MySQL UNIX_TIMESTAMP() dans la requête de sélection pour que le timestamp MySQL soit retourné au format unix. Aucun problème donc de ce côté là. Le cas des colonnes de type ou time est quant à lui plutôt lié à la langue dans laquelle on désire formater la. Pour les s an anglais, aucun problème, pour celles en français, il faut modifier le format. Il est possible pour cela d'utiliser la fonction MySQL FORMAT() dans la requête de selection. Il est aussi possible de faire des modifications du format par PHP, par exemple en utilisant str_replace pour remplacer les par des / Pour l'insertion d'information dans les colonnes de type et time, le plus simple est d'utiliser la fonction (combinée avec la fonction mktime pour les s passées ou à venir). ('Y m d h:m:s') générera une au bon format pour l'insertion. Conclusion La gestion du temps en PHP ne pose aucun problème, les fonctions et mktime couvrant à elles seules 75% des besoins. Avec un peu de pratique, vous connaitrez sur le bout des doigts les caractères de format. 06/13/02 5