CTimestamp

CDbHttpSession

Yii Framework v1.1.10 类参考

CTimestamp

system.utils
继承 class CTimestamp
源自 1.0
版本 $Id: CTimestamp.php 3515 2011-12-28 12:29:24Z mdomba $
源码 framework/utils/CTimestamp.php
CTimestamp represents a timestamp.

Part of this class was adapted from the ADOdb Date Library ADOdb abstraction library. The original source code was released under both BSD and GNU Lesser GPL library license, with the following copyright notice: Copyright (c) 2000, 2001, 2002, 2003, 2004 John Lim All rights reserved.

This class is provided to support UNIX timestamp that is beyond the range of 1901-2038 on Unix and1970-2038 on Windows. Except getTimestamp, all other methods in this class can work with the extended timestamp range. For getTimestamp, because it is merely a wrapper of http://php.net/manual/en/function.mktime.php, it may still be subject to the limit of timestamp range on certain platforms. Please refer to the PHP manual for more information.

公共方法

隐藏继承方法

方法描述定义在
formatDate() Formats a timestamp to a date string. CTimestamp
get4DigitYear() Returns 4-digit representation of the year. CTimestamp
getDate() Returns the getdate() array. CTimestamp
getDayofWeek() Gets day of week, 0 = Sunday,... 6=Saturday. CTimestamp
getGMTDiff() 返回get local time zone offset from GMT CTimestamp
getTimestamp() Generates a timestamp. CTimestamp
isLeapYear() Checks for leap year, returns true if it is. No 2-digit year check. Also CTimestamp
isValidDate() Checks to see if the year, month, day are valid combination. CTimestamp
isValidTime() Checks to see if the hour, minute and second are valid. CTimestamp

受保护方法

隐藏继承方法

方法描述定义在
digitCheck() Fix 2-digit years. Works for any century. CTimestamp

方法详细

