Added ability to manually set created at date

docs/basic-usage/logging-activity.md

@@ -74,6 +74,18 @@ $lastActivity->getExtraProperty('key'); //returns 'value'
 $lastActivity->where('properties->key', 'value')->get(); // get all activity where the `key` custom property is 'value'
 ```
 
+## Setting custom created date
+
+You can set a custom activity created_at date time by using `createdAt`
+
+```php
+activity()
+    ->causedBy($userModel)
+    ->performedOn($someContentModel)
+    ->createdAt(now()->subDays(10))
+    ->log('created')
+```
+
 ## Tap Activity before logged
 
 You can use the `tap()` method to fill properties and add custom fields before the activity is saved.

src/ActivityLogger.php

@@ -2,6 +2,9 @@
 
 namespace Spatie\Activitylog;
 
+use Spatie\String\Str;
+use Illuminate\Support\Arr;
+use Illuminate\Support\Carbon;
 use Illuminate\Auth\AuthManager;
 use Illuminate\Contracts\Config\Repository;
 use Illuminate\Database\Eloquent\Model;
@@ -104,6 +107,13 @@ public function withProperty(string $key, $value)
         return $this;
     }
 
+    public function createdAt(Carbon $dateTime)
+    {
+        $this->getActivity()->created_at = $dateTime;
+
+        return $this;
+    }
+
     public function useLog(string $logName)
     {
         $this->getActivity()->log_name = $logName;

tests/ActivityLoggerTest.php

@@ -323,4 +323,18 @@ public function it_can_log_activity_when_attributes_are_changed_with_tap()
         $this->assertEquals('value', $firstActivity->getExtraProperty('property.subProperty'));
         $this->assertEquals(Carbon::yesterday()->startOfDay()->format('Y-m-d H:i:s'), $firstActivity->created_at->format('Y-m-d H:i:s'));
     }
+
+    /** @test */
+    public function it_will_log_a_custom_created_at_date_time()
+    {
+        $activityDateTime = now()->subDays(10);
+
+        activity()
+            ->createdAt($activityDateTime)
+            ->log('created');
+
+        $firstActivity = Activity::first();
+
+        $this->assertEquals($activityDateTime->toAtomString(), $firstActivity->created_at->toAtomString());
+    }
 }