API des dates

De OviWiki
Révision de 6 mars 2009 à 17:45 par Paul (discussion | contributions) (La Classe BAB_DateTime)

Aller à : navigation, rechercher


Information.png Cet article est incomplet. Son contenu est donc à considérer avec précaution.

Voir la liste des articles incomplets


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 :

  • $iYear
  • $iMonth
  • $iDay
  • $iHours (optionnel)
  • $iMinutes (optionnel)
  • $iSeconds (optionnel)


fromTimeStamp($iTimeStamp)

fromTimeStamp est une méthode statique, le paramètre est un nombre entier

exemple : <source lang="php">

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

</source>


fromIsoDateTime($sIsoDateTime)

fromIsoDateTime 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 now(). C'est une méthode statique.