ilCertificateDateHelperTest Class Reference

Inheritance diagram for ilCertificateDateHelperTest:

Collaboration diagram for ilCertificateDateHelperTest:

Public Member Functions
	testFormatDateWithDefaultFormat ($input, $output)
	testFormatDateTimeWithDefaultFormat ($input, $output)
	testHelperDoesNotChangeUseRelativeDates ()
	testExplicitFormatsWorkAsExpected (string $method, $input, int $format, ?string $expected_exception, string $why)
	testCannotFormatNonDateString (string $method)
	testFormatDateWithUserLanguage ()
	testFormatDateTimeWithUserLanguage ()

Static Public Member Functions
static	dataProviderFormatDateWithDateFormat ()
static	dataProviderFormatDateTimeWithDateTimeFormat ()
static	provideExplicitFormatCases ()
static	dateFormattingMethodsProvider ()

Protected Member Functions
	setUp ()
	tearDown ()
Protected Member Functions inherited from ilCertificateBaseTestCase
	setUp ()
	tearDown ()
	assertDoesNotThrow (callable $cb, string $message='')
	assertThrows (callable $cb, ?string $expected_class=null, ?string $expected_message=null)
	@template T of Throwable More...
	setGlobalVariable (string $name, mixed $value)

Private Member Functions
	getUserMock ()
	getSystemLanguageMock ()
	mockUserLanguageGerman ()

Private Attributes
const string	USER_TIME_ZONE = 'Europe/Berlin'
const string	DEFAULT_TIME_ZONE = 'UTC'
int	$current_time

Additional Inherited Members
Protected Attributes inherited from ilCertificateBaseTestCase
Container	$dic

Detailed Description

Definition at line 24 of file ilCertificateDateHelperTest.php.

Member Function Documentation

dataProviderFormatDateTimeWithDateTimeFormat()

static ilCertificateDateHelperTest::dataProviderFormatDateTimeWithDateTimeFormat ( )

static

Definition at line 79 of file ilCertificateDateHelperTest.php.

                                                                         : array
    {
        return [
            [null, 'No date'],
            ['2001-01-01 00:00:00', '1. Jan 2001, 01:00'],
            [978307200, '1. Jan 2001, 01:00'],
            [0, 'No date'],
            ['', 'No date'],
        ];
    }

dataProviderFormatDateWithDateFormat()

static ilCertificateDateHelperTest::dataProviderFormatDateWithDateFormat ( )

static

Definition at line 60 of file ilCertificateDateHelperTest.php.

                                                                 : array
    {
        return [
            [null, 'No date'],
            ['2001-01-01', '1. Jan 2001'],
            ['2001-01-01 00:00:00', '1. Jan 2001'],
            [978307200, '1. Jan 2001'],
            [0, 'No date'],
            ['', 'No date'],
        ];
    }

dateFormattingMethodsProvider()

static ilCertificateDateHelperTest::dateFormattingMethodsProvider ( )

static

Returns

array<string, array{0: string}>

Definition at line 227 of file ilCertificateDateHelperTest.php.

                                                          : array
    {
        return [
            'formatDateTime' => ['formatDateTime'],
            'formatDate' => ['formatDate'],
        ];
    }

getSystemLanguageMock()

ilCertificateDateHelperTest::getSystemLanguageMock ( )

private

Definition at line 274 of file ilCertificateDateHelperTest.php.

                                            : ilLanguage
    {
        $lng = $this->getMockBuilder(ilLanguage::class)
                    ->onlyMethods(['txt', 'loadLanguageModule'])
                    ->disableOriginalConstructor()
                    ->getMock();
        $lng->method('txt')->willReturnCallback(function (string $topic): string {
            return match ($topic) {
                'month_01_short' => 'Jan',
                'month_01_long' => 'January',
                'month_02_short' => 'Feb',
                'month_03_short' => 'Mar',
                'month_04_short' => 'Apr',
                'month_05_short' => 'May',
                'month_06_short' => 'Jun',
                'month_07_short' => 'Jul',
                'month_08_short' => 'Aug',
                'month_09_short' => 'Sep',
                'month_10_short' => 'Oct',
                'month_11_short' => 'Nov',
                'month_12_short' => 'Dec',
                'no_date' => 'No date',
                'today' => 'Today',
                'yesterday' => 'Yesterday',
                'tomorrow' => 'Tomorrow',
                default => '-' . $topic . '-'
            };
        });
 
        return $lng;
    }

