/system/core/core.localize.php

<?php

/*
=====================================================
 ExpressionEngine - by EllisLab
-----------------------------------------------------
 http://expressionengine.com/
-----------------------------------------------------
 Copyright (c) 2003 - 2010 EllisLab, Inc.
=====================================================
 THIS IS COPYRIGHTED SOFTWARE
 PLEASE READ THE LICENSE AGREEMENT
 http://expressionengine.com/docs/license.html
=====================================================
 File: core.localize.php
-----------------------------------------------------
 Purpose: Date/time and localization functions
=====================================================
*/


if ( ! defined('EXT'))
{
    exit('Invalid file request');
}


class Localize {
  
  var $server_now			= '';  // Local server time
  var $now 					= '';  // Local server time as GMT  
  var $ctz 					=  0;  // Current user's timezone setting
  var $zones				= array();
  var $cached				= array();
  var $format				= array('DATE_ATOM'		=>	'%Y-%m-%dT%H:%i:%s%Q',
									'DATE_COOKIE'	=>	'%l, %d-%M-%y %H:%i:%s UTC',
									'DATE_ISO8601'	=>	'%Y-%m-%dT%H:%i:%s%O',
									'DATE_RFC822'	=>	'%D, %d %M %y %H:%i:%s %O',
									'DATE_RFC850'	=>	'%l, %d-%M-%y %H:%m:%i UTC',
									'DATE_RFC1036'	=>	'%D, %d %M %y %H:%i:%s %O',
									'DATE_RFC1123'	=>	'%D, %d %M %Y %H:%i:%s %O',
									'DATE_RFC2822'	=>	'%D, %d %M %Y %H:%i:%s %O',
									'DATE_RSS'		=>	'%D, %d %M %Y %H:%i:%s %O',
									'DATE_W3C'		=>	'%Y-%m-%dT%H:%i:%s%Q'
									);
  
  
    /** -------------------------------------
    /**  Constructor
    /** -------------------------------------*/
        
    // Fetch the current local server time and convert it to GMT

    function Localize()
    {
		$this->server_now 	= time();
        $this->now			= $this->set_gmt($this->server_now); 
        $this->zones		= $this->zones();
    }
    /* END */
    
    
    /** -------------------------------------
    /**  Set GMT time
    /** -------------------------------------*/
    
    // Takes a Unix timestamp as input and returns it as GMT
    
    function set_gmt($now = '')
    {    
        if ($now == '')
        {
            $now = time(); 
        }
            
        $time =  @mktime(	gmdate("H", $now),
							gmdate("i", $now),
							gmdate("s", $now),
							gmdate("m", $now),
							gmdate("d", $now),
							gmdate("Y", $now),
							-1	// this must be explicitly set or some FreeBSD servers behave erratically
							);
        // mktime() has a bug that causes it to fail during the DST "spring forward gap"
        // when clocks are offset an hour forward (around April 4).  Instead of returning a valid
        // timestamp, it returns -1.  Basically, mktime() gets caught in purgatory, not 
        // sure if DST is active or not.  As a work-around for this we'll test for "-1",
        // and if present, return the current time.  This is not a great solution, as this time
        // may not be what the user intended, but it's preferable than storing -1 as the timestamp, 
        // which correlates to: 1969-12-31 16:00:00. 

        if ($time == -1)
        {
            return $this->set_gmt();
        }
        else
        {
            return $time;
        }
    }    
    /* END */
    
    
    /** ---------------------------------------------
    /**  Convert a MySQL timestamp to GMT
    /** ---------------------------------------------*/
    
    function timestamp_to_gmt($str = '')
    {    
        
        // We'll remove certain characters for backward compatibility
        // since the formatting changed with MySQL 4.1
		// YYYY-MM-DD HH:MM:SS
		
        $str = str_replace('-', '', $str);
        $str = str_replace(':', '', $str);
        $str = str_replace(' ', '', $str);
        
		// YYYYMMDDHHMMSS

		return  $this->set_gmt( mktime( substr($str,8,2),
										substr($str,10,2),
										substr($str,12,2),
										substr($str,4,2),
										substr($str,6,2),
										substr($str,0,4)
									  )
							   );
    }
    /* END */


	
    /** --------------------------------------------
    /**  Set localized time
    /** --------------------------------------------*/
    
