PHP strtotime函数用法、实现原理和源码分析


Posted in PHP onFebruary 04, 2015

源码位置:\ext\date\php_date.c

/* {{{ proto int strtotime(string time [, int now ])

   Convert string representation of date and time to a timestamp */

PHP_FUNCTION(strtotime)

{

    char *times, *initial_ts;

    int   time_len, error1, error2;

    struct timelib_error_container *error;

    long  preset_ts = 0, ts;
    timelib_time *t, *now;

    timelib_tzinfo *tzi;
    tzi = get_timezone_info(TSRMLS_C);
    if (zend_parse_parameters_ex(ZEND_PARSE_PARAMS_QUIET, ZEND_NUM_ARGS() TSRMLS_CC, “sl”, ×, &time_len, &preset_ts) != FAILURE) {

        /* We have an initial timestamp */

        now = timelib_time_ctor();
        initial_ts = emalloc(25);

        snprintf(initial_ts, 24, “@%ld UTC”, preset_ts);

        t = timelib_strtotime(initial_ts, strlen(initial_ts), NULL, DATE_TIMEZONEDB, php_date_parse_tzfile_wrapper); /* we ignore the error here, as this should never fail */

        timelib_update_ts(t, tzi);

        now->tz_info = tzi;

        now->zone_type = TIMELIB_ZONETYPE_ID;

        timelib_unixtime2local(now, t->sse);

        timelib_time_dtor(t);

        efree(initial_ts);

    } else if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, “s|l”, ×, &time_len, &preset_ts) != FAILURE) {

        /* We have no initial timestamp */

        now = timelib_time_ctor();

        now->tz_info = tzi;

        now->zone_type = TIMELIB_ZONETYPE_ID;

        timelib_unixtime2local(now, (timelib_sll) time(NULL));

    } else {

        RETURN_FALSE;

    }
    if (!time_len) {

        timelib_time_dtor(now);    

        RETURN_FALSE;

    }
    t = timelib_strtotime(times, time_len, &error, DATE_TIMEZONEDB, php_date_parse_tzfile_wrapper);

    error1 = error->error_count;

    timelib_error_container_dtor(error);

    timelib_fill_holes(t, now, TIMELIB_NO_CLONE);

    timelib_update_ts(t, tzi);

    ts = timelib_date_to_int(t, &error2);
    timelib_time_dtor(now);

    timelib_time_dtor(t);
    if (error1 || error2) {

        RETURN_FALSE;

    } else {

        RETURN_LONG(ts);

    }

}

/* }}} */

strtotime函数在使用strtotime(“-1 month”)求上一个月的今天时会出一些状况,

因此也引出写这篇文章,本文包括如下内容:

1).strtotime函数的一些用法
2).strtotime函数的实现基本原理
3).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;

s->time->relative.d = -1;所表示的意思是当前时间的相对天数是-1。 这只是中间词法解析的中间结果,但是最后结果是通过这些中间结果计算出来的。

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号,程序会自动将日期计算到下一个月。
PHP 相关文章推荐
PHP mail 通过Windows的SMTP发送邮件失败的解决方案
May 27 PHP
PHP与C#分别格式化文件大小的代码
May 14 PHP
PHP+MySQL投票系统的设计和实现分享
Sep 23 PHP
php中serialize序列化与json性能测试的示例分析
Apr 27 PHP
深入php多态的实现详解
Jun 09 PHP
百度地图经纬度转换到腾讯地图/Google 对应的经纬度
Aug 28 PHP
WordPress中限制非管理员用户在文章后只能评论一次
Dec 31 PHP
PHP 将数组打乱 shuffle函数的用法及简单实例
Jun 17 PHP
PHP+mysql+ajax轻量级聊天室实现方法详解
Oct 17 PHP
解决出现SoapFault (looks like we got no XML document)的问题
Jun 24 PHP
php使用QueryList轻松采集js动态渲染页面方法
Sep 11 PHP
YII2框架中使用RBAC对模块,控制器,方法的权限控制及规则的使用示例
Mar 18 PHP
php curl登陆qq后获取用户信息时证书错误
Feb 03 #PHP
ecshop实现smtp发送邮件
Feb 03 #PHP
PHP中使用php://input处理相同name值的表单数据
Feb 03 #PHP
PHP中实现接收多个name相同但Value不相同表单数据实例
Feb 03 #PHP
四种php中webservice实现的简单架构方法及实例
Feb 03 #PHP
php上传中文文件名乱码问题处理方案
Feb 03 #PHP
php上传文件常见问题总结
Feb 03 #PHP
You might like
php 中include()与require()的对比
2006/10/09 PHP
linux使用crontab实现PHP执行计划定时任务
2014/05/10 PHP
PHP针对多用户实现更换头像功能
2016/09/04 PHP
WordPress JQuery处理沙发头像
2009/06/22 Javascript
查询绑定数据岛的表格中的文本并修改显示方式的js代码
2009/12/15 Javascript
javascript页面渲染速度测试脚本分享
2014/04/15 Javascript
javascript结合fileReader 实现上传图片
2015/01/30 Javascript
Spring mvc 接收json对象
2015/12/10 Javascript
Javascript json object 与string 相互转换的简单实现
2016/09/27 Javascript
微信小程序 video组件详解
2016/10/25 Javascript
AngularJS自定义插件实现网站用户引导功能示例
2016/11/07 Javascript
jQuery实现花式轮播之圣诞节礼物传送效果
2016/12/25 Javascript
JavaScript 通过Ajax 动态加载CheckBox复选框
2017/08/31 Javascript
JS 实现缓存算法的示例(FIFO/LRU)
2018/03/20 Javascript
小程序实现多个选项卡切换
2020/06/19 Javascript
微信小程序swiper组件实现抖音翻页切换视频功能的实例代码
2020/06/24 Javascript
vue 在methods中调用mounted的实现操作
2020/08/07 Javascript
react+antd 递归实现树状目录操作
2020/11/02 Javascript
Vue 事件的$event参数=事件的值案例
2021/01/29 Vue.js
深入源码解析Python中的对象与类型
2015/12/11 Python
python机器学习理论与实战(五)支持向量机
2018/01/19 Python
Django 根据数据模型models创建数据表的实例
2018/05/27 Python
对pandas将dataframe中某列按照条件赋值的实例讲解
2018/11/29 Python
pycharm 取消默认的右击运行unittest的方法
2018/11/29 Python
Python-ElasticSearch搜索查询的讲解
2019/02/25 Python
numpy库reshape用法详解
2020/04/19 Python
Python实现简单的猜单词小游戏
2020/10/28 Python
python实现图片转字符画的完整代码
2021/02/21 Python
汉米尔顿手表官网:Hamilton
2020/09/13 全球购物
最新教师自我评价分享
2013/11/12 职场文书
工程部经理岗位职责
2013/12/08 职场文书
拾金不昧表扬信范文
2014/01/11 职场文书
新颖的化妆品活动方案
2014/08/21 职场文书
2015年学校食堂工作总结
2015/04/22 职场文书
小学运动会通讯稿
2015/07/18 职场文书
Win11 vmware不兼容怎么办?Win11与VMware虚拟机不兼容的解决方法
2023/01/09 数码科技