Programmer's Reference Guide
Les sections qui suivent montrent l'utilisation de base de Zend_Date au travers d'exemples. Dans
ce manuel, une "date" représente toujours une date calendaire et un temps, même lorsque cela n'est pas mentionné
spécifiquement. La partie (date calendaire, ou temps) non spécifiée prend la valeur par défaut "zéro". Ainsi
additionner une date ayant une date calendaire mais pas de temps, à un temps "12 heures" n'ayant pas de date
calendaire, résultera en la combinaison des deux : la date calendaire connue avec une partie temps de 12 heures,
soit midi.
Paramétrer une date sans temps implique un temps par défaut de 00:00:00. Inversement paramétrer un temps mais sans date calendaire lui verra affectée la valeur de 01.01.1970 plus le temps. La plupart des ordinateurs entendent la date "nulle" comme étant la première seconde de l'année 1970. La notion de timestamp est un nombre de secondes depuis cette date dite "EPOCH".
Sans argument, construire un objet correspond à la date courante du système d'exploitation telle que
retournée par la fonction PHP time(), pour obtenir un timestamp UNIX pour l'objet. Prenez garde à la locale et au
fuseau horaire (timezone) par défaut .
Exemple 10.2. Créer la date courante
$date = new Zend_Date();
// Affiche le timestamp actuel
print $date;
Les exemples sont le meilleur moyen de prendre en main Zend_Date, particulièrement pour les
personnes non habituées à la notion de date dans d'autres langages ou frameworks.
La date contenue dans l'objet Zend_Date est obtenue en tant qu'entier ou chaîne de
caractères localisée, grâce à la méthode get(). Il y a des options disponibles, nous les
détaillerons ultérieurement.
Exemple 10.3. get() - affiche une date
$date = new Zend_Date();
// Affiche la date désirée
print $date->get();
La méthode set() modifie la date dans l'objet et retourne la date affectée comme un
timestamp (et non un objet). Là aussi des options sont disponibles, nous y reviendrons.
Exemple 10.4. set() - affecte une date
$date = new Zend_Date();
// Affecter une nouvelle date
$date->set('13:00:00',Zend_Date::TIMES);
print $date->get(Zend_Date::W3C);
Ajouter deux dates avec add() signifie souvent ajouter une date réelle plus un timestamp
artificiel représentant une partie de date, comme 12 heures par exemple. add() et
sub() utilisent les mêmes paramètres que set(), sur lesquels nous reviendrons plus
tard.
Exemple 10.5. add() - ajouter des dates
$date = new Zend_Date();
// modifie $date en ajoutant 12 heures
$date->add('12:00:00', Zend_Date::TIMES);
echo "Date via get() = ", $date->get(Zend_Date::W3C), "\n";
// utilise __toString()
echo "Date via toString() = ", $date, "\n";
Toutes les méthodes basiques de Zend_Date peuvent opérer sur des dates complètes, ou des
parties de dates. Par exemple, comparer la date dans l'objet à une certaines valeur de minutes, peut être
effectué grâce à la méthode compare().
Exemple 10.6. compare() - comparer des dates
$date = new Zend_Date(); // date actuelle
// Comparaison des 2 temps
if ($date->compare(10, Zend_Date::MINUTE) == -1) {
print "Cette heure n'a pas encore dépassé 10 minutes";
} else {
print "Cette heure a au plus dépassé les 10 minutes";
}
Pour demander une simple égalité, utilisez equals(), qui retourne un booléen.
Exemple 10.7. equals() - identifie une date ou partie de date
$date = new Zend_Date(); // date actuelle
// Identification, demande d'égalité
if ($date->equals(10, Zend_Date::HOUR)) {
print "Il est 10 heures.";
} else {
print "Il n'est pas 10 heures.";
}
Search the Manual
Components
Languages Available
Translation Status Reports
View the current status report of Zend Framework manual translations.
