wiki:CopixDateTime

Manipulation de dates et d'heures

CopixDateTime permet de manipuler des dates, des heures et des timestamps au sein de votre application Copix. Grâce à cette classe, vous pouvez par exemple convertir un timestamp en date en respectant le formatage induit par une langue donnée.

Dates

Date => YYYYMMDD

Entrée : vous disposez d'une date formatée contenant 3 champs (JJ, MM, YYYY) rangés dans un certain ordre et séparés par un caractère donné (/ par défaut).

Sortie : vous obtenez une date respectant le formatage YYYYMMDD

<?php
// CopixDateTime::dateToYYYYMMDD ($date, $separator);

$maDate = CopixDateTime::dateToYYYYMMDD ('31/12/2006', '/'); //retourne 20061231

$maDate = CopixDateTime::dateToYYYYMMDD ({{{, '/'); //retourne null
$maDate = CopixDateTime::dateToYYYYMMDD (null, '/'); //retourne null

$maDate = CopixDateTime::dateToYYYYMMDD ('31/12', '/'); //retourne false
$maDate = CopixDateTime::dateToYYYYMMDD ('310/120/2006', '/'); //retourne false
$maDate = CopixDateTime::dateToYYYYMMDD ('3/1/2', '/'); //retourne false

Date => Timestamp

Entrée : vous disposez d'une date formatée contenant 3 champs (JJ, MM, YYYY) rangés dans un certain ordre et séparés par un caractère donné (/ par défaut).

Sortie : vous obtenez une date sous forme d'un timestamp UNIX ( http://fr.php.net/date)

<?php
// CopixDateTime::dateTotimestamp ($date, $separator);

$maDate = CopixDateTime::dateTotimestamp ('31/12/2006', '/'); //retourne 1167516000

$maDate = CopixDateTime::dateTotimestamp(}}}, '/'); //retourne false
$maDate = CopixDateTime::dateTotimestamp (null, '/'); //retourne false
$maDate = CopixDateTime::dateTotimestamp ('31/12', '/'); //retourne false
$maDate = CopixDateTime::dateTotimestamp ('310/120/2006', '/'); //retourne false
$maDate = CopixDateTime::dateTotimestamp ('3/1/2', '/'); //retourne false

YYYYMMDD => Date

Entrée : vous disposez d'une date respectant le formatage YYYYMMDD

Sortie : vous obtenez une date formatée contenant 3 champs (JJ, MM, YYYY) rangés dans l'ordre établi par la langue courante et séparés par un caractère donné (/ par défaut).

<?php
// CopixDateTime::yyyymmddToDate ($yyyymmdd, $separator);

$maDate = CopixDateTime::yyyymmddToDate ('20061231', '/'); //en France, retourne 31/12/2006

$maDate = CopixDateTime::yyyymmddToDate ({{{, '/'); //retourne null
$maDate = CopixDateTime::yyyymmddToDate (null, '/'); //retourne null

$maDate = CopixDateTime::yyyymmddToDate ('2006120310', '/'); //retourne false
$maDate = CopixDateTime::yyyymmddToDate ('213', '/'); //retourne false

YYYYMMDD => Texte

Entrée : vous disposez d'une date respectant le formatage YYYYMMDD

Sortie : vous obtenez une date sous forme d'un texte lisible en fonction de la langue courante

<?php
// CopixDateTime::yyyymmddToText ($yyyymmdd);

$maDate = CopixDateTime::yyyymmddToText ('20061231');
//en France, retourne Dimanche 31 décembre 2006

$maDate = CopixDateTime::yyyymmddToText (}}}); //retourne null
$maDate = CopixDateTime::yyyymmddToText (null); //retourne null

$maDate = CopixDateTime::yyyymmddToText ('2006120310'); //retourne false
$maDate = CopixDateTime::yyyymmddToText ('213'); //retourne false

YYYYMMDD => Timestamp

Entrée : vous disposez d'une date respectant le formatage YYYYMMDD

Sortie : vous obtenez une date sous forme d'un timestamp UNIX ( http://fr.php.net/mktime)

<?php
// CopixDateTime::yyyymmddToTimestamp ($yyyymmdd);

$maDate = CopixDateTime::yyyymmddToTimestamp ('20061231'); //retourne 1167516000

