class FormatDateTest

Same name in this branch
  1. 10 core/modules/system/tests/src/Functional/Common/FormatDateTest.php \Drupal\Tests\system\Functional\Common\FormatDateTest
Same name in other branches
  1. 9 core/modules/migrate/tests/src/Unit/process/FormatDateTest.php \Drupal\Tests\migrate\Unit\process\FormatDateTest
  2. 9 core/modules/system/tests/src/Functional/Common/FormatDateTest.php \Drupal\Tests\system\Functional\Common\FormatDateTest
  3. 8.9.x core/modules/migrate/tests/src/Unit/process/FormatDateTest.php \Drupal\Tests\migrate\Unit\process\FormatDateTest
  4. 8.9.x core/modules/system/tests/src/Functional/Common/FormatDateTest.php \Drupal\Tests\system\Functional\Common\FormatDateTest
  5. 11.x core/modules/migrate/tests/src/Unit/process/FormatDateTest.php \Drupal\Tests\migrate\Unit\process\FormatDateTest
  6. 11.x core/modules/system/tests/src/Functional/Common/FormatDateTest.php \Drupal\Tests\system\Functional\Common\FormatDateTest

Tests the format date process plugin.

@group migrate

@coversDefaultClass Drupal\migrate\Plugin\migrate\process\FormatDate

Hierarchy

Expanded class hierarchy of FormatDateTest

File

core/modules/migrate/tests/src/Unit/process/FormatDateTest.php, line 17

Namespace

Drupal\Tests\migrate\Unit\process
View source 
class FormatDateTest extends MigrateProcessTestCase {
    
    /**
     * Tests that missing configuration will throw an exception.
     */
    public function testMigrateExceptionMissingFromFormat() : void {
        $configuration = [
            'from_format' => '',
            'to_format' => 'Y-m-d',
        ];
        $this->expectException(MigrateException::class);
        $this->expectExceptionMessage('Format date plugin is missing from_format configuration.');
        $this->plugin = new FormatDate($configuration, 'test_format_date', []);
        $this->plugin
            ->transform('01/05/1955', $this->migrateExecutable, $this->row, 'field_date');
    }
    
    /**
     * Tests that missing configuration will throw an exception.
     */
    public function testMigrateExceptionMissingToFormat() : void {
        $configuration = [
            'from_format' => 'm/d/Y',
            'to_format' => '',
        ];
        $this->expectException(MigrateException::class);
        $this->expectExceptionMessage('Format date plugin is missing to_format configuration.');
        $this->plugin = new FormatDate($configuration, 'test_format_date', []);
        $this->plugin
            ->transform('01/05/1955', $this->migrateExecutable, $this->row, 'field_date');
    }
    
    /**
     * Tests that date format mismatches will throw an exception.
     */
    public function testMigrateExceptionBadFormat() : void {
        $configuration = [
            'from_format' => 'm/d/Y',
            'to_format' => 'Y-m-d',
        ];
        $this->expectException(MigrateException::class);
        $this->expectExceptionMessage("Format date plugin could not transform 'January 5, 1955' using the format 'm/d/Y'. Error: The date cannot be created from a format.");
        $this->plugin = new FormatDate($configuration, 'test_format_date', []);
        $this->plugin
            ->transform('January 5, 1955', $this->migrateExecutable, $this->row, 'field_date');
    }
    
    /**
     * Tests that an unexpected date value will throw an exception.
     */
    public function testMigrateExceptionUnexpectedValue() : void {
        $configuration = [
            'from_format' => 'm/d/Y',
            'to_format' => 'Y-m-d',
        ];
        $this->expectException(MigrateException::class);
        $this->expectExceptionMessage("Format date plugin could not transform '01/05/55' using the format 'm/d/Y'. Error: The created date does not match the input value.");
        $this->plugin = new FormatDate($configuration, 'test_format_date', []);
        $this->plugin
            ->transform('01/05/55', $this->migrateExecutable, $this->row, 'field_date');
    }
    
    /**
     * Tests transformation.
     *
     * @covers ::transform
     *
     * @dataProvider datesDataProvider
     *
     * @param $configuration
     *   The configuration of the migration process plugin.
     * @param $value
     *   The source value for the migration process plugin.
     * @param $expected
     *   The expected value of the migration process plugin.
     */
    public function testTransform($configuration, $value, $expected) : void {
        $this->plugin = new FormatDate($configuration, 'test_format_date', []);
        $actual = $this->plugin
            ->transform($value, $this->migrateExecutable, $this->row, 'field_date');
        $this->assertEquals($expected, $actual);
    }
    