    // Converts GMT time to the localized values of the current logged-in user

    function set_localized_time($now = '', $timezone = '', $dst = '')
    {
        global $PREFS, $SESS;
                
        if ($now == '')
        {
            $now = $this->now;
        }
                
        // This lets us use a different timezone then the logged in user to calculate a time.
        // Right now we only use this to show the local time of other users

        if ($timezone == '')
        {    
			$timezone = $SESS->userdata['timezone'];
        }

        // If the current user has not set localization preferences
        // we'll instead use the master server settings
        
        if ($timezone == '')
        {
            return $this->set_server_time($now);   
        }

        $now += $this->zones[$timezone] * 3600;
    
		if ($dst == '')
		{
			$dst = $SESS->userdata('daylight_savings');
		}
    
        if ($dst == 'y')
        {
            $now += 3600;
        }
        
        return $this->set_server_offset($now);
    }
    /* END */

 
    /** --------------------------------------------
    /**  Set localized server time
    /** --------------------------------------------*/

    // Converts GMT time to the localized server timezone

    function set_server_time($now = '')
    {
        global $PREFS;
        
        if ($now == '')
        {
            $now = $this->now;
        }
        
        if ($tz = $PREFS->ini('server_timezone'))
        {
           $now += $this->zones[$tz] * 3600;
        }
        
        if ($PREFS->ini('daylight_savings') == 'y')
        {
            $now += 3600;
        }
        
        $now = $this->set_server_offset($now);
                
        return $now;
    }
    /* END */
    

    /** --------------------------------------------
    /**  Set server offset
    /** --------------------------------------------*/
    
    // Takes a Unix timestamp as input and adds/subtracts the number of 
    // minutes specified in the master server time offset preference
    
    // The optional second parameter lets us reverse the offset (positive number becomes negative)
    // We use the second paramter with set_localized_offset()

    function set_server_offset($time, $reverse = 0)
    {
        global $PREFS;
                
        $offset = ( ! $PREFS->ini('server_offset')) ? 0 : $PREFS->ini('server_offset') * 60;
        
        if ($offset == 0)
        {
            return $time;
        }
        
        if ($reverse == 1)
        {
            $offset = $offset * -1;
        }
        
        $time += $offset;
        
        return $time;
    }
    /* END */


    /** --------------------------------------------
    /**  Set localized offset
    /** --------------------------------------------*/
    
    // This function lets us calculate the time difference between the
    // timezone of the current user and the timezone of the server hosting
    // the site.  It solves a dilemma we face when using functions like mktime()
    // which base their output on the server's timezone.  When a weblog entry is
    // submitted, the entry date is converted to a Unix timestamp.  But since
    // the user submitting the entry might not be in the same timezone as the 
    // server we need to offset the timestamp to reflect this difference.
    
    function set_localized_offset()
    {
        global $PREFS, $SESS;
        
        $offset = 0;
                
        if ($SESS->userdata['timezone'] == '')
        {
            if ($tz = $PREFS->ini('server_timezone'))
            {
               $offset += $this->zones[$tz];
            }
            
            if ($PREFS->ini('daylight_savings') == 'y')
            {
                $offset += 1;
            }
        }
        else
        {             
            $offset += $this->zones[$SESS->userdata['timezone']];  
             
            if ($SESS->userdata['daylight_savings'] == 'y')
            {
                $offset += 1;
            }
        } 
                
        // Grab local time
        
        $time = $this->server_now;
        
        // Determine the number of seconds between the local time and GMT
        
        $time -= $this->now;
        
        // Offset this number based on the server offset (if it exists)
        
        $time = $this->set_server_offset($time, 1);
        
        // Divide by 3600, making our offset into hours
        
        $time = $time/3600;
        
        // add or subtract it from our timezone offset
        
        $offset -= $time;
        
        // Multiply by -1 to invert the value (positive becomes negative and vice versa)
        
        $offset = $offset * -1;
        
        // Convert it to seconds
                     
        if ($offset != 0)
            $offset = $offset * (60 * 60);
        
        return $offset;
    }
    /* END */
    
   
    
