Number
A Number property holds one number, such as a distance, a weight, a price or a rating.
Example: in Workouts, “Distance” is a Number with the unit km and 1 decimal. The entry
“Morning run” has Distance 5.2, shown as 5.2 km.
Formats
The format says what the number means. The stored value is always a number.
| Format | Shows as | Example |
|---|---|---|
| Plain (default) | the number, with its unit | 5.2 km |
| Percent | the number with a % sign | 85 % |
| Currency | the number with a currency sign | €12.50 |
| Duration | hours and minutes | 1 h 45 min |
Settings
| Setting | What it does | Example |
|---|---|---|
| Name | The name you see. | Distance |
| Format | Plain, Percent, Currency or Duration. | Plain |
| Unit | A word shown after the number. | km, kg, pages |
| Decimals | How many digits show after the point. | 1 |
| Display | Figure, Stars or Slider (see below). | Figure |
The list of currencies, the slider’s range and the highest number of stars are not decided yet.
Displays
The display changes only how the number shows and how you edit it.
| Display | Looks like | Good for |
|---|---|---|
| Figure | the number, for example 5.2 km; a card can show it as a big figure | distances, weights, prices |
| Stars | a row of symbols; you tap one to set the value | a book rating of 4 |
| Slider | a bar with a handle you drag | Mood from 1 to 10 |
How it shows
| Place | Shows |
|---|---|
| Card | the figure, the stars or the slider, as the card design says |
| List and table row | the figure with its unit; tables can total a column |
| Entry page | the standard number editor for its display |
In the folder
The value is one line in the frontmatter, as a plain number. The unit is a setting of the property, so it is not written next to each value.
---title: Morning rundistance: 5.2---How a Duration value is written in the file is not decided yet.
AI, formulas and search
- AI reads the number with its unit, under the collection’s AI setting.
- Formulas read it as a number:
round(prop("Distance") / prop("Hours"), 1). A Duration reads as a duration and counts in minutes. - Views filter, sort and total by it.
- Not for GPS runs. A run’s Distance, Time and Pace are Formulas that read its Route, so they update while you run. See Record a GPS run.