phpspreadsheet 中文文檔（三） 計算引擎

2019年10月11日13:59:52

使用PhpSpreadsheet計算引擎

執行公式計算

因爲PhpSpreadsheet表示內存中的電子表格，所以它還提供公式計算功能。單元格能夠是值類型（包含數字或文本），也能夠是公式類型（包含能夠求值的公式）。例如，該公式=SUM(A1:A10) 計算得出A1，A2，...，A10中的值之和。

要計算公式，能夠調用包含公式方法的單元格getCalculatedValue()，例如：

$spreadsheet->getActiveSheet()->getCell('E11')->getCalculatedValue(); 

若是您在PhpSpreadsheet隨附的發票演示中編寫了如下代碼行，則其評估值爲「 64」：

PhpSpreadsheet公式解析器的另外一個不錯的功能是，它能夠在插入/刪除行/列時自動調整公式。這是一個例子：

您會看到單元格E11中包含的公式是「 SUM（E4：E9）」。如今，當我編寫如下代碼行時，添加了兩個新的產品線：

$spreadsheet->getActiveSheet()->insertNewRowBefore(7, 2); 

你注意到了嗎？之前的單元格E11中的公式（當我插入2個新行時爲E13）更改成「 SUM（E4：E11）」。一樣，插入的單元格將複製前一個單元格的樣式信息，就像Excel的行爲同樣。請注意，您能夠插入行和列。

計算緩存

一旦計算引擎評估了單元格中的公式後，結果將被緩存，所以，若是您getCalculatedValue()再次調用同一單元格，則結果將從緩存中返回，而不是第二次評估公式。這有助於提升性能，由於就性能和速度而言，評估公式是一項昂貴的操做。

可是，有時您可能不但願這樣，也許您已經更改了基礎數據，而且須要使用該新數據從新評估相同的公式。

Calculation::getInstance($spreadsheet)->disableCalculationCache(); 

將禁用計算緩存，並刷新當前計算緩存。

若是您只想刷新緩存，則能夠調用

Calculation::getInstance($spreadsheet)->clearCalculationCache(); 

已知限制

PhpSpreadsheet計算引擎有一些已知的限制。它們中的大多數是因爲在執行以前將Excel公式轉換爲PHP代碼的事實。這意味着Excel公式的計算取決於PHP的語言特性。

Xls不支持的功能

並不是全部功能都受支持，要獲取完整列表，請按名稱閱讀 功能列表。

運算符優先級

在Excel中+賽過&，就像在普通代數中*賽過同樣+。前一條規則不是使用PhpSpreadsheet附帶的計算引擎所能找到的。

• Excel參考
• PHP參考

涉及數字和文字的公式

包含數字和文本的公式可能會產生意外的結果，甚至致使文件內容沒法讀取。例如，=3+"Hello "指望該公式在Excel中產生錯誤（#VALUE！）。因爲PHP轉換"Hello "爲數值（零）的事實，該公式的結果被評估爲3，而不是錯誤。這還會致使Excel文檔被生成爲包含不可讀的內容。

• PHP中此行爲的參考

公式彷佛不是在Excel2003中使用兼容包計算的？

這是兼容包的正常行爲，Xlsx正確顯示了這一點。使用\PhpOffice\PhpSpreadsheet\Writer\Xls若是你真的須要計算的值，或強制從新計算Excel2003中中。

處理日期和時間值

返回日期和時間值的Excel函數

在Excel中返回日期值的任何Date and Time函數均可以返回Excel時間戳或PHP時間戳或DateTime對象。

腳本能夠經過調用\PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType() 方法來更改用於返回日期值的數據類型 ：

\PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType($returnDateType); 

如下常量可用於$returnDateType：

• \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_PHP_NUMERIC
• \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_PHP_OBJECT
• \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_EXCEL

該方法將在成功時返回布爾值True，在失敗時返回False（例如，若是爲返回日期類型傳遞了無效值）。

該\PhpOffice\PhpSpreadsheet\Calculation\Functions::getReturnDateType() 方法可用於肯定此設置的當前值：

$returnDateType = \PhpOffice\PhpSpreadsheet\Calculation\Functions::getReturnDateType(); 

默認值爲RETURNDATE_PHP_NUMERIC。

PHP時間戳

若是RETURNDATE_PHP_NUMERIC爲Return Date Type設置了返回值，則經過對Excel中的Date和Time函數的任何訪問返回到調用腳本的任何日期值將是一個整數值，表示距PHP / Unix基礎日期的秒數。PHP / Unix的基準日期（0）在1970年1月1日爲美國標準時間00:00。該值能夠是正數或負數：所以-3600的值將是1969年12月31日的23:00。而1970年1月1日的+3600值爲01:00。這使PHP的日期範圍爲1901年12月14日至2038年1月19日。

PHP DateTime對象

若是將Return Date Type設置爲RETURNDATE_PHP_OBJECT，則經過對Excel中的Date和Time函數的任何訪問返回到調用腳本的任何日期值將是一個PHP DateTime對象。

Excel時間戳

若是RETURNDATE_EXCEL爲Return Date Type設置了返回值，則經過對Excel中的Date和Time函數的任何訪問返回的日期值將是一個浮點值，表明距Excel基本日期的天數。Excel的基本日期由Excel使用的日曆決定：Windows 1900或Mac 1904日曆。1900年1月1日是Windows 1900日曆的基準日期，而1904年1月1日是Mac 1904日曆的基準日期。

腳本能夠經過調用如下\PhpOffice\PhpSpreadsheet\Shared\Date::setExcelCalendar()方法來更改用於計算Excel日期值的日曆 ：

\PhpOffice\PhpSpreadsheet\Shared\Date::setExcelCalendar($baseDate); 

如下常量可用於$baseDate：

• \PhpOffice\PhpSpreadsheet\Shared\Date::CALENDAR_WINDOWS_1900
• \PhpOffice\PhpSpreadsheet\Shared\Date::CALENDAR_MAC_1904

