Your IP : 216.73.216.65
<?php
/**
* Time formatting and calculation functions
* @author Nick Korbel <lqqkout13@users.sourceforge.net>
* @version 12-26-09
* @package phpScheduleIt
*
* Copyright (C) 2003 - 2007 phpScheduleIt
* License: GPL, see LICENSE
*/
require_once('ReservationTime.class.php');
class Time
{
/**
* Formats number of minutes past midnight into a readable string and optionally adjust for timezone
* @param double $time time to convert in minutes
* @param bool $adjust if the time should be adjusted for timezone
* @param int $offset the timezone offset to use
* @return string time in 12 hour time
*/
function formatTime($time, $adjust = true, $offset = null) {
global $conf;
if ($adjust) {
$time = Time::getAdjustedMinutes($time, false, $offset);
}
// Set up time array with $timeArray[0]=hour, $timeArray[1]=minute
// If time does not contain decimal point
// then set time array manually
// else explode on the decimal point
$hour = intval($time / 60);
$min = $time % 60;
if ($conf['app']['timeFormat'] == 24) {
$a = ''; // AM/PM does not exist
if ($hour < 10) $hour = '0' . $hour;
}
else {
$a = ($hour < 12 || $hour == 24) ? translate('am') : translate('pm'); // Set am/pm
if ($hour > 12) $hour = $hour - 12; // Take out of 24hr clock
if ($hour == 0) $hour = 12; // Don't show 0hr, show 12 am
}
// Set proper minutes (the same for 12/24 format)
if ($min < 10)
{
$min = 0 . $min;
}
return $hour . ':' . $min . $a;
}
/**
* Convert timestamp to date format and adjust for timezone
* @param string $date timestamp
* @param string $format format to put datestamp into
* @param bool $adjust if the time should be adjusted for timezone
* @param int $offset the timezone offset to use
* @return string date as $format or as default format
*/
function formatDate($date, $format = '', $adjust = true, $offset = null) {
global $dates;
if ($adjust) {
$date = Time::getAdjustedTime($date, null, false, $offset);
}
if (empty($format)) {
$format = $dates['general_date'];
}
return strftime($format, $date);
}
/**
* Convert UNIX timestamp to datetime format and adjust for timezone
* @param string $ts MySQL timestamp
* @param string $format format to put datestamp into
* @return string date/time as $format or as default format
*/
function formatDateTime($ts, $format = '', $adjust = true) {
global $conf;
global $dates;
if ($adjust) {
$ts = Time::getAdjustedTime($ts);
}
if (empty($format)) {
$format = $dates['general_datetime'] . ' ' . (($conf['app']['timeFormat'] == 24) ? '%H' : '%I') . ':%M:%S' . (($conf['app']['timeFormat'] == 24) ? '' : ' %p');
}
return strftime($format, $ts);
}
/**
* Formats a timezone-adjusted timestamp for a reservation with this date and time
* @param int $res_ts the reservation start_date or end_date timestamp
* @param int $res_time the reservation starttime or endtime as minutes
* @param string $format the PHP format string for the resulting date
* @return the adjusted and formatted timestamp for the reservation
*/
function formatReservationDate($res_ts, $res_time, $format = '', $format_key = '', $offset = null) {
global $conf;
global $dates;
$start_ts = $res_ts + (60 * $res_time);
$res_ts = Time::getAdjustedTime($start_ts, null, false, $offset);
if (empty($format_key)) {
$format_key = 'general_date';
}
return translate_date($format_key, $res_ts);
}
/**
* Gets the timezone adjusted timestamp for the current user
* @param int $timestamp the timestamp to adjust
* @param int $res_time the reservation starttime or endtime as minutes
* @param bool $to_server_time if this is going to server time or user time
* @return the timezone adjusted timestamp for the current user, or the server timestamp if user is not logged in
*/
function getAdjustedTime($timestamp, $res_time = null, $to_server_time = false, $offset = null) {
$hourOffset = $offset != null ? $offset : Time::getHourOffset($to_server_time, $offset);
if ($hourOffset == 0) {
return $timestamp;
}
if (!empty($res_time)) {
$timestamp += ($res_time + (60 * $res_time));
}
return $timestamp + 3600 * $hourOffset;
}
/**
* Gets the timezone adjusted datestamp for the current user with 0 hour/minute/second
* @param int $timestamp the timestamp to adjust
* @param int $res_time the reservation starttime or endtime as minutes
* @param bool $to_server_time if this is going to server time or user time
* @return the timezone adjusted timestamp for the current user, or the server timestamp if user is not logged in
*/
function getAdjustedDate($timestamp, $res_time = null, $to_server_time = false) {
$tmp = getdate(Time::getAdjustedTime($timestamp, $res_time, $to_server_time));
return mktime(0,0,0, $tmp['mon'], $tmp['mday'], $tmp['year']);
}
/**
* Gets the user selected time and converts it into the server stored timezone
* @param int $datestamp the datestamp to adjust
* @param int $minutes number of minutes past midnight
*/
function getServerTime($datestamp, $minutes = null) {
if (Time::getHourOffset() == 0) {
$date = $datestamp;
$time = $minutes;
}
else {
$date = Time::getAdjustedDate($datestamp, $minutes, true);
$time = Time::getAdjustedMinutes($minutes, true);
}
return new ReservationTime($date, $time);
}
/**
* Gets the current hour, adjusted for timezone
* @param int $hour the 24 hour time to adjust
* @return the 24-hour adjusted hour
*/
function getAdjustedHour($hour) {
return ($hour + Time::getHourOffset() + 24)%24;
}
/**
* Returns the timezone adjusted number of minutes past midnight
* @param int $minutes minutes to adjust
* @return the timezone adjusted number of minutes past midnight
*/
function getAdjustedMinutes($minutes, $to_server_time = false, $offset = null) {
$hourOffset = $offset != null ? $offset : Time::getHourOffset($to_server_time);
return ($minutes + (60 * $hourOffset + 1440)) % 1440;
}
/**
* Gets the hourOffset for the currently logged in user or 0 if they are not logged in
* @return the hour offset between user timezone and server timezone
*/
function getHourOffset($to_server_time = false, $offset = null) {
$workingOffset = 0;
if ($offset == null && isset($_SESSION['hourOffset']))
{
$workingOffset = $_SESSION['hourOffset'];
}
if ($offset != null)
{
$workingOffset = $offset;
}
return $to_server_time ? $workingOffset * -1 : $workingOffset;
}
/**
* Convert minutes to hours/minutes
* @param int $minutes minutes to convert
* @return string version of hours and minutes
*/
function minutes_to_hours($minutes) {
if ($minutes == 0) {
return '0 ' . translate('hours');
}
$hours = (intval($minutes / 60) != 0) ? intval($minutes / 60) . ' ' . translate('hours') : '';
$min = (intval($minutes % 60) != 0) ? intval($minutes % 60) . ' ' . translate('minutes') : '';
return ($hours . ' ' . $min);
}
/**
* Gets the hour part from the number of minutes past midnight
* @param $minutes the number of minutes past midnight
* @return the string value of the hour part in 24 hour time
*/
function getHours($minutes) {
$hour = (intval($minutes / 60) != 0) ? intval($minutes / 60) : 0;
return ($hour < 10) ? "0$hour" : $hour;
}
/**
* Gets the hour part from the number of minutes past midnight
* @param $minutes the number of minutes past midnight
* @return the string value of the hour part in 24 hour time
*/
function getMinutes($minutes) {
$min = (intval($minutes % 60) != 0) ? intval($minutes % 60) : 0;
return ($min < 10) ? "0$min" : $min;
}
}
?>