mako\DateTime

Description

Collection of date and time related methods.

Class methods

protected __construct()

Protected constructor since this is a static class.

Return value

NULL

protected function __construct()
{
	// Nothing here
}

Toggle source

public static utcDate($dateFormat, $timestamp, $offset = 0)

Returns a localized date (based on the locale).

Parameters

Type	Description
string	Date format (http://php.net/manual/en/function.strftime.php)
int	Unix timestamp
int	(optional) Offset in seconds

Return value

string

public static function utcDate($dateFormat, $timestamp, $offset = 0)
{
	return gmstrftime($dateFormat, ($timestamp + $offset));
}

Toggle source

public static utcTimeZones()

Returns an array with all UTC timezones (keys are offset seconds from UTC).

Return value

array

public static function utcTimeZones()
{
	$timeZones = array
	(
		'-43200' => 'UTC-12:00',
		'-39600' => 'UTC-11:00',
		'-36000' => 'UTC-10:00',
		'-34200' => 'UTC-9:30',
		'-32400' => 'UTC-9:00',
		'-28800' => 'UTC-8:00',
		'-25200' => 'UTC-7:00',
		'-21600' => 'UTC-6:00',
		'-18000' => 'UTC-5:00',
		'-16200' => 'UTC-4:30',
		'-14400' => 'UTC-4:00',
		'-12600' => 'UTC-3:30',
		'-10800' => 'UTC-3:00',
		'-7200'  => 'UTC-2:00',
		'-3600'  => 'UTC-1:00',
		'0'      => 'UTC',
		'3600'   => 'UTC+1:00',
		'7200'   => 'UTC+2:00',
		'10800'  => 'UTC+3:00',
		'12600'  => 'UTC+3:30',
		'14400'  => 'UTC+4:00',
		'16200'  => 'UTC+4:30',
		'18000'  => 'UTC+5:00',
		'19800'  => 'UTC+5:30',
		'20700'  => 'UTC+5:45',
		'21600'  => 'UTC+6:00',
		'23400'  => 'UTC+6:30',
		'25200'  => 'UTC+7:00',
		'28800'  => 'UTC+8:00',
		'31500'  => 'UTC+8:45',
		'32400'  => 'UTC+9:00',
		'34200'  => 'UTC+9:30',
		'36000'  => 'UTC+10:00',
		'37800'  => 'UTC+10:30',
		'39600'  => 'UTC+11:00',
		'41400'  => 'UTC+11:30',
		'43200'  => 'UTC+12:00',
		'45900'  => 'UTC+12:45',
		'46800'  => 'UTC+13:00',
		'50400'  => 'UTC+14:00'
	);

	return $timeZones;
}

Toggle source

public static fuzzy($timestamp, $dateFormat, $offset = 0, $fullFuzzy = false, $clockFormat = ', %R %p')

Returns a "fuzzy date".

Parameters

Type	Description
int	Unix timestamp
string	Date format used for non-fuzy dates
int	(optional) Offset in seconds
boolean	(optional) Enable full fuzziness
string	(optional) Clock format for fuzzy dates - set to false to disable

Return value

string

public static function fuzzy($timestamp, $dateFormat, $offset = 0, $fullFuzzy = false, $clockFormat = ', %R %p')
{
	$now  = time();
	$diff = max($now - $timestamp, 0);
	
	if($diff < 120)
	{
		 return I18n::translate('a minute ago');
	}
	else if($diff < 3600)
	{
		return I18n::translate('%u minutes ago', array($diff / 60));
	}
	
	if($fullFuzzy === true)
	{
		// Full fuzzy
		
		if($diff < 7200)
		{
			return I18n::translate('an hour ago');
		}
		else if($diff < 86400)
		{
			return I18n::translate('%u hours ago', array($diff / 3600));
		}
		else if($diff < 172800)
		{
			$date = I18n::translate('a day ago');
		}
		else if($diff < 604800)
		{
			$date = I18n::translate('%u days ago', array($diff / 86400));
		}
		else if($diff < 1209600)
		{
			$date = I18n::translate('a week ago');
		}
		else if($diff < 3024000)
		{
			$date = I18n::translate('%u weeks ago', array($diff / 604800));
		}
		else
		{
			return static::utcDate($dateFormat, $timestamp, $offset);
		}
	}
	else
	{
		// Kinda fuzzy
		
		$compare = gmdate('jny', ($timestamp + $offset));

		if(gmdate('jny', ($now + $offset)) == $compare)
		{
			$date = I18n::translate('today');
		}
		else if(gmdate('jny', (($now + $offset) - 86400)) == $compare)
		{
			$date = I18n::translate('yesterday');
		}
		else
		{
			return static::utcDate($dateFormat, $timestamp, $offset);
		}
	}
	
	if($clockFormat !== false)
	{
		$date .= static::utcDate($clockFormat, $timestamp, $offset);
	}
	
	return $date;
}

Toggle source

public static isLeapYear($year)

Returns true if year is leap year and false if not.

Parameters

Type	Description
int	The year you want to check

Return value

boolean

public static function isLeapYear($year)
{
	if($year % 400 === 0 || ($year % 4 === 0 && $year % 100 !== 0))
	{
		return true;
	}

	return false;
}

Toggle source

public static daysInMonth($month = NULL, $year = NULL)

Returns the number of days in the chosen month.

Parameters

Type	Description
int	(optional) Numeric representation of a month without leading zeros
int	(optional) Full numeric representation of a year

Return value

int

public static function daysInMonth($month = null, $year = null)
{
	if($month !== null && ($month > 12 || $month < 1))
	{
		throw new OutOfRangeException(vsprintf("%s(): There are only 12 months in a year.", array(__METHOD__)));
	}

	$month === null && $month = date('n');

	$year === null && $year = date('Y');

	$days = array
	(
		31,
		static::isLeapYear($year) ? 29 : 28,
		31,
		30,
		31,
		30,
		31,
		31,
		30,
		31,
		30,
		31
	);

	return $days[$month - 1];
}

Toggle source

public static unix2dos($timestamp = NULL)

Converts a UNIX timestamp to a DOS timestamp.

Parameters

Type	Description
int	Unix timestamp

Return value

int

public static function unix2dos($timestamp = null)
{
	$time = ($timestamp === null) ? getdate() : getdate($timestamp);

	if($time['year'] < 1980)
	{
		$time['year']    = 1980;
		$time['mon']     = 1;
		$time['mday']    = 1;
		$time['hours']   = 0;
		$time['minutes'] = 0;
		$time['seconds'] = 0;
	}

	return (($time['year'] - 1980) << 25) | ($time['mon'] << 21) | ($time['mday'] << 16) | ($time['hours'] << 11) | ($time['minutes'] << 5) | ($time['seconds'] >> 1);
}

Toggle source

public static dos2unix($timestamp)

Converts a DOS timestamp to a UNIX timestamp.

Parameters

Type	Description
int	DOS timestamp

Return value

int

public static function dos2unix($timestamp)
{
	$year     = (($timestamp >> 25) & 0x7f) + 1980;
	$mon      = ($timestamp >> 21) & 0x0f;
	$mday     = ($timestamp >> 16) & 0x1f;
	$hours    = ($timestamp >> 11) & 0x1f;
	$minutes  = ($timestamp >> 5) & 0x3f;
	$seconds  = 2 * ($timestamp & 0x1f);

	return mktime($hours, $minutes, $seconds, $mon, $mday, $year);
}