    /** -------------------------------------
    /**  Human-readable time
    /** -------------------------------------*/
    
    // Formats Unix/GMT timestamp to the following format: 2003-08-21 11:35 PM
    
    // Will also switch to Euro time based on the user preference

    function set_human_time($now = '', $localize = TRUE, $seconds = FALSE)
    {
        global $PREFS, $SESS;
        
		/* -------------------------------------------
		/*	Hidden Configuration Variable
        /*  - include_seconds => If set to 'y',
        /*  then we include the seconds on our human time.
		/* -------------------------------------------*/

        if (func_num_args() != 3 && $PREFS->ini('include_seconds') == 'y')
        {
        	$seconds = TRUE;
        }
        
        $fmt = ($SESS->userdata['time_format'] != '') ? $SESS->userdata['time_format'] : $PREFS->ini('time_format');
    
        if ($localize)
        {
            $now = $this->set_localized_time($now);
        }
            
        $r  = date('Y', $now).'-'.date('m', $now).'-'.date('d', $now).' ';
            
        if ($fmt == 'us')
        {
            $r .= date('h', $now).':'.date('i', $now);
        }
        else
        {
            $r .= date('H', $now).':'.date('i', $now);
        }
        
        if ($seconds)
        {
            $r .= ':'.date('s', $now);
        }
        
        if ($fmt == 'us')
        {
            $r .= ' '.date('A', $now);
        }
            
        return $r;
    }
    /* END */
    
    
    /** -------------------------------------------------------
    /**  Convert "human" date to GMT
    /** -------------------------------------------------------*/

    // Converts the human-readable date used in the weblog entry 
    // submission page back to Unix/GMT