該方法將在成功時返回布爾值True，在失敗時返回False（例如，若是傳入了無效值）。

該\PhpOffice\PhpSpreadsheet\Shared\Date::getExcelCalendar()方法可用於肯定此設置的當前值：

$baseDate = \PhpOffice\PhpSpreadsheet\Shared\Date::getExcelCalendar(); 

默認值爲CALENDAR_WINDOWS_1900。

返回日期/時間值的函數

• 日期
• DATEVALUE
• EDATE
• EOMONTH
• 如今
• 時間
• 時間值
• 今天

接受日期和時間值做爲參數的Excel函數

做爲參數傳遞給函數的日期值能夠是Excel時間戳或PHP時間戳；或DateTime對象；或包含日期值的字符串（例如「 2009年1月1日」）。PhpSpreadsheet將嘗試根據PHP數據類型識別其類型：

整數將被視爲PHP / Unix時間戳。實數值（浮點數）將被視爲Excel日期/時間戳。任何PHP DateTime對象都將被視爲DateTime 對象。任何字符串值（甚至包含直接數字數據的字符串值）都將轉換爲DateTime用於驗證的對象做爲基於服務器區域設置的日期值，所以，若是服務器設置爲英國，則經過模棱兩可的值'07 / 08/2008'將被視爲2008年8月7日，而若是服務器爲UK，則將其視爲2008年7月8日設置爲美國。可是，若是您傳遞的值（例如「 31/12/2008」）被位於美國的服務器視爲錯誤，但並不明確，則PhpSpreadsheet會嘗試將其更正爲2008年12月31日。字符串的內容與php DateTime對象實現所識別的任何格式都不匹配strtotime()（能夠處理比常規strtotime()函數更普遍的格式），而後該函數將返回#VALUE錯誤。可是，Excel建議您始終對日期函數使用日期/時間戳，對PhpSpreadsheet的建議也相同：避免字符串，由於結果不可預測。

將數據寫入Excel時，將應用相同的原理。包含日期實際值（而不是返回日期值的Excel函數）的單元格始終被寫入Excel日期，並在必要時進行轉換。若是格式化爲日期的單元格包含整數或 DateTime對象值，則將其轉換爲Excel值以進行寫入：若是格式化爲日期的單元格包含實數值，則無需進行轉換。請注意，字符串值被寫爲字符串，而不是轉換爲Excel日期時間戳值。

須要日期/時間值的函數

• 達蒂夫
• 天
• DAYS360
• EDATE
• EOMONTH
• 小時
• 分鐘
• 月
• 網絡日
• 第二
• 平日
• WEEKNUM
• 工做日
• 年
• 年分會

輔助方法

除了setExcelCalendar()和getExcelCalendar()方法，\PhpOffice\PhpSpreadsheet\Shared\Date該類中還有許多其餘方法 能夠幫助處理日期：

\ PhpOffice \ PhpSpreadsheet \ Shared \ Date :: excelToTimestamp（$ excelDate）

從Excel日期時間戳轉換日期/時間以返回PHP序列化的日期/時間戳。

請注意，此方法不會捕獲超出PHP日期時間戳有效範圍的Excel日期。

\ PhpOffice \ PhpSpreadsheet \ Shared \ Date :: excelToDateTimeObject（$ excelDate）

將日期轉換爲Excel日期/時間戳以返回PHP DateTime 對象。

\ PhpOffice \ PhpSpreadsheet \ Shared \ Date :: PHPToExcel（$ PHPDate）

轉換PHP序列化的日期/時間戳或PHP DateTime對象以返回Excel日期時間戳。

\ PhpOffice \ PhpSpreadsheet \ Shared \ Date :: formattedPHPToExcel（$ year，$ month，$ day，$ hours = 0，$ minutes = 0，$ seconds = 0）

接受年，月和日值（以及可選的時，分和秒值），並返回Excel日期時間戳值。

時區支持Excel日期時間戳轉換

PhpSpreadsheet中日期函數的默認時區爲UST（通用標準時間）。若是須要使用其餘時區，則可使用如下方法：

\ PhpOffice \ PhpSpreadsheet \ Shared \ Date :: getDefaultTimezone（）

返回PhpSpeadsheet用於處理日期和時間的當前時區值。

\ PhpOffice \ PhpSpreadsheet \ Shared \ Date :: setDefaultTimezone（$ timeZone）

將Excel日期時間戳轉換的時區設置爲$ timeZone，該值必須是有效的PHP DateTimeZone值。返回值是一個布爾值，其中true是成功，false是失敗（例如，傳遞了無效的DateTimeZone值。）

\ PhpOffice \ PhpSpreadsheet \ Shared \ Date :: excelToDateTimeObject（$ excelDate，$ timeZone）

\ PhpOffice \ PhpSpreadsheet \ Shared \ Date :: excelToTimeStamp（$ excelDate，$ timeZone）

這些函數支持將時區做爲可選的第二個參數。這會將特定時區應用於該函數調用，而不會影響默認的PhpSpreadsheet時區。

功能參考

數據庫功能

降級

DAVERAGE函數返回列表或數據庫中符合您指定條件的列中單元格的平均值。

句法

DAVERAGE (database, field, criteria) 

參量

數據庫組成列表或數據庫的單元格範圍。

數據庫是相關數據的列表，其中相關信息的行是記錄，數據的列是字段。列表的第一行包含每一列的標籤。

字段指示函數中使用數據庫的哪一列。

輸入列標籤爲字符串（用雙引號引發來），例如「 Age」或「 Yield」，或者輸入表明列在列表中位置的數字（不帶引號）：1爲第一列，2用於第二列，依此類推。

條件包含您指定條件的單元格範圍。

您能夠對criteria參數使用任何範圍，只要它包含至少一個列標籤和在列標籤下方的至少一個單元格（您在其中爲該列指定條件）便可。