$maDate = CopixDateTime::yyyymmddToTimestamp ({{{); //retourne false
$maDate = CopixDateTime::yyyymmddToTimestamp (null); //retourne false
$maDate = CopixDateTime::yyyymmddToTimestamp ('213'); //retourne false

Timestamp => YYYYMMDD

Entrée : vous disposez d'une date sous forme d'un timestamp UNIX ( http://fr.php.net/strftime)

Sortie : vous obtenez une date respectant le formatage YYYYMMDD

<?php
// CopixDateTime::timestampToyyyymmdd($timestamp);

$maDate = CopixDateTime::timestampToyyyymmdd('1167563702'); //retourne 20061231

Timestamp => Date

Entrée : vous disposez d'une date sous forme d'un timestamp UNIX ( http://fr.php.net/date)

Sortie : vous obtenez une date formatée contenant 3 champs (JJ, MM, YYYY) rangés dans l'ordre établi par la langue courante et séparés par un caractère donné (/ par défaut).

<?php
// CopixDateTime::timestampToDate ($timestamp, $separator);

$maDate = CopixDateTime::timestampToDate ('1167563702', '/');
//en France, retourne 31/12/2006

Heures

Heure => HHMMSS

Entrée : vous disposez d'une heure formatée contenant 3 champs (HH, MM, SS) rangés dans l'ordre établi par la langue courante et séparés par un caractère donné (: par défaut)

Sortie : vous obtenez une heure respectant le formatage HHMMSS

<?php
// CopixDateTime::timeToHHMMSS ($time, $separator);

$monHeure = CopixDateTime::timeToHHMMSS ('13:15:02', ':'); //retourne 131502

$monHeure = CopixDateTime::timeToHHMMSS (}}}, ':'); //retourne null
$monHeure = CopixDateTime::timeToHHMMSS (null, ':'); //retourne null

$monHeure = CopixDateTime::timeToHHMMSS ('131502', ':'); //retourne false
$monHeure = CopixDateTime::timeToHHMMSS ('25:15:02', ':'); //retourne false
$monHeure = CopixDateTime::timeToHHMMSS ('13:75:02', ':'); //retourne false
$monHeure = CopixDateTime::timeToHHMMSS ('13:15:72', ':'); //retourne false
$monHeure = CopixDateTime::timeToHHMMSS ('a:b:c', ':'); //retourne false

HHMMSS => Heure

Entrée : vous disposez d'une heure respectant le formatage HHMMSS

Sortie : vous obtenez une heure formatée contenant 3 champs (HH, MM, SS) rangés dans l'ordre établi par la langue courante et séparés par un caractère donné (: par défaut).

<?php
// CopxDateTime::hhmmssToTime ($hhmmss, $separator);

$monHeure = CopxDateTime::hhmmssToTime ('131502', ':'); //en France, retourne 13:15:02

$monHeure = CopxDateTime::hhmmssToTime ({{{, ':'); //retourne null
$monHeure = CopxDateTime::hhmmssToTime (null, ':'); //retourne null

$monHeure = CopxDateTime::hhmmssToTime ('130150020', ':'); //retourne false
$monHeure = CopxDateTime::hhmmssToTime ('110', ':'); //retourne false

Dates et Heures

YYYYMMDDHHIISS => DateHeure?

Entrée : vous disposez d'une chaîne date/heure respectant le formatage YYYYMMDDHHIISS

Sortie : vous obtenez une chaîne date/heure formatée contenant 6 champs (DD, MM, YYYY, HH, II, SS) rangés dans l'ordre établi par la langue courante et séparés par un caractère donné (/ par défaut).

<?php
// CopixDateTime::yyyymmddhhiissToDateTime($pParam, $separator);

$monDateHeure = CopixDateTime::yyyymmddhhiissToDateTime('20061231131502', '/');
//en France, retourne 31/12/2006 13:15:02

$monDateHeure = CopixDateTime::yyyymmddhhiissToDateTime(}}}, '/'); //retourne null
$monDateHeure = CopixDateTime::yyyymmddhhiissToDateTime(null, '/'); //retourne null

$monDateHeure = CopixDateTime::yyyymmddhhiissToDateTime('20061231131502000', '/'); //retourne false
$monDateHeure = CopixDateTime::yyyymmddhhiissToDateTime('2006123113', '/'); //retourne false
$monDateHeure = CopixDateTime::yyyymmddhhiissToDateTime('20061231251502', '/'); //retourne false
$monDateHeure = CopixDateTime::yyyymmddhhiissToDateTime('20061231137502', '/'); //retourne false
$monDateHeure = CopixDateTime::yyyymmddhhiissToDateTime('20061231131572', '/'); //retourne false

YYYYMMDDHHIISS => Texte

Entrée : vous disposez d'une chaîne date/heure respectant le formatage YYYYMMDDHHIISS

Sortie : vous obtenez une chaîne date/heure formatée en texte pour la partie date (voir YYYMMDD=>Text) et l'heure à coté.

<?php
// CopixDateTime::yyyymmddToText ($yyyymmdd);

$maDate = CopixDateTime::yyyymmddhhiissToText ('20061231143020');
//en France, retourne Dimanche 31 décembre 2006 14:30:20

$maDate = CopixDateTime::yyyymmddhhiissToText ({{{); //retourne null
$maDate = CopixDateTime::yyyymmddhhiissToText (null); //retourne null

$maDate = CopixDateTime::yyyymmddhhiissToText ('2006120310'); //retourne false
$maDate = CopixDateTime::yyyymmddhhiissToText ('213'); //retourne false

YYYYMMDDHHIISS => Timestamp

Entrée : vous disposez d'une chaîne date/heure respectant le formatage YYYYMMDDHHIISS

Sortie : vous obtenez une chaîne date/heure sous forme d'un timestamp UNIX ( http://fr.php.net/date)

<?php
// CopixDateTime::yyyymmddhhiissToTimeStamp($pParam);

$monDateHeure = CopixDateTime::yyyymmddhhiissToTimeStamp('20061231131502'); //retourne 1167563702

$monDateHeure = CopixDateTime::yyyymmddhhiissToTimeStamp(}}}); //retourne null
$monDateHeure = CopixDateTime::yyyymmddhhiissToTimeStamp(null); //retourne null

$monDateHeure = CopixDateTime::yyyymmddhhiissToTimeStamp('20061231251502000'); //retourne false
$monDateHeure = CopixDateTime::yyyymmddhhiissToTimeStamp('200612312'); //retourne false
$monDateHeure = CopixDateTime::yyyymmddhhiissToTimeStamp('20061231251502'); //retourne false
$monDateHeure = CopixDateTime::yyyymmddhhiissToTimeStamp('20061231136502'); //retourne false
$monDateHeure = CopixDateTime::yyyymmddhhiissToTimeStamp('20061231131562'); //retourne false

Timestamp => YYYYMMDDHHIISS

Entrée : vous disposez d'une chaîne date/heure sous forme d'un timestamp UNIX ( http://fr.php.net/date)

Sortie : vous obtenez une chaîne date/heure respectant le formatage YYYYMMDDHHIISS

<?php
// CopixDateTime::timeStampToyyyymmddhhiiss($timestamp);

$monDateHeure = CopixDateTime::timeStampToyyyymmddhhiiss('1167563702');
//retourne 20061231131502

DateHeure? => YYYYMMDDHHIISS

Entrée : vous disposez d'une chaîne date/heure formatée contenant 6 champs (DD, MM, YYYY, HH, II, SS) rangés dans un ordre donné et séparés par un caractère donné (/ par défaut).

Sortie : vous obtenez une chaîne date/heure respectant le formatage YYYYMMDDHHIISS.

<?php
// CopixDateTime::DateTimeToyyyymmddhhiiss($DateTime,$separator);

$monDateHeure = CopixDateTime::DateTimeToyyyymmddhhiiss('31/12/2006 13:15:02', '/');
//retourne 20061231131502

DateHeure? ISO-8601 => DateHeure? Local

Entrée : vous disposez d'une chaîne date/heure sous forme d'un chaîne au format ISO-8601 (YYYY-MM-DD hh:ii:ss ou YYYY-MM-DDThh:ii:ssZ)

Sortie : vous obtenez une chaîne date/heure formatée contenant 6 champs (DD, MM, YYYY, HH, II, SS) rangés dans l'ordre établi par la langue courante et séparés par un caractère donné (/ par défaut).

<?php
// CopixDateTime::ISODateTimeToDateTime($pParam, $separator);

$monDateHeure = CopixDateTime::ISODateTimeToDateTime('2006-12-31 13:15:02', '/');
//en France, retourne 31/12/2006 13:15:02

$monDateHeure = CopixDateTime::ISODateTimeToDateTime('', '/'); //retourne null
$monDateHeure = CopixDateTime::ISODateTimeToDateTime(null, '/'); //retourne null

$monDateHeure = CopixDateTime::ISODateTimeToDateTime('20-1-3 13:15:02', '/'); //retourne false
$monDateHeure = CopixDateTime::ISODateTimeToDateTime('2006-120-310 13:15:02', '/'); //retourne false
$monDateHeure = CopixDateTime::ISODateTimeToDateTime('2006-12-31 25:15:02', '/'); //retourne false
$monDateHeure = CopixDateTime::ISODateTimeToDateTime('2006-12-31 13:75:02', '/'); //retourne false
$monDateHeure = CopixDateTime::ISODateTimeToDateTime('2006-12-31 13:15:72', '/'); //retourne false