mirror of
https://github.com/PHPOffice/PhpSpreadsheet.git
synced 2026-11-09 11:26:17 +00:00
oleibman
9565757138
A follow-on activity to PR #5061. That PR added scrollbars to the dropdown lists when samples were run in a browser. Earlier changes had broken up a number of categories into multiple entries because the dropdown lists were too long and wound up truncated. With the scrollbars, it makes sense to re-consolidate many of those lists, such as ComplexNumbers, which are all essentially the same test as each other. Some break-ups are retained (e.g. Basic/1/2/3/4/5) because they differ substantially from sample to sample; that's kind of an arbitrary decision, but it will have to do for now. I also renamed some of the members so that like members sort together when listing the directory (e.g. all pivot table samples now start with `pvt`). The sample code is mostly unchanged; only the directory and/or member names are changed. The download samples were moved to their own new directory, and now represent a complete set of all the write formats that we permit. Studying their code, an improvement for `Helper\Downloader` became evident. It had been used merely to copy an existing file to be downloaded. However, by changing the first parameter of `download` to be either the name of the file directory (the existing usage) *or* a `Writer` object poised to issue `save`, you can use it to download your spreadsheet without having to worry about the headers which the browser requires. It then becomes generally useful beyond being used in samples: ```php $writer = new WriterType($spreadsheet); $downloader = new Downloader($writer, 'suggestedFileName.xlsx'); $downloader->download(); ```
51 lines
1.5 KiB
PHP
51 lines
1.5 KiB
PHP
<?php
|
|
|
|
use PhpOffice\PhpSpreadsheet\Spreadsheet;
|
|
|
|
require __DIR__ . '/../Header.php';
|
|
/** @var PhpOffice\PhpSpreadsheet\Helper\Sample $helper */
|
|
$category = 'Date/Time';
|
|
$functionName = 'YEAR';
|
|
$description = 'Returns the year of a date, an integer ranging from 1900 to 9999';
|
|
|
|
$helper->titles($category, $functionName, $description);
|
|
|
|
// Create new PhpSpreadsheet object
|
|
$spreadsheet = new Spreadsheet();
|
|
$worksheet = $spreadsheet->getActiveSheet();
|
|
|
|
// Add some data
|
|
$testDates = [
|
|
[1900, 1, 1],
|
|
[1904, 2, 14],
|
|
[1936, 3, 17],
|
|
[1964, 4, 29],
|
|
[1999, 5, 18],
|
|
[2000, 6, 21],
|
|
[2019, 7, 4],
|
|
[2020, 8, 31],
|
|
[1956, 9, 10],
|
|
[2010, 10, 10],
|
|
[1982, 11, 30],
|
|
[1960, 12, 19],
|
|
['=YEAR(TODAY())', '=MONTH(TODAY())', '=DAY(TODAY())'],
|
|
];
|
|
$testDateCount = count($testDates);
|
|
|
|
$worksheet->fromArray($testDates, null, 'A1', true);
|
|
|
|
for ($row = 1; $row <= $testDateCount; ++$row) {
|
|
$worksheet->setCellValue('D' . $row, '=DATE(A' . $row . ',B' . $row . ',C' . $row . ')');
|
|
$worksheet->setCellValue('E' . $row, '=D' . $row);
|
|
$worksheet->setCellValue('F' . $row, '=YEAR(D' . $row . ')');
|
|
}
|
|
$worksheet->getStyle('E1:E' . $testDateCount)
|
|
->getNumberFormat()
|
|
->setFormatCode('yyyy-mm-dd');
|
|
|
|
// Test the formulae
|
|
for ($row = 1; $row <= $testDateCount; ++$row) {
|
|
$helper->log(sprintf('(E%d): %s', $row, $worksheet->getCell('E' . $row)->getFormattedValue()));
|
|
$helper->log('Year is: ' . $worksheet->getCell('F' . $row)->getCalculatedValueString());
|
|
}
|