Classe Date
Table des matières
La classe Date permet de manipuler des données temporelles (dates, timestamp, dates avec heure précise...) dans différents référentiels horaire.
Dans un monde internationnal tel qu'Internet, des gens de toutes les nationnalités et de tous les pays se retrouvent sur un même site, donc le serveur peut être basé n'importe où. Il est donc important d'adapter les dates à l'utilisateur (et notamment à son fuseau horaire). Cette classe gère aussi le changement d'heure (heure d'été/ heure d'hiver).
La classe Date gère la notion de fuseau horaire à partir de différents référentiels qui sont les suivants :
Voilà ce qu'il est important de retenir.
L'affichage d'une date se fait quasiment systématiquement dans le référentiel utilisateur. Lorsque l'utilisateur entre une date, elle sera aussi dans son propre référentiel.
L'enregistrement dans la base de données ou dans un fichier texte se fait dans le référentiel système.
Toute date doit être enregistrée dans le référentiel système, c'est le seul référentiel qui est commun tous les utilisateurs et qui fournira donc une heure équivalente à chacun d'entre eux. Il est impératif de respecter cette règle.
Cette classe permet de formater les dates en entrée et en sortie selon différents modes.
A l'importation :
A l'exportation :
Les formatages spécifiques sont adaptés à la langue de l'utilisateur.
Cette classe se trouve dans le dossier util du framework, donc le chemin complet est kernel/framework/util/date.class.php.
Il faut donc utiliser le code suivant pour la charger :
Les référentiels temporels
Dans un monde internationnal tel qu'Internet, des gens de toutes les nationnalités et de tous les pays se retrouvent sur un même site, donc le serveur peut être basé n'importe où. Il est donc important d'adapter les dates à l'utilisateur (et notamment à son fuseau horaire). Cette classe gère aussi le changement d'heure (heure d'été/ heure d'hiver).
Les différents référentiels
La classe Date gère la notion de fuseau horaire à partir de différents référentiels qui sont les suivants :
- L'heure système (ou l'heure du serveur). Toutes les données manipulées par l'application doivent être en heure système. En interne la classe Date manipule le temps selon le référentiel du système, et tout enregistrement dans la base de données ou dans un fichier quelconque doit se faire dans ce référentiel. Cela permet d'avoir des données homogènes. Ce fuseau horaire est donné automatiquement par le serveur.
- L'heure du site. Elle est dans le fuseau horaire de l'endroit où est localisé le site. Par exemple un site français sera à l'heure française, c'est à dire en GMT + 1 en hiver. Cette référence sera par ailleurs utilisée pour les invités (visiteurs non enregistrés). Le fuseau horaire du site est choisi par l'administrateur.
- L'heure de l'utilisateur. Chaque utilisateur enregistré choisit son fuseau horaire, les autres auront le référentiel par défaut, à savoir celui du site.
Quel référentiel utiliser ?
Voilà ce qu'il est important de retenir.
L'affichage d'une date se fait quasiment systématiquement dans le référentiel utilisateur. Lorsque l'utilisateur entre une date, elle sera aussi dans son propre référentiel.
L'enregistrement dans la base de données ou dans un fichier texte se fait dans le référentiel système.
Toute date doit être enregistrée dans le référentiel système, c'est le seul référentiel qui est commun tous les utilisateurs et qui fournira donc une heure équivalente à chacun d'entre eux. Il est impératif de respecter cette règle.
Formatage des dates en entrée/sortie
Cette classe permet de formater les dates en entrée et en sortie selon différents modes.
En entrée
A l'importation :
- A partir d'un timestamp.
- 3 entiers représentant l'année, le mois et le jour.
- 6 entiers représentant l'année, le mois, le jour, les heures, les minutes et les secondes.
- A partir d'une date dont le patron est choisi et donné en paramètre. Exemple 19/06/2008 en donnant d/m/y.
En sortie
A l'exportation :
- Mois année, ex : 06/2008
- Jour mois année, ex : 12/06/08
- Avec l'heure en plus, ex : 12/06/2008 à 13h20
- Timestamp
Les formatages spécifiques sont adaptés à la langue de l'utilisateur.
Chargement de la classe
Cette classe se trouve dans le dossier util du framework, donc le chemin complet est kernel/framework/util/date.class.php.
Il faut donc utiliser le code suivant pour la charger :
Code PHP :
include_once('../kernel/framework/util/date.class.php'); //Ou plus généralement si on n'est pas à l'emplacement traditionnel (racine du site plus un dossier) include_once(PATH_TO_ROOT . '/kernel/framework/util/date.class.php');
Méthodes disponibles
- Date : Constructeur de la classe Date
- Format_date : Permet de formater une date vers différents formats
- Get_timestamp : Renvoie le timestamp correspondant à la date
- 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).