 9b44cf3418
			
		
	
	
		9b44cf3418
		
			
		
	
	
	
	
		
			
			- Fix ISFORMULA() function to work with a cell reference to another worksheet
 - Added calculation engine support for the new functions that were added in MS Excel 2013 and MS Excel 2016
   - Text Functions
     - CONCAT()     Synonym for CONCATENATE()
     - NUMBERVALUE()  Converts text to a number, in a locale-independent way
     - UNICHAR()    Synonym for CHAR() in PHPSpreadsheet, which has always used UTF-8 internally
     - UNIORD()     Synonym for ORD() in PHPSpreadsheet, which has always used UTF-8 internally
     - TEXTJOIN()   Joins together two or more text strings, separated by a delimiter
   - Logical Functions
     - XOR()        Returns a logical Exclusive Or of all arguments
   - Date/Time Functions
     - ISOWEEKNUM()  Returns the ISO 8601 week number of the year for a given date
   - Lookup and Reference Functions
     - FORMULATEXT()  Returns a formula as a string
   - Engineering Functions
     - ERF.PRECISE()   Returns the error function integrated between 0 and a supplied limit
     - ERFC.PRECISE()  Synonym for ERFC
   - Math and Trig Functions
     - SEC()          Returns the secant of an angle
     - SECH()         Returns the hyperbolic secant of an angle
     - CSC()          Returns the cosecant of an angle
     - CSCH()         Returns the hyperbolic cosecant of an angle
     - COT()          Returns the cotangent of an angle
     - COTH()         Returns the hyperbolic cotangent of an angle
     - ACOT()         Returns the cotangent of an angle
     - ACOTH()        Returns the hyperbolic cotangent of an angle
  - Financial Functions
    - PDURATION()    Calculates the number of periods required for an investment to reach a specified value
    - RRI()          Calculates the interest rate required for an investment to grow to a specified future value
		
	
			
		
			
				
	
	
		
			386 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
			
		
		
	
	
			386 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
| <?php
 | |
| 
 | |
| namespace PhpOffice\PhpSpreadsheetTests\Calculation;
 | |
| 
 | |
| use PhpOffice\PhpSpreadsheet\Calculation\Functions;
 | |
| use PhpOffice\PhpSpreadsheet\Cell\Cell;
 | |
| use PhpOffice\PhpSpreadsheet\Spreadsheet;
 | |
| use PhpOffice\PhpSpreadsheet\Worksheet\Worksheet;
 | |
| use PHPUnit\Framework\TestCase;
 | |
| 
 | |
| class FunctionsTest extends TestCase
 | |
