个人技术作品 - PHP Array 常用排序及数据高级操作的 API Engine

<?php


/**


* fun.ArrayApi.php


*


* GMT 系列 - 功能库接口 1


*


* 功能库名: 数组操作系列


*


* 功能库内容介绍:


* 1. 格林威治时间快速转时间戳


* 2. usort 自动排序二维数组方法 1


* 1). 对大写字母或数字进行升序排列


* 2). 对大写字母或数字进行降序排列


* 3. usort 自动排序二维数组方法 2


* 1). 对时间进行升/降序排列


* 4. 把数组中带有时间戳的字段,实时修改为格林威治格式


* 5. 把数组中带有格林威治时间的字段,实时修改为时间戳


*


* global $index 为功能 2,3 的公共变量 , 由 $index 来控制 2,3 功能所要操作数组的字段


*


* @example


* 1. int void GmtToUnix(datetime)


* 返回时间戳 , datetime 可自由适配,只支持以 / ,- 为分割年月日的切割符,年月日时分秒可随意缺少增加


*


* 2. void function ORD_ASC / ORD_DESC


* 配合 global $index 及 php 自带函数 usort() 使用,usort()查看php手册


*


* @example:


* $exar = array(0=>array('a','1','A'),1=>array('b','2','B'));


* $index = 1;


* usort($exar,"ORD_ASC"); || usort($exar,"ORD_DESC");


*


* 3. void function DATE_ASC / DATE_DESC


* 配合 global $index 及 php 自带函数 usort() 使用,usort()查看php手册


*


* @example:


* $exar = array(0=>array('2005-08-21 13:21:77','A'),1=>array('2007-12-11 11:21:77','B'));


* $index = 0;


* usort($exar,"DATE_ASC"); || usort($exar,"DATE_DESC");


*


* 4. void array ARY_UTG($index,$arr,$Type = true,$format_string)


* $index 数组字段索引


* $arr 源数组


* $type 数组级别 true 为二维数组(默认),false为一维数组


* $format_string 格林威治时间样式 默认为 "Y-m-d H:i:s"


*


* @example:


* $exar = array(array(1176731096,'c1932'),array(1076731096,'i1932'));


* $exar = ARY_UTG(0,$exar);


* print_r($exar);


*


* 5. void array ARY_GTU($index,$arr,$Type = true)


* $index 数组字段索引


* $arr 源数组


* $type 数组级别 true 为二维数组(默认),false为一维数组


*


* @example:


* $exar = array(array('2003-03-28 22:31:21','f1932'),array('2005-07-18 22:31:21','i1932'));


* $exar = ARY_UTG(0,$exar);


* print_r($exar);


*/






global $Index;




/**


* 把格林威治时间转为时间戳


*/


function GmtToUnix($GmtDate)


{


$DateArr = explode(' ',$GmtDate); // 分割GMT日期为 日期 时间




/* 在日期中取得年,月,日 */


$pDate = split('[/.-]',$DateArr[0]);


$Year = $pDate[0];


$Month = $pDate[1];


$Day = $pDate[2];




/* 在时间中取得时,分,秒 */


$pTime = split('[:.-]',$DateArr[1]);


$Hour = $pTime[0];


$Minute = $pTime[1];


$Second = $pTime[2];




if($Year == '' || !is_numeric($Year))$Year = 0;


if($Month == '' || !is_numeric($Month))$Month = 0;


if($Day == '' || !is_numeric($Day))$Day = 0;


if($Hour == '' || !is_numeric($Hour))$Hour = 0;


if($Minute == '' || !is_numeric($Minute))$Minute = 0;


if($Second == '' || !is_numeric($Second))$Second = 0;




return mktime($Hour,$Minute,$Second,$Month,$Day,$Year);


}




/**


* 对大小写字母和数字进行升序排列


*/


function ORD_ASC($ax,$ay)


{


global $Index;


if($ax[$Index] == $ay[$Index]) {


return 0;


} elseif($ax[$Index] < $ay[$Index]) {


return -1;


} else {


return 1;


}


}




/**


* 对大小写字母和数字进行降序排列


*/


function ORD_DESC($ax,$ay)


{


global $Index;


if($ax[$Index] == $ay[$Index]) {


return 0;


} elseif($ax[$Index] > $ay[$Index]) {


return -1;


} else {


return 1;


}


}




/**


* 对日期字符进行升序排列


*/


function DATE_ASC($ax,$ay)


{


global $Index;


if(GmtToUnix($ax[$Index]) == GmtToUnix($ay[$Index])) {


return 0;


} elseif(GmtToUnix($ax[$Index]) < GmtToUnix($ay[$Index])) {


return -1;


} else {


return 1;


}


}




/**


* 对日期字符进行降序排列


*/


function DATE_DESC($ax,$ay)


{


global $Index;


if(GmtToUnix($ax[$Index]) == GmtToUnix($ay[$Index])) {


return 0;


} elseif(GmtToUnix($ax[$Index]) > GmtToUnix($ay[$Index])) {


return -1;


} else {


return 1;


}


}




/**


* 对数据集数组的时间戳转换为格林威治时间


* $index 需要修改数据的数组字段


* $Type 数组类型,一维为true 二维为false, 最高支持二维,默认二维


* $arr 源数组


* $format_string 将时间戳格式为以为 $format_string 为例的时间样式


* array(array('a1932',1176731096,'c1932'))


*/


function ARY_UTG($index = 0, $arr, $Type = true, $format_string = "Y-m-d H:i:s")


{


reset($arr);


if($Type){


foreach ($arr as $k => $value) {


$arr[$k][$index] = @gmdate($format_string,$arr[$k][$index]);


}


} else {


foreach ($arr as $k => $value) {


$arr[$index] = @gmdate($format_string,$arr[$index]);


}


}


return $arr;


}




/**


* 对数据集数组的格林威治时间转换为时间戳


* $index 需要修改数据的数组字段


* $Type 数组类型,一维为true 二维为false, 最高支持二维,默认二维


* $arr 源数组


* array(array('a1932',1176731096,'c1932'))


*/


function ARY_GTU($index = 0, $arr, $Type = true)


{


reset($arr);


if($Type){


foreach ($arr as $k => $value) {


$arr[$k][$index] = GmtToUnix($arr[$k][$index]);


}


} else {


foreach ($arr as $k => $value) {


$arr[$index] = GmtToUnix($arr[$index]);


}


}


return $arr;


}


?>

具体使用方法，在类内已经有说明，请根据类内介绍进行使用。

此API为了读者能更有效的操作复杂数据及排序有着重要作用。笔者在研究PHP开发中所经常遇到的问题。