Source for file jDateTime.class.php

Documentation is available at jDateTime.class.php

<?php
/**
* @package jelix
* @subpackage utils
* @author Gérald Croes, Laurent Jouanneau
* @contributor Laurent Jouanneau, Julien Issler
* @contributor Loic Mathaud
* @contributor Florian Hatat
* @contributor Emmanuel Hesry, Brice G.
* @contributor Hadrien Lanneau <hadrien@over-blog.com>
*
* This class was get originally from the Copix project (CopixDate.lib.php, Copix 2.3dev20050901, http://www.copix.org)
* Only few lines of code are still copyrighted 2001-2005 CopixTeam (LGPL licence).
* Initial authors of this Copix classes are Gerald Croes and Laurent Jouanneau,
* and this class was adapted/improved for Jelix by Laurent Jouanneau
*
* @link http://www.jelix.org
* @licence http://www.gnu.org/licenses/lgpl.html GNU Lesser General Public Licence, see LICENCE file
*/
// on windows plateform, this function doesn't exist.
if(!function_exists('strptime')){
/**
* @ignore
*/
function strptime ( $strdate, $format ){
// It's not a full compatibility with strptime of PHP5.1, but it is
// enough for our needs
$plop = array( 'S'=>'tm_sec', 'M'=>'tm_min', 'H'=>'tm_hour',
'd'=>'tm_mday', 'm'=>'tm_mon', 'Y'=>'tm_year');
$regexp = preg_quote($format, '/');
$regexp = str_replace(
array('%d','%m','%Y','%H','%M','%S'),
array('(?P<tm_mday>\d{2})','(?P<tm_mon>\d{2})',
'(?P<tm_year>\d{4})','(?P<tm_hour>\d{2})',
'(?P<tm_min>\d{2})','(?P<tm_sec>\d{2})'),
$regexp);
if(preg_match('/^'.$regexp.'$/', $strdate, $m)){
$result=array('tm_sec'=>0,'tm_min'=>0,'tm_hour'=>0,'tm_mday'=>0,'tm_mon'=>0,'tm_year'=>0,'tm_wday'=>0,'tm_yday'=>0,'unparsed'=>'');
foreach($m as $key => $value){
if(!isset($result[$key])){
continue;
}
$result[$key] = intval($value);
switch($key){
case 'tm_mon':
$result[$key]--;
break;
case 'tm_year':
$result[$key] -= 1900;
break;
default:
break;
}
}
return $result;
}
return false;
}
}
/**
* Utility to manipulate dates and convert date format
* @package jelix
* @subpackage utils
* @todo PHP53 : replace the use of strptime by date_parse_from_format
*/
class jDateTime {
public $day;
public $month;
public $year;
public $hour;
public $minute;
public $second;
public $defaultFormat = 11;
const LANG_DFORMAT=10;
const LANG_DTFORMAT=11;
const LANG_TFORMAT=12;
const LANG_SHORT_DTFORMAT=13;
const LANG_SHORT_TFORMAT=14;
const DB_DFORMAT=20;
const DB_DTFORMAT=21;
const DB_TFORMAT=22;
const ISO8601_FORMAT=40;
const TIMESTAMP_FORMAT=50;
const RFC822_FORMAT=60;
const RFC2822_FORMAT=61;
const FULL_LANG_DATE=62;
/**
*
*/
function __construct($year=0, $month=0, $day=0, $hour=0, $minute=0, $second=0){
$this->year = $year;
$this->month = $month;
$this->day = $day;
$this->hour = $hour;
$this->minute = $minute;
$this->second = $second;
if(!$this->_check())
{
throw new jException('jelix~errors.datetime.invalid',
array($this->year, $this->month, $this->day,
$this->hour, $this->minute, $this->second));
}
}
/**
* Checks if the current jDateTime object is a valid gregorian date/time
* @return bool true if the date/time are valid.
*/
private function _check() {
// Only check the date if it is defined (eg. day, month and year are
// strictly positive).
if($this->day > 0 && $this->month > 0 && $this->year > 0
&& !checkdate($this->month, $this->day, $this->year))
{
return false;
}
if(!(($this->second >= 0) && ($this->second < 60)
&& ($this->minute >= 0) && ($this->minute < 60)
&& ($this->hour >= 0) && ($this->hour < 24)))
{
return false;
}
return true;
}
/**
* Check if jDateTime is "null" (all values egals to 0)
*
* @return boolean
* @author Hadrien Lanneau (hadrien at over-blog dot com)
***/
public function isNull() {
return ($this->year === 0 && $this->month === 0 && $this->day === 0 && $this->hour == 0 && $this->minute == 0 && $this->second == 0);
}
/**
* Convert the date to a string format
* @param int $format one of the class constant xxx_FORMAT, or -1 if it should use the default format
* @return string the string date
* @see jDateTime:$defaultFormat
*/
function toString($format=-1){
if($format==-1)
$format = $this->defaultFormat;
$str='';
switch($format){
case self::LANG_DFORMAT:
$t = mktime ( $this->hour, $this->minute,$this->second , $this->month, $this->day, $this->year );
$lf = jLocale::get('jelix~format.date');
$str = date($lf, $t);
break;
case self::LANG_DTFORMAT:
$t = mktime ( $this->hour, $this->minute,$this->second , $this->month, $this->day, $this->year );
$lf = jLocale::get('jelix~format.datetime');
$str = date($lf, $t);
break;
case self::LANG_TFORMAT:
$t = mktime ( $this->hour, $this->minute,$this->second , 0 , 0, 0 );
$lf = jLocale::get('jelix~format.time');
$str = date($lf, $t);
break;
case self::LANG_SHORT_DTFORMAT:
$t = mktime ( $this->hour, $this->minute,$this->second , $this->month, $this->day, $this->year );
$lf = jLocale::get('jelix~format.short_datetime');
$str = date($lf, $t);
break;
case self::LANG_SHORT_TFORMAT:
$t = mktime ( $this->hour, $this->minute,$this->second , $this->month, $this->day, $this->year );
$lf = jLocale::get('jelix~format.short_time');
$str = date($lf, $t);
break;
case self::DB_DFORMAT:
$str = sprintf('%04d-%02d-%02d', $this->year, $this->month, $this->day);
break;
case self::DB_DTFORMAT:
$str = sprintf('%04d-%02d-%02d %02d:%02d:%02d', $this->year, $this->month, $this->day, $this->hour, $this->minute, $this->second);
break;
case self::DB_TFORMAT:
$str = sprintf('%02d:%02d:%02d', $this->hour, $this->minute, $this->second);
break;
case self::ISO8601_FORMAT:
$str = sprintf('%04d-%02d-%02dT%02d:%02d:%02dZ', $this->year, $this->month, $this->day, $this->hour, $this->minute, $this->second);
break;
case self::TIMESTAMP_FORMAT:
$str =(string) mktime ( $this->hour, $this->minute,$this->second , $this->month, $this->day, $this->year );
break;
case self::RFC822_FORMAT:
case self::RFC2822_FORMAT:
$str = date('r', mktime ( $this->hour, $this->minute,$this->second , $this->month, $this->day, $this->year ));
break;
case self::FULL_LANG_DATE:
$t = mktime ( $this->hour, $this->minute,$this->second , $this->month, $this->day, $this->year );
// month translation
$month = jLocale::get('jelix~date_time.month.'.date('m',$t).'.label');
// day translation
$day = jLocale::get('jelix~date_time.day.'.date('w',$t).'.label');
// get the date formatting
$lf = jLocale::get('jelix~format.date_full');
// get the ordinal format of the day in the month especially for the English format (1st, 2nd, 3rd and th for the others)
$ordinal = jLocale::get('jelix~date_time.day.'.$this->day.'.ordinal');
// put all this in the right order using the formatting string
$str = sprintf($lf, $day, $this->day, $ordinal, $month, $this->year);
break;
}
return $str;
}
/**
* read a string to extract date values
* @param string $str the string date
* @param int $format one of the class constant xxx_FORMAT, or -1 if it should use the default format
* @see jDateTime:$defaultFormat
*/
function setFromString($str,$format=-1){
if($format==-1){
$format = $this->defaultFormat;
}
$this->year = 0;
$this->month = 0;
$this->day = 0;
$this->hour = 0;
$this->minute = 0;
$this->second = 0;
$ok=false;
switch($format){
case self::LANG_DFORMAT:
$lf = jLocale::get('jelix~format.date_st');
if($res = strptime ( $str, $lf )){
$ok=true;
$this->year = $res['tm_year']+1900;
$this->month = $res['tm_mon'] +1;
$this->day = $res['tm_mday'];
}
break;
case self::LANG_DTFORMAT:
$lf = jLocale::get('jelix~format.datetime_st');
if($res = strptime ( $str, $lf )){
$ok=true;
$this->year = $res['tm_year'] + 1900;
$this->month = $res['tm_mon'] + 1;
$this->day = $res['tm_mday'];
$this->hour = $res['tm_hour'];
$this->minute = $res['tm_min'];
$this->second = $res['tm_sec'];
}
break;
case self::LANG_TFORMAT:
$lf = jLocale::get('jelix~format.time_st');
if($res = strptime ( $str, $lf )){
$ok=true;
$this->hour = $res['tm_hour'];
$this->minute = $res['tm_min'];
$this->second = $res['tm_sec'];
}
break;
case self::LANG_SHORT_TFORMAT:
$lf = jLocale::get('jelix~format.short_time_st');
if($res = strptime ( $str, $lf )){
$ok=true;
$this->hour = $res['tm_hour'];
$this->minute = $res['tm_min'];
$this->second = 0;
}
break;
case self::LANG_SHORT_DTFORMAT:
$lf = jLocale::get('jelix~format.short_datetime_st');
if($res = strptime ( $str, $lf )){
$ok=true;
$this->year = $res['tm_year'] + 1900;
$this->month = $res['tm_mon'] + 1;
$this->day = $res['tm_mday'];
$this->hour = $res['tm_hour'];
$this->minute = $res['tm_min'];
}
break;
case self::DB_DFORMAT:
if($res = strptime( $str, "%Y-%m-%d" )){
$ok=true;
$this->year = $res['tm_year'] + 1900;
$this->month = $res['tm_mon'] + 1;
$this->day = $res['tm_mday'];
}
break;
case self::DB_DTFORMAT:
if($res = strptime( $str, "%Y-%m-%d %H:%M:%S" )){
$ok=true;
$this->year = $res['tm_year'] + 1900;
$this->month = $res['tm_mon'] + 1;
$this->day = $res['tm_mday'];
$this->hour = $res['tm_hour'];
$this->minute = $res['tm_min'];
$this->second = $res['tm_sec'];
}
break;
case self::DB_TFORMAT:
if($res = strptime( $str, "%H:%M:%S" )){
$ok=true;
$this->hour = $res['tm_hour'];
$this->minute = $res['tm_min'];
$this->second = $res['tm_sec'];
}
break;
case self::ISO8601_FORMAT:
if($ok=preg_match('/^(\d{4})(?:\-(\d{2})(?:\-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{2,3}))?)?(Z|([+\-])(\d{2}):(\d{2})))?)?)?$/', $str, $match)){
$c = count($match)-1;
$this->year = intval($match[1]);
if($c<2) break;
$this->month = intval($match[2]);
if($c<3) break;
$this->day = intval($match[3]);
if($c<4) break;
$this->hour = intval($match[4]);
$this->minute = intval($match[5]);
if($match[6] != '') $this->second = intval($match[6]);
if($match[8] != 'Z'){
$d = new jDuration(array('hour'=>$match[10],'minute'=>$match[11]));
if($match[9] == '+')
$this->sub($d);
else
$this->add($d);
}
}
break;
case self::TIMESTAMP_FORMAT:
$ok=true;
$t = getdate ( intval($str) );
$this->year = $t['year'];
$this->month = $t['mon'];
$this->day = $t['mday'];
$this->hour = $t['hours'];
$this->minute = $t['minutes'];
$this->second = $t['seconds'];
break;
case self::RFC822_FORMAT:
case self::RFC2822_FORMAT:
// Note the "x" modifier, otherwise the pattern would look like
// obfuscated code.
$regexp = "/^
(?: (?P<nday> Mon | Tue | Wed | Thu | Fri | Sat | Sun) , )? \s+
(?P<day>\d{1,2}) \s+
(?P<nmonth> Jan | Feb | Mar | Apr | May | Jun |
Jul | Aug | Sep | Oct | Nov | Dec) \s+
(?P<year>\d{4}) \s+
(?P<hour>\d{2}) : (?P<minute>\d{2}) (?: : (?P<second>\d{2}))? \s+
(?P<tzsign>[+-]) (?P<tzhour>\d{2}) (?P<tzminute>\d{2})$/x";
$english_months = array("Jan", "Feb", "Mar", "Apr", "May", "Jun",
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec");
$match = array("year" => 0, "month" => 0, "day" => 0,
"hour" => 0, "minute" => 0, "second" => 0, "tzsign" => "+",
"tzhour" => 0, "tzminute" => 0);
if($ok = preg_match($regexp, $str, $match)){
$this->year = intval($match['year']);
$this->month = array_search($match['nmonth'], $english_months) + 1;
$this->day = intval($match['day']);
$this->hour = intval($match['hour']);
$this->minute = intval($match['minute']);
$this->second = intval($match['second']);
// Adjust according to the timezone, so that the stored time
// corresponds to UTC.
$tz = new jDuration(array('hour'=>intval($match['tzhour']),
'minute'=>intval($match['tzminute'])));
if($match['tzsign'] == '+'){
$this->sub($tz);
}
else{
$this->add($tz);
}
}
break;
}
return $ok && $this->_check();
}
/**
* Add a duration to the date.
* You can specify the duration in a jDuration object or give each value of
* the duration.
* @param jDuration/int $year the duration value or a year with 4 digits
* @param int $month month with 2 digits
* @param int $day day with 2 digits
* @param int $hour hour with 2 digits
* @param int $minute minute with 2 digits
* @param int $second second with 2 digits
*/
public function add($year, $month=0, $day=0, $hour=0, $minute=0, $second=0) {
if ($year instanceof jDuration) {
$dt = $year;
} else {
$dt = new jDuration(array("year" => $year, "month" => $month,
"day" => $day, "hour" => $hour, "minute" => $minute,
"second" => $second));
}
$t = mktime($this->hour, $this->minute, $this->second + $dt->seconds,
$this->month + $dt->months, $this->day + $dt->days, $this->year);
$t = getdate ($t);
$this->year = $t['year'];
$this->month = $t['mon'];
$this->day = $t['mday'];
$this->hour = $t['hours'];
$this->minute = $t['minutes'];
$this->second = $t['seconds'];
}
/**
* substract a <b>duration</b> to the date
* You can specify the duration in a jDuration object or give each value of
* the duration.
* @param jDuration/int $year the duration value or a year with 4 digits
* @param int $month month with 2 digits
* @param int $day day with 2 digits
* @param int $hour hour with 2 digits
* @param int $minute minute with 2 digits
* @param int $second second with 2 digits
*/
public function sub($year, $month=0, $day=0, $hour=0, $minute=0, $second=0) {
if ($year instanceof jDuration) {
$dt = $year;
} else {
$dt = new jDuration(array("year" => $year, "month" => $month,
"day" => $day, "hour" => $hour, "minute" => $minute,
"second" => $second));
}
$dt->mult(-1);
$this->add($dt);
}
/**
* to know the duration between two dates.
* @param jDateTime $dt the date on which a sub will be made with the date on the current object
* @param bool $absolute
* @return jDuration a jDuration object
*/
public function durationTo($dt, $absolute=true){
if($absolute){
$t = gmmktime($dt->hour, $dt->minute, $dt->second,
$dt->month, $dt->day, $dt->year)
- gmmktime($this->hour, $this->minute, $this->second,
$this->month, $this->day, $this->year);
return new jDuration($t);
}
else{
return new jDuration(array(
"year" => $dt->year - $this->year,
"month" => $dt->month - $this->month,
"day" => $dt->day - $this-> day,
"hour" => $dt->hour - $this->hour,
"minute" => $dt->minute - $this->minute,
"second" => $dt->second - $this->second
));
}
}
/**
* Compare two date
* @param jDateTime $dt the date to compare
* @return integer -1 if $dt > $this, 0 if $dt = $this, 1 if $dt < $this
*/
public function compareTo($dt){
$fields=array('year','month','day','hour','minute','second');
foreach($fields as $field){
if($dt->$field > $this->$field)
return -1;
if($dt->$field < $this->$field)
return 1;
}
return 0;
}
/**
* Set date to current datetime
*/
public function now() {
$this->year = intval(date('Y'));
$this->month = intval(date('m'));
$this->day = intval(date('d'));
$this->hour = intval(date('H'));
$this->minute = intval(date('i'));
$this->second = intval(date('s'));
}
/**
* Substract a date with another
* @param jDateTime $date
* @return jDateTime
* @author Hadrien Lanneau <hadrien@over-blog.com>
* @since 1.2
*/
public function substract($date = null) {
if (!$date) {
$date = new jDateTime();
$date->now();
}
$newDate = new jDateTime();
$items = array(
'second',
'minute',
'hour',
'day',
'month',
'year'
);
foreach ($items as $k => $i) {
$newDate->{$i} = $date->{$i} - $this->{$i};
if ($newDate->{$i} < 0) {
switch ($i) {
case 'second':
case 'minute':
$sub = 60;
break;
case 'hour':
$sub = 24;
break;
case 'day':
switch ($this->month) {
// Month with 31 days
case 1:
case 3:
case 5:
case 7:
case 8:
case 10:
case 12:
$sub = 31;
break;
// Month with 30 days
case 4:
case 6:
case 9:
case 11:
$sub = 30;
break;
// February
case 2:
if ($this->year % 4 == 0 and
!(
$this->year % 100 == 0 and
$this->year % 400 != 0
)) {
// Bissextile
$sub = 29;
}
else {
$sub = 28;
}
break;
}
break;
case 'month':
$sub = 12;
break;
default:
$sub = 0;
}
$newDate->{$i} = abs($sub + $newDate->{$i});
if (isset($items[$k+1])) {
$newDate->{$items[$k+1]}--;
}
}
}
return $newDate;
}
}

Documentation generated on Wed, 24 Sep 2014 21:58:22 +0200 by phpDocumentor 1.4.3