243 lines
8.1 KiB
PHP
243 lines
8.1 KiB
PHP
|
<?php
|
||
|
|
/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4 foldmethod=marker: */
|
||
|
|
|
||
|
|
// {{{ Header
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Class to convert date strings between Gregorian and Human calendar formats
|
||
|
|
*
|
||
|
|
* The Human Calendar format has been proposed by Scott Flansburg and can be
|
||
|
|
* explained as follows:
|
||
|
|
* The year is made up of 13 months
|
||
|
|
* Each month has 28 days
|
||
|
|
* Counting of months starts from 0 (zero) so the months will run from 0 to 12
|
||
|
|
* New Years day (00) is a monthless day
|
||
|
|
* Note: Leap Years are not yet accounted for in the Human Calendar system
|
||
|
|
*
|
||
|
|
* PHP versions 4 and 5
|
||
|
|
*
|
||
|
|
* LICENSE:
|
||
|
|
*
|
||
|
|
* Copyright (c) 1997-2006 Allan Kent
|
||
|
|
* All rights reserved.
|
||
|
|
*
|
||
|
|
* Redistribution and use in source and binary forms, with or without
|
||
|
|
* modification, are permitted under the terms of the BSD License.
|
||
|
|
*
|
||
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
||
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
||
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
||
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
||
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
||
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||
|
|
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||
|
|
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
||
|
|
*
|
||
|
|
* @category Date and Time
|
||
|
|
* @package Date
|
||
|
|
* @author Allan Kent <allan@lodestone.co.za>
|
||
|
|
* @copyright 1997-2006 Allan Kent
|
||
|
|
* @license http://www.opensource.org/licenses/bsd-license.php
|
||
|
|
* BSD License
|
||
|
|
* @version CVS: $Id$
|
||
|
|
* @link http://pear.php.net/package/Date
|
||
|
|
* @since File available since Release 1.3
|
||
|
|
*/
|
||
|
|
|
||
|
|
// }}}
|
||
|
|
// {{{ Class: Date_Human
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Class to convert date strings between Gregorian and Human calendar formats
|
||
|
|
*
|
||
|
|
* The Human Calendar format has been proposed by Scott Flansburg and can be
|
||
|
|
* explained as follows:
|
||
|
|
* The year is made up of 13 months
|
||
|
|
* Each month has 28 days
|
||
|
|
* Counting of months starts from 0 (zero) so the months will run from 0 to 12
|
||
|
|
* New Years day (00) is a monthless day
|
||
|
|
* Note: Leap Years are not yet accounted for in the Human Calendar system
|
||
|
|
*
|
||
|
|
* @category Date and Time
|
||
|
|
* @package Date
|
||
|
|
* @author Allan Kent <allan@lodestone.co.za>
|
||
|
|
* @copyright 1997-2005 Allan Kent
|
||
|
|
* @license http://www.opensource.org/licenses/bsd-license.php
|
||
|
|
* BSD License
|
||
|
|
* @version Release: 1.5.0a4
|
||
|
|
* @link http://pear.php.net/package/Date
|
||
|
|
* @since Class available since Release 1.3
|
||
|
|
*/
|
||
|
|
class Date_Human
|
||
|
|
{
|
||
|
|
// {{{ gregorianToHuman()
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns an associative array containing the converted date information
|
||
|
|
* in 'Human Calendar' format.
|
||
|
|
*
|
||
|
|
* If the day is New Years Day, the function will return
|
||
|
|
* "hdom" => 0
|
||
|
|
* "hdow" => 0
|
||
|
|
* "hwom" => 0
|
||
|
|
* "hwoy" => 0
|
||
|
|
* "hmoy" => -1
|
||
|
|
* Since 0 is a valid month number under the Human Calendar, I have left
|
||
|
|
* the month as -1 for New Years Day.
|
||
|
|
*
|
||
|
|
* @param int $day in DD format, default current local day
|
||
|
|
* @param int $month in MM format, default current local month
|
||
|
|
* @param int $year in CCYY format, default to current local year
|
||
|
|
*
|
||
|
|
* @return associative array(
|
||
|
|
* hdom, // Human Day Of Month, starting at 1
|
||
|
|
* hdow, // Human Day Of Week, starting at 1
|
||
|
|
* hwom, // Human Week of Month, starting at 1
|
||
|
|
* hwoy, // Human Week of Year, starting at 1
|
||
|
|
* hmoy, // Human Month of Year, starting at 0
|
||
|
|
* )
|
||
|
|
* @access public
|
||
|
|
* @static
|
||
|
|
*/
|
||
|
|
public function gregorianToHuman($day = 0, $month = 0, $year = 0)
|
||
|
|
{
|
||
|
|
/*
|
||
|
|
* Check to see if any of the arguments are empty
|
||
|
|
* If they are then populate the $dateinfo array
|
||
|
|
* Then check to see which arguments are empty and fill
|
||
|
|
* those with the current date info
|
||
|
|
*/
|
||
|
|
if ((empty($day) || (empty($month)) || empty($year))) {
|
||
|
|
$dateinfo = getdate(time());
|
||
|
|
}
|
||
|
|
if (empty($day)) {
|
||
|
|
$day = $dateinfo["mday"];
|
||
|
|
}
|
||
|
|
if (empty($month)) {
|
||
|
|
$month = $dateinfo["mon"];
|
||
|
|
}
|
||
|
|
if (empty($year)) {
|
||
|
|
$year = $dateinfo["year"];
|
||
|
|
}
|
||
|
|
/*
|
||
|
|
* We need to know how many days into the year we are
|
||
|
|
*/
|
||
|
|
$dateinfo = getdate(mktime(0, 0, 0, $month, $day, $year));
|
||
|
|
$dayofyear = $dateinfo["yday"];
|
||
|
|
/*
|
||
|
|
* Human Calendar starts at 0 for months and the first day of the year
|
||
|
|
* is designated 00, so we need to start our day of the year at 0 for
|
||
|
|
* these calculations.
|
||
|
|
* Also, the day of the month is calculated with a modulus of 28.
|
||
|
|
* Because a day is 28 days, the last day of the month would have a
|
||
|
|
* remainder of 0 and not 28 as it should be. Decrementing $dayofyear
|
||
|
|
* gets around this.
|
||
|
|
*/
|
||
|
|
$dayofyear--;
|
||
|
|
/*
|
||
|
|
* 28 days in a month...
|
||
|
|
*/
|
||
|
|
$humanMonthOfYear = floor($dayofyear / 28);
|
||
|
|
/*
|
||
|
|
* If we are in the first month then the day of the month is $dayofyear
|
||
|
|
* else we need to find the modulus of 28.
|
||
|
|
*/
|
||
|
|
if ($humanMonthOfYear == 0) {
|
||
|
|
$humanDayOfMonth = $dayofyear;
|
||
|
|
} else {
|
||
|
|
$humanDayOfMonth = ($dayofyear) % 28;
|
||
|
|
}
|
||
|
|
/*
|
||
|
|
* Day of the week is modulus 7
|
||
|
|
*/
|
||
|
|
$humanDayOfWeek = $dayofyear % 7;
|
||
|
|
/*
|
||
|
|
* We can now increment $dayofyear back to it's correct value for
|
||
|
|
* the remainder of the calculations
|
||
|
|
*/
|
||
|
|
$dayofyear++;
|
||
|
|
/*
|
||
|
|
* $humanDayOfMonth needs to be incremented now - recall that we fudged
|
||
|
|
* it a bit by decrementing $dayofyear earlier
|
||
|
|
* Same goes for $humanDayOfWeek
|
||
|
|
*/
|
||
|
|
$humanDayOfMonth++;
|
||
|
|
$humanDayOfWeek++;
|
||
|
|
/*
|
||
|
|
* Week of the month is day of the month divided by 7, rounded up
|
||
|
|
* Same for week of the year, but use $dayofyear instead $humanDayOfMonth
|
||
|
|
*/
|
||
|
|
$humanWeekOfMonth = ceil($humanDayOfMonth / 7);
|
||
|
|
$humanWeekOfYear = ceil($dayofyear / 7);
|
||
|
|
/*
|
||
|
|
* Return an associative array of the values
|
||
|
|
*/
|
||
|
|
return array("hdom" => $humanDayOfMonth,
|
||
|
|
"hdow" => $humanDayOfWeek,
|
||
|
|
"hwom" => $humanWeekOfMonth,
|
||
|
|
"hwoy" => $humanWeekOfYear,
|
||
|
|
"hmoy" => $humanMonthOfYear);
|
||
|
|
}
|
||
|
|
|
||
|
|
// }}}
|
||
|
|
// {{{ humanToGregorian()
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns unix timestamp for a given Human Calendar date
|
||
|
|
*
|
||
|
|
* @param int $day in DD format
|
||
|
|
* @param int $month in MM format
|
||
|
|
* @param int $year in CCYY format, default to current local year
|
||
|
|
*
|
||
|
|
* @return int unix timestamp of date
|
||
|
|
* @access public
|
||
|
|
* @static
|
||
|
|
*/
|
||
|
|
public function humanToGregorian($day, $month, $year = 0)
|
||
|
|
{
|
||
|
|
/*
|
||
|
|
* Check to see if the year has been passed through.
|
||
|
|
* If not get current year
|
||
|
|
*/
|
||
|
|
if (empty($year)) {
|
||
|
|
$dateinfo = getdate(time());
|
||
|
|
$year = $dateinfo["year"];
|
||
|
|
}
|
||
|
|
/*
|
||
|
|
* We need to get the day of the year that we are currently at so that
|
||
|
|
* we can work out the Gregorian Month and day
|
||
|
|
*/
|
||
|
|
$DayOfYear = $month * 28;
|
||
|
|
$DayOfYear += $day;
|
||
|
|
/*
|
||
|
|
* Human Calendar starts at 0, so we need to increment $DayOfYear
|
||
|
|
* to take into account the day 00
|
||
|
|
*/
|
||
|
|
$DayOfYear++;
|
||
|
|
/*
|
||
|
|
* the mktime() function will correctly calculate the date for out of
|
||
|
|
* range values, so putting $DayOfYear instead of the day of the month
|
||
|
|
* will work fine.
|
||
|
|
*/
|
||
|
|
$GregorianTimeStamp = mktime(0, 0, 0, 1, $DayOfYear, $year);
|
||
|
|
return $GregorianTimeStamp;
|
||
|
|
}
|
||
|
|
|
||
|
|
// }}}
|
||
|
|
}
|
||
|
|
|
||
|
|
// }}}
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Local variables:
|
||
|
|
* mode: php
|
||
|
|
* tab-width: 4
|
||
|
|
* c-basic-offset: 4
|
||
|
|
* c-hanging-comment-ender-p: nil
|
||
|
|
* End:
|
||
|
|
*/
|