digitCheck() 方法
protected static integer digitCheck(integer $y)
$y integer year
{return} integer change two digit year into multiple digits
源码: framework/utils/CTimestamp.php#113 (显示)
protected static function digitCheck($y)
{
    if (
$y 100){
        
$yr = (integer) date("Y");
        
$century = (integer) ($yr /100);

        if (
$yr%100 50) {
            
$c1 $century 1;
            
$c0 $century;
        } else {
            
$c1 $century;
            
$c0 $century 1;
        }
        
$c1 *= 100;
        
// if 2-digit year is less than 30 years in future, set it to this century
        // otherwise if more than 30 years in future, then we set 2-digit year to the prev century.
        
if (($y $c1) < $yr+30$y $y $c1;
        else 
$y $y $c0*100;
    }
    return 
$y;
}

Fix 2-digit years. Works for any century. Assumes that if 2-digit is more than 30 years in future, then previous century.

formatDate() 方法
public static string formatDate(string $fmt, integer|boolean $d=false, boolean $is_gmt=false)
$fmt string format pattern
$d integer|boolean timestamp
$is_gmt boolean whether this is a GMT timestamp
{return} string formatted date based on timestamp $d
源码: framework/utils/CTimestamp.php#217 (显示)
public static function formatDate($fmt,$d=false,$is_gmt=false)
{
    if (
$d === false)
        return (
$is_gmt)? @gmdate($fmt): @date($fmt);

    
// check if number in 32-bit signed range
    
if ((abs($d) <= 0x7FFFFFFF))
    {
        
// if windows, must be +ve integer
        
if ($d >= 0)
            return (
$is_gmt)? @gmdate($fmt,$d): @date($fmt,$d);
    }

    
$_day_power 86400;

    
$arr self::getDate($d,true,$is_gmt);

    
$year $arr['year'];
    
$month $arr['mon'];
    
$day $arr['mday'];
    
$hour $arr['hours'];
    
$min $arr['minutes'];
    
$secs $arr['seconds'];

    
$max strlen($fmt);
    
$dates '';

    
/*
        at this point, we have the following integer vars to manipulate:
        $year, $month, $day, $hour, $min, $secs
    */
    
for ($i=0$i $max$i++)
    {
        switch(
$fmt[$i])
        {
        case 
'T'$dates .= date('T');break;
        
// YEAR
        
case 'L'$dates .= $arr['leap'] ? '1' '0'; break;
        case 
'r'// Thu, 21 Dec 2000 16:01:07 +0200

            // 4.3.11 uses '04 Jun 2004'
            // 4.3.8 uses  ' 4 Jun 2004'
            
$dates .= gmdate('D',$_day_power*(3+self::getDayOfWeek($year,$month,$day))).', '
                
. ($day<10?'0'.$day:$day) . ' '.date('M',mktime(0,0,0,$month,2,1971)).' '.$year.' ';

            if (
$hour 10$dates .= '0'.$hour; else $dates .= $hour;

            if (
$min 10$dates .= ':0'.$min; else $dates .= ':'.$min;

            if (
$secs 10$dates .= ':0'.$secs; else $dates .= ':'.$secs;

            
$gmt self::getGMTDiff();
            
$dates .= sprintf(' %s%04d',($gmt<=0)?'+':'-',abs($gmt)/36);
            break;

        case 
'Y'$dates .= $year; break;
        case 
'y'$dates .= substr($year,strlen($year)-2,2); break;
        
// MONTH
        
case 'm': if ($month<10$dates .= '0'.$month; else $dates .= $month; break;
        case 
'Q'$dates .= ($month+3)>>2; break;
        case 
'n'$dates .= $month; break;
        case 
'M'$dates .= date('M',mktime(0,0,0,$month,2,1971)); break;
        case 
'F'$dates .= date('F',mktime(0,0,0,$month,2,1971)); break;
        
// DAY
        
case 't'$dates .= $arr['ndays']; break;
        case 
'z'$dates .= $arr['yday']; break;
        case 
'w'$dates .= self::getDayOfWeek($year,$month,$day); break;
        case 
'l'$dates .= gmdate('l',$_day_power*(3+self::getDayOfWeek($year,$month,$day))); break;
        case 
'D'$dates .= gmdate('D',$_day_power*(3+self::getDayOfWeek($year,$month,$day))); break;
        case 
'j'$dates .= $day; break;
        case 
'd': if ($day<10$dates .= '0'.$day; else $dates .= $day; break;
        case 
'S':
            
$d10 $day 10;
            if (
$d10 == 1$dates .= 'st';
            else if (
$d10 == && $day != 12$dates .= 'nd';
            else if (
$d10 == 3$dates .= 'rd';
            else 
$dates .= 'th';
            break;

        
// HOUR
        
case 'Z':
            
$dates .= ($is_gmt) ? : -self::getGMTDiff(); break;
        case 
'O':
            
$gmt = ($is_gmt) ? self::getGMTDiff();

            
$dates .= sprintf('%s%04d',($gmt<=0)?'+':'-',abs($gmt)/36);
            break;

        case 
'H':
            if (
$hour 10$dates .= '0'.$hour;
            else 
$dates .= $hour;
            break;
        case 
'h':
            if (
$hour 12$hh $hour 12;
            else {
                if (
$hour == 0$hh '12';
                else 
$hh $hour;
            }

            if (
$hh 10$dates .= '0'.$hh;
            else 
$dates .= $hh;
            break;

        case 
'G':
            
$dates .= $hour;
            break;

        case 
'g':
            if (
$hour 12$hh $hour 12;
            else {
                if (
$hour == 0$hh '12';
                else 
$hh $hour;
            }
            
$dates .= $hh;
            break;
        
// MINUTES
        
case 'i': if ($min 10$dates .= '0'.$min; else $dates .= $min; break;
        
// SECONDS
        
case 'U'$dates .= $d; break;
        case 
's': if ($secs 10$dates .= '0'.$secs; else $dates .= $secs; break;
        
// AM/PM
        // Note 00:00 to 11:59 is AM, while 12:00 to 23:59 is PM
        
case 'a':
            if (
$hour>=12$dates .= 'pm';
            else 
$dates .= 'am';
            break;
        case 
'A':
            if (
$hour>=12$dates .= 'PM';
            else 
$dates .= 'AM';
            break;
        default:
            
$dates .= $fmt[$i]; break;
        
// ESCAPE
        
case "\\":
            
$i++;
            if (
$i $max$dates .= $fmt[$i];
            break;
        }
    }
    return 
$dates;
}

Formats a timestamp to a date string.

get4DigitYear() 方法
public static integer get4DigitYear(integer $y)
$y integer year
{return} integer 4-digit representation of the year
源码: framework/utils/CTimestamp.php#140 (显示)
public static function get4DigitYear($y)
{
    return 
self::digitCheck($y);
}

Returns 4-digit representation of the year.

getDate() 方法
public static array getDate(integer|boolean $d=false, boolean $fast=false, boolean $gmt=false)
$d integer|boolean original date timestamp. False to use the current timestamp.
$fast boolean false to compute the day of the week, default is true
$gmt boolean true to calculate the GMT dates
{return} array an array with date info.
源码: framework/utils/CTimestamp.php#164 (显示)
public static function getDate($d=false,$fast=false,$gmt=false)
{
    if(
$d===false)
        
$d=time();
    if(
$gmt)
    {
        
$tz date_default_timezone_get();
        
date_default_timezone_set('GMT');
        
$result getdate($d);
        
date_default_timezone_set($tz);
    }
    else
    {
        
$result getdate($d);
    }
    return 
$result;
}

Returns the getdate() array.

getDayofWeek() 方法
public static integer getDayofWeek(integer $year, integer $month, integer $day)
$year integer year
$month integer month
$day integer day
{return} integer day of week
源码: framework/utils/CTimestamp.php#44 (显示)
public static function getDayofWeek($year$month$day)
{
    
/*
    Pope Gregory removed 10 days - October 5 to October 14 - from the year 1582 and
    proclaimed that from that time onwards 3 days would be dropped from the calendar
    every 400 years.

    Thursday, October 4, 1582 (Julian) was followed immediately by Friday, October 15, 1582 (Gregorian).
    */
    
if ($year <= 1582)
    {
        if (
$year 1582 ||
            (
$year == 1582 && ($month 10 || ($month == 10 && $day 15))))
        {
            
$greg_correction 3;
        }
        else
        {
            
$greg_correction 0;
        }
    }
    else
    {
        
$greg_correction 0;
    }

    if(
$month 2)
        
$month -= 2;
    else
    {
        
$month += 10;
        
$year--;
    }

    
$day =  floor((13 $month 1) / 5) +
            
$day + ($year 100) +
            
floor(($year 100) / 4) +
            
floor(($year 100) / 4) - *
            
floor($year 100) + 77 $greg_correction;

    return 
$day floor($day 7);
}

Gets day of week, 0 = Sunday,... 6=Saturday. Algorithm from PEAR::Date_Calc

getGMTDiff() 方法
public static integer getGMTDiff()
{return} integer get local time zone offset from GMT
源码: framework/utils/CTimestamp.php#148 (显示)
public static function getGMTDiff()
{
    static 
$TZ;
    if (isset(
$TZ)) return $TZ;

    
$TZ mktime(0,0,0,1,2,1970) - gmmktime(0,0,0,1,2,1970);
    return 
$TZ;
}

getTimestamp() 方法
public static integer|float getTimestamp(integer $hr, integer $min, integer $sec, integer|boolean $mon=false, integer|boolean $day=false, integer|boolean $year=false, boolean $is_gmt=false)
$hr integer hour
$min integer minute
$sec integer second
$mon integer|boolean month
$day integer|boolean day
$year integer|boolean year
$is_gmt boolean whether this is GMT time. If true, gmmktime() will be used.
{return} integer|float a timestamp given a local time.
源码: framework/utils/CTimestamp.php#371 (显示)
public static function getTimestamp($hr,$min,$sec,$mon=false,$day=false,$year=false,$is_gmt=false)
{
    if (
$mon === false)
        return 
$is_gmt? @gmmktime($hr,$min,$sec): @mktime($hr,$min,$sec);
    return 
$is_gmt ? @gmmktime($hr,$min,$sec,$mon,$day,$year) : @mktime($hr,$min,$sec,$mon,$day,$year);
}

Generates a timestamp. This is the same as the PHP function http://php.net/manual/en/function.mktime.php.

isLeapYear() 方法
public static boolean isLeapYear(integer $year)
$year integer year to check
{return} boolean true if is leap year
源码: framework/utils/CTimestamp.php#93 (显示)
public static function isLeapYear($year)
{
    
$year self::digitCheck($year);
    if (
$year != 0)
        return 
false;

    if (
$year 400 == 0)
        return 
true;
    
// if gregorian calendar (>1582), century not-divisible by 400 is not leap
    
else if ($year 1582 && $year 100 == )
        return 
false;
    return 
true;
}

Checks for leap year, returns true if it is. No 2-digit year check. Also handles julian calendar correctly.

isValidDate() 方法
public static boolean isValidDate(integer $y, integer $m, integer $d)
$y integer year
$m integer month
$d integer day
{return} boolean true if valid date, semantic check only.
源码: framework/utils/CTimestamp.php#189 (显示)
public static function isValidDate($y,$m,$d)
{
    return 
checkdate($m$d$y);
}

Checks to see if the year, month, day are valid combination.

isValidTime() 方法
public static boolean isValidTime(integer $h, integer $m, integer $s, boolean $hs24=true)
$h integer hour
$m integer minute
$s integer second
$hs24 boolean whether the hours should be 0 through 23 (default) or 1 through 12.
{return} boolean true if valid date, semantic check only.
源码: framework/utils/CTimestamp.php#202 (显示)
public static function isValidTime($h,$m,$s,$hs24=true)
{
    if(
$hs24 && ($h || $h 23) || !$hs24 && ($h || $h 12)) return false;
    if(
$m 59 || $m 0) return false;
    if(
$s 59 || $s 0) return false;
    return 
true;
}

Checks to see if the hour, minute and second are valid.

Copyright © 2008-2011 by Yii Software LLC
All Rights Reserved.