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
// 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)
// 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).
// 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
// 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)
// 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
// 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).
// 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
// 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).
// 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).
// 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é.
// 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)
// 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
// 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.
// 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).
// 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