返回值

float匹配單元格的平均值。

這是統計平均值。

例子

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=DAVERAGE(A4:E10,"Yield",A1:B2)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 12 

筆記

此功能沒有其餘註釋

DCOUNT

DCOUNT函數返回指定列表或數據庫中符合條件的列中包含數字的單元格計數。

句法

DCOUNT(database, [field], criteria) 

參量

數據庫組成列表或數據庫的單元格範圍。

數據庫是相關數據的列表，其中相關信息的行是記錄，數據的列是字段。列表的第一行包含每一列的標籤。

字段指示函數中使用數據庫的哪一列。

輸入列標籤爲字符串（用雙引號引發來），例如「 Age」或「 Yield」，或者輸入表明列在列表中位置的數字（不帶引號）：1爲第一列，2用於第二列，依此類推。

條件包含您指定條件的單元格範圍。

您能夠對criteria參數使用任何範圍，只要它包含至少一個列標籤和在列標籤下方的至少一個單元格（您在其中爲該列指定條件）便可。

返回值

float匹配單元格的計數。

例子

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=DCOUNT(A4:E10,"Height",A1:B3)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 3 

筆記

在MS Excel中，field參數是可選的。若是省略該字段，則DCOUNT將對數據庫中符合條件的全部記錄進行計數。PhpSpreadsheet中還沒有實現此邏輯。

DCOUNTA

DCOUNT函數返回列表或數據庫的列中不爲空且匹配您指定條件的單元格計數。

句法

DCOUNTA(database, [field], criteria) 

參量

數據庫組成列表或數據庫的單元格範圍。

數據庫是相關數據的列表，其中相關信息的行是記錄，數據的列是字段。列表的第一行包含每一列的標籤。

字段指示函數中使用數據庫的哪一列。

輸入列標籤爲字符串（用雙引號引發來），例如「 Age」或「 Yield」，或者輸入表明列在列表中位置的數字（不帶引號）：1爲第一列，2用於第二列，依此類推。

條件包含您指定條件的單元格範圍。

您能夠對criteria參數使用任何範圍，只要它包含至少一個列標籤和在列標籤下方的至少一個單元格（您在其中爲該列指定條件）便可。

返回值

float匹配單元格的計數。

例子

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=DCOUNTA(A4:E10,"Yield",A1:A3)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 5 

筆記

在MS Excel中，field參數是可選的。若是省略該字段，則DCOUNTA將對數據庫中符合條件的全部記錄進行計數。PhpSpreadsheet中還沒有實現此邏輯。

DGET

DGET函數從與您指定的條件匹配的列表或數據庫的列中提取單個值。

句法

DGET(database, field, criteria) 

參量

數據庫組成列表或數據庫的單元格範圍。

數據庫是相關數據的列表，其中相關信息的行是記錄，數據的列是字段。列表的第一行包含每一列的標籤。

字段指示函數中使用數據庫的哪一列。

輸入列標籤爲字符串（用雙引號引發來），例如「 Age」或「 Yield」，或者輸入表明列在列表中位置的數字（不帶引號）：1爲第一列，2用於第二列，依此類推。

條件包含您指定條件的單元格範圍。

您能夠對criteria參數使用任何範圍，只要它包含至少一個列標籤和在列標籤下方的至少一個單元格（您在其中爲該列指定條件）便可。

返回值

混合從匹配行的選定列中選擇的值。

例子

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=GET(A4:E10,"Age",A1:F2)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 14 

筆記

此功能沒有其餘註釋

DMAX

DMAX函數返回列表或數據庫中符合您指定條件的列中的最大數字。

句法

DMAX(database, field, criteria) 

參量

數據庫組成列表或數據庫的單元格範圍。

數據庫是相關數據的列表，其中相關信息的行是記錄，數據的列是字段。列表的第一行包含每一列的標籤。

字段指示函數中使用數據庫的哪一列。

輸入列標籤爲字符串（用雙引號引發來），例如「 Age」或「 Yield」，或者輸入表明列在列表中位置的數字（不帶引號）：1爲第一列，2用於第二列，依此類推。

條件包含您指定條件的單元格範圍。

您能夠對criteria參數使用任何範圍，只要它包含至少一個列標籤和在列標籤下方的至少一個單元格（您在其中爲該列指定條件）便可。

返回值

float匹配單元格的最大值。

例子

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=DMAX(A4:E10,"Profit",A1:B2)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 105 

筆記

此功能沒有其餘註釋

DMIN

DMIN函數返回與指定條件匹配的列表或數據庫的列中的最小數字。

句法

DMIN(database, field, criteria) 

參量

數據庫組成列表或數據庫的單元格範圍。

數據庫是相關數據的列表，其中相關信息的行是記錄，數據的列是字段。列表的第一行包含每一列的標籤。

字段指示函數中使用數據庫的哪一列。

輸入列標籤爲字符串（用雙引號引發來），例如「 Age」或「 Yield」，或者輸入表明列在列表中位置的數字（不帶引號）：1爲第一列，2用於第二列，依此類推。

條件包含您指定條件的單元格範圍。

您能夠對criteria參數使用任何範圍，只要它包含至少一個列標籤和在列標籤下方的至少一個單元格（您在其中爲該列指定條件）便可。

返回值

float匹配單元格的最小值。

例子

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=DMIN(A4:E10,"Yield",A1:A3)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 6 

筆記

此功能沒有其餘註釋

D產品

DPRODUCT函數將匹配您指定條件的列表或數據庫的列中的值相乘。

句法

DPRODUCT(database, field, criteria) 

參量

數據庫組成列表或數據庫的單元格範圍。

數據庫是相關數據的列表，其中相關信息的行是記錄，數據的列是字段。列表的第一行包含每一列的標籤。

字段指示函數中使用數據庫的哪一列。