    function convert_human_date_to_gmt($datestr = '')
    {
        global $LANG, $SESS, $PREFS;
    
        if ($datestr == '')
            return false;
                    
            $datestr = trim($datestr);
            
            $datestr = preg_replace("/\040+/", "\040", $datestr);
			
			if ( ! preg_match('/^[0-9]{2,4}\-[0-9]{1,2}\-[0-9]{1,2}\s[0-9]{1,2}:[0-9]{1,2}(?::[0-9]{1,2})?(?:\s[AP]M)?$/i', $datestr))
            {
                return $LANG->line('invalid_date_formatting');
            }

            $split = preg_split("/\040/", $datestr);

            $ex = explode("-", $split['0']);            
            
            $year  = (strlen($ex['0']) == 2) ? '20'.$ex['0'] : $ex['0'];
            $month = (strlen($ex['1']) == 1) ? '0'.$ex['1']  : $ex['1'];
            $day   = (strlen($ex['2']) == 1) ? '0'.$ex['2']  : $ex['2'];

            $ex = explode(":", $split['1']); 
            
            $hour = (strlen($ex['0']) == 1) ? '0'.$ex['0'] : $ex['0'];
            $min  = (strlen($ex['1']) == 1) ? '0'.$ex['1'] : $ex['1'];

			// I'll explain later
			$fib_seconds = FALSE;
			
            if (isset($ex['2']) AND preg_match("/[0-9]{1,2}/", $ex['2']))
            {
                $sec  = (strlen($ex['2']) == 1) ? '0'.$ex['2'] : $ex['2'];
            }
            else
            {
	        	// Unless specified, seconds get set to zero.
				// $sec = '00'; 
				// The above doesn't make sense to me, and can cause entries submitted within the same
				// minute to have identical timestamps, so I'm reverting to an older behavior - D'Jones
				// *********************************************************************************************
				// I now see what Paul was initially avoiding.  So, here's the dealio and how we'll address it:
				// Since the seconds were not specified, we're going to fib and roll back one second, otherwise
				// the submitted entry will be considered to not be < $LOC->now and will not be displayed on
				// the page request that creates it, a common scenario when submitting entries via a SAEF.
				// So we'll set a flag, and adjust the time by one second after the timestamp is generated.
				// If we do it here, we'd have to step backwards through minutes and hours and days etc. to
				// check if each needs to roll back, for dates like January 1, 1990 12:00:00
				$sec = date('s', $this->now);
				$fib_seconds = TRUE;
            }
            
            if (isset($split['2']))
            {
                $ampm = strtolower($split['2']);
                
                if (substr($ampm, 0, 1) == 'p' AND $hour < 12)
                    $hour = $hour + 12;
                    
                if (substr($ampm, 0, 1) == 'a' AND $hour == 12)
                    $hour =  '00';
                    
                if (strlen($hour) == 1)
                    $hour = '0'.$hour;
            }

        if ($year < 1902 || $year > 2037)            
        {
            return $LANG->line('date_outside_of_range');
        }
                
        $time = $this->set_gmt(mktime($hour, $min, $sec, $month, $day, $year));
		
		// Are we fibbing?
		if ($fib_seconds === TRUE)
		{
			$time = $time - 1;
		}
		
        // Offset the time by one hour if the user is submitting a date
        // in the future or past so that it is no longer in the same
        // Daylight saving time.
        
        if (date("I", $this->now))
        { 
            if ( ! date("I", $time))
            {
               $time -= 3600;            
            }
        }
        else
        {
            if (date("I", $time))
            {
                $time += 3600;           
            }
        }

        $time += $this->set_localized_offset();

        return $time;      
    }
    /* END */



    /** --------------------------------------------
    /**  Simple Offset
    /** --------------------------------------------*/
    
    // This allows a timestamp to be offset by the submitted timezone.
    // Currently this is only used in the PUBLISH page

    function simpl_offset($time = '', $timezone = '')
    {
    	global $SESS;
    	
		$time += $this->zones[$timezone] * 3600;

        if ($SESS->userdata('daylight_savings') == 'y')
        {
            $time += 3600;
        }
    
    	return $time;
	}
	/* END */


    /** --------------------------------------------
    /**  Offset Entry DST
    /** --------------------------------------------*/
    
    // This adds/subtracts an hour if the submitted entry
    // has the "honor DST setting" clicked

    function offset_entry_dst($time = '', $dst_enabled = '', $add_time = TRUE)
    {
		global $SESS, $PREFS;

		if ($PREFS->ini('honor_entry_dst') == 'y')
		{
			if ($dst_enabled == 'n' AND $SESS->userdata('daylight_savings') == 'y')
			{
				if ($add_time == TRUE)
					$time += 3600;
				else
					$time -= 3600;
			}
			elseif ($dst_enabled == 'y' AND $SESS->userdata('daylight_savings') == 'n')
			{
				if ($add_time == TRUE)
					$time -= 3600;
				else
					$time += 3600;
			}
		}
		
		return $time;
	}
	/* END */
	

    /** ----------------------------------
    /**  Format timespan
    /** ----------------------------------*/
    
    // Returns a span of seconds in this format: 10 days 14 hours 36 minutes 47 seconds

