php 深入理解strtotime函数的使用详解

时间:2022-05-07 00:58:18

在前面的<如何使用PHP计算上一个月的今天>一文中, 我们提到strtotime函数在使用strtotime(”-1 month”)求上一个月的今天时会出一些状况,
因此也引出写这篇文章,本文包括如下内容:
•strtotime函数的一些用法
•strtotime函数的实现基本原理
•strtotime(”-1 month”)求值失败的原因

strtotime函数的一些用法
1、 strtotime(”JAN”)和strtotime(”January”)
这两个用法的效果是一样的,都是返回指定月份的今天,如果指定月份没有今天,则顺延到下一个月。 如在2011-03-31计算二月,代码:

复制代码 代码如下:


echo date("Y-m-d H:i:s", strtotime("feb", strtotime("2011-03-31")));


程序会输出: 2011-03-03 00:00:00。 从表象来看,这个结果也许不一定是我们想要的,但是这也算是一种解决方案,这种方案是由什么决定的呢? strtotime函数在执行月份的计算时只计算了月份,相当于直接将月份设置为指定的月份的值,而如jan,january都会有一个对应内部数值。
2、 first关键字
first是一个辅助型的关键字,它可以与星期,天等可以指定确认值的关键字组合使用,如求2011年的第一个星期天:

复制代码 代码如下:


echo date("Y-m-d H:i:s", strtotime("second sunday", strtotime("2011-01-01"))), "<br />"; 


在PHP的源码中,对于first与星期和天的组合使用是分开的,即first day对应一个处理操作, 在最终的C实现中,天的值指定为1,即time结构中的d字段指定为1,如下代码:

复制代码 代码如下:


switch (time->relative.first_last_day_of) { 
         case 1: /* first */ 
             time->d = 1; 
             break; 
         case 2: /* last */ 
             time->d = 0; 
             time->m++; 
             break; 
     }


3、previous和next关键字
与first类似,previous关键字可以与星期,天组合使用,表示指定时间的前一个星期几或前一天。如下所示代码:

复制代码 代码如下:


echo date("Y-m-d H:i:s", strtotime("previous sunday", strtotime("2011-02-01"))), "<br />"; 


程序会输出:2011-01-30 00:00:00
程序求2011-02-01的前一个星期天。
next关键字与previous相反,它表示下一个星期几或后一天。
4、 last关键字
last关键字既可以作为上一个,也可以作为最后一个。如求上一个星期天的日期:

复制代码 代码如下:


echo date("Y-m-d H:i:s", strtotime("last sunday", strtotime("2011-02-05"))), "<br />"; 


程序会输出: 2011-01-30 00:00:00
当程序作为最后时,其应用场景是指定日期所在月的最后一天,相当于date(”t”)的结果。如求2000年2月的最后一天:

复制代码 代码如下:


echo date("Y-m-d H:i:s", strtotime("last day", strtotime("2000-02-01"))), "<br />"; 


first、previous、last和this关键字在re文件中属于同一组。
5、 back和front关键字
这两个关键字是对一天中的小时的向前和向后操作,其调用格式如下:

复制代码 代码如下:


echo date("Y-m-d H:i:s", strtotime("back of 24", strtotime("2011-02-01"))), "<br />"; 
echo date("Y-m-d H:i:s", strtotime("front of 24", strtotime("2011-02-01"))), "<br />"; 


•back表示将时间设置指定小时值的后一个小时的15分的位置。如果是24点,则算到第二天的0点15分。
•front表示将时间设置指定小时值的前一个小时的45分的位置。如果是0点,则算前一天的23点45分。
上面的代码输出:2011-02-02 00:15:00 2011-02-01 23:45:00。 其中back of和front of后接的数组必须大于等于0并且小于等于24。
strtotime函数的实现基本原理
官方文档对于strtotime函数的说明是这样的:本函数预期接受一个包含美国英语日期格 式的字符串并尝试将其解析为 Unix 时间戳 (自 January 1 1970 00:00:00 GMT 起的秒数),其值相对于 now 参数给出的时间,如果没有提供此参数则用系统当前时间。
这是一个标准PHP内置函数,从PHP4起就已经存在。strtotime函数是以一个扩展的方式加载进来的,在ext/date目录下有其全部实现。 作为一个标准的内置函数,其定义格式也是标准的,如下:

复制代码 代码如下:


PHP_FUNCTION(strtotime) 
//  处理输入,对于是否有第二个参数有没的处理 
 //  调用相关函数,实现字符串的解析和结果计算 
//  返回结果 


