Documentation PHPBoost 3

Les dates



De base, sans faire appel la class Date le framework PHPBoost en V3 met a disposition 3 fonctions.

gmdate_format($format,$timestamp,$timezone_system)
Cette fonction reprend les grandes ligne de date() mais avec des format défini, et la gestion de la "time zone".
$format :
date_format_tiny = d/m
date_format_short = d/m/y
date_format_long = d/m/y à H\hi\m\i\ns\s

$timestamp : Le temps au format système a transformer.
$timezone_system : (optionnel) temps de décalage (le timezonne vien s'ajouter au timestamp ((+-)X3600)
Soit un retour en php hors framework : date($format,($timestamp+($timezone_system X3600)))


strtotimestamp($str,$date_format)
Cette fonction permet de passer d'un format date à un format timestamp.
Exemple : strtotimestamp('25/12/10','d/m/y') retourne : 1293231601. Ce qui correspond a la bonne date.
$str : la date ex : 25/12/10
$date_format : 'd/m/y' ou leur placement respectif


strtodate($str,$date_format)
Cette fonction permet de passer d'un format date à un format date ISO 8601
Exemple : strtotimestamp('25/12/2010','DD/MM/YYYY') retourne : 2010-12-25. Ce qui correspond a la bonne date.
$str : la date ex : 25/12/2010
$date_format : 'DD/MM/YYYY' ou leur placement respectif


L'utilisation de la class Date augmente les possibilité.

Pour utiliser la classe la date, il faut importé la class:
Code PHP :
import('util/date');



l'objet Date s'initialise a l'appel avec un certain nombre de paramètre.
Le nombre de Paramètre dépend du premier paramètre.

Le paramètre DATE_NOW s'utilise avec comme second paramètre TIMEZONE_AUTO
Code PHP :
$date = new Date(DATE_NOW, TIMEZONE_AUTO);

Pour que ce soit la date du moment qui soit la référence.

En utilisant DATE_YEAR_MONTH_DAY[b] comme premier paramètre.
Il faut en deuxième paramètre fournir le référentiel horaire : [b]TIMEZONE_USER

A la suite doivent etre utiliserer les 3 paramètres pour indiquer la date (YYYY,MM,DD).
Code PHP :
$date = new Date(DATE_YEAR_MONTH_DAY, TIMEZONE_USER, 2010, 12, 25);

Pour récupérer le timestamp :
Code PHP :
 $timestamp_noel=$date->get_timestamp(); 


On a aussi la possibilité d'utiliser de la meme façon DATE_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND
Il faut en deuxième paramètre fournir le référentiel horaire : TIMEZONE_USER
En passant en 3eme paramètre : (YYYY,MM,DD,HH,MM,SS)
Code PHP :
$date = new Date(DATE_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND, TIMEZONE_USER, 2010, 12, 25, 20, 50, 30);


Pour DATE_FROM_STRING , qui sert à renseigner une date en provenance d'un formulaire par exemple.
Il faut en deuxième paramètre fournir le référentiel horaire : TIMEZONE_USER
En 3eme paramètre $str qui a pour schéma le 4eme paramètre qui devra être passer aussi.
Code PHP :
$date = new Date(DATE_FROM_STRING, TIMEZONE_USER, '25/12/2010', 'd/m/y');


On dispose aussi de DATE_TIMESTAMP.
Qui sert quand a lui a manipuler des date à partir du timestamp Unix ou le nombre de secondes écoulées depuis le 1er janvier 1970 à minuit.
Il faut en deuxième paramètre fournir le référentiel système: TIMEZONE_SYSTEM (celui ci est suffisant dans 99% des cas)
En 3eme paramètre $str qui est l'entier timestamp Unix.
Code PHP :
$date = new Date(DATE_TIMESTAMP, TIMEZONE_SYSTEM, '1293310230');



Pour exploiter les objets de cette classe ainsi instancier on peut utiliser par exemple :
Code PHP :
 $var=$date->get_timestamp() 
Ou $var aura en valeur le timestamp de l'objet en fonction de ce qui l'aura instancier.

La liste des fonctionnalité disponible sont :
get_timestamp() : Renvoie le timestamp correspondant à la date.
format_date() : Permet de formater une date vers différents formats.
get_year() : Renvoie l'année de la date.
get_month() : Renvoie le mois.
get_day() : Renvoie le jour.
get_hours() : Renvoie l'heure.
get_minutes() : Renvoie les minutes.
get_seconds() : Renvoie les secondes.
to_date() : Renvoie la chaîne formatée pour l'enregistrement dans une base de données (YYYY-mm-dd).
Cette page a été vue 2796 fois