Skip to main content Link Search Menu Expand Document (external link)

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

<p>Lowest score: </p>

Data:

doc.Params["model"] = new {
    scores = new[] { 85, 92, 78, 95, 88 }
};

Output:

<p>Lowest score: 78</p>

Price Range

<p>Price range: $ - $</p>

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

<h3>Weekly Temperature Summary</h3>
<p>High: °F</p>
<p>Low: °F</p>
<p>Average: °F</p>

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


  <p>: Best , Worst , Average </p>

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

See Also