🚀 [Feature]: Add Get-CurrentDateTime function

src/functions/public/Get-CurrentDateTime.ps1

@@ -0,0 +1,60 @@
+function Get-CurrentDateTime {
+    <#
+        .SYNOPSIS
+        Returns the current date and time in a specified format.
+
+        .DESCRIPTION
+        Returns the current date and time formatted according to the specified format string.
+        Supports common format presets or custom format strings.
+
+        .EXAMPLE
+        Get-CurrentDateTime
+
+        Returns the current date and time in the default format (yyyy-MM-dd HH:mm:ss).
+
+        .EXAMPLE
+        Get-CurrentDateTime -Format 'Short'
+
+        Returns the current date in short date format.
+
+        .EXAMPLE
+        Get-CurrentDateTime -Format 'Custom' -CustomFormat 'dddd, MMMM dd, yyyy'
+
+        Returns the current date in a custom format like "Monday, January 20, 2026".
+
+        .LINK
+        https://MariusStorhaug.github.io/MariusTestModule/Functions/Get-CurrentDateTime/
+    #>
+    [OutputType([string])]
+    [CmdletBinding()]
+    param (
+        # The format preset to use for the date and time output.
+        [Parameter()]
+        [ValidateSet('Default', 'Short', 'Long', 'ISO8601', 'Custom')]
+        [string] $Format = 'Default',
+
+        # Custom format string when Format is set to 'Custom'.
+        [Parameter()]
+        [string] $CustomFormat = 'yyyy-MM-dd HH:mm:ss'
+    )
+
+    $currentDateTime = Get-Date
+
+    switch ($Format) {
+        'Default' {
+            $currentDateTime.ToString('yyyy-MM-dd HH:mm:ss')
+        }
+        'Short' {
+            $currentDateTime.ToShortDateString()
+        }
+        'Long' {
+            $currentDateTime.ToLongDateString()
+        }
+        'ISO8601' {
+            $currentDateTime.ToString('o')
+        }
+        'Custom' {
+            $currentDateTime.ToString($CustomFormat)
+        }
+    }
+}

tests/PSModuleTest.Tests.ps1

@@ -21,4 +21,29 @@ Describe 'Module' {
     It 'Function: Get-Greeting - Evening' {
         Get-Greeting -TimeOfDay 'Evening' | Should -Be 'Good Evening!'
     }
+
+    It 'Function: Get-CurrentDateTime - Default format' {
+        $result = Get-CurrentDateTime
+        $result | Should -Match '^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$'
+    }
+
+    It 'Function: Get-CurrentDateTime - ISO8601 format' {
+        $result = Get-CurrentDateTime -Format 'ISO8601'
+        $result | Should -Match '^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}'
+    }
+
+    It 'Function: Get-CurrentDateTime - Custom format' {
+        $result = Get-CurrentDateTime -Format 'Custom' -CustomFormat 'yyyy'
+        $result | Should -Be (Get-Date).ToString('yyyy')
+    }
+
+    It 'Function: Get-CurrentDateTime - Short format' {
+        $result = Get-CurrentDateTime -Format 'Short'
+        $result | Should -Not -BeNullOrEmpty
+    }
+
+    It 'Function: Get-CurrentDateTime - Long format' {
+        $result = Get-CurrentDateTime -Format 'Long'
+        $result | Should -Not -BeNullOrEmpty
+    }
 }