README

Lightweight PHP DateTime utility library providing a simple, chainable interface for timestamp manipulation and formatting.
Designed as a minimal alternative to Carbon\Carbon, it allows quick date/time operations without dependencies.

🕓 Features

• Simple object wrapper around UNIX timestamps
• Supports numeric, string, and DateTimeInterface inputs
• Chainable time adjustment methods (adjSec, adjMin, adjHour, adjDay, adjWeek)
• Built-in helpers for quick usage (now(), epoch())
• Lightweight — no external dependencies

📦 Installation

Install via Composer:

composer require chaoswd/datetime

Or manually include the files in your project and autoload via PSR-4.

🚀 Usage

use Chaos\DT\DT;

$now = DT::now();
echo $now->format(); // 2025-10-20 12:00:00

// Adjust the date/time
$nextDay = $now->copy()->adjDay(1)->format('Y-m-d');
echo $nextDay; // 2025-10-21

// Built-in helper functions
echo now()->adjHour(2)->format('H:i:s');
echo epoch(); // 1730000000 || Current Epoch timestamp

⚙️ Methods

🧩 Helpers

Two optional global helper functions are included in src/helpers.php:

now();   // Returns Chaos\DT\DT::now()
epoch(); // Returns current UNIX timestamp

🧑‍💻 Author

Chaos Web Dev
https://github.com/ChaosWebDev

Changelog

See CHANGELOG.md for version history.

License

This package is open-sourced software licensed under the MIT license.