Add -MergedAfter / -MergedBefore to Get-GitlabMergeRequest

GitLab's REST API has no server-side merge-date filter, so the new
parameters apply a client-side filter on MergedAt after the listing
call returns. Bare dates (YYYY-MM-DD) are interpreted as whole-day
inclusive for parity with GitHub's `merged:` search qualifier:
`-MergedBefore 2026-04-21` includes MRs merged any time that day.

Enables year-to-date delivery analytics that filter on merge timing
independent of state, matching the capability pwsh-github added in
0.9.0.

Author: chris-peterson

docs/MergeRequests/Get-GitlabMergeRequest.md

@@ -4,7 +4,7 @@ external help file: GitlabCli-Help.xml
 HelpUri: https://chris-peterson.github.io/pwsh-gitlab/#/MergeRequests/Get-GitlabMergeRequest
 Locale: en-US
 Module Name: GitlabCli
-ms.date: 04/07/2026
+ms.date: 04/21/2026
 PlatyPS schema version: 2024-05-01
 title: Get-GitlabMergeRequest
 ---
@@ -21,47 +21,50 @@ Retrieves merge requests from GitLab.
 
 ```
 Get-GitlabMergeRequest [[-MergeRequestId] <string>] [-ProjectId <string>] [-State <string>]
- [-CreatedAfter <string>] [-CreatedBefore <string>] [-IsDraft <bool>] [-SourceBranch <string>]
- [-TargetBranch <string>] [-IncludeChangeSummary] [-IncludeDiffs] [-IncludeApprovals]
- [-ReviewerUsername <string>] [-Scope <string>] [-MaxPages <uint>] [-All] [-SiteUrl <string>]
- [<CommonParameters>]
+ [-CreatedAfter <string>] [-CreatedBefore <string>] [-MergedAfter <string>] [-MergedBefore <string>]
+ [-IsDraft <bool>] [-SourceBranch <string>] [-TargetBranch <string>] [-IncludeChangeSummary]
+ [-IncludeDiffs] [-IncludeApprovals] [-ReviewerUsername <string>] [-Scope <string>]
+ [-MaxPages <uint>] [-All] [-SiteUrl <string>] [<CommonParameters>]
 ```
 
 ### ByGroupId
 
 ```
 Get-GitlabMergeRequest [-GroupId] <string> [-State <string>] [-CreatedAfter <string>]
- [-CreatedBefore <string>] [-IsDraft <bool>] [-SourceBranch <string>] [-TargetBranch <string>]
- [-IncludeChangeSummary] [-IncludeDiffs] [-IncludeApprovals] [-ReviewerUsername <string>]
- [-Scope <string>] [-MaxPages <uint>] [-All] [-SiteUrl <string>] [<CommonParameters>]
+ [-CreatedBefore <string>] [-MergedAfter <string>] [-MergedBefore <string>] [-IsDraft <bool>]
+ [-SourceBranch <string>] [-TargetBranch <string>] [-IncludeChangeSummary] [-IncludeDiffs]
+ [-IncludeApprovals] [-ReviewerUsername <string>] [-Scope <string>] [-MaxPages <uint>] [-All]
+ [-SiteUrl <string>] [<CommonParameters>]
 ```
 
 ### ByUrl
 
 ```
 Get-GitlabMergeRequest [-Url] <string> [-State <string>] [-CreatedAfter <string>]
- [-CreatedBefore <string>] [-IsDraft <bool>] [-SourceBranch <string>] [-TargetBranch <string>]
- [-IncludeChangeSummary] [-IncludeDiffs] [-IncludeApprovals] [-ReviewerUsername <string>]
- [-Scope <string>] [-MaxPages <uint>] [-All] [-SiteUrl <string>] [<CommonParameters>]
+ [-CreatedBefore <string>] [-MergedAfter <string>] [-MergedBefore <string>] [-IsDraft <bool>]
+ [-SourceBranch <string>] [-TargetBranch <string>] [-IncludeChangeSummary] [-IncludeDiffs]
+ [-IncludeApprovals] [-ReviewerUsername <string>] [-Scope <string>] [-MaxPages <uint>] [-All]
+ [-SiteUrl <string>] [<CommonParameters>]
 ```
 
 ### ByUser
 
 ```
 Get-GitlabMergeRequest [-State <string>] [-CreatedAfter <string>] [-CreatedBefore <string>]
- [-IsDraft <bool>] [-SourceBranch <string>] [-TargetBranch <string>] [-IncludeChangeSummary]
- [-IncludeDiffs] [-IncludeApprovals] [-Username <string>] [-Role <string>]
- [-ReviewerUsername <string>] [-Scope <string>] [-MaxPages <uint>] [-All] [-SiteUrl <string>]
- [<CommonParameters>]
+ [-MergedAfter <string>] [-MergedBefore <string>] [-IsDraft <bool>] [-SourceBranch <string>]
+ [-TargetBranch <string>] [-IncludeChangeSummary] [-IncludeDiffs] [-IncludeApprovals]
+ [-Username <string>] [-Role <string>] [-ReviewerUsername <string>] [-Scope <string>]
+ [-MaxPages <uint>] [-All] [-SiteUrl <string>] [<CommonParameters>]
 ```
 
 ### Mine
 
 ```
 Get-GitlabMergeRequest [-State <string>] [-CreatedAfter <string>] [-CreatedBefore <string>]
- [-IsDraft <bool>] [-SourceBranch <string>] [-TargetBranch <string>] [-IncludeChangeSummary]
- [-IncludeDiffs] [-IncludeApprovals] [-ReviewerUsername <string>] [-Mine] [-Scope <string>]
- [-MaxPages <uint>] [-All] [-SiteUrl <string>] [<CommonParameters>]
+ [-MergedAfter <string>] [-MergedBefore <string>] [-IsDraft <bool>] [-SourceBranch <string>]
+ [-TargetBranch <string>] [-IncludeChangeSummary] [-IncludeDiffs] [-IncludeApprovals]
+ [-ReviewerUsername <string>] [-Mine] [-Scope <string>] [-MaxPages <uint>] [-All]
+ [-SiteUrl <string>] [<CommonParameters>]
 ```
 
 ## ALIASES
@@ -309,6 +312,48 @@ AcceptedValues: []
 HelpMessage: ''
 ```
 
+### -MergedAfter
+
+Filter merge requests merged on or after this date (client-side). Accepts a bare date (YYYY-MM-DD) or a full ISO timestamp. Bare dates are interpreted as start-of-day.
+
+```yaml
+Type: System.String
+DefaultValue: ''
+SupportsWildcards: false
+Aliases: []
+ParameterSets:
+- Name: (All)
+  Position: Named
+  IsRequired: false
+  ValueFromPipeline: false
+  ValueFromPipelineByPropertyName: false
+  ValueFromRemainingArguments: false
+DontShow: false
+AcceptedValues: []
+HelpMessage: ''
+```
+
+### -MergedBefore
+
+Filter merge requests merged on or before this date (client-side). Accepts a bare date (YYYY-MM-DD) or a full ISO timestamp. Bare dates are interpreted as end-of-day, matching the inclusive semantics of GitHub's `merged:` search qualifier.
+
+```yaml
+Type: System.String
+DefaultValue: ''
+SupportsWildcards: false
+Aliases: []
+ParameterSets:
+- Name: (All)
+  Position: Named
+  IsRequired: false
+  ValueFromPipeline: false
+  ValueFromPipelineByPropertyName: false
+  ValueFromRemainingArguments: false
+DontShow: false
+AcceptedValues: []
+HelpMessage: ''
+```
+
 ### -MergeRequestId
 
 The internal ID of a specific merge request to retrieve. Alias: Id.

src/GitlabCli/GitlabCli.psd1

@@ -1,5 +1,5 @@
 @{
-    ModuleVersion = '1.170.1'
+    ModuleVersion = '1.171.0'
 
     RequiredModules = @(
         @{
@@ -31,9 +31,10 @@
             )
             ReleaseNotes =
 @'
-### Fixes
-- `Get-GitlabMergeRequest` no longer requires being inside a git repo
-  when querying globally (e.g. `-ReviewerUsername` without `-ProjectId`)
+### Features
+- `Get-GitlabMergeRequest` gains `-MergedAfter` / `-MergedBefore`
+  for filtering by merge date. Bare dates are whole-day inclusive,
+  matching the semantics of GitHub's `merged:` search qualifier.
 '@
         }
     }

src/GitlabCli/MergeRequests.psm1

@@ -33,6 +33,14 @@ function Get-GitlabMergeRequest {
         [GitlabDate()][string]
         $CreatedBefore,
 
+        [Parameter()]
+        [string]
+        $MergedAfter,
+
+        [Parameter()]
+        [string]
+        $MergedBefore,
+
         [TrueOrFalse()][bool]
         $IsDraft,
 
@@ -179,6 +187,25 @@ function Get-GitlabMergeRequest {
         }
     }
 
+    # GitLab's REST API has no merged-date filter, so apply client-side.
+    # Bare dates are interpreted as whole days for parity with GitHub's `merged:`
+    # qualifier: -MergedAfter '2026-01-01' includes MRs merged any time that day;
+    # -MergedBefore '2026-04-21' includes MRs merged any time that day.
+    if ($MergedAfter -or $MergedBefore) {
+        $MergedAfterDate = if ($MergedAfter) { [datetime]$MergedAfter } else { $null }
+        $MergedBeforeDate = if ($MergedBefore) {
+            $d = [datetime]$MergedBefore
+            if ($MergedBefore -notmatch 'T') { $d.AddDays(1).AddTicks(-1) } else { $d }
+        } else { $null }
+        $MergeRequests = $MergeRequests | Where-Object {
+            if (-not $_.MergedAt) { return $false }
+            $MergedAt = [datetime]$_.MergedAt
+            if ($MergedAfterDate  -and $MergedAt -lt $MergedAfterDate)  { return $false }
+            if ($MergedBeforeDate -and $MergedAt -gt $MergedBeforeDate) { return $false }
+            $true
+        }
+    }
+
     $MergeRequests | Sort-Object ProjectPath
 }
 

tests/Get-GitlabMergeRequest.Tests.ps1

@@ -183,4 +183,60 @@ Describe "Get-GitlabMergeRequest" {
             }
         }
     }
+
+    Context "-MergedAfter / -MergedBefore" {
+        It "Should filter MRs merged before the MergedAfter cutoff" {
+            Mock -CommandName Invoke-GitlabApi -ModuleName $TestModuleName -MockWith {
+                @(
+                    [PSCustomObject]@{ MergedAt = '2023-06-15T00:00:00Z'; ProjectPath = 'p' },
+                    [PSCustomObject]@{ MergedAt = '2024-06-15T00:00:00Z'; ProjectPath = 'p' }
+                )
+            }
+
+            $result = Get-GitlabMergeRequest -Mine -MergedAfter '2024-01-01'
+
+            $result.Count | Should -Be 1
+            $result[0].MergedAt | Should -Be '2024-06-15T00:00:00Z'
+        }
+
+        It "Should filter MRs merged after the MergedBefore cutoff" {
+            Mock -CommandName Invoke-GitlabApi -ModuleName $TestModuleName -MockWith {
+                @(
+                    [PSCustomObject]@{ MergedAt = '2024-06-15T00:00:00Z'; ProjectPath = 'p' },
+                    [PSCustomObject]@{ MergedAt = '2025-06-15T00:00:00Z'; ProjectPath = 'p' }
+                )
+            }
+
+            $result = Get-GitlabMergeRequest -Mine -MergedBefore '2024-12-31'
+
+            $result.Count | Should -Be 1
+            $result[0].MergedAt | Should -Be '2024-06-15T00:00:00Z'
+        }
+
+        It "Should treat bare-date MergedBefore as whole-day inclusive" {
+            Mock -CommandName Invoke-GitlabApi -ModuleName $TestModuleName -MockWith {
+                @(
+                    [PSCustomObject]@{ MergedAt = '2024-12-31T23:30:00Z'; ProjectPath = 'p' }
+                )
+            }
+
+            $result = Get-GitlabMergeRequest -Mine -MergedBefore '2024-12-31'
+
+            $result.Count | Should -Be 1
+        }
+
+        It "Should exclude unmerged MRs when MergedAfter is set" {
+            Mock -CommandName Invoke-GitlabApi -ModuleName $TestModuleName -MockWith {
+                @(
+                    [PSCustomObject]@{ MergedAt = $null; ProjectPath = 'p' },
+                    [PSCustomObject]@{ MergedAt = '2024-06-15T00:00:00Z'; ProjectPath = 'p' }
+                )
+            }
+
+            $result = Get-GitlabMergeRequest -Mine -MergedAfter '2024-01-01'
+
+            $result.Count | Should -Be 1
+            $result[0].MergedAt | Should -Be '2024-06-15T00:00:00Z'
+        }
+    }
 }