From afaad38a7cd2dc3859398cdda76c2de5f2b0adad Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Danijel=20Gali=C4=87?= Date: Tue, 17 Nov 2026 15:27:40 +0100 Subject: [PATCH 1/2] Update DateTime methods to reference native timezone retrieval --- CHANGELOG.md | 5 +++++ README.md | 2 +- src/Temporal/DateTime.php | 8 +++++--- 3 files changed, 11 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 69bd54e..cecd0e2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +# [[v0.4.1](https://github.com/The-FireHub-Project/Foundation/compare/v0.4.0...v0.4.1)] – 2026-11-17 + +### Added +* Update DateTime methods to reference native timezone retrieval by @dieselxxx + # [[v0.4.0](https://github.com/The-FireHub-Project/Foundation/compare/v0.3.0...v0.4.0)] – 2026-11-17 ### Added diff --git a/README.md b/README.md index 304f729..26145e5 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ /> version diff --git a/src/Temporal/DateTime.php b/src/Temporal/DateTime.php index fc972f1..6fd86f6 100644 --- a/src/Temporal/DateTime.php +++ b/src/Temporal/DateTime.php @@ -217,8 +217,8 @@ public function format (string|Token $format):string { * * @since 1.0.0 * - * @uses \FireHub\Foundation\Temporal\DateTime::from() To create a new DateTime instance with the specified timezone. - * @uses \FireHub\Foundation\Temporal\DateTime::value() To get the raw value of the DateTime instance. + * @uses \FireHub\Foundation\Temporal\NamedTimezone::native() To get the native timezone. + * @uses \FireHub\Foundation\Temporal\FixedTimezone::native() To get the native timezone. * * @param TimezoneType $timezone

* The timezone to set. @@ -234,7 +234,9 @@ public function format (string|Token $format):string { public function withTimezone (NamedTimezone|FixedTimezone $timezone):static { /** @var static */ - return self::from($this->value(), $timezone); + return new static( + $this->value->setTimezone($timezone->native()) + ); } From 092f42456819a2dd2aad6ed1d462f1824ff347a7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Danijel=20Gali=C4=87?= <56673130+dieselxxx@users.noreply.github.com> Date: Tue, 17 Nov 2026 15:28:40 +0100 Subject: [PATCH 2/2] Update README.md --- README.md | 126 +++++++++++++++++++++++++++++++++++------------------- 1 file changed, 83 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index 26145e5..8d933d6 100644 --- a/README.md +++ b/README.md @@ -17,79 +17,119 @@ /> GitHub license -[![PHPStan](https://github.com/The-FireHub-Project/Foundation/actions/workflows/PHPStan.yml/badge.svg?branch=develop)](https://github.com/The-FireHub-Project/Foundation/actions/workflows/PHPStan.yml) -[![PHPUnit](https://github.com/The-FireHub-Project/Foundation/actions/workflows/PHPUnit.yml/badge.svg?branch=develop)](https://github.com/The-FireHub-Project/Foundation/actions/workflows/PHPUnit.yml) -[![Codecov](https://codecov.io/gh/The-FireHub-Project/Foundation/branch/develop/graph/badge.svg?token=XW2YEONF51)](https://app.codecov.io/gh/The-FireHub-Project/Foundation/tree/develop) -

- + + GitHub created at + GitHub last commit (branch) - + GitHub activity (branch) - + + GitHub contributors + + GitHub language count + + GitHub top language + GitHub commit difference between two branches + + GitHub code size

-The essential PHP core for building domain-driven, clean architecture applications. -Standard provides the base classes, kernel, domain layer, and minimal runtime utilities needed to start any FireHub project. +Provides the high-level foundation layer of the FireHub ecosystem. This repository contains developer-focused APIs and reusable building blocks that simplify common programming tasks while maintaining consistency, type safety, and architectural principles across FireHub applications. + +The Foundation layer is built on top of the Runtime layer and transforms low-level execution primitives into expressive object-oriented APIs. It provides commonly used components such as string manipulation, date and time handling, mathematical utilities, and other essential application-level abstractions. + +This repository represents the developer-facing layer between the FireHub Runtime and application code, enabling clean, readable, and maintainable PHP development. --- -## FireHub Icon Development Branch +## FireHub Icon Repository Purpose + +FireHub Foundation is the high-level developer API layer of the FireHub ecosystem. + +Built on top of FireHub Runtime, it provides expressive, object-oriented abstractions for common programming tasks. The purpose of this layer is to expose simple, consistent, and powerful APIs while hiding low-level implementation details. -⚠️ **This is the `develop` branch** +Foundation contains reusable building blocks such as: -- Unstable -- APIs may change without notice -- Not intended for production use +- String manipulation APIs +- Date and time handling +- Mathematical utilities +- Common application-level abstractions +- Developer-oriented helper objects -## FireHub Icon Branch Purpose +The Foundation layer follows the FireHub architectural principles by separating responsibilities between definition, execution, and usage: -The `develop` branch is the **primary integration branch** for all ongoing development. +## FireHub Icon Security -It serves as the staging area where: -- Feature branches are merged -- Bug fixes are integrated -- Experimental work is stabilized -- Code is prepared for upcoming releases +For security reporting and guidelines, please refer to our [SECURITY.md](https://github.com/The-FireHub-Project/.github/blob/master/.github/SECURITY.md) file. -All **release branches** are created **from `develop`**. +## FireHub Icon Community -## Stability Guarantee +![GitHub watchers](https://img.shields.io/github/watchers/The-FireHub-Project/Foundation?style=social) +![GitHub Repo stars](https://img.shields.io/github/stars/The-FireHub-Project/Foundation?style=social) +![GitHub forks](https://img.shields.io/github/forks/The-FireHub-Project/Foundation?style=social) -❌ No backward compatibility guarantee -❌ APIs may change without notice -❌ Behavior may be incomplete or inconsistent -❌ Breaking changes are expected +- Be sure to review the [Code of Conduct](https://github.com/The-FireHub-Project/.github/blob/master/.github/CODE_OF_CONDUCT.md). +- Read a [Contributing](https://github.com/The-FireHub-Project/.github/blob/master/.github/CONTRIBUTING.md) file to see how you can contribute to this project. +- Read our [Security policy](https://github.com/The-FireHub-Project/.github/blob/master/.github/SECURITY.md) file to see how you can report a vulnerability. +- Review the project [Governance model](https://github.com/The-FireHub-Project/.github/blob/master/.github/GOVERNANCE.md), including roles, decision-making, RFC process, and releases. -This branch is intended **only for contributors and advanced testers**. +## FireHub Icon Support -## FireHub Icon Composer Usage (Not Recommended) +

+ + GitHub in-progress issues + + GitHub total issues + + GitHub opened pull requests +

-For internal testing only: +For help with FireHub products, please refer to the following resources: -```json -{ - "require": { - "the-firehub-project/foundation": "dev-develop" - } -} -``` -⚠️ Never use dev-develop in production. +- **General questions & discussions**: [GitHub Discussions](https://github.com/orgs/The-FireHub-Project/discussions) +- **Bug reports & issues**: [Support](https://github.com/The-FireHub-Project/Foundation/issues) +- **Documentation & guides**: [FireHub Docs](https://the-firehub-project.github.io) +- **Commercial support** (Pro/Enterprise): contact your account manager ## FireHub Icon Authors and Contributors