	function format_timespan($seconds = '')
	{
		global $LANG;

		// things can get really screwy if a negative number is passed, which can happen
		// in very rare load-balanced environments when the web servers' are not in
		// perfect sync with one another
		$seconds = abs($seconds);
		
		if ($seconds == '')
			$seconds = 1;

		$str = '';
		
		$years = floor($seconds / 31536000);
		
		if ($years > 0)
		{		
			$str .= $years.' '.$LANG->line(($years	> 1) ? 'years' : 'year').', ';
		}	
		
		$seconds -= $years * 31536000;
		
		$months = floor($seconds / 2628000);
		
		if ($years > 0 || $months > 0)
		{
			if ($months > 0)
			{		
				$str .= $months.' '.$LANG->line(($months	> 1) ? 'months'	: 'month').', ';
			}	
		
			$seconds -= $months * 2628000;
		}

		$weeks = floor($seconds / 604800);
		
		if ($years > 0 || $months > 0 || $weeks > 0)
		{
			if ($weeks > 0)
			{				
				$str .= $weeks.' '.$LANG->line(($weeks > 1) ? 'weeks' : 'week').', ';
			}
			
			$seconds -= $weeks * 604800;
		}			

		$days = floor($seconds / 86400);
		
		if ($months > 0 || $weeks > 0 || $days > 0)
		{
			if ($days > 0)
			{			
				$str .= $days.' '.$LANG->line(($days > 1) ? 'days' : 'day').', ';
			}
		
			$seconds -= $days * 86400;
		}
		
		$hours = floor($seconds / 3600);
		
		if ($days > 0 || $hours > 0)
		{
			if ($hours > 0)
			{
				$str .= $hours.' '.$LANG->line(($hours > 1) ? 'hours' : 'hour').', ';
			}
			
			$seconds -= $hours * 3600;
		}
		
		$minutes = floor($seconds / 60);
		
		if ($days > 0 || $hours > 0 || $minutes > 0)
		{
			if ($minutes > 0)
			{		
				$str .= $minutes.' '.$LANG->line(($minutes	> 1) ? 'minutes' : 'minute').', ';
			}
			
			$seconds -= $minutes * 60;
		}
		
		if ($str == '')
		{
			$str .= $seconds.' '.$LANG->line(($seconds	> 1) ? 'seconds' : 'second').', ';
		}
				
		$str = substr(trim($str), 0, -1);
		           
		return $str;
	}
	/* END */
	
   
    /** -------------------------------------------------
    /**  Fetch Date Params (via template parser)
    /** -------------------------------------------------*/

    function fetch_date_params($datestr = '')
    {
        if ($datestr == '')
            return;

        if ( ! preg_match_all("/(%\S)/", $datestr, $matches))
               return;
                 
        return $matches['1'];
    }
    /* END */


    /** -------------------------------------------------
    /**  Decode date string (via template parser)
    /** -------------------------------------------------*/
    // This function takes a string containing text and
    // date codes and extracts only the codes.  Then,
    // the codes are converted to their actual timestamp 
    // values and the string is reassembled.

    function decode_date($datestr = '', $unixtime = '', $localize = TRUE)
    {
		$prelocalized = FALSE;

		if ($datestr == '')
            return;
            
		if ($unixtime == 0)
			return '';

        if ( ! preg_match_all("/(%\S)/", $datestr, $matches))
               return;
               
        if ($localize === TRUE)
        {
        	$unixtime = $this->set_localized_time($unixtime);
			$prelocalized = TRUE;
        }

        foreach ($matches['1'] as $val)
        {
            $datestr = str_replace($val, $this->convert_timestamp($val, $unixtime, FALSE, $prelocalized), $datestr);
        }
                 
        return $datestr;
    }
    /* END */



    /** -------------------------------------
    /**  Localize month name
    /** -------------------------------------*/
    
    // Helper function used to translate month names.

    function localize_month($month = '')
    {    
        $months = array(
						    '01' => array('Jan', 'January'),
						    '02' => array('Feb', 'February'),
						    '03' => array('Mar', 'March'),
						    '04' => array('Apr', 'April'),
						    '05' => array('May', 'May_l'),
						    '06' => array('Jun', 'June'),
						    '07' => array('Jul', 'July'),
						    '08' => array('Aug', 'August'),
						    '09' => array('Sep', 'September'),
						    '10' => array('Oct', 'October'),
						    '11' => array('Nov', 'November'),
						    '12' => array('Dec', 'December')
						);
						
        if (isset($months[$month]))
        {
            return $months[$month];
        }
    }
    /* END */
    
    
    
