Voir la source de API des dates

[[Catégorie:Développement de modules]]
[[Catégorie:API Ovidentia]]

{{Incomplet}}

Gestion des dates et heures dans Ovidentia

== Fonctions ==

===bab_mktime()===
Retourne un time stamp à partir d'une date MySQL ( ISO DATE ou ISO DATETIME par exemple : '2006-03-10 17:37:02' ou '2006-03-10')
:'''function bab_mktime($time)'''

* '''$time''' :
*: Date au format de ISO DATETIME de MySQL ( par ex: 2006-03-10 17:37:02 )

===bab_formatDate()===
Retourne une chaîne contenant la date/heure formatée selon le format spécifié
:'''function bab_formatDate($format, $time)'''

* '''$format''' :
*: Format désiré. Par exemple '%'
*: %d   Une représentation courte du jour ( sur trois caractères )
*: %D   Jour de la semaine complet par exemple Lundi
*: %j   Jour du mois ( padding avec zéros )
*: %m   Une représentation courte du mois ( sur trois caractères )
*: %M   Mois complet par exemple Avril
*: %n   Une représentation abrégée du mois ( sur trois caractères )
*: %Y   Représentation numérique de l'année, 4 caractères
*: %y   Année sur deux carcatères
*: %H   Heure au format 24 heures ( padding avec zéros )
*: %i   Minutes ( padding avec zéros ) 
*: %S   Format de la date courte préférée de l'utilisateur
*: %L   Format de la date longue préférée de l'utilisateur
*: %T   Format du temps préféré de l'utilisateur

* '''$time''' :
*: Time stamp unix

===bab_time()===
Retourne une chaîne contenant l'heure formatée selon les préférences de l'utilisateur
:'''function bab_time($time)'''

* '''$time''' :
*: Time stamp unix

===bab_longDate()===
Retourne une chaîne contenant la date/heure dans un format long
:'''function bab_longDate($time, $hour=true)'''
* '''$time''' :
*: Time stamp unix
:'''function bab_longDate($time, $hour=true)'''
* '''$hour''' :
*: Si true la fonctionne retourne l'heure aussi sinon uniquement la date

===bab_shortDate()===
Retourne une chaîne contenant la date/heure dans un format court
:'''function bab_shortDate($time, $hour=true)'''
* '''$time''' :
*: Time stamp unix
:'''function bab_longDate($time, $hour=true)'''
* '''$hour''' :
*: Si true la fonctionne retourne l'heure aussi sinon uniquement la date



== La Classe BAB_DateTime ==

=== Création de l'objet ===

L'objet BAB_DateTime peut être crée à partir de plusieurs formats

==== Le constructeur ====

les paramètres du constructeur sont :

* <code>$iYear</code>
* <code>$iMonth</code>
* <code>$iDay</code>
* <code>$iHours</code> (optionnel)
* <code>$iMinutes</code> (optionnel)
* <code>$iSeconds</code> (optionnel)


==== fromTimeStamp($iTimeStamp) ====

<code>fromTimeStamp</code> est une méthode statique, le paramètre est un nombre entier

exemple :
<source lang="php">

$date = BAB_DateTime::fromTimeStamp(time());

</source>


==== fromIsoDateTime($sIsoDateTime) ====

<code>fromIsoDateTime</code> est une méthode statique, le paramètre est une date au format ISO date ou ISO datetime

exemple :
<source lang="php">

$date = BAB_DateTime::fromIsoDateTime('2006-12-25 17:35:17');

</source>



=== Les formats de sortie ===


=== Les opérations ===



==== now() ====

Créé un objet date initialisé au moment même de l'appel de la méthode <code>now()</code>. C'est une méthode statique.