<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');
/**
* CodeIgniter
*
* An open source application development framework for PHP 5.1.6 or newer
*
* @package CodeIgniter
* @author ExpressionEngine Dev Team
* @copyright Copyright (c) 2008 - 2011, EllisLab, Inc.
* @license http://codeigniter.com/user_guide/license.html
* @link http://codeigniter.com
* @since Version 1.0
* @filesource
*/
// ------------------------------------------------------------------------
/**
* CodeIgniter Date Helpers
* CI 日期帮助
* @package CodeIgniter
* @subpackage Helpers
* @category Helpers
* @author ExpressionEngine Dev Team
* @link http://codeigniter.com/user_guide/helpers/date_helper.html
*/
// ------------------------------------------------------------------------
/**
* Get "now" time
* “现在”时间
* Returns time() or its GMT equivalent based on the config file preference
* 返回时间（）或GMT相当于基于配置文件偏好
* @access public
* @return integer 定义now()函数
*/
if ( ! function_exists('now'))
{
function now()
{
$CI =& get_instance();
//如果CI config中用的是teim_reference == gmt的话
if (strtolower($CI->config->item('time_reference')) == 'gmt')
{
$now = time(); //当前时间
//gmdate() 函数格式化GMT/UTC 日期/时间
//同date()函数类似，不同的是返回时间是格林威治标准时(GMT)
$system_time = mktime(gmdate("H", $now), gmdate("i", $now), gmdate("s", $now), gmdate("m", $now), gmdate("d", $now), gmdate("Y", $now));
if (strlen($system_time) < 10)
{
$system_time = time();
log_message('error', 'The Date class could not set a proper GMT timestamp so the local time() value was used.Date类不能设置一个适当的GMT时间戳，所以本地时间（）值。');
}
return $system_time;
}
else
{
return time();
}
}
}
// ------------------------------------------------------------------------
/**
* Convert MySQL Style Datecodes
* MySQL的风格转换日期代码
*
* This function is identical to PHPs date() function,
* except that it allows date codes to be formatted using
* the MySQL style, where each code letter is preceded
* with a percent sign: %Y %m %d etc...
* 此功能PHPS date（）函数相同，
* 只是它允许被格式化的日期代码使用MySQL的风格，
* 每个代码字母前面百分号：％Y％M％D等..
*
* The benefit of doing dates this way is that you don't
* have to worry about escaping your text letters that
* match the date codes.
* 日期这样做的好处是，你不这样做有担心逃脱你的文字字母相匹配的日期代码。
* @access public
* @param string
* @param integer
* @return integer
*/
if ( ! function_exists('mdate'))
{
function mdate($datestr = '', $time = '')
{
if ($datestr == '')
return '';
if ($time == '')
$time = now();
// preg_replace("/([a-z]+?){1}/i", "\\\\\\1", $datestr)
// 只要是a-z 后面加上一次或多次的{1} 替换为\\\\\1
$datestr = str_replace('%\\', '', preg_replace("/([a-z]+?){1}/i", "\\\\\\1", $datestr));
return date($datestr, $time);
}
}
// ------------------------------------------------------------------------
/**
* Standard Date
* 标准日期
*
* Returns a date formatted according to the submitted standard.
* 根据提交的标准格式返回日期。
* @access public
* @param string the chosen format //格式
* @param integer Unix timestamp //时间截
* @return string
*/
if ( ! function_exists('standard_date'))
{
function standard_date($fmt = 'DATE_RFC822', $time = '')
{
$formats = 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%Q',
'DATE_RFC822' => '%D, %d %M %y %H:%i:%s %O',
'DATE_RFC850' => '%l, %d-%M-%y %H:%i:%s UTC',
'DATE_RFC1036' => '%D, %d %M %y %H:%i:%s %O',
'DATE_RFC1123' => '%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'
);
//DATE_ATOM
//DATE_COOKIE
//DATE_ISO8601
//DATE_RFC822
//DATE_REC850
//DATE_RFC1036
//DATE_RFC1123
//DATE_RSS
//DATE_W3C
//如果指定的格式不存在
if ( ! isset($formats[$fmt]))
{
return FALSE;
}
//mdate
return mdate($formats[$fmt], $time);
}
}
// ------------------------------------------------------------------------
/**
* Timespan
* 时间跨度
*
* Returns a span of seconds in this format:
* 10 days 14 hours 36 minutes 47 seconds
* *返回跨度秒格式为：10天14小时36分钟47秒 days hours minutes seconds
* @access public
* @param integer a number of seconds 秒数
* @param integer Unix timestamp 时间
* @return integer
*/
if ( ! function_exists('timespan'))
{
function timespan($seconds = 1, $time = '')
{
$CI =& get_instance();
$CI->lang->load('date'); //$CI->lang->load('date');?这是加载的那个文档，没找到？
//如果秒数不为数值，is_numeric
if ( ! is_numeric($seconds))
{
$seconds = 1;
}
//如果时间不为数值，取当前时间time()
if ( ! is_numeric($time))
{
$time = time();
}
//如果当前时间还要小于需要计算的秒数
if ($time <= $seconds)
{
$seconds = 1;
}
else
{
//取两者之间相差的秒数
$seconds = $time - $seconds;
}
$str = '';
$years = floor($seconds / 31536000); //一年的秒数 31536000
// 如果年数大于0
if ($years > 0)
{
//如果$years 大于1 取lang->line中的date_years这行，或者取date_year这行
$str .= $years.' '.$CI->lang->line((($years > 1) ? 'date_years' : 'date_year')).', ';
}
$seconds -= $years * 31536000; //用相差的秒数减去已经取得的年数
$months = floor($seconds / 2628000); //一月的秒数 2628000
//如果年大于0 或者月大于0
if ($years > 0 OR $months > 0)
{
//月大于0
if ($months > 0)
{
//
$str .= $months.' '.$CI->lang->line((($months > 1) ? 'date_months' : 'date_month')).', ';
}
//减去月所在的秒数
$seconds -= $months * 2628000;
}
//一周的秒数 604800
$weeks = floor($seconds / 604800);
//如果年大于0或者月大于0或者周大于0
if ($years > 0 OR $months > 0 OR $weeks > 0)
{
//周大于0
if ($weeks > 0)
{
$str .= $weeks.' '.$CI->lang->line((($weeks > 1) ? 'date_weeks' : 'date_week')).', ';
}
$seconds -= $weeks * 604800;
}
//一天的秒数为 86400
// floor() 返回的类型仍然是 float,因为 float 值的范围通常比 integer 要大
// floor() 返回的类型仍然是float,因为float值的范围通常比integer要大
$days = floor($seconds / 86400);
//如果月大于0 周大于0，天大于0
if ($months > 0 OR $weeks > 0 OR $days > 0)
{
if ($days > 0)
{
$str .= $days.' '.$CI->lang->line((($days > 1) ? 'date_days' : 'date_day')).', ';
}
$seconds -= $days * 86400;
}
//一小时
$hours = floor($seconds / 3600);
if ($days > 0 OR $hours > 0)
{
if ($hours > 0)
{
$str .= $hours.' '.$CI->lang->line((($hours > 1) ? 'date_hours' : 'date_hour')).', ';
}
$seconds -= $hours * 3600;
}
//一分种
$minutes = floor($seconds / 60);
if ($days > 0 OR $hours > 0 OR $minutes > 0)
{
if ($minutes > 0)
{
$str .= $minutes.' '.$CI->lang->line((($minutes > 1) ? 'date_minutes' : 'date_minute')).', ';
}
$seconds -= $minutes * 60;
}
if ($str == '')
{
$str .= $seconds.' '.$CI->lang->line((($seconds > 1) ? 'date_seconds' : 'date_second')).', ';
}
//
return substr(trim($str), 0, -1);
}
}
// ------------------------------------------------------------------------
/**
* Number of days in a month
* 一个月的天数
*
* Takes a month/year as input and returns the number of days
* for the given month/year. Takes leap years into consideration.
* 需要一个月/年作为输入并返回的天数
* 给定月份/年。考虑闰年。
* @access public
* @param integer a numeric month 月
* @param integer a numeric year 年
* @return integer
*/
if ( ! function_exists('days_in_month'))
{
function days_in_month($month = 0, $year = '')
{
//如果月分小于1大于12就是不合法的
if ($month < 1 OR $month > 12)
{
return 0;
}
//如果year不为数值，或者长度不等于四位，取当前的年月
if ( ! is_numeric($year) OR strlen($year) != 4)
{
$year = date('Y');
}
//如果是二月
if ($month == 2)
{
//用年%400ak或者年%4==0 并且$year%100!=0
//不是润年
if ($year % 400 == 0 OR ($year % 4 == 0 AND $year % 100 != 0))
{
return 29;
}
}
//
$days_in_month = array(31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31);
return $days_in_month[$month - 1];
}
}
// ------------------------------------------------------------------------
/**
* Converts a local Unix timestamp to GMT
* 本地的Unix时间戳转换GMT
* @access public
* @param integer Unix timestamp
* @return integer
*/
if ( ! function_exists('local_to_gmt'))
{
function local_to_gmt($time = '')
{
if ($time == '')
$time = time();
//Hours时 mintern seconds month days year
return mktime( gmdate("H", $time), gmdate("i", $time), gmdate("s", $time), gmdate("m", $time), gmdate("d", $time), gmdate("Y", $time));
}
}
// ------------------------------------------------------------------------
/**
* Converts GMT time to a localized value
* GMT时间转换本地化值
*
* Takes a Unix timestamp (in GMT) as input, and returns
* at the local value based on the timezone and DST setting
* submitted
* 注意到一个Unix时间戳（GMT）作为输入，并返回
* 在当地的价值基础上的时区和夏令时设置
* 提交
* @access public
* @param integer Unix timestamp
* @param string timezone
* @param bool whether DST is active 是否是活跃DST
* @return integer
*/
if ( ! function_exists('gmt_to_local'))
{
function gmt_to_local($time = '', $timezone = 'UTC', $dst = FALSE)
{
if ($time == '')
{
return now();
}
$time += timezones($timezone) * 3600;
//是否为夏令时
if ($dst == TRUE)
{
$time += 3600;
}
return $time;
}
}
// ------------------------------------------------------------------------
/**
* Converts a MySQL Timestamp to Unix
* 一个MySQL时间戳转换到Unix
* @access public
* @param integer Unix timestamp
* @return integer
*/
if ( ! function_exists('mysql_to_unix'))
{
function mysql_to_unix($time = '')
{
// We'll remove certain characters for backward compatibility
// since the formatting changed with MySQL 4.1
// YYYY-MM-DD HH:MM:SS
// 我们会删除某些字符的向后兼容性
// 因为与MySQL4.1的格式改变
// YYYY-MM-DD HH：MM：SS
$time = str_replace('-', '', $time);
$time = str_replace(':', '', $time);
$time = str_replace(' ', '', $time);
// YYYYMMDDHHMMSS
return mktime(
substr($time, 8, 2), //hours
substr($time, 10, 2),//minute
substr($time, 12, 2),//secods
substr($time, 4, 2), //month
substr($time, 6, 2), //day
substr($time, 0, 4) //year
);
}
}
// ------------------------------------------------------------------------
/**
* Unix to "Human"
* Unix的“人”
* Formats Unix timestamp to the following prototype: 2006-08-21 11:35 PM
* Unix时间戳格式的原型如下：2006-08-2111:35 PM
* @access public
* @param integer Unix timestamp
* @param bool whether to show seconds 是否显示秒
* @param string format: us or euro 格式：我们或欧元
* @return string
*/
if ( ! function_exists('unix_to_human'))
{
function unix_to_human($time = '', $seconds = FALSE, $fmt = 'us')
{
//YYYY-MM-DD
$r = date('Y', $time).'-'.date('m', $time).'-'.date('d', $time).' ';
//如果显示时分
//YYY-MM-DD 看是选择12小时时间制，还是24小时间制显示
if ($fmt == 'us')
{
$r .= date('h', $time).':'.date('i', $time);
}
else
{
$r .= date('H', $time).':'.date('i', $time);
}
//是否显示秒数
if ($seconds)
{
$r .= ':'.date('s', $time);
}
//是否显示上午还是下秆AM PM
if ($fmt == 'us')
{
$r .= ' '.date('A', $time);
}
return $r;
}
}
// ------------------------------------------------------------------------
/**
* Convert "human" date to GMT
* 转换“人”的日期为GMT
* Reverses the above process
* 上述过程反转
* @access public
* @param string format: us or euro
* @return integer
*/
if ( ! function_exists('human_to_unix'))
{
function human_to_unix($datestr = '')
{
if ($datestr == '')
{
return FALSE;
}
$datestr = trim($datestr);//去空格
//将\040替换为空格
$datestr = preg_replace("/\040+/", ' ', $datestr);
//YYYY-MM-DD HH:II:SS [AP]M 如果不是这个格式，直接回false
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 FALSE;
}
//以空格分割
$split = explode(' ', $datestr);
//
$ex = explode("-", $split['0']); //元素1为年月日
$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'];
if (isset($ex['2']) && 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';
}
//如果存在AM 或者PM
if (isset($split['2']))
{
//转换为小写
$ampm = strtolower($split['2']);
//如果首字符为p,并且小时大于12点，那么用12+当前小时
if (substr($ampm, 0, 1) == 'p' AND $hour < 12)
$hour = $hour + 12;
//如果为a, 并且小时等于12 那么小时为00
if (substr($ampm, 0, 1) == 'a' AND $hour == 12)
$hour = '00';
//如果小时的长度为1，那以前面拼接一个0
if (strlen($hour) == 1)
$hour = '0'.$hour;
}
return mktime($hour, $min, $sec, $month, $day, $year);
}
}
// ------------------------------------------------------------------------
/**
* Timezone Menu
* 时区菜单
*
* Generates a drop-down menu of timezones.
* 产生一个下拉菜单的时区。
*
* @access public
* @param string timezone
* @param string classname
* @param string menu name
* @return string
*/
if ( ! function_exists('timezone_menu'))
{
function timezone_menu($default = 'UTC', $class = "", $name = 'timezones')
{
$CI =& get_instance();
$CI->lang->load('date');
if ($default == 'GMT')
$default = 'UTC';
$menu = '<select name="'.$name.'"';
if ($class != '')
{
$menu .= ' class="'.$class.'"';
}
$menu .= ">\n";
foreach (timezones() as $key => $val)
{
$selected = ($default == $key) ? " selected='selected'" : '';
$menu .= "<option value='{$key}'{$selected}>".$CI->lang->line($key)."</option>\n";
}
$menu .= "</select>";
return $menu;
}
}
// ------------------------------------------------------------------------
/**
* Timezones
* 时区
*
* Returns an array of timezones. This is a helper function
* for various other ones in this library
* 返回一个数组的时区。这是一个辅助函数这个库中的各种其他的
* @access public
* @param string timezone
* @return string
*/
if ( ! function_exists('timezones'))
{
function timezones($tz = '')
{
// Note: Don't change the order of these even though
// some items appear to be in the wrong order
// 附注信息：请勿更改这些的顺序，即使
// 一些会出现下列选项是在了错误的的的顺序
$zones = 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
);
if ($tz == '')
{
return $zones;
}
if ($tz == 'GMT')
$tz = 'UTC';
return ( ! isset($zones[$tz])) ? 0 : $zones[$tz];
}
}
/* End of file date_helper.php */
/* Location: ./system/helpers/date_helper.php */