    /** -------------------------------------
    /**  Convert timestamp codes
    /** -------------------------------------*/
    
    // All text codes are converted to the user-specified language.

    function convert_timestamp($which = '', $time = '', $localize = TRUE, $prelocalized = FALSE)
    {
        global $LANG, $SESS, $TMPL;

        if ($which == '')
            return;

		$localized_tz = ($prelocalized == TRUE) ? TRUE : $localize;
   
		$translate = (is_object($TMPL) && $TMPL->template_type == 'rss') ? FALSE : TRUE;
            
        if ($this->ctz == 0)
        {
            $this->ctz = $this->set_localized_timezone();
        }
            
        $time = ($localize == TRUE) ? $this->set_localized_time($time) : $time;
        
        $may = ($which == '%F' AND date('F', $time) == 'May') ? date('F', $time).'_l' : date('F', $time);
        
        if (isset($this->cached[$time][$which]))
        {
        	return $this->cached[$time][$which];
        }
  
  		switch ($which)
  		{
			case '%a': 	$var = ($translate === FALSE) ? date('a', $time) : $LANG->line(date('a', $time)); // am/pm
				break;
			case '%A': 	$var = ($translate === FALSE) ? date('A', $time) : $LANG->line(date('A', $time)); // AM/PM
				break;
			case '%B': 	$var = date('B', $time);
				break;
			case '%d': 	$var = date('d', $time);
				break;
			case '%D': 	$var = ($translate === FALSE) ? date('D', $time) : $LANG->line(date('D', $time)); // Mon, Tues
				break;
			case '%F': 	$var = ($translate === FALSE) ? date('F', $time) : $LANG->line($may); // January, February
				break;
			case '%g': 	$var = date('g', $time);
				break;
			case '%G': 	$var = date('G', $time);
				break;
			case '%h': 	$var = date('h', $time);
				break;
			case '%H': 	$var = date('H', $time);
				break;
			case '%i': 	$var = date('i', $time);
				break;
			case '%I': 	$var = ($localized_tz === TRUE) ? date('I', $time) : gmdate('I', $time);
				break;
			case '%j': 	$var = date('j', $time);
				break;
			case '%l': 	$var = ($translate === FALSE) ? date('l', $time) : $LANG->line(date('l', $time)); // Monday, Tuesday
				break;
			case '%L': 	$var = date('L', $time); 
				break;
			case '%m': 	$var = date('m', $time);    
				break;
			case '%M': 	$var = ($translate === FALSE) ? date('M', $time) : $LANG->line(date('M', $time)); // Jan, Feb
				break;
			case '%n': 	$var = date('n', $time);
				break;
			case '%O': 	$var = ($localized_tz === TRUE) ? date('O', $time) : gmdate('O', $time);
				break;
			case '%r': 	$var = ($translate === FALSE) ? date('D', $time).date(', d ', $time).date('M', $time).date(' Y H:i:s O', $time) : $LANG->line(date('D', $time)).date(', d ', $time).$LANG->line(date('M', $time)).date(' Y H:i:s O', $time);
				break;
			case '%s': 	$var = date('s', $time);
				break;
			case '%S': 	$var = date('S', $time);
				break;
			case '%t': 	$var = date('t', $time);
				break;
			case '%T': 	$var = ($localized_tz === TRUE) ? $this->ctz : gmdate('T', $time);
				break;
			case '%U': 	$var = date('U', $time);
				break;
			case '%w': 	$var = date('w', $time);
				break;
			case '%W': 	$var = date('W', $time);
				break;
			case '%y': 	$var = date('y', $time);
				break;
			case '%Y': 	$var = date('Y', $time);
				break;
			case '%Q':	$var = ($localized_tz === TRUE) ? $this->zone_offset($SESS->userdata['timezone']) : '+00:00';
				break;
			case '%z': 	$var = date('z', $time);
				break;
			case '%Z':	$var = ($localized_tz === TRUE) ? date('Z', $time) : gmdate('Z', $time);
				break;
			default  :  $var = '';
				break;
  		}
		
		$this->cached[$time][$which] = $var;
		
  		return $var;
    }
    /* END */



    /** ----------------------------------------------
    /**  GMT Offset - Ouputs:  +01:00
    /** ----------------------------------------------*/
    
	function zone_offset($tz = '')
	{
		if ($tz == '')
		{
			return '+00:00';
		}	
			
		$zone = trim($this->zones[$tz]);
		
		if ( ! strstr($zone, '.'))
		{
			$zone .= ':00';
		}
		
		$zone = str_replace(".5", ':30', $zone);
		
		if (substr($zone, 0, 1) != '-')
		{
			$zone = '+'.$zone;
		}
				
		$zone = preg_replace("/^(.{1})([0-9]{1}):(\d+)$/", "\\1D\\2:\\3", $zone);
		$zone = str_replace("D", '0', $zone);
     
		return $zone;        
	}
	/* END */



    /** ----------------------------------------------
    /**  Create timezone localization pull-down menu
    /** ----------------------------------------------*/
        
    function timezone_menu($default = '')
    {
        global $LANG, $DSP;
                
        $r  = "<div class='default'>";
        $r .= "<select name='server_timezone' class='select'>";
        
        foreach ($this->zones as $key => $val)
        {
            $selected = ($default == $key) ? " selected='selected'" : '';

			$r .= "<option value='{$key}'{$selected}>".$LANG->line($key)."</option>\n";
        }

        $r .= "</select>";
        $r .= "</div>";

        return $r;
    }
    /* END */


    /** -------------------------------------
    /**  Timezones
    /** -------------------------------------*/
    
    // This array is used to render the localization pull-down menu

    function zones()
    {
        // Note: Don't change the order of these even though 
        // some items appear to be in the wrong order
            
		return array( 
					'UM12'		=> -12,
					'UM11'		=> -11,
					'UM10'		=> -10,
					'UM95'		=> -9.5,
					'UM9'		=> -9,
					'UM8'		=> -8,
					'UM7'		=> -7,
					'UM6'		=> -6,
					'UM5'		=> -5,
					'UM45'		=> -4.5,
					'UM4'		=> -4,
					'UM35'		=> -3.5,
					'UM3'		=> -3,
					'UM2'		=> -2,
					'UM1'		=> -1,
					'UTC'		=> 0,
					'UP1'		=> +1,
					'UP2'		=> +2,
					'UP3'		=> +3,
					'UP35'		=> +3.5,
					'UP4'		=> +4,
					'UP45'		=> +4.5,
					'UP5'		=> +5,
					'UP55'		=> +5.5,
					'UP575'		=> +5.75,
					'UP6'		=> +6,
					'UP65'		=> +6.5,
					'UP7'		=> +7,
					'UP8'		=> +8,
					'UP875'		=> +8.75,
					'UP9'		=> +9,
					'UP95'		=> +9.5,
					'UP10'		=> +10,
					'UP105'		=> +10.5,
					'UP11'		=> +11,
					'UP115'		=> +11.5,
					'UP12'		=> +12,
					'UP1275'	=> +12.75,
					'UP13'		=> +13,
					'UP14'		=> +14
			);
    }
    /* END */



    /** --------------------------------------------
    /**  Set localized timezone
    /** --------------------------------------------*/
    
