CONVERT function

PRO BASIC

The CONVERT function in Jspreadsheet Formulas Pro is a useful tool that allows you to change a number from one measurement system to another. This could be anything from converting currencies, weights, lengths, or even temperatures. You simply input the number you want to convert, specify the current measurement unit, and then specify the unit you want the number converted to. It's a handy function that saves you time, making conversions quick and error-free.

Documentation

Converts a number from one measurement system to another.

Syntax

CONVERT(number, from_unit, to_unit)

Parameter	Description
`number`	The value to be converted.
`from_unit`	A text string representing the current unit of the value (e.g., 'm', 'ft', 'kg').
`to_unit`	TA text string representing the unit to convert to (must be compatible with from_unit).

Behavior

The CONVERT function is used to convert a number from one measurement system to another. The function requires three arguments: the number you wish to convert, the unit you are converting from, and the unit you are converting to.

If the cell referenced for the number to be converted is empty, the function will return #VALUE! error.
The function cannot handle text values. If any of the arguments are text that cannot be interpreted as a valid number or unit, the function will return #VALUE! error.
Booleans are not supported. If any of the arguments are boolean values, the function will return #VALUE! error.
If the unit inputted for conversion is not supported or not recognized by the function, it will return a #N/A error.
Units must be from the same measurement category (e.g., length to length).
Units are case-sensitive and must be spelled precisely.

Common Errors

Error	Description
`#VALUE!`	This error occurs when either the number to be converted, the unit you are converting from, or the unit you are converting to is not a valid number or unit. It is also returned when the cell referenced for the number is empty.
`#N/A`	This error is returned when the unit inputted for conversion is not supported or not recognized by the function.

Best practices

Always double-check the units you are converting from and to, to ensure they are valid and supported by the CONVERT function.

Handle errors such as #VALUE!, #N/A, and #DIV/0! using error handling functions like IFERROR to ensure your spreadsheet remains clean and easy to read.

Avoid referencing empty cells as the number to be converted, as this will result in a #VALUE! error.

Use the CONVERT function for dynamic conversions where the numbers or units may change, rather than hard coding conversions.

Use UPPER() or LOWER() functions cautiously, as CONVERT is case-sensitive and does not accept unit abbreviations in incorrect case.

Usage

A few examples using the CONVERT function.

CONVERT(2.5, "ft", "m") → 0.762  
CONVERT(250, "lbm", "kg") → 113.398  
CONVERT(100, "mi", "km") → 160.934  
CONVERT(98.6, "F", "C") → 37  // Fahrenheit to Celsius  
CONVERT(1, "gal", "l") → 3.78541

Interactive Spreadsheet Demo

<html>
<script src="https://jspreadsheet.com/v11/jspreadsheet.js"></script>
<script src="https://jsuites.net/v5/jsuites.js"></script>
<link rel="stylesheet" href="https://jsuites.net/v5/jsuites.css" type="text/css" />
<link rel="stylesheet" href="https://jspreadsheet.com/v11/jspreadsheet.css" type="text/css" />

<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Material+Icons" />
<script src="https://cdn.jsdelivr.net/npm/@jspreadsheet/formula-pro/dist/index.min.js"></script>

<div id="spreadsheet"></div>