輸入列標籤爲字符串（用雙引號引發來），例如「 Age」或「 Yield」，或者輸入表明列在列表中位置的數字（不帶引號）：1爲第一列，2用於第二列，依此類推。

條件包含您指定條件的單元格範圍。

您能夠對criteria參數使用任何範圍，只要它包含至少一個列標籤和在列標籤下方的至少一個單元格（您在其中爲該列指定條件）便可。

返回值

float匹配單元格的乘積。

例子

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=DPRODUCT(A4:E10,"Yield",A1:B2)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 140 

筆記

此功能沒有其餘註釋

DSTDEV

The DSTDEV function estimates the standard deviation of a population based on a sample by using the numbers in a column of a list or database that match conditions that you specify.

Syntax

DSTDEV(database, field, criteria) 

Parameters

database The range of cells that makes up the list or database.

A database is a list of related data in which rows of related information are records, and columns of data are fields. The first row of the list contains labels for each column.

field Indicates which column of the database is used in the function.

Enter the column label as a string (enclosed between double quotation marks), such as "Age" or "Yield," or as a number (without quotation marks) that represents the position of the column within the list: 1 for the first column, 2 for the second column, and so on.

criteria The range of cells that contains the conditions you specify.

You can use any range for the criteria argument, as long as it includes at least one column label and at least one cell below the column label in which you specify a condition for the column.

Return Value

float The estimated standard deviation of the matching cells.

Examples

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=DSTDEV(A4:E10,"Yield",A1:A3)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 2.97 

Notes

There are no additional notes on this function

DSTDEVP

The DSTDEVP function calculates the standard deviation of a population based on the entire population by using the numbers in a column of a list or database that match conditions that you specify.

Syntax

DSTDEVP(database, field, criteria) 

Parameters

database The range of cells that makes up the list or database.

A database is a list of related data in which rows of related information are records, and columns of data are fields. The first row of the list contains labels for each column.

field Indicates which column of the database is used in the function.

Enter the column label as a string (enclosed between double quotation marks), such as "Age" or "Yield," or as a number (without quotation marks) that represents the position of the column within the list: 1 for the first column, 2 for the second column, and so on.

criteria The range of cells that contains the conditions you specify.

You can use any range for the criteria argument, as long as it includes at least one column label and at least one cell below the column label in which you specify a condition for the column.

Return Value

float The estimated standard deviation of the matching cells.

Examples

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=DSTDEVP(A4:E10,"Yield",A1:A3)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 2.65 

Notes

There are no additional notes on this function

DSUM

The DSUM function adds the numbers in a column of a list or database that matches conditions you specify.

Syntax

DSUM(database, field, criteria) 

Parameters

database The range of cells that makes up the list or database.

A database is a list of related data in which rows of related information are records, and columns of data are fields. The first row of the list contains labels for each column.

field Indicates which column of the database is used in the function.

Enter the column label as a string (enclosed between double quotation marks), such as "Age" or "Yield," or as a number (without quotation marks) that represents the position of the column within the list: 1 for the first column, 2 for the second column, and so on.

criteria The range of cells that contains the conditions you specify.

You can use any range for the criteria argument, as long as it includes at least one column label and at least one cell below the column label in which you specify a condition for the column.

Return Value

float The total value of the matching cells.

Examples

$database = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit' ], [ 'Apple', 18, 20, 14, 105.00 ], [ 'Pear', 12, 12, 10, 96.00 ], [ 'Cherry', 13, 14, 9, 105.00 ], [ 'Apple', 14, 15, 10, 75.00 ], [ 'Pear', 9, 8, 8, 76.80 ], [ 'Apple', 8, 9, 6, 45.00 ], ]; $criteria = [ [ 'Tree', 'Height', 'Age', 'Yield', 'Profit', 'Height' ], [ '="=Apple"', '>10', NULL, NULL, NULL, '<16' ], [ '="=Pear"', NULL, NULL, NULL, NULL, NULL ], ]; $worksheet->fromArray( $criteria, NULL, 'A1' ) ->fromArray( $database, NULL, 'A4' ); $worksheet->setCellValue('A12', '=DMIN(A4:E10,"Profit",A1:A2)'); $retVal = $worksheet->getCell('A12')->getCalculatedValue(); // $retVal = 225 

Notes

There are no additional notes on this function

DVAR

Not yet documented.

DVARP

Not yet documented.

Date and Time Functions

Excel provides a number of functions for the manipulation of dates and times, and calculations based on date/time values. it is worth spending some time reading the section titled "Date and Time Values" on passing date parameters and returning date values to understand how PhpSpreadsheet reconciles the differences between dates and times in Excel and in PHP.

DATE

The DATE function returns an Excel timestamp or a PHP timestamp or DateTime object representing the date that is referenced by the parameters.

Syntax

DATE(year, month, day) 

Parameters

year The year number.

If this value is between 0 (zero) and 1899 inclusive (for the Windows 1900 calendar), or between 4 and 1903 inclusive (for the Mac 1904), then PhpSpreadsheet adds it to the Calendar base year, so a value of 108 will interpret the year as 2008 when using the Windows 1900 calendar, or 2012 when using the Mac 1904 calendar.

month The month number.

If this value is greater than 12, the DATE function adds that number of months to the first month in the year specified. For example, DATE(2008,14,2) returns a value representing February 2, 2009.

If the value of month is less than 1, then that value will be adjusted by -1, and that will then be subtracted from the first month of the year specified. For example, DATE(2008,0,2) returns a value representing December 2, 2007; while DATE(2008,-1,2) returns a value representing November 2, 2007.

day The day number.

If this value is greater than the number of days in the month (and year) specified, the DATE function adds that number of days to the first day in the month. For example, DATE(2008,1,35) returns a value representing February 4, 2008.

