PHPackages valksor/php-functions-date - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. valksor/php-functions-date ActiveLibrary valksor/php-functions-date ========================== A PHP library providing enhanced date and time manipulation functions with improved validation and formatting capabilities 01PHPCI passing Since Dec 28Pushed 3mo agoCompare [ Source](https://github.com/valksor/php-functions-date)[ Packagist](https://packagist.org/packages/valksor/php-functions-date)[ RSS](/packages/valksor-php-functions-date/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Valksor Functions: Date ======================= [](#valksor-functions-date) [![valksor](https://camo.githubusercontent.com/2af5a6a7e5f7da47cd0a924c8b00038f208f45f9b0d5be8d7a497a9808168187/68747470733a2f2f62616467656e2e6e65742f7374617469632f6f72672f76616c6b736f722f677265656e)](https://github.com/valksor)[![BSD-3-Clause](https://camo.githubusercontent.com/72547f8afb6b5ace804caebbf95c3bcbfc027ce9214777bc452f308f3165db01/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4253442d2d332d2d436c617573652d677265656e3f7374796c653d666c6174)](https://github.com/valksor/php-functions-date/blob/master/LICENSE)[![Coverage Status](https://camo.githubusercontent.com/f7c4f3bc800a02225022a9db52a72823d760eedb4375578f0d2b3d7a1b07e0a1/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f76616c6b736f722f7068702d66756e6374696f6e732d646174652f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/valksor/php-functions-date?branch=master)[![php](https://camo.githubusercontent.com/77da2f7bbc049873edb2d1045a756d7a32e3ba50440a8e0e76a9109f62f0771b/68747470733a2f2f62616467656e2e6e65742f7374617469632f7068702f2533453d382e342f707572706c65)](https://www.php.net/releases/8.4/en.php) A PHP library providing enhanced date and time manipulation functions with improved validation and formatting capabilities. Installation ------------ [](#installation) Install the package via Composer: ``` composer require valksor/php-functions-date ``` Requirements ------------ [](#requirements) PHP 8.4 or higher Usage ----- [](#usage) There are two ways to use this package: via the Functions class or by directly using the traits. ### Using the Functions Class [](#using-the-functions-class) The Functions class provides enhanced date and time manipulation functions with better validation and formatting capabilities. ``` use Valksor\Functions\Date\Functions; // Create a new Functions instance $date = new Functions(); // Format a date $formatted = $date->formatDate('2023-01-15', 'Y-m-d'); // Validate a date $isValid = $date->validateDate('15022023'); // Convert Excel date to regular date $excelDate = $date->excelDate(44941, 'd-m-Y'); // Convert Unix timestamp to formatted date $fromTimestamp = $date->fromUnixTimestamp(1673740800, 'd-m-Y H:i:s'); // Format time duration $formattedTime = $date->format(3665); // "1 hour 1 minute 5 seconds" ``` ### Using Traits Directly [](#using-traits-directly) Alternatively, you can use the traits directly in your own classes: ``` use Valksor\Functions\Date\Traits\_FormatDate; use Valksor\Functions\Date\Traits\_ValidateDate; use Valksor\Functions\Date\Traits\_ExcelDate; class MyClass { // Import the traits you need use _FormatDate; use _ValidateDate; use _ExcelDate; public function doSomething(): void { // Use the methods directly $formatted = $this->formatDate('2023-01-15', 'Y-m-d'); $isValid = $this->validateDate('15022023'); $excelDate = $this->excelDate(44941, 'd-m-Y'); } } ``` Note that some traits may depend on other helper traits or components. The Functions class handles these dependencies for you, but if you use the traits directly, you may need to include these helper traits as well. Features -------- [](#features) For a complete list of all functions available in this package, see [Features](docs/features.md). Testing ------- [](#testing) Run the test suite for Date functions: ``` # Run all Date function tests vendor/bin/phpunit tests/Functions/Date/ # Run tests with coverage vendor/bin/phpunit tests/Functions/Date/ --coverage-text # Run specific function tests vendor/bin/phpunit tests/Functions/Date/FunctionsTest.php vendor/bin/phpunit tests/Functions/Date/Traits/ ``` Contributing ------------ [](#contributing) Contributions are welcome! - Code style requirements (PSR-12) - Testing requirements for PRs - One feature per pull request - Development setup instructions To contribute to Date functions: 1. Fork the repository 2. Create a feature branch (`git checkout -b feature/new-date-function`) 3. Implement your function following existing patterns 4. Add comprehensive tests 5. Ensure all tests pass and code style is correct 6. Submit a pull request Security -------- [](#security) If you discover any security-related issues, please email us at instead of using the issue tracker. Support ------- [](#support) - **Documentation**: [Full documentation](https://github.com/valksor/php-valksor) - **Issues**: [GitHub Issues](https://github.com/valksor/php-valksor/issues) for bug reports and feature requests - **Discussions**: [GitHub Discussions](https://github.com/orgs/valksor/discussions/categories/php-valksor) for questions and community support Credits ------- [](#credits) - **[Original Author](https://github.com/valksor)** - Creator and maintainer - **[All Contributors](https://github.com/valksor/php-valksor/graphs/contributors)** - Thank you to all who contributed - **[PHP DateTime](https://www.php.net/manual/en/book.datetime.php)** - Core date functionality inspiration - **[Valksor Project](https://github.com/valksor)** - Part of the larger Valksor PHP ecosystem License ------- [](#license) This package is licensed under the [BSD-3-Clause License](LICENSE). About Valksor ------------- [](#about-valksor) This package is part of the [valksor/php-valksor](https://github.com/valksor/php-valksor) project - a comprehensive PHP library and Symfony bundle that provides a collection of utilities, components, and integrations for Symfony applications. The main project includes: - Various utility functions and components - Doctrine ORM tools and extensions - Symfony bundle for easy configuration - And much more If you find this Date component useful, you might want to check out the full Valksor project for additional tools and utilities that can enhance your Symfony application development. To install the complete package: ``` composer require valksor/php-valksor ``` ### Health Score 18 — LowBetter than 8% of packages Maintenance53 Moderate activity, may be stable Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity12 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/c4db85e32518c5a6caa2fd625032a2b016ef42d60cf8a101c165cc5c0048b221?d=identicon)[k0d3r1s](/maintainers/k0d3r1s) --- Top Contributors [![k0d3r1s](https://avatars.githubusercontent.com/u/38725938?v=4)](https://github.com/k0d3r1s "k0d3r1s (39 commits)") ### Embed Badge ![Health badge](/badges/valksor-php-functions-date/health.svg) ``` [![Health](https://phpackages.com/badges/valksor-php-functions-date/health.svg)](https://phpackages.com/packages/valksor-php-functions-date) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)