PHP4手册:函数库及函数

keaide

--------------------------------------------------------------------------------
函式:strftime()  
--------------------------------------------------------------------------------
  


日期与时间函式库


strftime
将伺服器的时间本地格式化。

语法: string strftime(string format, int [timestamp]);

传回值: 字串

函式种类: 时间日期


  
  
内容说明  


传回值的字串依设定的格式来决定。若有传入时间戳记值，则将时间戳记格式化传回；若无传入时间戳记值，则将目前伺服器的时间本地格式化传回。月份或者星期名称随着本地语系设定 setlocale() 的不同而改变。

传回的字串可以依下列的格式而定：


%a 星期几的缩写。  
%A 星期几的全名。  
%b 月份名称的缩写。  
%B 月份名称的全名。  
%c 本地端日期时间较佳表示字串。  
%d 用数字表示本月的第几天 (范围为 00 至 31)。  
%H 用 24 小时制数字表示小时数 (范围为 00 至 23)。  
%I 用 12 小时制数字表示小时数 (范围为 01 至 12)。  
%j 以数字表示当年度的第几天 (范围为 001 至 366)。  
%m 月份的数字 (范围由 1 至 12)。  
%M 分钟。  
%p 以 'AM' 或 'PM' 表示本地端时间。  
%S 秒数。  
%U 数字表示为本年度的第几周，第一个星期由第一个周日开始。  
%W 数字表示为本年度的第几周，第一个星期由第一个周一开始。  
%w 用数字表示本周的第几天 ( 0 为周日)。  
%x 不含时间的日期表示法。  
%X 不含日期的时间表示法。  
%y 二位数字表示年份 (范围由 00 至 99)。  
%Y 完整的年份数字表示，即四位数。  
%Z 时区或名称缩写。  
%% % 字元。  

  
  
使用范例  


