Merge pull request #8439 from RakeshJesadiya/datetime-library

Add Datetime Library

Author: dobooth

src/_data/toc/php-developer-guide.yml

@@ -251,34 +251,39 @@ pages:
 
     - label: Configuration
       children:
-        - label: Sensitive Environment Settings
-          url: /extension-dev-guide/configuration/sensitive-and-environment-settings.html
 
         - label: Configuration Importers
           url: /extension-dev-guide/configuration/importers.html
 
+        - label: Sensitive Environment Settings
+          url: /extension-dev-guide/configuration/sensitive-and-environment-settings.html
+
     - label: Framework
       children:
-        - label: Serialize Library
-          url: /extension-dev-guide/framework/serializer.html
 
         - label: Array Manager
           url: /extension-dev-guide/framework/array-manager.html
 
+        - label: DateTime Library
+          url: /extension-dev-guide/framework/datetime.html
+
+        - label: Serialize Library
+          url: /extension-dev-guide/framework/serializer.html
+
         - label: URL Library
           url: /extension-dev-guide/framework/url-library.html
 
     - label: Security
       children:
 
-        - label: XSS Prevention
-          url: /extension-dev-guide/xss-protection.html
+        - label: Content Security Policies
+          url: /extension-dev-guide/security/content-security-policies.html
 
         - label: Non-secure functions
           url: /extension-dev-guide/security/non-secure-functions.html
 
-        - label: Content Security Policies
-          url: /extension-dev-guide/security/content-security-policies.html
+        - label: XSS Prevention
+          url: /extension-dev-guide/xss-protection.html
 
     - label: Versioning
       url: /extension-dev-guide/versioning/

src/guides/v2.3/extension-dev-guide/framework/datetime.md

@@ -0,0 +1,52 @@
+---
+group: php-developer-guide
+title: DateTime library
+contributor_name: Rakesh Jesadiya
+contributor_link: https://github.com/RakeshJesadiya
+---
+
+This DateTime library provides utilities to work with date and time formatting. Provided methods in this library are described below.
+
+## Usage
+
+|Method|Description|
+|--- |--- |
+| `formatDate` | Format the date to the Magento internal format |
+| `isEmptyDate` | Check whether provided date value is empty or null |
+
+### Example
+
+The following example shows how to format the current date and time into the Magento internal format.
+
+```php
+<?php
+
+use Magento\Framework\Stdlib\DateTime;
+
+...
+    /**
+     * @var DateTime
+     */
+    private $dateTime;
+
+    /**
+     * SomeClass constructor.
+     *
+     * @param DateTime $dateTime
+     */
+    public function __construct(DateTime $dateTime)
+    {
+        $this->dateTime = $dateTime;
+    }
+
+    /**
+     * display current date to internal format time zone
+     *
+     * @return string
+     */
+    public function getFormatDate(): string
+    {        
+    return $this->dataTime->formatDate(time());
+    }
+
+...

src/guides/v2.4/extension-dev-guide/framework/datetime.md

@@ -0,0 +1 @@
+../../../v2.3/extension-dev-guide/framework/datetime.md