PHPExcel RangeToArray - 导出日期格式数据

在使用 PHPExcel 时，很多情况下需要将 Excel 中的数据导出为数组，其中包含了日期格式数据。在这种情况下，我们可以使用 PHPExcel 的 RangeToArray 方法。本文将详细讲解如何使用 PHPExcel 的 RangeToArray 方法来导出日期格式数据。

准备工作

在开始使用 RangeToArray 方法前，我们需要确保已经安装了 PHPExcel 扩展，并且已经创建了 Excel 文件的实例。我们可以使用以下代码来创建一个简单的 Excel 文件实例：

<?php

require_once 'path/to/PHPExcel.php';

// 创建 Excel 文件实例
$objPHPExcel = new PHPExcel();

// 设置 Excel 文件属性
$objPHPExcel->getProperties()->setTitle("Demo");
$objPHPExcel->getDefaultStyle()->getFont()->setName("Arial")->setSize(10);

// 添加数据到 Excel 文件
$objPHPExcel->setActiveSheetIndex(0);
$objPHPExcel->getActiveSheet()->setTitle('Sheet1');
$objPHPExcel->getActiveSheet()->setCellValue('A1', '日期');
$objPHPExcel->getActiveSheet()->setCellValue('B1', '数字');
$objPHPExcel->getActiveSheet()->setCellValue('A2', '2021-01-01');
$objPHPExcel->getActiveSheet()->setCellValue('B2', '123');

// 文件格式设置
header('Content-Type: application/vnd.ms-excel');
header('Content-Disposition: attachment;filename="demo.xls"');
header('Cache-Control: max-age=0');

// 输出 Excel 文件
$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel5');
$objWriter->save('php://output');

?>

运行以上代码，将得到一个包含日期格式数据的 Excel 文件实例。

RangeToArray 方法

PHPExcel 中的 RangeToArray 方法可以将 Excel 中指定的单元格区域转化成数组格式。该方法的基本语法如下：

public function rangeToArray (
    $pRange = null,
    $nullValue = null,
    $calculateFormulas = true,
    $formatData = false,
    $returnCellRef = false
)

RangeToArray 方法参数说明：

• $pRange：需要转化为数组格式的单元格区域，格式如 A1:B2。
• $nullValue：当单元格中的值为 null 时，将会被替换成该参数指定的值。
• $calculateFormulas：是否计算公式。
• $formatData：是否格式化数据。
• $returnCellRef：是否返回单元格引用。

导出日期格式数据

使用以上的 RangeToArray 方法，配合 PHP 中的 date 函数，可以非常方便的导出 Excel 中的日期格式数据。以下是具体实现：

<?php

require_once 'path/to/PHPExcel.php';

// 创建 Excel 文件实例
$objPHPExcel = PHPExcel_IOFactory::load('path/to/demo.xls');

// 获取 Excel 中指定区域的数据
$sheet = $objPHPExcel->getActiveSheet();
$data = $sheet->rangeToArray('A2:B2');

// 处理日期格式数据
foreach ($data as &$row) {
    $row[0] = date('Y-m-d', PHPExcel_Shared_Date::ExcelToPHP($row[0]));
}

// 输出处理后的数据
print_r($data);

?>

运行上述代码，将输出以下结果：

Array
(
    [0] => Array
        (
            [0] => 2021-01-01
            [1] => 123
        )
)

以上代码中，我们首先使用 PHPExcel_IOFactory 类的 load 方法，从已有的 Excel 文件中获取数据。接着，使用 rangeToArray 方法，将指定的单元格区域转化成数组格式。由于日期格式数据需要进行处理，我们遍历数组，使用 PHP 中的 date 函数将 Excel 中的日期格式转换成 Y-m-d 格式。最终输出处理后的数据。

总结

利用 PHPExcel 提供的 RangeToArray 方法，我们可以很方便的将 Excel 中的数据导出为数组格式。当 Excel 中包含日期格式数据时，我们可以使用 PHP 自带的 date 函数和 PHPExcel 提供的 ExcelToPHP 方法，对日期格式数据进行处理。