Awesome
HumanBytes
A library to convert byte sizes to a human readable form.
Installation
Install the library via NuGet
PM> Install-Package HumanBytes
Basic usage
The Bytes
extension method returns an object that has a human readable string representation:
var f = new FileInfo("TheFile.jpg");
Console.WriteLine($"The size of '{f.Name}' is {f.Length.Bytes()}");
// Prints "The size of 'TheFile.jpg' is 89 KB"
The value is formatted using the default formatter; you can change the default formatter settings through the ByteSizeFormatter.Default
static property.
More advanced usage
If you need more control, create an instance of ByteSizeFormatter
and change its settings:
var formatter = new ByteSizeFormatter
{
Convention = ByteSizeConvention.Binary,
DecimalPlaces = 1,
NumberFormat = "#,##0.###",
MinUnit = ByteSizeUnit.Kilobyte,
MaxUnit = ByteSizeUnit.Gigabyte,
RoundingRule = ByteSizeRounding.Closest,
UseFullWordForBytes = true,
};
var f = new FileInfo("TheFile.jpg");
Console.WriteLine($"The size of '{f.Name}' is {formatter.Format(f.Length)}");
// Prints "The size of 'TheFile.jpg' is 88.7 KiB"
Localization
At this stage, HumanBytes only supports English and French. However, if you need support for another language, it's very easy, as there are only 3 terms that need to be translated. Just create an instance of ByteSizeFormatter
as shown above, and set the following properties:
ByteSymbol
: the symbol for byte, e.g. "B" in English.ByteWord
: the word for byte, e.g. "byte" in English.BytesWord
: the word for several bytes, e.g. "bytes" in English.
The values set on these properties will be used instead of the ones defined in resources.
If you would like to add permanent support for another language, you'll have to modify the library itself. Just clone the project, add a Resources.xx.resx
file (where xx
is the language code) in the HumanBytes/Properties
folder, translate the terms, and build.
I'll be glad to accept pull requests to support more languages.