| {
 | |
|     public function setUp()
 | |
|     {
 | |
|         Functions::setCompatibilityMode(Functions::COMPATIBILITY_EXCEL);
 | |
|         Functions::setReturnDateType(Functions::RETURNDATE_EXCEL);
 | |
|     }
 | |
| 
 | |
|     public function tearDown()
 | |
|     {
 | |
|         Functions::setCompatibilityMode(Functions::COMPATIBILITY_EXCEL);
 | |
|         Functions::setReturnDateType(Functions::RETURNDATE_EXCEL);
 | |
|     }
 | |
| 
 | |
|     public function testCompatibilityMode()
 | |
|     {
 | |
|         $result = Functions::setCompatibilityMode(Functions::COMPATIBILITY_GNUMERIC);
 | |
|         // Test for a true response for success
 | |
|         $this->assertTrue($result);
 | |
|         // Test that mode has been changed
 | |
|         $this->assertEquals(Functions::COMPATIBILITY_GNUMERIC, Functions::getCompatibilityMode());
 | |
|     }
 | |
| 
 | |
|     public function testInvalidCompatibilityMode()
 | |
|     {
 | |
|         $result = Functions::setCompatibilityMode('INVALIDMODE');
 | |
|         // Test for a false response for failure
 | |
|         $this->assertFalse($result);
 | |
|         // Test that mode has not been changed
 | |
|         $this->assertEquals(Functions::COMPATIBILITY_EXCEL, Functions::getCompatibilityMode());
 | |
|     }
 | |
| 
 | |
|     public function testReturnDateType()
 | |
|     {
 | |
|         $result = Functions::setReturnDateType(Functions::RETURNDATE_PHP_OBJECT);
 | |
|         // Test for a true response for success
 | |
|         $this->assertTrue($result);
 | |
|         // Test that mode has been changed
 | |
|         $this->assertEquals(Functions::RETURNDATE_PHP_OBJECT, Functions::getReturnDateType());
 | |
|     }
 | |
| 
 | |
|     public function testInvalidReturnDateType()
 | |
|     {
 | |
|         $result = Functions::setReturnDateType('INVALIDTYPE');
 | |
|         // Test for a false response for failure
 | |
|         $this->assertFalse($result);
 | |
|         // Test that mode has not been changed
 | |
|         $this->assertEquals(Functions::RETURNDATE_EXCEL, Functions::getReturnDateType());
 | |
|     }
 | |
| 
 | |
|     public function testDUMMY()
 | |
|     {
 | |
|         $result = Functions::DUMMY();
 | |
|         self::assertEquals('#Not Yet Implemented', $result);
 | |
|     }
 | |
| 
 | |
|     public function testDIV0()
 | |
|     {
 | |
|         $result = Functions::DIV0();
 | |
|         self::assertEquals('#DIV/0!', $result);
 | |
|     }
 | |
| 
 | |
|     public function testNA()
 | |
|     {
 | |
|         $result = Functions::NA();
 | |
|         self::assertEquals('#N/A', $result);
 | |
|     }
 | |
| 
 | |
|     public function testNAN()
 | |
|     {
 | |
|         $result = Functions::NAN();
 | |
|         self::assertEquals('#NUM!', $result);
 | |
|     }
 | |
| 
 | |
|     public function testNAME()
 | |
|     {
 | |
|         $result = Functions::NAME();
 | |
|         self::assertEquals('#NAME?', $result);
 | |
|     }
 | |
| 
 | |
|     public function testREF()
 | |
|     {
 | |
|         $result = Functions::REF();
 | |
|         self::assertEquals('#REF!', $result);
 | |
|     }
 | |
| 
 | |
|     public function testNULL()
 | |
|     {
 | |
|         $result = Functions::null();
 | |
|         self::assertEquals('#NULL!', $result);
 | |
|     }
 | |
| 
 | |
|     public function testVALUE()
 | |
|     {
 | |
|         $result = Functions::VALUE();
 | |
|         self::assertEquals('#VALUE!', $result);
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsBlank
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsBlank($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isBlank(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsBlank()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_BLANK.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsErr
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsErr($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isErr(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsErr()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_ERR.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsError
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsError($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isError(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsError()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_ERROR.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerErrorType
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testErrorType($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::errorType(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerErrorType()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/ERROR_TYPE.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsLogical
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsLogical($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isLogical(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsLogical()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_LOGICAL.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsNa
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsNa($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isNa(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsNa()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_NA.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsNumber
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsNumber($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isNumber(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsNumber()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_NUMBER.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsText
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsText($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isText(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsText()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_TEXT.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsNonText
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsNonText($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isNonText(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsNonText()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_NONTEXT.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsEven
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsEven($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isEven(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsEven()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_EVEN.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsOdd
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIsOdd($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::isOdd(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsOdd()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IS_ODD.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerTYPE
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testTYPE($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::TYPE(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerTYPE()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/TYPE.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerN
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testN($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::n(...$args);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerN()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/N.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIsFormula
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      * @param mixed $reference       Reference to the cell we wish to test
 | |
|      * @param mixed $value           Value of the cell we wish to test
 | |
|      */
 | |
|     public function testIsFormula($expectedResult, $reference, $value = 'undefined')
 | |
|     {
 | |
|         $ourCell = null;
 | |
|         if ($value !== 'undefined') {
 | |
|             $remoteCell = $this->getMockBuilder(Cell::class)
 | |
|                 ->disableOriginalConstructor()
 | |
|                 ->getMock();
 | |
|             $remoteCell->method('isFormula')
 | |
|                 ->will($this->returnValue(substr($value, 0, 1) == '='));
 | |
| 
 | |
|             $remoteSheet = $this->getMockBuilder(Worksheet::class)
 | |
|                 ->disableOriginalConstructor()
 | |
|                 ->getMock();
 | |
|             $remoteSheet->method('getCell')
 | |
|                 ->will($this->returnValue($remoteCell));
 | |
| 
 | |
|             $workbook = $this->getMockBuilder(Spreadsheet::class)
 | |
|                 ->disableOriginalConstructor()
 | |
|                 ->getMock();
 | |
|             $workbook->method('getSheetByName')
 | |
|                 ->will($this->returnValue($remoteSheet));
 | |
| 
 | |
|             $sheet = $this->getMockBuilder(Worksheet::class)
 | |
|                 ->disableOriginalConstructor()
 | |
|                 ->getMock();
 | |
|             $sheet->method('getCell')
 | |
|                 ->will($this->returnValue($remoteCell));
 | |
|             $sheet->method('getParent')
 | |
|                 ->will($this->returnValue($workbook));
 | |
| 
 | |
|             $ourCell = $this->getMockBuilder(Cell::class)
 | |
|                 ->disableOriginalConstructor()
 | |
|                 ->getMock();
 | |
|             $ourCell->method('getWorksheet')
 | |
|                 ->will($this->returnValue($sheet));
 | |
|         }
 | |
| 
 | |
|         $result = Functions::isFormula($reference, $ourCell);
 | |
|         self::assertEquals($expectedResult, $result, null, 1E-8);
 | |
|     }
 | |
| 
 | |
|     public function providerIsFormula()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/ISFORMULA.php';
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @dataProvider providerIfCondition
 | |
|      *
 | |
|      * @param mixed $expectedResult
 | |
|      */
 | |
|     public function testIfCondition($expectedResult, ...$args)
 | |
|     {
 | |
|         $result = Functions::ifCondition(...$args);
 | |
|         self::assertEquals($expectedResult, $result);
 | |
|     }
 | |
| 
 | |
|     public function providerIfCondition()
 | |
|     {
 | |
|         return require 'data/Calculation/Functions/IF_CONDITION.php';
 | |
|     }
 | |
| }
 |