References $lng.

Referenced by setUp().

Here is the caller graph for this function:

getUserMock()

ilCertificateDateHelperTest::getUserMock ( )

private

Definition at line 261 of file ilCertificateDateHelperTest.php.

                                  : ilObjUser
    {
        $user = $this->getMockBuilder(ilObjUser::class)
                     ->disableOriginalConstructor()
                     ->onlyMethods(['getTimeFormat', 'getLanguage', 'getTimeZone'])
                     ->getMock();
        $user->method('getTimeFormat')->willReturn((string) ilCalendarSettings::TIME_FORMAT_24);
        $user->method('getLanguage')->willReturn('de');
        $user->method('getTimeZone')->willReturn(self::USER_TIME_ZONE);
 
        return $user;
    }

References ilCalendarSettings\TIME_FORMAT_24.

Referenced by setUp().

Here is the caller graph for this function:

mockUserLanguageGerman()

ilCertificateDateHelperTest::mockUserLanguageGerman ( )

private

Definition at line 306 of file ilCertificateDateHelperTest.php.

                                             : void
    {
        if (!defined('ILIAS_LOG_ENABLED')) {
            define('ILIAS_LOG_ENABLED', false);
        }
        if (!defined('ILIAS_ABSOLUTE_PATH')) {
            define('ILIAS_ABSOLUTE_PATH', dirname(__FILE__, 5));
        }
 
        $ilClientIniFile = $this->getMockBuilder(ilIniFile::class)
                                ->disableOriginalConstructor()
                                ->getMock();
        $this->setGlobalVariable('ilClientIniFile', $ilClientIniFile);
 
        $ilDB = $this->createMock(ilDBInterface::class);
        $ilDB->method('query')->willReturnCallback(function ($query): ilDBStatement {
            $statement = $this->createMock(ilDBStatement::class);
 
            if (str_contains($query, 'SELECT * FROM lng_modules')) {
                $statement->method('numRows')->willReturn(1);
                $statement->method('fetchRow')->willReturn([
                    'lang_array' => serialize([
                        'month_01_short' => 'Jan',
                        'month_01_long' => 'Januar',
                        'month_02_short' => 'Feb',
                        'month_03_short' => 'Mär',
                        'month_04_short' => 'Apr',
                        'month_05_short' => 'Mai',
                        'month_06_short' => 'Jun',
                        'month_07_short' => 'Jul',
                        'month_08_short' => 'Aug',
                        'month_09_short' => 'Sep',
                        'month_10_short' => 'Okt',
                        'month_11_short' => 'Nov',
                        'month_12_short' => 'Dez',
                        'no_date' => 'Kein Datum',
                        'today' => 'Heute',
                        'yesterday' => 'Gestern',
                        'tomorrow' => 'Morgen'
                    ]),
                ]);
            } else {
                $statement->method('numRows')->willReturn(0);
                $statement->method('fetchRow')->willReturn(false);
            }
 
            return $statement;
        });
 
        $this->setGlobalVariable('ilDB', $ilDB);
    }

References $ilDB, and setGlobalVariable().

Here is the call graph for this function:

provideExplicitFormatCases()

static ilCertificateDateHelperTest::provideExplicitFormatCases ( )

static

