HUGO
Menu
GitHub 90486 stars Mastodon

compare.Le

Reports whether the first argument is less than or equal to all of the subsequent arguments.
Syntax
compare.Le ARG1 ARG2 [ARG...]
Returns
bool
Alias
le

Usage

The compare.Le function reports whether the first argument is less than or equal to all of the subsequent arguments. Numbers are compared by value, regardless of type. You can also use this function to compare strings, boolean values, dates, and other comparable data types.

time.Time values are compared by the moment they represent, regardless of time zone. To compare date strings, such as custom date parameters in front matter, convert them with the time.AsTime function first.

Examples

{{ compare.Le 1 1 }} → true
{{ compare.Le 1 2 }} → true
{{ compare.Le 2 1 }} → false

{{ compare.Le 1 1 1 }} → true
{{ compare.Le 1 1 2 }} → true
{{ compare.Le 1 2 1 }} → true
{{ compare.Le 1 2 2 }} → true

{{ compare.Le 2 1 1 }} → false
{{ compare.Le 2 1 2 }} → false
{{ compare.Le 2 2 1 }} → false

Comparing numbers of different types:

{{ compare.Le 1 1.0 }} → true

Comparing other data types:

{{ compare.Le "ab" "a" }} → false
{{ compare.Le now (time "1964-12-30") }} → false
{{ compare.Le true false }} → false

Comparing the same moment in different time zones:

{{ $utc := time.AsTime "2023-07-19T17:42:36Z" }}
{{ $tokyo := $utc | time.In "Asia/Tokyo" }}
{{ compare.Le $utc $tokyo }} → true