run-pace

Calculate running pace, time or length by providing the other two.

Interactive demo: https://daghall.github.io/run-pace/

Table of contents

• CLI
  • Installation
  • Usage
• Node module
  • Installation
  • Usage
    • Methods
      • calculateLength
        • Example
      • calculateTime
        • Example
      • calculatePace
        • Example
  • Parameters in detail
    • Time
      • [[dd:][hh:]mm:ss
        • Examples
      • X<d>Y<h>Z<m>W<s>
        • Examples
    • Length
      • X<unit>
      • <constant>
        • Examples
    • Pace
      • <time>/<unit>
    • Imperial
    • Metric
• Tips and tricks
  • Convert kilometer-pace to mile-pace
  • Convert mile-pace to kilometer-pace

CLI

Run as a command line program.

Installation

npm install -g run-pace

Usage

run-pace -t <time> -l <length> -p <pace> [-i] [-m]

Two of "time", "length" and "pace" must be provided.

Parameters:
   -l, --length,    <value><unit> (10km, 10mi, 10000m, hm, ma)
   -p, --pace,      <value>/<unit> (4:30/km, 4m30s/mi)
   -t, --time,      <value> (11:23, 11min23sec, 11m23s)
   -i, --imperial,  force imperial output
   -m, --metric,    force metric output

Node module

Use in a node script.

Installation

npm install run-pace

Usage

const runPace = require("run-pace");

Methods

All methods takes an object as its only argument.

calculateLength

Call with an object with the properties time and length.

Example

const length = runPace.calculateLength({
  time: "45m",
  pace: "4:30/km",
});

console.log(length); // 10km

calculateTime

Call with an object with the properties pace and length.

Example

const time = runPace.calculateTime({
  length: "10km",
  pace: "4:30/km",
});

console.log(time); // 45:00

calculatePace

Call with an object with the properties time and length.

Example

const pace = runPace.calculatePace({
  time: "45m",
  length: "10km",
});

console.log(pace); // 4:30/km

Parameters in detail

Time

Can be provided in the following formats:

[[dd:][hh:]mm:ss

Examples

• 04:40
• 2:44:36
• 0:59
• 0:3599 (non-standard)

X<d>Y<h>Z<m>W<s>

Only one unit needs to be provided.

• <d>is in the format days, day or d
• <h>is in the format hours, hour, hrsorh`
• <m>is in the format mins, min or m
• <s>is in the format secs, sec or s

Examples

• 2days13hours45mins16secs
• 3hrs15sec
• 23m16s

---

Length

If length is provided in miles, imperial output is enabled.

X<unit>

X is a number, including optional decimal point

<unit> is one of the following:

• Kilometers: km or k
• Meters: m
• Miles: mi

<constant>

• Half-marathon: hm
• Marathon: ma

Examples

• hm
• 10k
• 5.25KM(case-insensitive)
• 26.21875mi

---

Pace

If pace is provided in miles, imperial output is enabled.

<time>/<unit>

<time> as specified above

<unit> is km or mi

---

Imperial

Default output is kilometers. Use this switch to force output in miles.

---

Metric

If miles are given in pace or length output will be in miles as well. Use this switch to force output in kilometers.

Tips and tricks

Convert kilometer-pace to mile-pace

run-pace -t 7m15s -l 1mi -m
4:30/km

Convert mile-pace to kilometer-pace

run-pace -t 4:30 -l 1k -i
7:15/mi