Source for file Date.inc
Documentation is available at Date.inc
require_once $config->get('sysRoot'). 'alpha/exceptions/AlphaException.inc';
require_once $config->get('sysRoot'). 'alpha/model/types/AlphaType.inc';
require_once $config->get('sysRoot'). 'alpha/model/types/AlphaTypeInterface.inc';
* The Date complex data type
* @package alpha::model::types
* @author John Collins <dev@alphaframework.org>
* @version $Id: Date.inc 1341 2011-03-17 15:02:02Z johnc $
* @license http://www.opensource.org/licenses/bsd-license.php The BSD License
* @copyright Copyright (c) 2011, John Collins (founder of Alpha Framework).
* Redistribution and use in source and binary forms, with or
* without modification, are permitted provided that the
* following conditions are met:
* * Redistributions of source code must retain the above
* copyright notice, this list of conditions and the
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the
* following disclaimer in the documentation and/or other
* materials provided with the distribution.
* * Neither the name of the Alpha Framework nor the names
* of its contributors may be used to endorse or promote
* products derived from this software without specific
* prior written permission.
* 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 HOLDER 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.
* The textual version of the day, e.g. Monday
* The validation rule (reg-ex) applied to Date values
* The error message returned for invalid values
protected $helper= 'Not a valid date value! A date should be in the ISO format YYYY-MM-DD.';
* Constructor. Leave $date param empty to default to now.
* @param string $date Date string in the ISO format YYYY-MM-DD.
* @throws IllegalArguementException
if($config->get('sysDefaultDateTime') == 'now') {
$this->weekday= date('l');
* Accepts a full date string in ISO YYYY-mm-dd format and populates relevent Date attributes.
* @throws IllegalArguementException
* Set the Date attributes to match the three values provided
* @throws IllegalArguementException
$valid = 'Error: the year value '. $year. ' provided is invalid!';
if (!isset ($valid) && !preg_match('/^[0-9]{1,2}$/', $month))
$valid = 'Error: the month value '. $month. ' provided is invalid!';
if (!isset ($valid) && !preg_match('/^[0-9]{1,2}$/', $day))
$valid = 'Error: the day value '. $day. ' provided is invalid!';
if (!isset ($valid) && !checkdate($month, $day, $year))
$valid = 'Error: the day value '. $year. '-'. $month. '-'. $day. ' provided is invalid!';
$this->month = str_pad($month, 2, '0', STR_PAD_LEFT);
$this->day = str_pad($day, 2, '0', STR_PAD_LEFT);
$unixTime = mktime(0, 0, 0, $this->month, $this->day, $this->year);
$this->weekday= date('l', $unixTime);
* Get the date value as a string in the format "YYYY-MM-DD"
return $this->year. '-'. $this->month. '-'. $this->day;
* Return the value in UNIX timestamp format
return mktime(0, 0, 0, $this->month, $this->day, $this->year);
* Get the date value as a string in the format "DD/MM/YYYY"
return $this->day. '/'. $this->month. '/'. substr($this->year, 2, 2);
* Get the date value as a string in the format "MM/DD/YYYY"
return $this->month. '/'. $this->day. '/'. substr($this->year, 2, 2);
* Get the textual weekday part, e.g. Monday
* Accepts a full date string in YYYY-MM-DD format and populates relevent Date attributes.
* @throws IllegalArguementException
if($date == '' || $date == '0000-00-00') {
// This is just here for legacy to ensure that any old time value from a Date object is ignored
$spilt_by_space = explode(" ", $date);
if(isset ($spilt_by_space[0])) {
$date = $spilt_by_space[0];
$split_by_dash = explode("-", $date);
// Parse for the date parts, seperated by "-"
if(isset ($split_by_dash[0]) && isset ($split_by_dash[1]) && isset ($split_by_dash[2])) {
$year = $split_by_dash[0];
$month = $split_by_dash[1];
$day = $split_by_dash[2];
$valid = 'Error: the year value '. $year. ' provided is invalid!';
if (!isset ($valid) && !preg_match('/^[0-9]{1,2}$/', $month))
$valid = 'Error: the month value '. $month. ' provided is invalid!';
if (!isset ($valid) && !preg_match('/^[0-9]{1,2}$/', $day))
$valid = 'Error: the day value '. $day. ' provided is invalid!';
if (!isset ($valid) && !checkdate($month, $day, $year))
$valid = 'Error: the day value '. $year. '/'. $month. '/'. $day. ' provided is invalid!';
$this->month = str_pad($month, 2, '0', STR_PAD_LEFT);
$this->day = str_pad($day, 2, '0', STR_PAD_LEFT);
$unixTime = mktime(0, 0, 0, $this->month, $this->day, $this->year);
$this->weekday= date('l', $unixTime);
* Get the validation rule
return $this->validationRule;
* Set the validation rule
$this->validationRule = $rule;
|