If the value of day is less than 1, then that value will be adjusted by -1, and that will then be subtracted from the first month of the year specified. For example, DATE(2008,3,0) returns a value representing February 29, 2008; while DATE(2008,3,-2) returns a value representing February 27, 2008.

Return Value

mixed A date/time stamp that corresponds to the given date.

This could be a PHP timestamp value (integer), a PHP DateTime object, or an Excel timestamp value (real), depending on the value of \PhpOffice\PhpSpreadsheet\Calculation\Functions::getReturnDateType().

Examples

$worksheet->setCellValue('A1', 'Year') ->setCellValue('A2', 'Month') ->setCellValue('A3', 'Day'); $worksheet->setCellValue('B1', 2008) ->setCellValue('B2', 12) ->setCellValue('B3', 31); $worksheet->setCellValue('D1', '=DATE(B1,B2,B3)'); $retVal = $worksheet->getCell('D1')->getCalculatedValue(); // $retVal = 1230681600 

// We're going to be calling the same cell calculation multiple times, // and expecting different return values, so disable calculation cacheing \PhpOffice\PhpSpreadsheet\Calculation\Calculation::getInstance()->setCalculationCacheEnabled(FALSE); $saveFormat = \PhpOffice\PhpSpreadsheet\Calculation\Functions::getReturnDateType(); \PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType( \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_EXCEL ); $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATE'], [2008, 12, 31] ); // $retVal = 39813.0 \PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType( \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_PHP_NUMERIC ); $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATE'], [2008, 12, 31] ); // $retVal = 1230681600 \PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType($saveFormat); 

Notes

There are no additional notes on this function

DATEDIF

The DATEDIF function computes the difference between two dates in a variety of different intervals, such number of years, months, or days.

Syntax

DATEDIF(date1, date2 [, unit]) 

Parameters

date1 First Date.

Excel日期值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期。

date2第二個日期。

Excel日期值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期。

單位用於計算的間隔類型

這是一個字符串，包含下面列出的值之一：

單元	含義	描述
米	月數	在日期之間完成日曆月。
d	天	日期之間的天數。
ÿ	年份	在日期之間完成日曆年。
ym	不包括月份的月份	在日期之間完成日曆月，就好像它們是同一年同樣。
碼	不含年份的天數	在日期之間完成日曆日，就好像它們是同一年同樣。
md	不包括年月的天數	完成日期之間的日曆日，就好像它們是同一月和同一年。

單位值不區分大小寫，默認爲d。

返回值

整數反映兩個日期之間差別的整數值。

這能夠是兩個日期之間的完成天數，月數或年數，具體取決於傳遞給函數的間隔單位值做爲第三個參數。

例子

$worksheet->setCellValue('A1', 'Year') ->setCellValue('A2', 'Month') ->setCellValue('A3', 'Day'); $worksheet->setCellValue('B1', 2001) ->setCellValue('C1', 2009) ->setCellValue('B2', 7) ->setCellValue('C2', 12) ->setCellValue('B3', 1) ->setCellValue('C3', 31); $worksheet->setCellValue('D1', '=DATEDIF(DATE(B1,B2,B3),DATE(C1,C2,C3),"d")') ->setCellValue('D2', '=DATEDIF(DATE(B1,B2,B3),DATE(C1,C2,C3),"m")') ->setCellValue('D3', '=DATEDIF(DATE(B1,B2,B3),DATE(C1,C2,C3),"y")') ->setCellValue('D4', '=DATEDIF(DATE(B1,B2,B3),DATE(C1,C2,C3),"ym")') ->setCellValue('D5', '=DATEDIF(DATE(B1,B2,B3),DATE(C1,C2,C3),"yd")') ->setCellValue('D6', '=DATEDIF(DATE(B1,B2,B3),DATE(C1,C2,C3),"md")'); $retVal = $worksheet->getCell('D1')->getCalculatedValue(); // $retVal = 3105 $retVal = $worksheet->getCell('D2')->getCalculatedValue(); // $retVal = 101 $retVal = $worksheet->getCell('D3')->getCalculatedValue(); // $retVal = 8 $retVal = $worksheet->getCell('D4')->getCalculatedValue(); // $retVal = 5 $retVal = $worksheet->getCell('D5')->getCalculatedValue(); // $retVal = 183 $retVal = $worksheet->getCell('D6')->getCalculatedValue(); // $retVal = 30 

$date1 = 1193317015; // PHP timestamp for 25-Oct-2007 $date2 = 1449579415; // PHP timestamp for 8-Dec-2015 $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATEDIF'], [$date1, $date2, 'd'] ); // $retVal = 2966 $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATEDIF'], [$date1, $date2, 'm'] ); // $retVal = 97 $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATEDIF'], [$date1, $date2, 'y'] ); // $retVal = 8 $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATEDIF'], [$date1, $date2, 'ym'] ); // $retVal = 1 $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATEDIF'], [$date1, $date2, 'yd'] ); // $retVal = 44 $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATEDIF'], [$date1, $date2, 'md'] ); // $retVal = 13 

筆記

若是Date1晚於Date2，則DATEDIF將返回#NUM！錯誤。

DATEVALUE

DATEVALUE函數返回由格式爲文本字符串的日期表示的日期。使用DATEVALUE將文本表示的日期轉換爲序列號。

句法

DATEVALUE(dateString) 

參量

date日期字符串。

字符串，表示日期值。

返回值

混合對應於給定日期的日期/時間戳。

根據的值，它能夠是PHP時間戳記值（整數），PHP DateTime對象或Excel時間戳記值（實數） \PhpOffice\PhpSpreadsheet\Calculation\Functions::getReturnDateType()。

例子

