這篇文章主要介紹了PHP strtotime函數用法、實現原理和源碼分析,本文講解了strtotime函數的一些用法、strtotime函數的實現基本原理、strtotime(“-1 month”)求值失敗的原因等內容,需要的朋友可以參考下
源碼位置:extdatephp_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"))), "
";
在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"))), "
";
程序會輸出: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"))), "
";
程序會輸出: 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"))), "
";
first、previous、last和this關鍵字在re文件中屬於同一組。
5、 back和front關鍵字
這兩個關鍵字是對一天中的小時的向前和向後操作,其調用格式如下:
代碼如下:
echo date("Y-m-d H:i:s", strtotime("back of 24", strtotime("2011-02-01"))), "
";
echo date("Y-m-d H:i:s", strtotime("front of 24", strtotime("2011-02-01"))), "
";
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;