mirror of
https://github.com/immich-app/immich
synced 2025-10-17 18:19:27 +00:00
69 lines
2 KiB
TypeScript
69 lines
2 KiB
TypeScript
export const enum ByteUnit {
|
|
'B' = 'B',
|
|
'KiB' = 'KiB',
|
|
'MiB' = 'MiB',
|
|
'GiB' = 'GiB',
|
|
'TiB' = 'TiB',
|
|
'PiB' = 'PiB',
|
|
'EiB' = 'EiB',
|
|
}
|
|
|
|
const byteUnits = [ByteUnit.B, ByteUnit.KiB, ByteUnit.MiB, ByteUnit.GiB, ByteUnit.TiB, ByteUnit.PiB, ByteUnit.EiB];
|
|
|
|
/**
|
|
* Convert bytes to best human readable unit and number of that unit.
|
|
*
|
|
* * For `1024` bytes, returns `1` and `KiB`.
|
|
* * For `1536` bytes, returns `1.5` and `KiB`.
|
|
*
|
|
* @param bytes number of bytes
|
|
* @param maxPrecision maximum number of decimal places, default is `1`
|
|
* @returns size (number) and unit (string)
|
|
*/
|
|
export function getBytesWithUnit(bytes: number, maxPrecision = 1): [number, ByteUnit] {
|
|
const magnitude = Math.floor(Math.log(bytes === 0 ? 1 : bytes) / Math.log(1024));
|
|
|
|
return [Number.parseFloat((bytes / 1024 ** magnitude).toFixed(maxPrecision)), byteUnits[magnitude]];
|
|
}
|
|
|
|
/**
|
|
* Localized number of bytes with a unit.
|
|
*
|
|
* For `1536` bytes:
|
|
* * en: `1.5 KiB`
|
|
* * de: `1,5 KiB`
|
|
*
|
|
* @param bytes number of bytes
|
|
* @param maxPrecision maximum number of decimal places, default is `1`
|
|
* @returns localized bytes with unit as string
|
|
*/
|
|
export function getByteUnitString(bytes: number, locale?: string, maxPrecision = 1): string {
|
|
const [size, unit] = getBytesWithUnit(bytes, maxPrecision);
|
|
return `${size.toLocaleString(locale)} ${unit}`;
|
|
}
|
|
|
|
/**
|
|
* Convert to bytes from on a specified unit.
|
|
*
|
|
* * `1, 'GiB'`, returns `1073741824` bytes
|
|
*
|
|
* @param size value to be converted
|
|
* @param unit unit to convert from
|
|
* @returns bytes (number)
|
|
*/
|
|
export function convertToBytes(size: number, unit: ByteUnit): number {
|
|
return size * 1024 ** byteUnits.indexOf(unit);
|
|
}
|
|
|
|
/**
|
|
* Convert from bytes to a specified unit.
|
|
*
|
|
* * `11073741824, 'GiB'`, returns `1` GiB
|
|
*
|
|
* @param bytes value to be converted
|
|
* @param unit unit to convert to
|
|
* @returns bytes (number)
|
|
*/
|
|
export function convertFromBytes(bytes: number, unit: ByteUnit): number {
|
|
return bytes / 1024 ** byteUnits.indexOf(unit);
|
|
}
|