    function set_localized_timezone()
    {
        global $PREFS, $SESS;
        
        $zones = array(
						'UM12'	=> array('',	''),
						'UM11'	=> array('SST',	'SST'),
						'UM10'	=> array('HST',	'HST'),
						'UM95'	=> array('MART','MART'),
						'UM9'	=> array('AKST','AKDT'),					
						'UM8'	=> array('PST',	'PDT'),
						'UM7'	=> array('MST',	'MDT'),
						'UM6'	=> array('CST',	'CDT'),
						'UM5'	=> array('EST',	'EDT'),
						'UM45'	=> array('VET',	'VET'),
						'UM4'	=> array('AST',	'ADT'),
						'UM35'	=> array('NST',	'NDT'),
						'UM3'	=> array('ADT',	'ADT'),
						'UM2'	=> array('MAST','MAST'),
						'UM1'	=> array('AZOT','AZOT'),
						'UTC'	=> array('GMT',	'GMT'),
						'UP1'	=> array('MET',	'MET'),
						'UP2'	=> array('EET',	'EET'),
						'UP3'	=> array('BT', 	'BT'),
						'UP35'	=> array('IRT',	'IRT'),
						'UP4'	=> array('ZP4',	'ZP4'),
						'UP45'	=> array('AFT',	'AFT'),
						'UP5'	=> array('ZP5',	'ZP5'),
						'UP55'	=> array('IST',	'IDT'),
						'UP575'	=> array('NPT',	'NPT'),
						'UP6'	=> array('ZP6',	'ZP6'),
						'UP65'	=> array('BURT','BURT'),
						'UP7'	=> array('WAST','WADT'),
						'UP8'	=> array('WST','WDT'),
						'UP875'	=> array('CWST','CWDT'),
						'UP9'	=> array('JST',	'JDT'),
						'UP95'	=> array('CST',	'CDT'),
						'UP10'	=> array('AEST','AEDT'),
						'UP105'	=> array('LHST','LHST'),
						'UP11'	=> array('MAGT','MAGT'),
						'UP115'	=> array('NFT',	'NFT'),
						'UP12'	=> array('NZST','NZDT'),
						'UP1275'=> array('CHAST','CHAST'),
						'UP13'	=> array('PHOT','PHOT'),
						'UP14'	=> array('LINT','LINT')
                     ); 
    
        
        if ($SESS->userdata['timezone'] == '')
        {
            $zone = $PREFS->ini('server_timezone');
			$dst = ($PREFS->ini('daylight_savings')  == 'y') ? TRUE : FALSE;
        }
        else
        {
            $zone = $SESS->userdata['timezone'];
			$dst = ($SESS->userdata['daylight_savings'] == 'y') ? TRUE : FALSE;
		}
		
		if (isset($zones[$zone]))
		{
			if ($dst == FALSE)
			{
				return $zones[$zone]['0'];        
			}
			else
			{
				return $zones[$zone]['1'];        
			}
		}
		
		return 'GMT';	
    }
    /* END */
 
 
 
    /** ----------------------------------------
    /**  Fetch Days in Month
    /** ----------------------------------------*/
    
    // Returns the number of days for the given month/year
    // Takes leap years into consideration

    function fetch_days_in_month($month, $year)
    {
    	$days_in_month	= array(31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31);
    
        if ($month < 1 || $month > 12)
        {
            return 0;
        }
        
        if ($month == 2)
        {        
			if ($year % 400 == 0 || ($year % 4 == 0 AND $year % 100 != 0))
			{
				return 29;
			}
        }
    
        return $days_in_month[$month - 1];
    }
	/* END */
 
 
 
    /** ----------------------------------------
    /**  Adjust Date
    /** ----------------------------------------*/
    
    // This function is used by the calendar.  It verifies that
    // the month/day are within the correct range and adjusts 
    // if necessary.  For example:  Day 34 in Feburary would
    // be adjusted to March 6th.

    function adjust_date($month, $year, $pad = FALSE)
    {
        $date = array(); 
        
        $date['month']	= $month;
        $date['year']	= $year;
        
        while ($date['month'] > 12)
        {
            $date['month'] -= 12;
            $date['year']++;
        }
        
        while ($date['month'] <= 0)
        {
            $date['month'] += 12;
            $date['year']--;
        }
        
        if ($pad == TRUE AND strlen($date['month']) == 1)
        {
        	$date['month'] = '0'.$date['month'];
        }
        
        return $date;
    }
	/* END */
}
// END CLASS
?>