$worksheet->setCellValue('A1', 'Date String'); ->setCellValue('A2', '31-Dec-2008') ->setCellValue('A3', '31/12/2008') ->setCellValue('A4', '12-31-2008'); $worksheet->setCellValue('B2', '=DATEVALUE(A2)') ->setCellValue('B3', '=DATEVALUE(A3)') ->setCellValue('B4', '=DATEVALUE(A4)'); \PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType( \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_EXCEL ); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); $retVal = $worksheet->getCell('B3')->getCalculatedValue(); $retVal = $worksheet->getCell('B4')->getCalculatedValue(); // $retVal = 39813.0 for all cases 

// We're going to be calling the same cell calculation multiple times, // and expecting different return values, so disable calculation cacheing \PhpOffice\PhpSpreadsheet\Calculation\Calculation::getInstance()->setCalculationCacheEnabled(FALSE); $saveFormat = \PhpOffice\PhpSpreadsheet\Calculation\Functions::getReturnDateType(); \PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType( \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_EXCEL ); $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATEVALUE'], ['31-Dec-2008'] ); // $retVal = 39813.0 \PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType( \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_PHP_NUMERIC ); $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DATEVALUE'], ['31-Dec-2008'] ); // $retVal = 1230681600 \PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType($saveFormat); 

筆記

DATEVALUE使用的php DateTime對象實現strtotime() （能夠處理比常規strtotime() 函數更普遍的格式），而且當參數值是字符串時，也能夠爲傳遞給其餘日期函數（例如DATEDIF）的任何date參數調用它。

警告： -PhpSpreadsheet比MS Excel接受更普遍的日期格式，所以Excel徹底有可能返回#VALUE！傳遞了沒法解釋的日期字符串時出錯，而PhpSpreadsheet能夠將同一字符串轉換爲正確的日期值。

寫入Xls或Xlsx時，在計算中使用字符串格式日期的工做簿中應格外當心。

天

DAY函數返回日期。日期以1到31之間的整數形式給出。

句法

DAY(datetime) 

參量

datetime日期。

Excel日期值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期。

返回值

整數反映月份的整數值。

整數形式，取值範圍是1〜31。

例子

$worksheet->setCellValue('A1', 'Date String') ->setCellValue('A2', '31-Dec-2008') ->setCellValue('A3', '14-Feb-2008'); $worksheet->setCellValue('B2', '=DAY(A2)') ->setCellValue('B3', '=DAY(A3)'); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); // $retVal = 31 $retVal = $worksheet->getCell('B3')->getCalculatedValue(); // $retVal = 14 

$retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DAYOFMONTH'], ['25-Dec-2008'] ); // $retVal = 25 

筆記

請注意，PhpSpreadsheet函數是 \PhpOffice\PhpSpreadsheet\Calculation\Functions::DAYOFMONTH()靜態調用該方法時。

DAYS360

DAYS360函數根據某些會計系統使用的360天年（每一個12個相等的期間，每一個30天）來計算兩個日期之間的差額。

句法

DAYS360(date1, date2 [, method]) 

參量

date1第一個日期。

Excel日期值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期。

date2第二個日期。

Excel日期值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期。

方法布爾標誌（TRUE或FALSE）

這是一個標誌，用於根據如下列出的值肯定要在計算中使用的方法：

方法	描述
假	U.S. (NASD) method. If the starting date is the last day of a month, it becomes equal to the 30th of the same month. If the ending date is the last day of a month and the starting date is earlier than the 30th of a month, the ending date becomes equal to the 1st of the next month; otherwise the ending date becomes equal to the 30th of the same month.
TRUE	European method. Starting dates and ending dates that occur on the 31st of a month become equal to the 30th of the same month.

The method value defaults to FALSE.

Return Value

integer An integer value that reflects the difference between the two dates.

This is the number of full days between the two dates, based on a 360 day year.

Examples

$worksheet->setCellValue('B1', 'Start Date') ->setCellValue('C1', 'End Date') ->setCellValue('A2', 'Year') ->setCellValue('A3', 'Month') ->setCellValue('A4', 'Day'); $worksheet->setCellValue('B2', 2003) ->setCellValue('B3', 2) ->setCellValue('B4', 3); $worksheet->setCellValue('C2', 2007) ->setCellValue('C3', 5) ->setCellValue('C4', 31); $worksheet->setCellValue('E2', '=DAYS360(DATE(B2,B3,B4),DATE(C2,C3,C4))') ->setCellValue('E4', '=DAYS360(DATE(B2,B3,B4),DATE(C2,C3,C4),FALSE)'); $retVal = $worksheet->getCell('E2')->getCalculatedValue(); // $retVal = 1558 $retVal = $worksheet->getCell('E4')->getCalculatedValue(); // $retVal = 1557 

$date1 = 37655.0; // Excel timestamp for 25-Oct-2007 $date2 = 39233.0; // Excel timestamp for 8-Dec-2015 $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DAYS360'], [$date1, $date2] ); // $retVal = 1558 $retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'DAYS360'], [$date1, $date2, TRUE] ); // $retVal = 1557 

Notes

警告：-當第三個（可選）參數使用PHP布爾值時（如上例所示），此功能當前不適用於Xls Writer，而且該編寫器將生成並出錯。若是方法參數使用數字0或1，它將起做用。或者，若是改用Excel TRUE()和FALSE()函數。

EDATE

EDATE函數返回DateTime 表明日期的Excel時間戳或PHP時間戳或對象，該日期是在指定日期（start_date）以前或以後的月份數。使用EDATE來計算到期日或到期日，該到期日或到期日與發行日期在當月的同一天。

句法

EDATE(baseDate, months) 

參量

baseDate開始日期。

Excel日期值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期。

月要添加的月數。

一個整數值，指示baseDate以前或以後的月數。幾個月的正值表示未來的日期；負值表示過去的日期。

返回值

混合的日期/時間戳，與基礎+月相對應。

根據的值，它能夠是PHP時間戳記值（整數），PHP DateTime對象或Excel時間戳記值（實數） \PhpOffice\PhpSpreadsheet\Calculation\Functions::getReturnDateType()。

例子

