⚡ features: add carbon extension feature with mixin.

README.md

@@ -65,6 +65,47 @@ The following format specifiers are supported for formatting dates:
 - `l` - Day in full name (Sunday-Saturday/आइतबार-शनिबार)
 - `S` - Day in two letters (st, nd, rd, th)
 
+## Extending Carbon with NepaliDateMixin
+In order to use the `toNepaliDate` and `toEnglishDate` mixin on Carbon instances, you need to register the `NepaliDateMixin` mixin in your Laravel service provider.
+
+You can do so by adding the following code to your `AppServiceProvider`
+```php
+<?php
+
+use Anuzpandey\LaravelNepaliDate\NepaliDateMixin;
+use Carbon\Carbon;
+use Illuminate\Support\ServiceProvider;
+
+class AppServiceProvider extends ServiceProvider
+{
+    public function boot(): void
+    {
+        // Register the NepaliDateMixin
+        Carbon::mixin(new NepaliDateMixin());
+    }
+}
+```
+
+Or create your own service provider with `php artisan make:provider MacroableServiceProvider`,
+register it in `config/app.php` and add the following code to the `boot` method.
+```php
+<?php
+
+use Anuzpandey\LaravelNepaliDate\NepaliDateMixin;
+use Carbon\Carbon;
+use Illuminate\Support\ServiceProvider;
+
+class MacroableServiceProvider extends ServiceProvider
+{
+    public function boot(): void
+    {
+        // Register the NepaliDateMixin
+        Carbon::mixin(new NepaliDateMixin());
+    }
+}
+```
+
+
 ## Testing
 
 ```bash

src/Mixin/NepaliDateMixin.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Anuzpandey\LaravelNepaliDate\Mixin;
+
+use Anuzpandey\LaravelNepaliDate\LaravelNepaliDate;
+use Carbon\Carbon;
+use Closure;
+
+/**
+ * @mixin Carbon
+ */
+class NepaliDateMixin
+{
+
+    public function toNepaliDate(): Closure
+    {
+        return function (?string $format = 'Y-m-d', ?string $locale = 'np') {
+            $date = $this->toDateString();
+
+            return LaravelNepaliDate::from($date)->toNepaliDate($format, $locale);
+        };
+    }
+
+
+    public function toEnglishDate(): Closure
+    {
+        return function (?string $format = 'Y-m-d', ?string $locale = 'en') {
+            $date = $this->toDateString();
+
+            return LaravelNepaliDate::from($date)->toEnglishDate($format, $locale);
+        };
+    }
+
+}

src/Traits/EnglishDateTrait.php

@@ -62,7 +62,7 @@ trait EnglishDateTrait
     ];
 
 
-    public function toEnglishDate(?string $format = NULL, ?string $locale = 'en'): string
+    public function toEnglishDate(string $format = 'Y-m-d', string $locale = 'en'): string
     {
         if ($format) {
             return $this->toFormattedEnglishDate($format, $locale);

src/Traits/NepaliDateTrait.php

@@ -63,7 +63,7 @@ trait NepaliDateTrait
     ];
 
 
-    public function toNepaliDate(?string $format = NULL, ?string $locale = 'np'): string
+    public function toNepaliDate(string $format = 'Y-m-d', string $locale = 'np'): string
     {
         if ($format) {
             return $this->toFormattedNepaliDate($format, $locale);