Definition at line 117 of file ilCertificateDateHelperTest.php.

                                                       : array
    {
        $ts = 1757609100; // See snippet in: https://github.com/ILIAS-eLearning/ILIAS/pull/10084
 
        class_exists('ilDateTime');
 
        return [
            'date: unix-int ok' => ['date', $ts, IL_CAL_UNIX, null, 'unix timestamp (int) accepted for date'],
            'date: unix-string ok' => [
                'date',
                (string) $ts,
                IL_CAL_UNIX,
                null,
                'unix timestamp (string) accepted for date'
            ],
            'datetime: unix-int ok' => [
                'datetime',
                $ts,
                IL_CAL_UNIX,
                null,
                'unix timestamp (int) accepted for datetime'
            ],
            'datetime: unix-string ok' => [
                'datetime',
                (string) $ts,
                IL_CAL_UNIX,
                null,
                'unix timestamp (string) accepted for datetime'
            ],
 
            'date: negative-unix ok' => ['date', -1, IL_CAL_UNIX, null, 'negative unix timestamp accepted as int'],
            'datetime: negative-unix ok' => [
                'datetime',
                -1,
                IL_CAL_UNIX,
                null,
                'negative unix timestamp accepted as int'
            ],
 
            'date: date ok' => ['date', '2025-09-12', IL_CAL_DATE, null, 'valid date string'],
            'datetime: datetime ok' => [
                'datetime',
                '2025-09-12 20:30:00',
                IL_CAL_DATETIME,
                null,
                'valid date-time string'
            ],
            'date: YYYYMMDD ok' => ['date', '20250912', IL_CAL_DATE, null, 'numeric YYYYMMDD is not treated as unix'],
 
            'date: unix-string with DATE throws' => [
                'date',
                (string) $ts,
                IL_CAL_DATE,
                InvalidArgumentException::class,
                'unix-like string with DATE format should be rejected'
            ],
            'datetime: unix-string with DATETIME throws' => [
                'datetime',
                (string) $ts,
                IL_CAL_DATETIME,
                InvalidArgumentException::class,
                'unix-like string with DATETIME format should be rejected'
            ],
            'date: date with UNIX throws' => [
                'date',
                '2025-09-12',
                IL_CAL_UNIX,
                InvalidArgumentException::class,
                'non-numeric with UNIX should be rejected'
            ],
            'datetime: datetime with UNIX throws' => [
                'datetime',
                '2025-09-12 20:30:00',
                IL_CAL_UNIX,
                InvalidArgumentException::class,
                'non-numeric with UNIX should be rejected'
            ],
        ];
    }

References IL_CAL_DATE, IL_CAL_DATETIME, and IL_CAL_UNIX.

setUp()

ilCertificateDateHelperTest::setUp ( )

protected

Reimplemented from ilCertificateBaseTestCase.

Definition at line 31 of file ilCertificateDateHelperTest.php.

                              : void
    {
        parent::setUp();
 
        class_exists('ilDateTime');
 
        ilTimeZone::_setDefaultTimeZone(self::DEFAULT_TIME_ZONE);
 
        $logger = $this->getMockBuilder(ilLogger::class)
                       ->disableOriginalConstructor()
                       ->getMock();
 
        $logger_factory = $this->getMockBuilder(ilLoggerFactory::class)
                               ->disableOriginalConstructor()
                               ->onlyMethods(['getComponentLogger'])
                               ->getMock();
        $logger_factory->method('getComponentLogger')->willReturn($logger);
        $this->setGlobalVariable('ilLoggerFactory', $logger_factory);
        $this->setGlobalVariable('lng', $this->getSystemLanguageMock());
        $this->setGlobalVariable('ilUser', $this->getUserMock());
        $this->current_time = time();
    }

References ilTimeZone\_setDefaultTimeZone(), getSystemLanguageMock(), getUserMock(), and ilCertificateBaseTestCase\setGlobalVariable().

Here is the call graph for this function:

tearDown()

ilCertificateDateHelperTest::tearDown ( )

protected

Reimplemented from ilCertificateBaseTestCase.

Definition at line 54 of file ilCertificateDateHelperTest.php.

                                 : void
    {
        ilTimeZone::_restoreDefaultTimeZone();
        parent::tearDown();
    }

References ilTimeZone\_restoreDefaultTimeZone().

Here is the call graph for this function:

testCannotFormatNonDateString()

ilCertificateDateHelperTest::testCannotFormatNonDateString

(

string

$method

)

Definition at line 236 of file ilCertificateDateHelperTest.php.

                                                                 : void
    {
        $helper = new ilCertificateDateHelper();
        $this->expectExceptionMessage('Cannot parse date: invalid-date');
        $helper->$method('invalid-date');
    }

testExplicitFormatsWorkAsExpected()

ilCertificateDateHelperTest::testExplicitFormatsWorkAsExpected	(	string	$method,
			$input,
		int	$format,
		?string	$expected_exception,
		string	$why
	)

