papimod/date

Module Papi

v2.1.1 2025-12-29 14:11 UTC

Requires

• php: >=8.3.0
• papi/papi: ^2.1.0
• papimod/dotenv: ^2.1.0

Requires (Dev)

• phpunit/phpunit: ^12.4
• squizlabs/php_codesniffer: ^4.0

Apache-2.0

• 4uruanna

README

Description

Help defining the API date format with time zone in your papi.

Also provide a DateService class to convert dates.

Prerequisites Modules

• Papimod/Dotenv

Configuration

DATE_FORMAT (.ENV)

Required	No
Type	string
Description	Global date format
Default	Y-m-d

DATE_TIME_FORMAT (.ENV)

Required	No
Type	string
Description	Global time format
Default	H:i:s

DATE_TIMEZONE (.ENV)

Required	No
Type	string
Description	Global timezone
Default	Europe/Paris

Definitions

• (service) DateService

Usage

You can add the following options to your .env file:

DATE_FORMAT="Y-m-d"
DATE_TIME_FORMAT="H:i:s"
DATE_TIMEZONE="Europe/Paris"

Import the module when creating your application:

require __DIR__ . "/../vendor/autoload.php";

use Papi\PapiBuilder;
use Papimod\Dotenv\DotEnvModule;
use Papimod\Date\DateModule;
use function DI\create;

$builder = new PapiBuilder();

$builder->setModule(
        DotEnvModule::class,
        DateModule::class
    )
    ->build()
    ->run();

Use the dedicated service anywhere:

final class MyService
{
    public function __construct(public readonly DateService $date_service) 
    {
    }

    public getNow(): string
    {
        $now = new DateTime();
        return $this->date_service->format($now);
    }
}