Rating

On this page

A rating on its own scale: 4.5/5.

Use it for reviews and scores. It keeps its scale with it, so 4 of 5 and 8 of 10 aren't mixed up. For a plain percentage score, use Percentage.

Shape

Its parts keep these rules, and a value that breaks one fails with the rule's name:

example

Rating { value: 4.5 best: 5.0 worst: 1.0 }

best must be above worst, and value between them.
== tells you whether two are the same. < and list.sort_by don't take it, so sort by one of its parts instead.

An object of its parts, in a request, a response or json.write:

json

{"value":"4.5","best":"5","worst":"1"}{"value":"8","best":"10","worst":"0"}{"value":"92","best":"100","worst":"0"}

Text form, storage, how it is shown, and operations

Rating is in the group Commerce and logistics, and has been in Jadpo since 0.1.0.

It has no single text form, so text.from and text.parse don't take it.

It is stored in 3 columns, each named for the field, _ and its suffix. This is {"value":"92","best":"100","worst":"0"}:

text.format(value, locale:) shows it to people in their locale.

With locale: Locale.en_gb:

It also takes text.format, json.read, json.write and ==. How every standard type behaves says how they work.

Markdown for agents: /docs/types/type-rating.md.Built from Jadpo main at aee2e8f.