setlocale ("LC_TIME", "C";
print(strftime("%A in Finnish is ");
setlocale ("LC_TIME", "fi";
print(strftime("%A, in French ");
setlocale ("LC_TIME", "fr";
print(strftime("%A and in German ");
setlocale ("LC_TIME", "de";
print(strftime("%A.\n");
?>  

  
  
参考  


setlocale()  mktime()

keaide

--------------------------------------------------------------------------------
函式:getdate()  
--------------------------------------------------------------------------------
  


日期与时间函式库


getdate
获得时间及日期资讯。

语法: array getdate(int timestamp);

传回值: 阵列

函式种类: 时间日期


  
  
内容说明  


传回阵列的元素包括下列的项目：


"seconds" - 秒  
"minutes" - 分  
"hours" - 时  
"mday" - 当月的第几天  
"wday" - 当周的第几天数字  
"mon" - 月份数字  
"year" - 年，数字  
"yday" - 当年的第几天数字; 如: "299"  
"weekday" - 星期几全名; 如: "Friday"  
"month" - 月份全名; 如: "January"  

--------------------------------------------------------------------------------
函式:gettimeofday()  
--------------------------------------------------------------------------------
  


日期与时间函式库


gettimeofday
取得目前时间。

语法: array gettimeofday(void);

传回值: 阵列

函式种类: 时间日期


  
  
内容说明  


传回阵列的元素包括下列的项目：


"sec" - 秒  
"usec" - 百万分之一秒  
"minuteswest" - 格林威治时间的分  
"dsttime" - 目的的时区

keaide

--------------------------------------------------------------------------------
函式:gmdate()  
--------------------------------------------------------------------------------
  


日期与时间函式库


gmdate
取得目前与 GMT 差后的时间。

语法: string gmdate(string format, int timestamp);

传回值: 字串

函式种类: 时间日期


  
  
内容说明  


本函式与 date() 函式相似，不同的是本函式传回与格林威治标准时间 (Greenwich Mean Time, GMT) 时间差后的时间。


  
  
使用范例  


echo date( "M d Y H:i:s",mktime(0,0,0,1,1,1998) );
echo gmdate( "M d Y H:i:s",mktime(0,0,0,1,1,1998) );
?>

若执行本范例的机器在芬兰 (Finland, GMT +0200)，传回的结果为:
Jan 01 1998 00:00:00
Dec 31 1997 22:00:00


  
  
参考  


date()  mktime()  gmmktime()

keaide

--------------------------------------------------------------------------------
函式:easter_date()  
--------------------------------------------------------------------------------
  


日期与时间函式库


easter_date
计算复活节日期。

语法: int easter_date(int [year]);

传回值: 整数

函式种类: 时间日期


  
  
内容说明  


输入某一年份，则以 UNIX 时间戳记的格式传回该年的复活节日期，若没有输入年份，则计算当年的日期。值得注意的是输入的年份必需在西元 1970 至 2037 年之间，否则无法计算。


  
  
使用范例  


echo date("M-d-Y", easter_date(1999));
echo date("M-d-Y", easter_date(2000));
echo date("M-d-Y", easter_date(2001));
?>

传回结果为
Apr-04-1999
Apr-23-2000
Apr-15-2001  


--------------------------------------------------------------------------------
函式:easter_days()  
--------------------------------------------------------------------------------
  


日期与时间函式库


easter_days
计算复活节与三月廿一日之间日期数。

语法: int easter_days(int [year]);

传回值: 整数

函式种类: 时间日期


  
  
内容说明  


输入某一年份，则以计算该年复活节与三月二十一日之间的日期数，若没有输入年份，则以当年计算。这个函式可以用来替代 easter_date() 1970-2037 年外范围无法计算的问题。


  
  
使用范例  


echo easter_days(1999);
echo easter_days(1492);
echo easter_days(1913);
?>

传回结果为:
14 (4/4)
32 (4/22)
2  (3/23)


  
  
参考  


easter_date()

keaide

--------------------------------------------------------------------------------
函式:gmmktime()  
--------------------------------------------------------------------------------
  


日期与时间函式库


gmmktime
取得 UNIX 时间戳记的格林威治时间。

语法: int gmmktime(int hour, int minute, int second, int month, int day, int year);

传回值: 整数

函式种类: 时间日期


  
  
内容说明  


输入一个时间，则传回 UNIX 的格林威治时间戳记的长整数。

--------------------------------------------------------------------------------
函式:time()  
--------------------------------------------------------------------------------
  


日期与时间函式库


time
取得目前时间的 UNIX 时间戳记。

语法: int time(void);

传回值: 整数

函式种类: 时间日期


  
  
内容说明  


传回目前时间的戳记值。


  
  
参考  


date()   


--------------------------------------------------------------------------------
函式:microtime()  
--------------------------------------------------------------------------------
  


日期与时间函式库


microtime
取得目前时间的 UNIX 时间戳记的百万分之一秒值。

语法: string microtime(void);

传回值: 字串

函式种类: 时间日期


  
  
内容说明  


传回目前时间的百万分之一秒戳记值。若作业系统没有提供 gettimeofday() 的系统呼叫函式，则本函式亦无效。


  
  
参考  


time()

keaide

DBA 函式库

--------------------------------------------------------------------------------
DBA 函式库  
--------------------------------------------------------------------------------
  


本函式库共有 12 个函式
在柏克莱的 BSD 系列作业系统中，有个简单的资料库结构，它以数个档案组成超小型的资料库系统，架构成抽象层 (abstraction layer) 的 DBA 资料库。
目前 PHP 支援的 DBA 资料库包括  

dbm：柏克莱发展的最早期 DBA 资料库。  
ndbm：较新且较有弹性的 DBA。  
gdbm：GNU 发展的 DBA，ftp://ftp.gnu.org/pub/gnu/gdbm/  
db2：由 Sleepycat 软体开发的 DB2 (非 IBM 的 DB2)，http://www.sleepycat.com  
cdb：这是 qmail 作者开发快速可靠的 DBA，http://pobox.com/~djb/cdb.html  
以下是简单的使用范例，当然在使用前，必须先装好 DBA。

$id = dba_open("/tmp/test.db", "n", "db2";

if(!$id) {
    echo "dba_open failed\n";
    exit;
}

dba_replace("key", "This is an example!", $id);

if(dba_exists("key", $id)) {
    echo dba_fetch("key", $id);
    dba_delete("key", $id);
}

dba_close($id);
?>

  


dba_close: 关闭资料库。  
dba_delete: 删除指定资料。  
dba_exists: 检查键是否存在。  
dba_fetch: 取回指定资料。  
dba_firstkey: 取回首笔键值。  
dba_insert: 加入资料。  
dba_nextkey: 取回下笔键值。  
dba_popen: 开启并保持资料库连结。  
dba_open: 开启资料库连结。  
dba_optimize: 最佳化资料库。  
dba_replace: 更动或加入资料。  
dba_sync: 资料库同步化。  


--------------------------------------------------------------------------------
函式:dba_close()  
--------------------------------------------------------------------------------
  


DBA 函式库


dba_close
关闭资料库。

语法: void dba_close(int handle);

传回值: 无

函式种类: 资料库功能


  
  
内容说明  


本函式用来将已开启的资料库关闭。参数 handle 为开启资料库时所传回来的代号 ID。


  
  
参考  


dba_popen()  dba_open()

keaide

--------------------------------------------------------------------------------
函式:dba_delete()  
--------------------------------------------------------------------------------
  


DBA 函式库


dba_delete
删除指定资料。

语法: int dba_delete(string key, int handle);

传回值: 整数

函式种类: 资料库功能


  
  
内容说明  


本函式将删除指定的资料。参数 key 为欲删除的键值 (key)。参数 handle 为开启资料库时所传回来的代号 ID。删除成功则传回 true 值。


  
  
参考  


dba_exists()  dba_fetch()  dba_insert()  dba_replace()   



--------------------------------------------------------------------------------
函式:dba_exists()  
--------------------------------------------------------------------------------
  


DBA 函式库


dba_exists
检查键是否存在。

语法: boolean dba_exists(string key, int handle);

传回值: 布林值

函式种类: 资料库功能


  
  
内容说明  


本函式用来检查指定的键是否存在。参数 key 为待检查的键值 (key)。参数 handle 为开启资料库时所传回来的代号 ID。若键存在则传回 true 值。


  
  
参考  


dba_delete()  dba_fetch()  dba_insert()  dba_replace()

keaide

--------------------------------------------------------------------------------
函式:dba_fetch()  
--------------------------------------------------------------------------------
  


DBA 函式库


dba_fetch
取回指定资料。

语法: string dba_fetch(string key, int handle);

传回值: 字串

函式种类: 资料库功能


  
  
内容说明  


本函式取得指定的资料。参数 key 为欲取出资料的键值 (key)。参数 handle 为开启资料库时所传回来的代号 ID。传回值即为资料字串，若取出失败则传回 false。


  
  
参考  


dba_exists()  dba_delete()  dba_insert()  dba_replace()   


--------------------------------------------------------------------------------
函式:dba_firstkey()  
--------------------------------------------------------------------------------
  


DBA 函式库


dba_firstkey
取回首笔键值。

语法: string dba_firstkey(int handle);

传回值: 字串

函式种类: 资料库功能


  
  
内容说明  


本函式取得资料库的第一笔键值 (key)。参数 handle 为开启资料库时所传回来的代号 ID。传回值即为键值，若取出失败则传回 false。


  
  
参考  


dba_nextkey()

keaide

--------------------------------------------------------------------------------
函式:dba_insert()  
--------------------------------------------------------------------------------
  


DBA 函式库


dba_insert
加入资料。

语法: boolean dba_insert(string key, string value, int handle);

传回值: 布林值

函式种类: 资料库功能


  
  
内容说明  


本函式将加入资料至资料库中。参数 key 为键值 (key) 字串。参数 value 为欲加入的资料内容。参数 handle 为开启资料库时所传回来的代号 ID。成功则传回 true 值。


  
  
参考  


dba_exists()  dba_fetch()  dba_delete()  dba_replace()   


--------------------------------------------------------------------------------
函式:dba_nextkey()  
--------------------------------------------------------------------------------
  


DBA 函式库


dba_nextkey
取回下笔键值。

语法: string dba_nextkey(int handle);

传回值: 字串

函式种类: 资料库功能


  
  
内容说明  


本函式取得资料库的下一笔键值 (key)。参数 handle 为开启资料库时所传回来的代号 ID。传回值即为键值，若取出失败则传回 false。


  
  
参考  


dba_firstkey()

keaide

--------------------------------------------------------------------------------
函式:dba_popen()  
--------------------------------------------------------------------------------
  


DBA 函式库


dba_popen
开启并保持资料库连结。

语法: int dba_popen(string path, string mode, string handler);

传回值: 整数

函式种类: 资料库功能


  
  
内容说明  


本函式用来开启指定的资料库，并保持与资料库连线的状态。参数 path 为资料库的路径及资料库名称，例如 "/tmp/mysite/wahaha.db"。参数 mode 值如下表

属性 说明  
r 开启唯读既有资料库  
w 开启可读写既有资料库  
c 开启可读写资料库，若不存在则建立  
n 删去现有资料库，若不存在则建立，之后可读写  


参数 handler 为开启资料库的种类，有 dbm、ndbm、gdbm、db2 或 cdb 等种类。传回值为资料库的代号 ID，若失败则传回 false。


  
  
参考  


dba_close()  dba_open()