Division with repeating decimal detection

Downloads in past


1.0.05 years ago5 years agoMinified + gzip package size for cycle-division in KB


GitHub license npm version CircleCI Status Greenkeeper badge
This is a Javascript module which implements division with repeating decimal detection. This allows you to divide two numbers and extract the integer, fractional, and repeating decimal parts of the result.
This module was inspired by and the implementation at


import { divide } from 'cycle-division';
const q = divide(438, 35);

// 12.5(142857)

// Quotient {
//   sign: 1,
//   whole: 12,
//   fraction: [ 5 ],
//   cycle: [ 1, 4, 2, 8, 5, 7 ],
//   base: 10 }

The examples here use the import statement, which is supported by TypeScript and Babel. If you're using Node.js or a bundler that only supports CommonJS modules, then you can replace the import statements with require calls:
const { divide } = require('cycle-division');


divide(dividend, divisor, base?)

This function returns a Quotient object. The base parameter is argument and defaults to 10.


Quotient objects have the following properties:
  • sign: 1 if the result is positive or zero, -1 if the result is negative.
  • whole: The integer part of the result.
  • fraction: An array containing the series of digits that come after the radix
point in the result but before the.repeating part if any.
  • cycle: An array containing the repeating part of the fraction, the repetend.
  • base: The base of the digits in the fraction and cycle.

Quotient objects have the following methods:
  • toString(): Stringifies the Quotient object. If the quotient contains no cycle,
then the result will be a standard number string (ie. "5" or "12.34"). If a cycle is present, then the cycle will be wrapped with parenthesis (ie. "12.3(56)" or "0.(3)").
  • equals(other): The other parameter must be a Quotient object. The method
returns true if both objects' properties are equal.


TypeScript type definitions for this module are included! The type definitions won't require any configuration to use.