[Sommaire] [Imprimer]

   1  <?php
   2  //
   3  // +----------------------------------------------------------------------+
   4  // | PHP Version 4                                                        |
   5  // +----------------------------------------------------------------------+
   6  // | Copyright (c) 1997-2003 The PHP Group                                |
   7  // +----------------------------------------------------------------------+
   8  // | This source file is subject to version 2.0 of the PHP license,       |
   9  // | that is bundled with this package in the file LICENSE, and is        |
  10  // | available at through the world-wide-web at                           |
  11  // | http://www.php.net/license/2_02.txt.                                 |
  12  // | If you did not receive a copy of the PHP license and are unable to   |
  13  // | obtain it through the world-wide-web, please send a note to          |
  14  // | license@php.net so we can mail you a copy immediately.               |
  15  // +----------------------------------------------------------------------+
  16  // | Author: Allan Kent <allan@lodestone.co.za>                           |
  17  // +----------------------------------------------------------------------+
  18  //
  19  // $Id: Human.php,v 1.3 2003/01/04 11:54:54 mj Exp $
  20  //
  21  
  22  /**
  23   * Class to convert date strings between Gregorian and Human calendar formats.
  24   * The Human Calendar format has been proposed by Scott Flansburg and can be
  25   * explained as follows:
  26   *  The year is made up of 13 months
  27   *  Each month has 28 days
  28   *  Counting of months starts from 0 (zero) so the months will run from 0 to 12
  29   *  New Years day (00) is a monthless day
  30   *  Note: Leap Years are not yet accounted for in the Human Calendar system
  31   *
  32   * @since PHP 4.0.4
  33   * @author Allan Kent <allan@lodestone.co.za>
  34   */
  35  class Date_Human
  36  {
  37  
  38      /**
  39       * Returns an associative array containing the converted date information
  40       * in 'Human Calendar' format.
  41       *
  42       * @param int day in DD format, default current local day
  43       * @param int month in MM format, default current local month
  44       * @param int year in CCYY format, default to current local year
  45       *
  46       * @access public
  47       *
  48       * @return associative array(
  49       *               hdom,       // Human Day Of Month, starting at 1
  50       *               hdow,       // Human Day Of Week, starting at 1
  51       *               hwom,       // Human Week of Month, starting at 1
  52       *               hwoy,       // Human Week of Year, starting at 1
  53       *               hmoy,       // Human Month of Year, starting at 0
  54       *               )
  55       *
  56       * If the day is New Years Day, the function will return
  57       * "hdom" =>  0
  58       * "hdow" =>  0
  59       * "hwom" =>  0
  60       * "hwoy" =>  0
  61       * "hmoy" => -1
  62       *  Since 0 is a valid month number under the Human Calendar, I have left
  63       *  the month as -1 for New Years Day.
  64       */
  65      function gregorianToHuman($day=0, $month=0, $year=0)
  66      {
  67          /**
  68           * Check to see if any of the arguments are empty
  69           * If they are then populate the $dateinfo array
  70           * Then check to see which arguments are empty and fill
  71           * those with the current date info
  72           */
  73          if ((empty($day) || (empty($month)) || empty($year))) {
  74              $dateinfo = getdate(time());
  75          }
  76          if (empty($day)) {
  77              $day = $dateinfo["mday"];
  78          }
  79          if (empty($month)) {
  80              $month = $dateinfo["mon"];
  81          }
  82          if (empty($year)) {
  83              $year = $dateinfo["year"];
  84          }
  85          /**
  86           * We need to know how many days into the year we are
  87           */
  88          $dateinfo = getdate(mktime(0, 0, 0, $month, $day, $year));
  89          $dayofyear = $dateinfo["yday"];
  90          /**
  91           * Human Calendar starts at 0 for months and the first day of the year
  92           * is designated 00, so we need to start our day of the year at 0 for
  93           * these calculations.
  94           * Also, the day of the month is calculated with a modulus of 28.
  95           * Because a day is 28 days, the last day of the month would have a
  96           * remainder of 0 and not 28 as it should be.  Decrementing $dayofyear
  97           * gets around this.
  98           */
  99          $dayofyear--;
 100          /**
 101           * 28 days in a month...
 102           */
 103          $humanMonthOfYear = floor($dayofyear / 28);
 104          /**
 105           * If we are in the first month then the day of the month is $dayofyear
 106           * else we need to find the modulus of 28.
 107           */
 108          if ($humanMonthOfYear == 0) {
 109              $humanDayOfMonth = $dayofyear;
 110          } else {
 111              $humanDayOfMonth = ($dayofyear) % 28;
 112          }
 113          /**
 114           * Day of the week is modulus 7
 115           */
 116          $humanDayOfWeek = $dayofyear % 7;
 117          /**
 118           * We can now increment $dayofyear back to it's correct value for
 119           * the remainder of the calculations
 120           */
 121          $dayofyear++;
 122          /**
 123           * $humanDayOfMonth needs to be incremented now - recall that we fudged
 124           * it a bit by decrementing $dayofyear earlier
 125           * Same goes for $humanDayOfWeek
 126           */
 127          $humanDayOfMonth++;
 128          $humanDayOfWeek++;
 129          /**
 130           * Week of the month is day of the month divided by 7, rounded up
 131           * Same for week of the year, but use $dayofyear instead $humanDayOfMonth
 132           */
 133          $humanWeekOfMonth = ceil($humanDayOfMonth / 7);
 134          $humanWeekOfYear = ceil($dayofyear / 7);
 135          /**
 136           * Return an associative array of the values
 137           */
 138          return array(
 139                       "hdom" => $humanDayOfMonth,
 140                       "hdow" => $humanDayOfWeek,
 141                       "hwom" => $humanWeekOfMonth,
 142                       "hwoy" => $humanWeekOfYear,
 143                       "hmoy" => $humanMonthOfYear );
 144      }
 145  
 146      /**
 147       * Returns unix timestamp for a given Human Calendar date
 148       *
 149       * @param int day in DD format
 150       * @param int month in MM format
 151       * @param int year in CCYY format, default to current local year
 152       *
 153       * @access public
 154       *
 155       * @return int unix timestamp of date
 156       */
 157      function HumanToGregorian($day, $month, $year=0)
 158      {
 159          /**
 160           * Check to see if the year has been passed through.
 161           * If not get current year
 162           */
 163          if (empty($year)) {
 164              $dateinfo = getdate(time());
 165              $year = $dateinfo["year"];
 166          }
 167          /**
 168           * We need to get the day of the year that we are currently at so that
 169           * we can work out the Gregorian Month and day
 170           */
 171          $DayOfYear = $month * 28;
 172          $DayOfYear += $day;
 173          /**
 174           * Human Calendar starts at 0, so we need to increment $DayOfYear
 175           * to take into account the day 00
 176           */
 177          $DayOfYear++;
 178          /**
 179           * the mktime() function will correctly calculate the date for out of
 180           * range values, so putting $DayOfYear instead of the day of the month
 181           * will work fine.
 182           */
 183          $GregorianTimeStamp = mktime(0, 0, 0, 1, $DayOfYear, $year);
 184          return $GregorianTimeStamp;
 185      }
 186  
 187  }
 188  ?>