DataUnits 1.0.2

DataUnits

DataUnits allows easier handling of byte size representation. (Bytes, KB, MB, GB, TB)

How to use it

You can create a ByteSize object from Bits, bytes, kilobytes, megabytes, gigabytes and terabytes.

• JsonConverter and TypeConverter are already available.

ByteSize bytes = ByteSize.FromBytes(10);
ByteSize kilobytes = ByteSize.FromKilobytes(10);
ByteSize megabytes = ByteSize.FromMegabytes(10);
ByteSize gigabytes = ByteSize.FromGigabytes(10);
ByteSize terabytes = ByteSize.FromTerabytes(10);

Calculate bit rate

BitRate bitRate = ByteSize.FromBytes(1) / TimeSpan.FromSeconds(2); //4
TimeSpan time = ByteSize.FromBytes(1) / BitRate.FromBits(4); //2
ByteSize byteSize = BitRate.FromBits(8) * TimeSpan.FromSeconds(2); //2

Parsing

ByteSize bytes = ByteSize.Parse("1"); //if no size is specified, byte is used
ByteSize bytes = ByteSize.Parse("1 B");
ByteSize bytes = ByteSize.Parse("1 b"); //ignores case
ByteSize kilobytes = ByteSize.Parse("1 KB");
ByteSize gigabytes = ByteSize.Parse(" 1GB "); //ignores whitespaces
ByteSize gigabytes = ByteSize.Parse("1.1 GB", CultureInfo.Invariant);

Formattable

ByteSize.FromBytes(1024).ToString(CultureInfo.InvariantCulture); // "1 KB"
ByteSize.FromKilobytes(1.5).ToString(CultureInfo.InvariantCulture); // "1.5 KB"

//use explicit unit
ByteSize.FromMegabytes(1).ToString(ByteUnit.Kilobyte, null, CultureInfo.InvariantCulture); //"1,024 KB"

Comparable

bool result = ByteSize.FromBytes(1024) == ByteSize.FromKilobytes(1);
bool result = ByteSize.FromBytes(100) > ByteSize.FromKilobytes(1);

Operators

long value = ByteSize.FromBytes(1024); //returns byte value

ByteSize size = 1024; //use byte unit

Arithmetic operations

ByteSize a = ByteSize.FromBytes(10) + ByteSize.FromMegabytes(5);
ByteSize b = ByteSize.FromMegabytes(100) - ByteSize.FromMegabytes(5);

a = a.AddTerabytes(10);

JSON

JsonSerializer.Serialize(ByteSize.FromKilobytes(1)); //returns byte value as number

TypeConverter

In your appsettings.json you can specify the byte size in different types:

{
  "MaxContentLength": 1024
}

{
  "MaxContentLength": "1024"
}

{
  "MaxContentLength": "1 KB"
}