    /**
     * Data provider of test dates.
     *
     * @return array
     *   Array of date formats and actual/expected values.
     */
    public static function datesDataProvider() {
        return [
            'datetime_date' => [
                'configuration' => [
                    'from_format' => 'm/d/Y',
                    'to_format' => 'Y-m-d',
                ],
                'value' => '01/05/1955',
                'expected' => '1955-01-05',
            ],
            'datetime_datetime' => [
                'configuration' => [
                    'from_format' => 'm/d/Y H:i:s',
                    'to_format' => 'Y-m-d\\TH:i:s e',
                ],
                'value' => '01/05/1955 10:43:22',
                'expected' => '1955-01-05T10:43:22 Australia/Sydney',
            ],
            'empty_values' => [
                'configuration' => [
                    'from_format' => 'm/d/Y',
                    'to_format' => 'Y-m-d',
                ],
                'value' => '',
                'expected' => '',
            ],
            'timezone_from_to' => [
                'configuration' => [
                    'from_format' => 'Y-m-d H:i:s',
                    'to_format' => 'Y-m-d H:i:s e',
                    'from_timezone' => 'America/Managua',
                    'to_timezone' => 'UTC',
                ],
                'value' => '2004-12-19 10:19:42',
                'expected' => '2004-12-19 16:19:42 UTC',
            ],
            'timezone_from' => [
                'configuration' => [
                    'from_format' => 'Y-m-d h:i:s',
                    'to_format' => 'Y-m-d h:i:s e',
                    'from_timezone' => 'America/Managua',
                ],
                'value' => '2004-11-19 10:25:33',
                // Unit tests use Australia/Sydney timezone, so date value will be
                // converted from America/Managua to Australia/Sydney timezone.
'expected' => '2004-11-20 03:25:33 Australia/Sydney',
            ],
            'timezone_to' => [
                'configuration' => [
                    'from_format' => 'Y-m-d H:i:s',
                    'to_format' => 'Y-m-d H:i:s e',
                    'to_timezone' => 'America/Managua',
                ],
                'value' => '2004-12-19 10:19:42',
                // Unit tests use Australia/Sydney timezone, so date value will be
                // converted from Australia/Sydney to America/Managua timezone.
'expected' => '2004-12-18 17:19:42 America/Managua',
            ],
            'integer_0' => [
                'configuration' => [
                    'from_format' => 'U',
                    'to_format' => 'Y-m-d',
                ],
                'value' => 0,
                'expected' => '1970-01-01',
            ],
            'string_0' => [
                'configuration' => [
                    'from_format' => 'U',
                    'to_format' => 'Y-m-d',
                ],
                'value' => '0',
                'expected' => '1970-01-01',
            ],
            'zeros' => [
                'configuration' => [
                    'from_format' => 'Y-m-d H:i:s',
                    'to_format' => 'Y-m-d H:i:s e',
                    'settings' => [
                        'validate_format' => FALSE,
                    ],
                ],
                'value' => '0000-00-00 00:00:00',
                'expected' => '-0001-11-30 00:00:00 Australia/Sydney',
            ],
            'zeros_same_timezone' => [
                'configuration' => [
                    'from_format' => 'Y-m-d H:i:s',
                    'to_format' => 'Y-m-d H:i:s',
                    'settings' => [
                        'validate_format' => FALSE,
                    ],
                    'from_timezone' => 'UTC',
                    'to_timezone' => 'UTC',
                ],
                'value' => '0000-00-00 00:00:00',
                'expected' => '-0001-11-30 00:00:00',
            ],
            'collected_date_attributes_day' => [
                'configuration' => [
                    'from_format' => 'Y-m-d\\TH:i:s',
                    'to_format' => 'Y-m-d\\TH:i:s',
                ],
                'value' => '2012-01-00T00:00:00',
                'expected' => '2012-01-01T00:00:00',
            ],
            'collected_date_attributes_month' => [
                'configuration' => [
                    'from_format' => 'Y-m-d\\TH:i:s',
                    'to_format' => 'Y-m-d\\TH:i:s',
                ],
                'value' => '2012-00-00T00:00:00',
                'expected' => '2012-01-01T00:00:00',
            ],
        ];
    }

}

Members

Title Deprecated Modifiers Object type Summary Overriden Title Overrides
FormatDateTest::datesDataProvider public static function Data provider of test dates.
FormatDateTest::testMigrateExceptionBadFormat public function Tests that date format mismatches will throw an exception.
FormatDateTest::testMigrateExceptionMissingFromFormat public function Tests that missing configuration will throw an exception.
FormatDateTest::testMigrateExceptionMissingToFormat public function Tests that missing configuration will throw an exception.
FormatDateTest::testMigrateExceptionUnexpectedValue public function Tests that an unexpected date value will throw an exception.
FormatDateTest::testTransform public function Tests transformation.
MigrateProcessTestCase::$migrateExecutable protected property
MigrateProcessTestCase::$plugin protected property 1
MigrateProcessTestCase::$row protected property
MigrateProcessTestCase::setUp protected function Overrides UnitTestCase::setUp 17
MigrateTestCase::$idMap protected property The migration ID map.
MigrateTestCase::$migrationConfiguration protected property An array of migration configuration values. 10
MigrateTestCase::$migrationStatus protected property Local store for mocking setStatus()/getStatus().
MigrateTestCase::createSchemaFromRow protected function Generates a table schema from a row.
MigrateTestCase::getDatabase protected function Gets an SQLite database connection object for use in tests.
MigrateTestCase::getMigration protected function Retrieves a mocked migration.
MigrateTestCase::getValue protected function Gets the value on a row for a given key.
MigrateTestCase::queryResultTest public function Tests a query.
MigrateTestCase::retrievalAssertHelper protected function Asserts tested values during test retrieval.
PhpUnitWarnings::$deprecationWarnings private static property Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning public function Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
RandomGeneratorTrait::getRandomGenerator protected function Gets the random generator for the utility methods.
RandomGeneratorTrait::randomMachineName protected function Generates a unique random string containing letters and numbers.
RandomGeneratorTrait::randomObject public function Generates a random PHP object.
RandomGeneratorTrait::randomString public function Generates a pseudo-random string of ASCII characters of codes 32 to 126.
RandomGeneratorTrait::randomStringValidate Deprecated public function Callback for random string validation.
UnitTestCase::$root protected property The app root. 1
UnitTestCase::getClassResolverStub protected function Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub public function Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub public function Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator protected function Sets up a container with a cache tags invalidator.
UnitTestCase::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setUpBeforeClass public static function
UnitTestCase::__get public function

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.