<script>
// Set your JSS license key (The following key only works for one day)
jspreadsheet.setLicense('YjdmMjY0YTgzY2NkMGZjYjRlMDk2YmJlMWIxZDZiZGU2ZjMwNjRlYmVkNTBjOTJjNGU4NTdmYzIxMTZhNzU2MWE4NjZhYzZiZTExYTU1NjY1ZTEwMGE1MjQ0ODBjNTViN2JmM2VmMmNjMTNhYzJiNzhlMDU1MTk1YTU5Y2QzMjQsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBNemt6TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

// Create a new spreadsheet
jspreadsheet(document.getElementById('spreadsheet'), {
  worksheets: [{
    data: [
    [
        "Distance (ft)",
        "Distance (m)",
        "=CONVERT(A1,\"ft\",\"m\")"
    ],
    [
        10,
        "Weight (lbs)",
        "=CONVERT(B2,\"lbm\",\"kg\")"
    ],
    [
        25.5,
        220,
        "=CONVERT(A3,\"ft\",\"m\")"
    ],
    [
        100,
        150,
        "=CONVERT(B4,\"lbm\",\"kg\")"
    ]
]
  }]
});
</script>
</html>

import React, { useRef } from "react";
import { Spreadsheet, Worksheet, jspreadsheet } from "@jspreadsheet/react";
import formula from "@jspreadsheet/formula-pro";
import "jsuites/dist/jsuites.css";
import "jspreadsheet/dist/jspreadsheet.css";

// Set license
jspreadsheet.setLicense('YjdmMjY0YTgzY2NkMGZjYjRlMDk2YmJlMWIxZDZiZGU2ZjMwNjRlYmVkNTBjOTJjNGU4NTdmYzIxMTZhNzU2MWE4NjZhYzZiZTExYTU1NjY1ZTEwMGE1MjQ0ODBjNTViN2JmM2VmMmNjMTNhYzJiNzhlMDU1MTk1YTU5Y2QzMjQsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBNemt6TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

export default function App() {
    // Spreadsheet array of worksheets
    const spreadsheet = useRef();

    // Worksheet data
    const data = [
    [
        "Distance (ft)",
        "Distance (m)",
        "=CONVERT(A1,\"ft\",\"m\")"
    ],
    [
        10,
        "Weight (lbs)",
        "=CONVERT(B2,\"lbm\",\"kg\")"
    ],
    [
        25.5,
        220,
        "=CONVERT(A3,\"ft\",\"m\")"
    ],
    [
        100,
        150,
        "=CONVERT(B4,\"lbm\",\"kg\")"
    ]
];

    // Render component
    return (
        <Spreadsheet ref={spreadsheet}>
            <Worksheet data={data} />
        </Spreadsheet>
    );
}

<template>
    <Spreadsheet ref="spreadsheet">
        <Worksheet :data="data" />
    </Spreadsheet>
</template>

<script>
import { Spreadsheet, Worksheet, jspreadsheet } from "@jspreadsheet/vue";
import "jsuites/dist/jsuites.css";
import "jspreadsheet/dist/jspreadsheet.css";
import formula from "@jspreadsheet/formula-pro";

// Set license
jspreadsheet.setLicense('YjdmMjY0YTgzY2NkMGZjYjRlMDk2YmJlMWIxZDZiZGU2ZjMwNjRlYmVkNTBjOTJjNGU4NTdmYzIxMTZhNzU2MWE4NjZhYzZiZTExYTU1NjY1ZTEwMGE1MjQ0ODBjNTViN2JmM2VmMmNjMTNhYzJiNzhlMDU1MTk1YTU5Y2QzMjQsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBNemt6TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

export default {
    components: {
        Spreadsheet,
        Worksheet,
    },
    data() {
        // Worksheet data
        const data = [
    [
        "Distance (ft)",
        "Distance (m)",
        "=CONVERT(A1,\"ft\",\"m\")"
    ],
    [
        10,
        "Weight (lbs)",
        "=CONVERT(B2,\"lbm\",\"kg\")"
    ],
    [
        25.5,
        220,
        "=CONVERT(A3,\"ft\",\"m\")"
    ],
    [
        100,
        150,
        "=CONVERT(B4,\"lbm\",\"kg\")"
    ]
]

        return {
            data
        };
    }
}
</script>

import { Component, ViewChild, ElementRef } from "@angular/core";
import jspreadsheet from "jspreadsheet";
import * as formula from "@jspreadsheet/formula-pro";

// Set your JSS license key (The following key only works for one day)
jspreadsheet.setLicense('YjdmMjY0YTgzY2NkMGZjYjRlMDk2YmJlMWIxZDZiZGU2ZjMwNjRlYmVkNTBjOTJjNGU4NTdmYzIxMTZhNzU2MWE4NjZhYzZiZTExYTU1NjY1ZTEwMGE1MjQ0ODBjNTViN2JmM2VmMmNjMTNhYzJiNzhlMDU1MTk1YTU5Y2QzMjQsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBNemt6TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

@Component({
    standalone: true,
    selector: "app-root",
    template: `<div #spreadsheet></div>`
})
export class AppComponent {
    @ViewChild("spreadsheet") spreadsheet: ElementRef;
    // Worksheets
    worksheets: jspreadsheet.worksheetInstance[];

    // Create a new data grid
    ngAfterViewInit() {
        // Create spreadsheet
        this.worksheets = jspreadsheet(this.spreadsheet.nativeElement, {
            worksheets: [{
                data: [
    [
        "Distance (ft)",
        "Distance (m)",
        "=CONVERT(A1,\"ft\",\"m\")"
    ],
    [
        10,
        "Weight (lbs)",
        "=CONVERT(B2,\"lbm\",\"kg\")"
    ],
    [
        25.5,
        220,
        "=CONVERT(A3,\"ft\",\"m\")"
    ],
    [
        100,
        150,
        "=CONVERT(B4,\"lbm\",\"kg\")"
    ]
]
            }]
        });
    }
}

Edit this page on GitHub