在输入处理中,先识别两个参数都存在的情况并进行处理,如果不是此种状态,则处理第二个参数不存在的情况, 如果都没有,则报错,返回FALSE。
strtotime函数的第一个参数是一个字符串,对于这个字符串,由于其复杂性,PHP使用了其词法解析一样的工具:re2c 。 在/ext/date/lib目录下,从parse_date.re文件我们可以看到其原始的re文件。 当用户以参数的形式传入一个字符串,此字符串将交给此程序处理,针对其字符串的不同,匹配不同的处理函数。 如strtotime(”yesterday”)调用,分析字符串时,将匹配yesterday字符串,此字符串对应函数如下:

复制代码 代码如下:


'yesterday' 
     { 
         DEBUG_OUTPUT("yesterday"); 
         TIMELIB_INIT; 
         TIMELIB_HAVE_RELATIVE(); 
         TIMELIB_UNHAVE_TIME(); 
         s->time->relative.d = -1; 
         TIMELIB_DEINIT; 
         return TIMELIB_RELATIVE; 
     }


这里有几个关键的结构体:

复制代码 代码如下:


typedef struct Scanner { 
         int           fd; 
         uchar        *lim, *str, *ptr, *cur, *tok, *pos; 
         unsigned int  line, len; 
         struct timelib_error_container *errors; 
         struct timelib_time *time; 
         const timelib_tzdb  *tzdb; 
     } Scanner; 
     typedef struct timelib_time { 
         timelib_sll      y, m, d;     /* Year, Month, Day */ 
         timelib_sll      h, i, s;     /* Hour, mInute, Second */ 
         double           f;           /* Fraction */ 
         int              z;           /* GMT offset in minutes */ 
         char            *tz_abbr;     /* Timezone abbreviation (display only) */ 
         timelib_tzinfo  *tz_info;     /* Timezone structure */ 
         signed int       dst;         /* Flag if we were parsing a DST zone */ 
         timelib_rel_time relative; 
         timelib_sll      sse;         /* Seconds since epoch */ 
         unsigned int   have_time, have_date, have_zone, have_relative, have_weeknr_day; 
         unsigned int   sse_uptodate; /* !0 if the sse member is up to date with the date/time members */ 
         unsigned int   tim_uptodate; /* !0 if the date/time members are up to date with the sse member */ 
         unsigned int   is_localtime; /*  1 if the current struct represents localtime, 0 if it is in GMT */ 
         unsigned int   zone_type;    /*  1 time offset,
                                       *  3 TimeZone identifier,
                                       *  2 TimeZone abbreviation */ 
     } timelib_time; 
     typedef struct timelib_rel_time { 
         timelib_sll y, m, d; /* Years, Months and Days */ 
         timelib_sll h, i, s; /* Hours, mInutes and Seconds */ 
         int weekday; /* Stores the day in 'next monday' */ 
         int weekday_behavior; /* 0: the current day should *not* be counted when advancing forwards; 1: the current day *should* be counted */ 
         int first_last_day_of; 
         int invert; /* Whether the difference should be inverted */ 
         timelib_sll days; /* Contains the number of *days*, instead of Y-M-D differences */ 
         timelib_special  special; 
         unsigned int   have_weekday_relative, have_special_relative; 
     } timelib_rel_time;


strtotime(”-1 month”)求值失败的原因
虽然strtotime(”-1 month”)这种方法对于后一个月比前一个月的天数的情况会求值失败,但是从其本质上来说,这并没有错。 PHP这样实现也无可厚非。只是我们的需求决定了我们不能使用这种方法,因此我们称其为求值失败。
我们来看它的实现过程,由于没有第二个参数,所以程序使用默认的当前时间。 第一个参数传入的是-1 month字符串,这个字符串所对应的re文件中的正则为:

复制代码 代码如下:


reltextunit = (('sec'|'second'|'min'|'minute'|'hour'|'day'|'fortnight'|'forthnight'|'month'|'year') 's'?) | 'weeks' | daytext; 
relnumber = ([+-]*[ /t]*[0-9]+); 
relative = relnumber space? (reltextunit | 'week' ); 


最终relative会对应一系列操作,程序会识别出前面的-1 和后面的month字符串,month对应一种操作类型:TIMELIB_MONTH 。 在此之后,根据识别出来的数字和操作类型执行操作,如下代码:

复制代码 代码如下:


case TIMELIB_MONTH:  s->time->relative.m += amount * relunit->multiplier; break; 


如上代码,则是直接记录月份的相对值减一。 但是对于类似于3月31号这样的情况,2月没有31号,程序会自动将日期计算到下一个月。