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.
- Simple object wrapper around UNIX timestamps
- Supports numeric, string, and
DateTimeInterfaceinputs - Chainable time adjustment methods (
adjSec,adjMin,adjHour,adjDay,adjWeek) - Built-in helpers for quick usage (
now(),epoch()) - Lightweight — no external dependencies
Install via Composer:
composer require chaoswd/datetimeOr manually include the files in your project and autoload via PSR-4.
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| Method | Description |
|---|---|
__construct($value = null) |
Accepts timestamp, string, or DateTimeInterface. Defaults to current time. |
format(string $pattern = 'Y-m-d H:i:s') |
Returns formatted date/time string. |
copy() |
Returns a cloned DT instance. |
adjSec(int $adj) |
Adjusts seconds by ± value. |
adjMin(int $adj) |
Adjusts minutes by ± value. |
adjHour(int $adj) |
Adjusts hours by ± value. |
adjDay(int $adj) |
Adjusts days by ± value. |
adjWeek(int $adj) |
Adjusts weeks by ± value. |
Two optional global helper functions are included in src/helpers.php:
now(); // Returns Chaos\DT\DT::now()
epoch(); // Returns current UNIX timestampChaos Web Dev
https://github.com/ChaosWebDev
See CHANGELOG.md for version history.
This package is open-sourced software licensed under the MIT license.