Parameters

int | string	$input
	class-string<Throwable>|null	$expected_exception

Definition at line 202 of file ilCertificateDateHelperTest.php.

     : void {
        $helper = new ilCertificateDateHelper();
 
        $cb = static function () use ($helper, $method, $input, $format) {
            return $method === 'date'
                ? $helper->formatDate($input, null, $format)
                : $helper->formatDateTime($input, null, $format);
        };
 
        if ($expected_exception === null) {
            $this->assertDoesNotThrow($cb, $why);
        } else {
            $this->assertThrows($cb, $expected_exception, null);
        }
    }

References ilCertificateDateHelper\formatDate().

Here is the call graph for this function:

testFormatDateTimeWithDefaultFormat()

ilCertificateDateHelperTest::testFormatDateTimeWithDefaultFormat	(		$input,
			$output
	)

Definition at line 91 of file ilCertificateDateHelperTest.php.

                                                                        : void
    {
        $helper = new ilCertificateDateHelper();
        $this->assertEquals($output, $helper->formatDateTime($input));
    }

testFormatDateTimeWithUserLanguage()

ilCertificateDateHelperTest::testFormatDateTimeWithUserLanguage

(

)

Definition at line 253 of file ilCertificateDateHelperTest.php.

                                                        : void
    {
        $this->mockUserLanguageGerman();
 
        $helper = new ilCertificateDateHelper();
        $this->assertEquals('1. Mai 2001, 03:30', $helper->formatDateTime('2001-05-01 01:30:59', $this->getUserMock()));
    }

testFormatDateWithDefaultFormat()

ilCertificateDateHelperTest::testFormatDateWithDefaultFormat	(		$input,
			$output
	)

Definition at line 73 of file ilCertificateDateHelperTest.php.

                                                                    : void
    {
        $helper = new ilCertificateDateHelper();
        $this->assertEquals($output, $helper->formatDate($input));
    }

testFormatDateWithUserLanguage()

ilCertificateDateHelperTest::testFormatDateWithUserLanguage

(

)

Definition at line 244 of file ilCertificateDateHelperTest.php.

                                                    : void
    {
        $this->mockUserLanguageGerman();
 
        $helper = new ilCertificateDateHelper();
        $this->assertEquals('1. Mai 2001', $helper->formatDate('2001-05-01 01:30:59', $this->getUserMock()));
    }

testHelperDoesNotChangeUseRelativeDates()

ilCertificateDateHelperTest::testHelperDoesNotChangeUseRelativeDates

(

)

Definition at line 97 of file ilCertificateDateHelperTest.php.

                                                             : void
    {
        $used_relative_dates = ilDatePresentation::useRelativeDates();
 
        $helper = new ilCertificateDateHelper();
 
        $helper->formatDate('2001-01-01');
        $this->assertEquals($used_relative_dates, ilDatePresentation::useRelativeDates());
 
        ilDatePresentation::setUseRelativeDates(true);
        $helper->formatDate('2001-01-01');
        $this->assertTrue(ilDatePresentation::useRelativeDates());
 
        ilDatePresentation::setUseRelativeDates(false);
        $helper->formatDate('2001-01-01');
        $this->assertFalse(ilDatePresentation::useRelativeDates());
 
        ilDatePresentation::setUseRelativeDates($used_relative_dates);
    }

References ilDatePresentation\setUseRelativeDates(), and ilDatePresentation\useRelativeDates().

Here is the call graph for this function:

Field Documentation

$current_time

int ilCertificateDateHelperTest::$current_time

private

Definition at line 29 of file ilCertificateDateHelperTest.php.

DEFAULT_TIME_ZONE

const string ilCertificateDateHelperTest::DEFAULT_TIME_ZONE = 'UTC'

private

Definition at line 27 of file ilCertificateDateHelperTest.php.

USER_TIME_ZONE

const string ilCertificateDateHelperTest::USER_TIME_ZONE = 'Europe/Berlin'

private

Definition at line 26 of file ilCertificateDateHelperTest.php.

---

The documentation for this class was generated from the following file:

• components/ILIAS/Certificate/tests/ilCertificateDateHelperTest.php