DOLLARDE function

PRO BASIC

The DOLLARDE function in Jspreadsheet Formulas Pro is used to change a dollar price from its fractional form into a decimal. This is done by utilizing a specified denominator. This function is especially useful when you need to perform calculations with prices that are usually expressed in fractions, allowing you to convert them into a more universally recognized decimal format.

Documentation

Converts a dollar price expressed in fractional format into a decimal using the specified denominator.

Syntax

DOLLARDE(decimal_dollar, fraction)

Parameter	Description
`decimal_dollar`	The decimal dollar value you want to convert to a fraction.
`fraction`	The denominator to use for the resulting fraction.

Behavior

The DOLLARDE function converts a dollar price, expressed as a fraction, into a dollar price expressed as a decimal number. The function requires two arguments: a fractional dollar price and the number of units per fraction.

If the function encounters an empty cell, it will treat it as zero.
If the function encounters text, it will return an error.
This function does not support boolean values. If a boolean value is used, the function returns an error.
If the function encounters an error, it will propagate that error.
The function will return an error if the fraction argument is less than zero, not an integer, or zero.
The fraction argument (denominator) must be an integer greater than 0; otherwise, the function returns an error.

Common Errors

Error	Description
#VALUE!	This error occurs when the supplied arguments are non-numeric.
#DIV/0!	This error is returned if the units per fraction argument is zero.

Best practices

Always ensure to input numeric values as the arguments for the DOLLARDE function to avoid a #VALUE! error.

Be aware that the function will return a #NUM! error if the fraction is less than zero or if the fraction is greater than or equal to the units per fraction, or if the units per fraction is not an integer.

Do not use a zero value as the second argument (units per fraction) to avoid a #DIV/0! error.

It is recommended to use this function when dealing with securities prices that are traditionally quoted in fractions.

Usage

A few examples using the DOLLARDE function.

DOLLARDE(1.02, 16)
// Returns: 1.125
// Explanation: 1.02 represents 1 and 2/16 → converted to 1 + (2 ÷ 16) = 1.125

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('NmM1ODhkNTVhNDA1NWU4MDJiZTYzNjFlNTQ5Nzg2MzE4NmI4MjQxZDljNjdmN2Q4ZDc0MDNiYmQzNDE4ODViYzRiNDBkMmY0ODFmMzI4NjE0MDMzNGFjOGQ5MWEzYjQ2YzQwNDI5ODA1NmU1N2Q4MGI0MGI4ZDViNWU4NDNiOTYsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBOekF6TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

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

// Create a new spreadsheet
jspreadsheet(document.getElementById('spreadsheet'), {
  worksheets: [{
    data: [
    [
        "Decimal Price",
        "Denominator",
        "Fractional Price"
    ],
    [
        1.25,
        16,
        "=DOLLARDE(A2,B2)"
    ],
    [
        2.75,
        32,
        "=DOLLARDE(A3,B3)"
    ],
    [
        0.5,
        8,
        "=DOLLARDE(A4,B4)"
    ],
    [
        3.125,
        16,
        "=DOLLARDE(A5,B5)"
    ]
]
  }]
});
</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('NmM1ODhkNTVhNDA1NWU4MDJiZTYzNjFlNTQ5Nzg2MzE4NmI4MjQxZDljNjdmN2Q4ZDc0MDNiYmQzNDE4ODViYzRiNDBkMmY0ODFmMzI4NjE0MDMzNGFjOGQ5MWEzYjQ2YzQwNDI5ODA1NmU1N2Q4MGI0MGI4ZDViNWU4NDNiOTYsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBOekF6TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

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

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

    // Worksheet data
    const data = [
    [
        "Decimal Price",
        "Denominator",
        "Fractional Price"
    ],
    [
        1.25,
        16,
        "=DOLLARDE(A2,B2)"
    ],
    [
        2.75,
        32,
        "=DOLLARDE(A3,B3)"
    ],
    [
        0.5,
        8,
        "=DOLLARDE(A4,B4)"
    ],
    [
        3.125,
        16,
        "=DOLLARDE(A5,B5)"
    ]
];

    // 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('NmM1ODhkNTVhNDA1NWU4MDJiZTYzNjFlNTQ5Nzg2MzE4NmI4MjQxZDljNjdmN2Q4ZDc0MDNiYmQzNDE4ODViYzRiNDBkMmY0ODFmMzI4NjE0MDMzNGFjOGQ5MWEzYjQ2YzQwNDI5ODA1NmU1N2Q4MGI0MGI4ZDViNWU4NDNiOTYsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBOekF6TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

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

export default {
    components: {
        Spreadsheet,
        Worksheet,
    },
    data() {
        // Worksheet data
        const data = [
    [
        "Decimal Price",
        "Denominator",
        "Fractional Price"
    ],
    [
        1.25,
        16,
        "=DOLLARDE(A2,B2)"
    ],
    [
        2.75,
        32,
        "=DOLLARDE(A3,B3)"
    ],
    [
        0.5,
        8,
        "=DOLLARDE(A4,B4)"
    ],
    [
        3.125,
        16,
        "=DOLLARDE(A5,B5)"
    ]
]

        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('NmM1ODhkNTVhNDA1NWU4MDJiZTYzNjFlNTQ5Nzg2MzE4NmI4MjQxZDljNjdmN2Q4ZDc0MDNiYmQzNDE4ODViYzRiNDBkMmY0ODFmMzI4NjE0MDMzNGFjOGQ5MWEzYjQ2YzQwNDI5ODA1NmU1N2Q4MGI0MGI4ZDViNWU4NDNiOTYsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBOekF6TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// 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: [
    [
        "Decimal Price",
        "Denominator",
        "Fractional Price"
    ],
    [
        1.25,
        16,
        "=DOLLARDE(A2,B2)"
    ],
    [
        2.75,
        32,
        "=DOLLARDE(A3,B3)"
    ],
    [
        0.5,
        8,
        "=DOLLARDE(A4,B4)"
    ],
    [
        3.125,
        16,
        "=DOLLARDE(A5,B5)"
    ]
]
            }]
        });
    }
}

Edit this page on GitHub