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:
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
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).
Pour récupérer le 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)
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.
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.
Pour exploiter les objets de cette classe ainsi instancier on peut utiliser par exemple :
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).