From 9b43a10fc8ea4e1e9965ee54b41ed7020180f403 Mon Sep 17 00:00:00 2001
From: Gabriel Caruso <carusogabriel34@gmail.com>
Date: Fri, 13 Oct 2017 18:44:42 -0300
Subject: [PATCH] Create carbon helper

Test carbon helper

StyleCI

Fix timezone from DateTime override if $tz wasn't passed to carbon func

Fix tests for PHP 7.1 and 7.2 fom Travis CI

Organize conditions to match existing helpers

Use Carbon constructor method instead of parse

Use $tz even if $datetime is null

Create carbon helper
---
 src/Illuminate/Foundation/helpers.php      | 26 ++++++++++++++
 tests/Foundation/FoundationHelpersTest.php | 40 ++++++++++++++++++++++
 2 files changed, 66 insertions(+)

diff --git a/src/Illuminate/Foundation/helpers.php b/src/Illuminate/Foundation/helpers.php
index 5734bafce24a..879fae8fc339 100644
--- a/src/Illuminate/Foundation/helpers.php
+++ b/src/Illuminate/Foundation/helpers.php
@@ -249,6 +249,32 @@ function cache()
     }
 }
 
+if (! function_exists('carbon')) {
+    /**
+     * Create a new Carbon instance for the given datetime or return a new instance.
+     *
+     * @param  \DateTime|string|null $datetime
+     * @param  \DateTimeZone|string|null $tz
+     * @return \Illuminate\Support\Carbon
+     */
+    function carbon($datetime = null, $tz = null)
+    {
+        if (is_null($datetime)) {
+            return new Carbon(null, $tz);
+        }
+
+        if ($datetime instanceof \DateTime) {
+            if (is_null($tz)) {
+                return Carbon::instance($datetime);
+            }
+
+            return Carbon::instance($datetime)->setTimezone($tz);
+        }
+
+        return new Carbon($datetime, $tz);
+    }
+}
+
 if (! function_exists('config')) {
     /**
      * Get / set the specified configuration value.
diff --git a/tests/Foundation/FoundationHelpersTest.php b/tests/Foundation/FoundationHelpersTest.php
index aefac13b3a88..fcd90fb086c5 100644
--- a/tests/Foundation/FoundationHelpersTest.php
+++ b/tests/Foundation/FoundationHelpersTest.php
@@ -3,6 +3,7 @@
 namespace Illuminate\Tests\Foundation;
 
 use Mockery as m;
+use Illuminate\Support\Carbon;
 use PHPUnit\Framework\TestCase;
 use Illuminate\Foundation\Application;
 
@@ -43,6 +44,45 @@ public function testCacheThrowsAnExceptionIfAnExpirationIsNotProvided()
         cache(['foo' => 'bar']);
     }
 
+    public function testCarbon()
+    {
+        // carbon()
+        $this->assertInstanceOf('Illuminate\Support\Carbon', carbon());
+
+        // carbon('string', 'timezone')
+        $this->assertEquals(13, carbon('2017-10-13 22:00:00')->day);
+        $this->assertEquals('2017', carbon('first day of october 2017')->year);
+        $this->assertFalse(carbon('today', 'America/Sao_Paulo')->utc);
+        $this->assertFalse(carbon(null, 'America/Sao_Paulo')->utc);
+
+        // carbon(\DateTime)
+        $this->assertEquals(
+            '22',
+            carbon(\DateTime::createFromFormat('Y-m-d H', '2017-10-13 22'))->hour
+        );
+        $this->assertFalse(
+            carbon(new \DateTime('now', new \DateTimeZone('America/Sao_Paulo')))->utc
+        );
+        $this->assertFalse(
+            carbon(new \DateTime('now'), new \DateTimeZone('America/Sao_Paulo'))->utc
+        );
+
+        // Carbon helpers
+        $this->assertEquals(Carbon::yesterday(), carbon()->yesterday());
+        $this->assertEquals(Carbon::tomorrow(), carbon()->tomorrow());
+
+        // Relative phrases
+        $this->assertEquals(
+            Carbon::now()->addMonth()->month, carbon('next month')->month
+        );
+
+        // Addition and Subtraction
+        $this->assertEquals(
+            Carbon::tomorrow()->addWeek(),
+            carbon()->tomorrow()->addWeek()
+        );
+    }
+
     public function testUnversionedElixir()
     {
         $file = 'unversioned.css';