$worksheet->setCellValue('A1', 'Date String') ->setCellValue('A2', '1-Jan-2008') ->setCellValue('A3', '29-Feb-2008'); $worksheet->setCellValue('B2', '=EDATE(A2,5)') ->setCellValue('B3', '=EDATE(A3,-12)'); \PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType( \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_EXCEL ); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); // $retVal = 39600.0 (1-Jun-2008) $retVal = $worksheet->getCell('B3')->getCalculatedValue(); // $retVal = 39141.0 (28-Feb-2007) 

\PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType(
    \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_EXCEL
);

$retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'EDATE'], ['31-Oct-2008', 25] ); // $retVal = 40512.0 (30-Nov-2010) 

筆記

警告： -Xls Writer當前不支持此功能，由於它不是Excel 5中的標準功能，而是Analysis ToolPak的外接程序。

EOMONTH

The EOMONTH function returns an Excel timestamp or a PHP timestamp or DateTime object representing the date of the last day of the month that is the indicated number of months before or after a specified date (the start_date). Use EOMONTH to calculate maturity dates or due dates that fall on the last day of the month.

Syntax

EOMONTH(baseDate, months) 

Parameters

baseDate Start Date.

An Excel date value, PHP date timestamp, PHP DateTime object, or a date represented as a string.

months Number of months to add.

An integer value indicating the number of months before or after baseDate. A positive value for months yields a future date; a negative value yields a past date.

Return Value

mixed A date/time stamp that corresponds to the last day of basedate + months.

根據的值，它能夠是PHP時間戳記值（整數），PHP DateTime對象或Excel時間戳記值（實數） \PhpOffice\PhpSpreadsheet\Calculation\Functions::getReturnDateType()。

例子

$worksheet->setCellValue('A1', 'Date String') ->setCellValue('A2', '1-Jan-2000') ->setCellValue('A3', '14-Feb-2009'); $worksheet->setCellValue('B2', '=EOMONTH(A2,5)') ->setCellValue('B3', '=EOMONTH(A3,-12)'); \PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType(\PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_EXCEL); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); // $retVal = 39629.0 (30-Jun-2008) $retVal = $worksheet->getCell('B3')->getCalculatedValue(); // $retVal = 39507.0 (29-Feb-2008) 

\PhpOffice\PhpSpreadsheet\Calculation\Functions::setReturnDateType(
    \PhpOffice\PhpSpreadsheet\Calculation\Functions::RETURNDATE_EXCEL
);

$retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'EOMONTH'], ['31-Oct-2008', 13] ); // $retVal = 40147.0 (30-Nov-2010) 

筆記

警告： -Xls Writer當前不支持此功能，由於它不是Excel 5中的標準功能，而是Analysis ToolPak的外接程序。

小時

HOUR函數返回時間值的小時。小時以整數形式給出，範圍從0（12:00 AM）到23（11:00 PM）。

句法

HOUR(datetime) 

參量

datetime時間。

Excel日期/時間值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期/時間。

返回值

整數反映一天中的小時的整數值。

整數形式，取值範圍是0〜23。

例子

$worksheet->setCellValue('A1', 'Time String') ->setCellValue('A2', '31-Dec-2008 17:30') ->setCellValue('A3', '14-Feb-2008 4:20 AM') ->setCellValue('A4', '14-Feb-2008 4:20 PM'); $worksheet->setCellValue('B2', '=HOUR(A2)') ->setCellValue('B3', '=HOUR(A3)') ->setCellValue('B4', '=HOUR(A4)'); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); // $retVal = 17 $retVal = $worksheet->getCell('B3')->getCalculatedValue(); // $retVal = 4 $retVal = $worksheet->getCell('B4')->getCalculatedValue(); // $retVal = 16 

$retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'HOUROFDAY'], ['09:30'] ); // $retVal = 9 

筆記

請注意，PhpSpreadsheet函數是 \PhpOffice\PhpSpreadsheet\Calculation\Functions::HOUROFDAY()靜態調用該方法時。

分鐘

MINUTE函數返回時間值的分鐘。分鐘以整數形式給出，範圍爲0到59。

句法

MINUTE(datetime) 

參量

datetime時間。

Excel日期/時間值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期/時間。

返回值

整數反映小時中分鐘的整數值。

整數形式，取值範圍是0〜59。

例子

$worksheet->setCellValue('A1', 'Time String') ->setCellValue('A2', '31-Dec-2008 17:30') ->setCellValue('A3', '14-Feb-2008 4:20 AM') ->setCellValue('A4', '14-Feb-2008 4:45 PM'); $worksheet->setCellValue('B2', '=MINUTE(A2)') ->setCellValue('B3', '=MINUTE(A3)') ->setCellValue('B4', '=MINUTE(A4)'); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); // $retVal = 30 $retVal = $worksheet->getCell('B3')->getCalculatedValue(); // $retVal = 20 $retVal = $worksheet->getCell('B4')->getCalculatedValue(); // $retVal = 45 

$retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'MINUTE'], ['09:30'] ); // $retVal = 30 

筆記

請注意，PhpSpreadsheet函數是 \PhpOffice\PhpSpreadsheet\Calculation\Functions::MINUTE()靜態調用該方法時。

月

MONTH函數返回日期的月份。月份爲1到12之間的整數。

句法

MONTH(datetime) 

參量

datetime日期。

Excel日期值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期。

返回值

integer An integer value that reflects the month of the year.

This is an integer ranging from 1 to 12.

Examples

$worksheet->setCellValue('A1', 'Date String'); $worksheet->setCellValue('A2', '31-Dec-2008'); $worksheet->setCellValue('A3', '14-Feb-2008'); $worksheet->setCellValue('B2', '=MONTH(A2)'); $worksheet->setCellValue('B3', '=MONTH(A3)'); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); // $retVal = 12 $retVal = $worksheet->getCell('B3')->getCalculatedValue(); // $retVal = 2 

$retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'MONTHOFYEAR'], ['14-July-2008'] ); // $retVal = 7 

Notes

Note that the PhpSpreadsheet function is \PhpOffice\PhpSpreadsheet\Calculation\Functions::MONTHOFYEAR() when the method is called statically.

NETWORKDAYS

The NETWORKDAYS function returns the number of whole working days between a start date and an end date. Working days exclude weekends and any dates identified in holidays. Use NETWORKDAYS to calculate employee benefits that accrue based on the number of days worked during a specific term.

Syntax

NETWORKDAYS(startDate, endDate [, holidays]) 

Parameters

startDate Start Date of the period.

An Excel date value, PHP date timestamp, PHP DateTime object, or a date represented as a string.

endDate End Date of the period.

An Excel date value, PHP date timestamp, PHP DateTime object, or a date represented as a string.

假日假日日期的可選數組。

從工做日曆中排除的一個或多個日期的可選範圍，例如州和聯邦假日以及浮動假日。

該列表能夠是包含日期的單元格範圍，也能夠是Excel日期值，PHP日期時間戳，PHP日期對象或表示爲字符串的日期的數組常量。

返回值

整數工做天數。

startDate和endDate之間的工做天數。

例子

筆記

此功能沒有其餘註釋

如今

NOW函數返回當前日期和時間。

句法

NOW() 

參量

該NOW()功能沒有參數。

返回值

混合的與當前日期和時間相對應的日期/時間戳。

根據的值，它能夠是PHP時間戳記值（整數），PHP DateTime對象或Excel時間戳記值（實數） \PhpOffice\PhpSpreadsheet\Calculation\Functions::getReturnDateType()。

例子

筆記

請注意，PhpSpreadsheet函數是 \PhpOffice\PhpSpreadsheet\Calculation\Functions::DATETIMENOW()靜態調用該方法時。

第二

SECOND函數返回時間值的秒數。第二個整數形式，取值範圍是0到59。

句法

SECOND(datetime) 

參量

datetime時間。

Excel日期/時間值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期/時間。

返回值

整數反映分鐘內秒數的整數值。

整數形式，取值範圍是0〜59。

例子

$worksheet->setCellValue('A1', 'Time String') ->setCellValue('A2', '31-Dec-2008 17:30:20') ->setCellValue('A3', '14-Feb-2008 4:20 AM') ->setCellValue('A4', '14-Feb-2008 4:45:59 PM'); $worksheet->setCellValue('B2', '=SECOND(A2)') ->setCellValue('B3', '=SECOND(A3)'); ->setCellValue('B4', '=SECOND(A4)'); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); // $retVal = 20 $retVal = $worksheet->getCell('B3')->getCalculatedValue(); // $retVal = 0 $retVal = $worksheet->getCell('B4')->getCalculatedValue(); // $retVal = 59 

$retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'SECOND'], ['09:30:17'] ); // $retVal = 17 

筆記

請注意，PhpSpreadsheet函數是 \PhpOffice\PhpSpreadsheet\Calculation\Functions::SECOND()靜態調用該方法時。

時間

還沒有記錄。

時間值

還沒有記錄。

今天

還沒有記錄。

平日

WEEKDAY函數返回給定日期的星期幾。該日期以1到7之間的整數形式給出，但能夠修改成返回0到6之間的值。

句法

WEEKDAY(datetime [, method]) 

參量

datetime日期。

Excel日期值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期。

方法整數標誌（值0、1或2）

這是一個標誌，用於根據如下列出的值肯定要在計算中使用的方法：

method | Description :-----:|------------------------------------------ 0 | Returns 1 (Sunday) through 7 (Saturday). 1 | Returns 1 (Monday) through 7 (Sunday). 2 | Returns 0 (Monday) through 6 (Sunday). 

方法值默認爲1。

返回值

整數反映星期幾的整數值。

這是一個整數，範圍是1到7，或0到6，取決於method的值。

例子

$worksheet->setCellValue('A1', 'Date String') ->setCellValue('A2', '31-Dec-2008') ->setCellValue('A3', '14-Feb-2008'); $worksheet->setCellValue('B2', '=WEEKDAY(A2)') ->setCellValue('B3', '=WEEKDAY(A3,0)') ->setCellValue('B4', '=WEEKDAY(A3,2)'); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); // $retVal = 12 $retVal = $worksheet->getCell('B3')->getCalculatedValue(); // $retVal = 2 $retVal = $worksheet->getCell('B4')->getCalculatedValue(); // $retVal = 2 

$retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'WEEKDAY'], ['14-July-2008'] ); // $retVal = 7 

筆記

請注意，PhpSpreadsheet函數是 \PhpOffice\PhpSpreadsheet\Calculation\Functions::WEEKDAY()靜態調用該方法時。

WEEKNUM

還沒有記錄。

工做日

還沒有記錄。

年

YEAR函數返回日期的年份。

句法

YEAR(datetime) 

參量

datetime日期。

Excel日期值，PHP日期時間戳，PHP DateTime對象或表示爲字符串的日期。

返回值

整數反映一年中月份的整數值。

這是整數年值。

例子

$worksheet->setCellValue('A1', 'Date String') ->setCellValue('A2', '17-Jul-1982') ->setCellValue('A3', '16-Apr-2009'); $worksheet->setCellValue('B2', '=YEAR(A2)') ->setCellValue('B3', '=YEAR(A3)'); $retVal = $worksheet->getCell('B2')->getCalculatedValue(); // $retVal = 1982 $retVal = $worksheet->getCell('B3')->getCalculatedValue(); // $retVal = 2009 

$retVal = call_user_func_array( ['\PhpOffice\PhpSpreadsheet\Calculation\Functions', 'YEAR'], ['14-July-2001'] ); // $retVal = 2001 

筆記

此功能沒有其餘註釋

年分會

還沒有記錄