debian-mirror-gitlab/app/assets/javascripts/lib/utils/number_utils.js

165 lines
4.4 KiB
JavaScript
Raw Normal View History

2021-01-03 14:25:43 +05:30
import { BYTES_IN_KIB, BYTES_IN_KB } from './constants';
2019-09-04 21:01:54 +05:30
import { sprintf, __ } from '~/locale';
2017-08-17 22:00:37 +05:30
/**
* Function that allows a number with an X amount of decimals
* to be formatted in the following fashion:
* * For 1 digit to the left of the decimal point and X digits to the right of it
* * * Show 3 digits to the right
* * For 2 digits to the left of the decimal point and X digits to the right of it
* * * Show 2 digits to the right
2018-12-13 13:39:08 +05:30
*/
2017-08-17 22:00:37 +05:30
export function formatRelevantDigits(number) {
let digitsLeft = '';
let relevantDigits = 0;
let formattedNumber = '';
2018-11-08 19:23:39 +05:30
if (!Number.isNaN(Number(number))) {
[digitsLeft] = number.toString().split('.');
2017-08-17 22:00:37 +05:30
switch (digitsLeft.length) {
case 1:
relevantDigits = 3;
break;
case 2:
relevantDigits = 2;
break;
case 3:
relevantDigits = 1;
break;
default:
relevantDigits = 4;
break;
}
formattedNumber = Number(number).toFixed(relevantDigits);
}
return formattedNumber;
}
2021-01-03 14:25:43 +05:30
/**
* Utility function that calculates KB of the given bytes.
* Note: This method calculates KiloBytes as opposed to
* Kibibytes. For Kibibytes, bytesToKiB should be used.
*
* @param {Number} number bytes
* @return {Number} KiB
*/
export function bytesToKB(number) {
return number / BYTES_IN_KB;
}
2017-08-17 22:00:37 +05:30
/**
* Utility function that calculates KiB of the given bytes.
*
* @param {Number} number bytes
* @return {Number} KiB
*/
export function bytesToKiB(number) {
return number / BYTES_IN_KIB;
}
2017-09-10 17:25:29 +05:30
/**
* Utility function that calculates MiB of the given bytes.
*
* @param {Number} number bytes
* @return {Number} MiB
*/
export function bytesToMiB(number) {
return number / (BYTES_IN_KIB * BYTES_IN_KIB);
}
2018-03-17 18:26:18 +05:30
/**
* Utility function that calculates GiB of the given bytes.
* @param {Number} number
* @returns {Number}
*/
export function bytesToGiB(number) {
return number / (BYTES_IN_KIB * BYTES_IN_KIB * BYTES_IN_KIB);
}
/**
* Port of rails number_to_human_size
* Formats the bytes in number into a more understandable
* representation (e.g., giving it 1500 yields 1.5 KB).
*
* @param {Number} size
* @returns {String}
*/
export function numberToHumanSize(size) {
if (size < BYTES_IN_KIB) {
2019-09-04 21:01:54 +05:30
return sprintf(__('%{size} bytes'), { size });
2018-03-17 18:26:18 +05:30
} else if (size < BYTES_IN_KIB * BYTES_IN_KIB) {
2019-09-04 21:01:54 +05:30
return sprintf(__('%{size} KiB'), { size: bytesToKiB(size).toFixed(2) });
2018-03-17 18:26:18 +05:30
} else if (size < BYTES_IN_KIB * BYTES_IN_KIB * BYTES_IN_KIB) {
2019-09-04 21:01:54 +05:30
return sprintf(__('%{size} MiB'), { size: bytesToMiB(size).toFixed(2) });
2018-03-17 18:26:18 +05:30
}
2019-09-04 21:01:54 +05:30
return sprintf(__('%{size} GiB'), { size: bytesToGiB(size).toFixed(2) });
2018-03-17 18:26:18 +05:30
}
2019-07-07 11:18:12 +05:30
/**
* A simple method that returns the value of a + b
* It seems unessesary, but when combined with a reducer it
* adds up all the values in an array.
*
* e.g. `[1, 2, 3, 4, 5].reduce(sum) // => 15`
*
* @param {Float} a
* @param {Float} b
* @example
* // return 15
* [1, 2, 3, 4, 5].reduce(sum);
*
* // returns 6
* Object.values([{a: 1, b: 2, c: 3].reduce(sum);
* @returns {Float} The summed value
*/
export const sum = (a = 0, b = 0) => a + b;
2019-09-04 21:01:54 +05:30
/**
* Checks if the provided number is odd
* @param {Int} number
*/
export const isOdd = (number = 0) => number % 2;
2019-12-21 20:55:43 +05:30
/**
* Computes the median for a given array.
* @param {Array} arr An array of numbers
* @returns {Number} The median of the given array
*/
export const median = arr => {
const middle = Math.floor(arr.length / 2);
const sorted = arr.sort((a, b) => a - b);
return arr.length % 2 !== 0 ? sorted[middle] : (sorted[middle - 1] + sorted[middle]) / 2;
};
2019-12-26 22:10:19 +05:30
/**
* Computes the change from one value to the other as a percentage.
* @param {Number} firstY
* @param {Number} lastY
* @returns {Number}
*/
export const changeInPercent = (firstY, lastY) => {
if (firstY === lastY) {
return 0;
}
return Math.round(((lastY - firstY) / Math.abs(firstY)) * 100);
};
/**
* Computes and formats the change from one value to the other as a percentage.
* Prepends the computed percentage with either "+" or "-" to indicate an in- or decrease and
* returns a given string if the result is not finite (for example, if the first value is "0").
* @param firstY
* @param lastY
* @param nonFiniteResult
* @returns {String}
*/
export const formattedChangeInPercent = (firstY, lastY, { nonFiniteResult = '-' } = {}) => {
const change = changeInPercent(firstY, lastY);
if (!Number.isFinite(change)) {
return nonFiniteResult;
}
return `${change >= 0 ? '+' : ''}${change}%`;
};