updated docs, changelog and version

Author: ElhamAryanpur

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
 
+## [0.27.0](https://github.com/ArkForgeLabs/Astra/compare/v0.26.0..v0.27.0) - 2025-07-18
+
+### Features
+
+- [**breaking**] multiple of datetime creation methods was replaced by `Astra.datetime.new` - ([25e9c21](https://github.com/ArkForgeLabs/Astra/commit/25e9c21e86d5cdc8aa2bdfaa4e86aa7485b32a15))
+
 ## [0.26.0](https://github.com/ArkForgeLabs/Astra/compare/v0.25.1..v0.26.0) - 2025-07-17
 
 ### Bug Fixes

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "lua-astra"
-version = "0.26.0"
+version = "0.27.0"
 authors = ["Elham Aryanpur <elhamaryanpur5@gmail.com>"]
 description = "🔥 Blazingly Fast 🔥 web server runtime for Lua"
 documentation = "https://astra.arkforge.net/docs/latest"

Cargo.toml

@@ -1396,9 +1396,7 @@ <h1 id="async-tasks"><a class="header" href="#async-tasks">Async Tasks</a></h1>
 <h1 id="datetime"><a class="header" href="#datetime">DateTime</a></h1>
 <p>Astra provides date &amp; time functionality as an extension to the standard library. It is loosely inspired by the <a href="https://www.w3schools.com/jsref/jsref_obj_date.asp">JavaScript Date</a> implementation.</p>
 <pre><code class="language-lua">-- Returns a DateTime object which corresponds to the current date, time &amp; local offset from UTC.
-local dt = Astra.datetime.new_now()
--- or for UTC
-local dt = Astra.datetime.new_utc_now()
+local dt = Astra.datetime.new()
 
 -- Returns a DateTime object which corresponds to the provided date and/or time arguments &amp; local offset from UTC.
 -- You can provide the following arguments:
@@ -1412,9 +1410,10 @@ <h1 id="datetime"><a class="header" href="#datetime">DateTime</a></h1>
 --
 -- Providing the year is mandatory.
 -- The other values, if not provided, will default to the following in respective order: 1, 1, 0, 0, 0, 0
-local dt = Astra.datetime.new_from(2001, 7, 8, 0, 24, 48, 241)
--- or for UTC
-local dt = Astra.datetime.new_utc_from(2001, 7, 8, 0, 24, 48, 241)
+local dt = Astra.datetime.new(2001, 7, 8, 0, 24, 48, 241)
+
+-- Or parse a string
+local dt = Astra.datetime.new("Tue, 1 Jul 2003 10:52:37 +0200")
 </code></pre>
 <p>Available methods:</p>
 <ul>

docs/docs/latest/print.html

@@ -229,9 +229,7 @@ <h1 class="menu-title">ArkForge Astra</h1>
 <h1 id="datetime"><a class="header" href="#datetime">DateTime</a></h1>
 <p>Astra provides date &amp; time functionality as an extension to the standard library. It is loosely inspired by the <a href="https://www.w3schools.com/jsref/jsref_obj_date.asp">JavaScript Date</a> implementation.</p>
 <pre><code class="language-lua">-- Returns a DateTime object which corresponds to the current date, time &amp; local offset from UTC.
-local dt = Astra.datetime.new_now()
--- or for UTC
-local dt = Astra.datetime.new_utc_now()
+local dt = Astra.datetime.new()
 
 -- Returns a DateTime object which corresponds to the provided date and/or time arguments &amp; local offset from UTC.
 -- You can provide the following arguments:
@@ -245,9 +243,10 @@ <h1 id="datetime"><a class="header" href="#datetime">DateTime</a></h1>
 --
 -- Providing the year is mandatory.
 -- The other values, if not provided, will default to the following in respective order: 1, 1, 0, 0, 0, 0
-local dt = Astra.datetime.new_from(2001, 7, 8, 0, 24, 48, 241)
--- or for UTC
-local dt = Astra.datetime.new_utc_from(2001, 7, 8, 0, 24, 48, 241)
+local dt = Astra.datetime.new(2001, 7, 8, 0, 24, 48, 241)
+
+-- Or parse a string
+local dt = Astra.datetime.new("Tue, 1 Jul 2003 10:52:37 +0200")
 </code></pre>
 <p>Available methods:</p>
 <ul>

docs/docs/latest/searchindex.js

@@ -4,9 +4,7 @@ Astra provides date & time functionality as an extension to the standard library
 
 ```lua
 -- Returns a DateTime object which corresponds to the current date, time & local offset from UTC.
-local dt = Astra.datetime.new_now()
--- or for UTC
-local dt = Astra.datetime.new_utc_now()
+local dt = Astra.datetime.new()
 
 -- Returns a DateTime object which corresponds to the provided date and/or time arguments & local offset from UTC.
 -- You can provide the following arguments:
@@ -20,9 +18,10 @@ local dt = Astra.datetime.new_utc_now()
 --
 -- Providing the year is mandatory.
 -- The other values, if not provided, will default to the following in respective order: 1, 1, 0, 0, 0, 0
-local dt = Astra.datetime.new_from(2001, 7, 8, 0, 24, 48, 241)
--- or for UTC
-local dt = Astra.datetime.new_utc_from(2001, 7, 8, 0, 24, 48, 241)
+local dt = Astra.datetime.new(2001, 7, 8, 0, 24, 48, 241)
+
+-- Or parse a string
+local dt = Astra.datetime.new("Tue, 1 Jul 2003 10:52:37 +0200")
 ```
 
 Available methods: