min() : Find Minimum Value
On this page
Summary
Find the minimum (smallest) value in a collection of numeric values.
Signature
min(collection)
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
collection |
Array of Numbers | Yes | The collection of numeric values |
Returns
Type: Number
The smallest value in the collection. Returns null for empty collections.
Examples
Simple Minimum
Data:
doc.Params["model"] = new {
scores = new[] { 85, 92, 78, 95, 88 }
};
Output:
<p>Lowest score: 78</p>
Price Range
Data:
doc.Params["model"] = new {
products = new[] {
new { name = "Widget A", price = 15.50 },
new { name = "Widget B", price = 22.00 },
new { name = "Widget C", price = 8.75 },
new { name = "Widget D", price = 31.25 }
}
};
Output:
<p>Price range: $8.75 - $31.25</p>
Temperature Analysis
Data:
doc.Params["model"] = new {
temperatures = new[] { 72, 68, 75, 70, 73, 69, 71 }
};
Output:
<h3>Weekly Temperature Summary</h3>
<p>High: 75°F</p>
<p>Low: 68°F</p>
<p>Average: 71.1°F</p>
Student Performance
Data:
doc.Params["model"] = new {
students = new[] {
new { name = "Alice", scores = new[] { 85, 90, 92, 88 } },
new { name = "Bob", scores = new[] { 78, 82, 88, 75 } },
new { name = "Charlie", scores = new[] { 95, 93, 97, 92 } }
}
};
Output:
<p>Alice: Best 92, Worst 85, Average 88.8</p>
<p>Bob: Best 88, Worst 75, Average 80.8</p>
<p>Charlie: Best 97, Worst 92, Average 94.2</p>
Notes
- Returns null for empty or null collections
- All items must be numeric
- Supports both integers and decimals
- For finding minimum of a property across objects, use with
collect():min(collect(items, 'price')) - For finding minimum property value, use
minOf()as shorthand - Useful for:
- Price ranges
- Performance metrics
- Quality control
- Temperature/measurement ranges
- Threshold calculations