UnitOf - Convert anything into everything

{{UnitOfLength()}} Measurements in UnitOf

- Syntax, Units Available, and Examples -

Quick Summary

One Liner

Set Then Convert

Data Type and Fractions

Create your own custom measurement

UnitOf.Anything x = new UnitOf.Anything("FEET", new HashMap<Object, Double>() {{ put("METERS", 0.3048); put("INCHES", 12.0); }});

var x = UnitOf.Anything("FEET", 1, true, {METERS:0.3048, INCHES:12}); //Cust measurement w/ 3 units

UnitOf.Anything x = new UnitOf.Anything("FEET", new Dictionary<Object, Double>(){ {"METERS", 0.3048}, {"INCHES", 12.0} });

Example

In using example

Units available for our custom UnitOf measurement

{{javaJSOrCS('final String', 'var', 'const String')}} FEET = {{selectedExampleDDL[$index] === '3' ? '1' : '"FEET"'}}; {{selectedExampleDDL[$index] === '3' ? '//Unit name "Feet" with value of 1 also for key' : '//Unit name "Feet" as String.'}}

{{javaJSOrCS('final String', 'var', 'const String')}} METERS = {{selectedExampleDDL[$index] === '3' ? '0.3048' : '"Meters"'}}; {{selectedExampleDDL[$index] === '3' ? '//Unit name/value: 0.3048 Meters in 1 foot.' : '//Unit name "Meters" as String.'}}

{{javaJSOrCS('final double', 'var', 'const double')}} INCHES = 12; {{selectedExampleDDL[$index] === '3' ? '//Unit name/value: 12 inches in 1 foot' : '//Unit name can also be the key conversion value (12 inches in 1 foot).'}}

Create our custom UnitOf measurement and add the units with their values.

The values are defined by how many units it takes to equal one key unit.

Key = 1 foot | values = 12 inches (12 inches in 1 foot), 0.3048 meters (0.3048 meters in 1 foot)

{{isJS('var','')}}{{bJS('UnitOf.')}}{{bJS('Anything')}} length = {{bJS('new')}} UnitOf.Anything(FEET); //Our key is 1 foot. All added units are their conversion into 1 foot.

length.{{langCasing('addUnit')}}(METERS, 0.3048); //Unit name/value: 0.3048 Meters in 1 foot.

length.{{langCasing('addUnit')}}(INCHES); //Unit name/value: 12 inches in 1 foot.

{{isJS('var','')}}{{bJS('UnitOf.')}}{{bJS('Anything')}} length = {{bJS('new')}} UnitOf.Anything(FEET, 1, true, new {{javaJSOrCS('HashMap', '', 'Dictionary')}}<Object, Double>() {{javaJSOrCS('{', '', '')}}{

{{javaJSOrCS('put(', '', '')}}{{javaJSOrCS('', '', '{')}}METERS: 0.3048{{javaJSOrCS(')','','')}}{{javaJSOrCS(';',',','}, {')}}{{javaJSOrCS(' put(', ' ', '')}}INCHES: INCHES{{javaJSOrCS(')','','')}}{{javaJSOrCS('','','}')}}

}{{javaJSOrCS('}','','')}});

{{isJS('var','')}}{{bJS('UnitOf.')}}{{bJS('Anything')}} length = {{bJS('new')}} UnitOf.Anything(FEET, {{isJS('[','')}}{{bJS('new ')}}{{bJS('double')}}{{bJS('[]{')}}

METERS, INCHES

{{isJS(']','}')}});

One line conversions

No "from" value set yet but can still perform one line conversions by passing in the "from" unit and value as well as the "to" unit.

{{isJS('var','double')}} from12d5_FeetToMeters = length.{{langCasing('convertNow')}}(12.5, FEET, METERS); //Returns 3.81 as 12.5 feet to meters = 3.81 meters

{{isJS('var','double')}} from12d5_FeetToInches = length.{{langCasing('convertNow')}}(12.5, FEET, INCHES); //Returns 150 as 12.5 feet to inches = 150 inches

Setting then converting

The custom UnitOf measurement can define a "from" unit/value so to allow it to be converted more than once.

length.{{langCasing('from')}}(METERS, 5); //Set the length to 5 Meters

{{isJS('var','double')}} from5_MetersToFeet = length.{{langCasing('to')}}(FEET); //Returns 16.404 as 5 meters to feet = ~16.404 feet

{{isJS('var','double')}} from5_MetersToInches = length.{{langCasing('to')}}(INCHES); //Returns 196.85 as 5 meters to inches = ~196.85 inches

Returns the currently set values

{{isJS('var','String')}} keyName = length.{{langCasing('getKeyName')}}(); //Returns "Feet"

{{isJS('var','double')}} keyValue = length.{{langCasing('getKeyValue')}}(); //Returns 1

{{isJS('var','String')}} fromName = length.{{langCasing('getFromName')}}(); //Returns "Meters"

{{isJS('var','double')}} fromValue = length.{{langCasing('getFromValue')}}(); //Returns 5

Example

In using example

/**

* Convert any {{javaJSOrCS('Java','JavaScript','C#')}} data type and more including converting to and from fractions.

* Default Values:

* When a conversion in DataType fails its default, passed by caller as a parameter or if not uses UnitOf's defaults, is returned.

* UnitOf defaults (when no parameter is passed) for each method are as follows:

* toObject(): null

* toString(): ""

* toBoolean(): false

* toChar(): '\u0000'

* toByte(): (byte)0

* toShort(): (short)0

* toInt(): 0

* toLong(): (long)0

* toFloat(): 0.0f

* toDouble(): 0.0d

* toFraction(): ""

* toSbyte(): 0

* toUint(): 0

* toUlong: 0

* toUshort: 0

* toDecimal(): 0.0M

* toDateTime(): new DateTime()

* toTimeSpan(): new TimeSpan()

* toString(): ""

* toBoolean(): false

* toNumber(): 0

* toChar(): ""

* toInt(): 0

* toFloat(): 0

* toFraction(): ""

* NOTE: {{javaJSOrCS('','','toSbyte, toShort, toUint, toUlong, toUshort, ')}}{{isJS('toNumber, toInt, and toFloat','toByte, toInt, toLong, toFloat, and toDouble')}} {{isJS('functions','methods')}} on failure will attempt to read the value as a fraction and convert it to a decimal form.

* This is to account for fractions originally passed in as Strings to be converted as a number type (EX: "2/4" {{isJS('toFloat()','toDouble()')}} will return 0.5).

{{isJS('var','String')}} typePassed = {{bJS('new')}} UnitOf.DataType(1.23).{{langCasing('getTypeConstantPassed()')}}; //Returns "{{isJS('number','Double')}}"

{{isJS('var','Object')}} valuePassed = {{bJS('new')}} UnitOf.DataType(1.23).{{langCasing('getValuePassed()')}}; //Returns 1.23

double xToDouble = new UnitOf.DataType("12.5").{{langCasing('t')}}oDouble(); //"12.5" -> 12.5

int xToInt = new UnitOf.DataType(12.5).{{langCasing('t')}}oInt(7); //12.5 -> 12

double xToFloat = new UnitOf.DataType(true).{{langCasing('t')}}oFloat(7.0f); //true -> 7.0

String xToString = new UnitOf.DataType(true).{{langCasing('t')}}oString("If Failed"); //"true" -> true

boolean xToBoolean = new UnitOf.DataType("TrUe").{{langCasing('t')}}oBoolean(); //"TrUe" -> true

boolean xExistsInCollection = new UnitOf.DataType("12.5").{{langCasing('t')}}oBoolean(new Integer[]{5,12,3},false,true); //"12.5" -> true

String xToFraction = new UnitOf.DataType(12.5).{{langCasing('t')}}oFraction(); //12.5 -> "25/2"

String xToReducedFrac = new UnitOf.DataType("2/4").{{langCasing('t')}}oFraction(); //"2/4" -> "1/2"

double fracToDouble = new UnitOf.DataType("2/4").{{langCasing('t')}}oDouble(); //"2/4" -> 0.5

char xToChar = new UnitOf.DataType(12.5).{{langCasing('t')}}oChar('@'); //12.5 -> '1'

Object xToObject = new UnitOf.DataType("12.5").{{langCasing('t')}}oObject(); //"12.5" -> "12.5"

byte xToByte = new UnitOf.DataType(12.5).{{langCasing('t')}}oByte((byte)7); //12.5 -> 12.5

short xToShort = new UnitOf.DataType(12).{{langCasing('t')}}oShort(); //12 -> 12

long xToLong = new UnitOf.DataType(12).{{langCasing('t')}}oLong(); //12 -> 12

sbyte xToSbyte = new UnitOf.DataType(12.5).ToSbyte(); //12.5 -> 12

uint xToUint = new UnitOf.DataType(12.5).ToUint((uint)7); //12.5 -> 12

ulong xToUlong = new UnitOf.DataType(12).ToUlong(); //12 -> 12

ushort xToUshort = new UnitOf.DataType(12).ToUshort(); //12 -> 12

decimal xToDecimal = new UnitOf.DataType(12).ToDecimal(7M); //12 -> 12

DateTime xToDateTime = new UnitOf.DataType("5/2").ToDateTime(); //"5/2/2018 12:00:00 AM"

TimeSpan xToTimeSpan = new UnitOf.DataType(12.5).ToTimeSpan(TimeSpan.FromMinutes(2)); //"00:02:00"

var xToFloat = UnitOf.DataType("12.5").toFloat(); //"12.5" -> 12.5

var xToInt = UnitOf.DataType(12.5).toInt(7); //12.5 -> 12

var xToString = UnitOf.DataType(12).toString(); //12 -> "12"

var xToBoolean = UnitOf.DataType("TrUe").toBoolean(); //"TrUe" -> true

var xExistsInCollection = UnitOf.DataType("12.5").toBoolean([5,12,3],false,true); //"12.5" -> true

var xToFraction = UnitOf.DataType(12.5).toFraction(); //12.5 -> "25/2"

var xToReducedFrac = UnitOf.DataType("2/4").toFraction(); //"2/4" -> "1/2"

var fracToDouble = UnitOf.DataType("2/4").toFloat(); //"2/4" -> 0.5

var xToChar = UnitOf.DataType(12.5).toChar('@'); //12.5 -> '1'

var xToNumber = UnitOf.DataType(12.5).toNumber(7.0); //"12.5" -> 12.5

{{bJS('UnitOf.')}}{{bJS('DataType')}}{{isJS('var','')}} x = {{bJS('new')}} UnitOf.DataType("12.5"); //String passed in

double xToDouble = x.{{langCasing('t')}}oDouble(); //"12.5" -> 12.5

int xToInt = x.{{langCasing('t')}}oInt(7); //"12.5" -> 12

double xToFloat = x.{{langCasing('t')}}oFloat(7.0f); //"12.5" -> 12.5

String xToString = x.{{langCasing('t')}}oString("If Failed"); //"12.5" -> "12.5"

boolean xToBoolean = x.{{langCasing('t')}}oBoolean(); //"12.5" -> false

boolean xExistsInCollection = x.{{langCasing('t')}}oBoolean(new Integer[]{5, 12, 3}, false, true); //"12.5" -> true

String xToFraction = x.{{langCasing('t')}}oFraction(); //12.5 -> "25/2"

char xToChar = x.{{langCasing('t')}}oChar('@'); //"12.5" -> '1'

Object xToObject = x.{{langCasing('t')}}oObject(); //"12.5" -> "12.5"

byte xToByte = x.{{langCasing('t')}}oByte((byte)7); //"12.5" -> 12.5

short xToShort = x.{{langCasing('t')}}oShort(); //"12.5" -> 12

long xToLong = x.{{langCasing('t')}}oLong(); //"12.5" -> 12

sbyte xToSbyte = x.ToSbyte(); //"12.5" -> 12

uint xToUint = x.ToUint((uint)7); //"12.5" -> 12

ulong xToUlong = x.ToUlong(); //"12.5" -> 12

ushort xToUshort = x.ToUshort(); //"12.5" -> 12

decimal xToDecimal = x.ToDecimal(7M); //"12.5" -> 12.5

DateTime xToDateTime = x.ToDateTime(); //"12/5/2018 12:00:00 AM"

TimeSpan xToTimeSpan = x.ToTimeSpan(TimeSpan.FromMinutes(2)); //"00:02:00"

var xToFloat = x.toFloat(); //"12.5" -> 12.5

var xToInt = x.toInt(7); //12.5 -> 12

var xToString = x.toString(); //12 -> "12"

var xToBoolean = x.toBoolean(); //"TrUe" -> true

var xExistsInCollection = x.toBoolean([5, 12, 3], false, true); //"12.5" -> true

var xToFraction = x.toFraction(); //12.5 -> "25/2"

var xToReducedFrac = x.toFraction(); //"2/4" -> "1/2"

var fracToDouble = x.toFloat(); //"2/4" -> 0.5

var xToChar = x.toChar('@'); //12.5 -> '1'

var xToNumber = x.toNumber(7.0); //"12.5" -> 12.5

/**

* Normal Syntax (Simple):

* Simply parse the value passed.

* An optional single parameter of the default value of true or false can be passed.

* Examples:

* {{bJS('new')}} UnitOf.DataType("true").{{langCasing('toBoolean()')}}; //Returns true

* {{bJS('new')}} UnitOf.DataType("Invalid").{{langCasing('toBoolean()')}}; //Returns false

* {{bJS('new')}} UnitOf.DataType("Invalid").{{langCasing('toBoolean(true)')}}; //Returns true

*-=-=-=-=-=-=-=-=-=-=-=-

* Extended Syntax (Complex):

* Rather than just converting the passed value to true or false as the "Normal Syntax (Simple)" does,

* {{langCasing('toBoolean')}} can compare the passed value against a collection of other Objects to find if there match, even of different data types.

* When a match exists between the passed object and the passed collection, true is returned. otherwise it is false.

* Constraints can be strengthened or loosened by enforcing case sensitivity or matching by containing only part of the value passed.

* UnitOf.{{langCasing('toBoolean()')}} allows passing in a collection of values where is the variable equals any one of them true will be returned.

* This can be combined with the other 2 parameters, caseSensitive and contains.

* caseSensitive being the UnitOf.DataType variable must match the casing of collection to return true.

* EX: caseSensitive = true, "UnitOf" & "unitof" = false

* caseSensitive = false, "UnitOf" & "unitof" = true

* contains being the collection passed has an element with a sequence of characters that are contains in the UnitOf.DataType variable.

* EX: contains = true, "UnitOf" & "Unit" = true

* contains = false, "UnitOf" & "tOf" = false

* These can be combined something like the following will return true: "uNiTOF" = "UNIt"

value used for the next 6 examples

{{isJS('','UnitOf.')}}{{isJS('','DataType')}}{{isJS('var','')}} x = {{bJS('new')}} UnitOf.DataType("12.5");

//Returns true for all

{{isJS('var','boolean')}} t1 = x.{{langCasing('toBoolean(')}}{{bJS('new ')}}{{bJS('String[]')}}{{isJS('[','{')}}"1.2", "12.5", "3"{{isJS(']','}')}}); //True, matches "12.5"

{{isJS('var','boolean')}} t2 = x.{{langCasing('toBoolean(')}}{{bJS('new ')}}{{javaJSOrCS('Float[]','','Object[]')}}{{isJS('[','{')}}1.2f, 12.5f, 3f{{isJS(']','}')}}); //True, matches 12.5

{{isJS('var','boolean')}} t3 = x.{{langCasing('toBoolean(')}}{{bJS('new ')}}{{javaJSOrCS('Integer[]','','Object[]')}}{{isJS('[','{')}}5, 12, 3{{isJS(']','}')}}, false, true); //True, matches 5 & 12

//Returns false for all

{{isJS('var','boolean')}} f1 = x.{{langCasing('toBoolean(')}}{{bJS('new ')}}{{bJS('String[]')}}{{isJS('[','{')}}"1.2", "12.55", "3"{{isJS(']','}')}}); //False, No matches

{{isJS('var','boolean')}} f2 = x.{{langCasing('toBoolean(')}}{{bJS('new ')}}{{javaJSOrCS('Float[]','','Object[]')}}{{isJS('[','{')}}1.2f, 12.55f, 3f{{isJS(']','}')}}); //False, No matches

{{isJS('var','boolean')}} f3 = x.{{langCasing('toBoolean(')}}{{bJS('new ')}}{{javaJSOrCS('Integer[]','','Object[]')}}{{isJS('[','{')}}5, 12, 3{{isJS(']','}')}}, false, false); //False, No matches

One line String examples

{{isJS('var','boolean')}} noCasingAndContains = {{bJS('new')}} UnitOf.DataType("UnitOf").{{langCasing('toBoolean(')}}{{bJS('new ')}}{{bJS('String[]')}}{{isJS('[','{')}}"Unit", "unitof", "ThisIsUnitOf"{{isJS(']','}')}}, true, true); //Returns true due to "Unit"

{{isJS('var','boolean')}} contains = {{bJS('new')}} UnitOf.DataType("UnitOf").{{langCasing('toBoolean(')}}{{bJS('new ')}}{{bJS('String[]')}}{{isJS('[','{')}}"Unit", "unitof", "ThisIsUnitOf"{{isJS(']','}')}},false, true); //Returns true: "Unit", "unitof"

{{isJS('var','boolean')}} equals = {{bJS('new')}} UnitOf.DataType("UnitOf").{{langCasing('toBoolean(')}}{{bJS('new ')}}{{bJS('String[]')}}{{isJS('[','{')}}"Unit", "unitof", "ThisIsUnitOf"{{isJS(']','}')}}); //Returns true. only "unitof"

{{isJS('var','boolean')}} noCasingAndEquals = {{bJS('new')}} UnitOf.DataType("UnitOf").{{langCasing('toBoolean(')}}{{bJS('new ')}}{{bJS('String[]')}}{{isJS('[','{')}}"Unit", "unitof", "ThisIsUnitOf"{{isJS(']','}')}}, true); //Returns false, no matches

Decimal to fraction

Convert whole numbers, decimals, and numbers in strings to fraction equivalent.

{{isJS('var','String')}} x1 = {{bJS('new')}} UnitOf.DataType(.5).{{langCasing('toFraction()')}}; //Returns "1/2"

{{isJS('var','String')}} x2 = {{bJS('new')}} UnitOf.DataType(.75).{{langCasing('toFraction()')}}; //Returns "3/4"

{{isJS('var','String')}} x3 = {{bJS('new')}} UnitOf.DataType("Invalid").{{langCasing('toFraction(')}}"2/3"); //Cannot create a fraction from this, default "2/3" is returned

{{isJS('var','String')}} x4 = {{bJS('new')}} UnitOf.DataType("-2").{{langCasing('toFraction()')}}; //Returns "-2" or "-2/1"

Fraction to Decimal

Convert the following fractions to their decimal ({{isJS('float','double')}}) equivalent.

{{isJS('var','double')}} y1 = {{bJS('new')}} UnitOf.DataType("2/4").{{javaJSOrCS('toDouble()','toFloat()','ToDouble()')}}; //Returns 0.5

{{isJS('var','double')}} y2 = {{bJS('new')}} UnitOf.DataType("Invalid").{{javaJSOrCS('toDouble(','toFloat(','ToDouble(')}}0.25); //Cannot create a fraction from this, default 0.25 is returned

{{isJS('var','double')}} y3 = {{bJS('new')}} UnitOf.DataType("4/2").{{javaJSOrCS('toDouble()','toFloat()','ToDouble()')}}; //Returns 2

Simplify the following existing fractions.

{{isJS('var','String')}} z1 = {{bJS('new')}} UnitOf.DataType("2/4").{{langCasing('toFraction()')}}; //Returns "1/2"

{{isJS('var','String')}} z2 = {{bJS('new')}} UnitOf.DataType("4/2").{{langCasing('toFraction()')}}; //Returns "2" or "2/1"

{{isJS('var','String')}} z3 = {{bJS('new')}} UnitOf.DataType("2/5").{{langCasing('toFraction()')}}; //Returns "2/5", cant get any simpler

{{isJS('var','String')}} z4 = {{bJS('new')}} UnitOf.DataType("Invalid").{{langCasing('toFraction(')}}"1/2"); //Cannot create a fraction from this, default "1/2" is returned

Syntax

In using example

* NOTE: For NumericBase to work in JavaScript, a reference to a BigInterger library MUST be made. The following was used in developing/testing UnitOf and is recommended: https://peterolson.github.io/BigInteger.js/BigInteger.min.js

UnitOf.NumericBase currently unsupported in C#. More info here:

try {

{{isJS('var','String')}} x = {{bJS('new')}} UnitOf.{{key}}{{bJS('()')}} .{{langCasing(docFromCode)}}() .{{langCasing(docToCode)}}{{bJS('()')}}; //{{convertMe(theNumericBaseUserInput, key, docFromCode, docToCode)}}

} catch ({{bJS('Exception ')}}e) {

//Handle exception: all NumericBase conversion "To" are throwable. This is due to many conversions having letters passed in that may not apply to other base units. Exceptions caught in this example will be displayed as N/A in the comment above.

}

try {

{{isJS('var','')}}{{bJS('UnitOf.')}}{{bJS( key)}} unit = {{bJS('new')}} UnitOf.{{key}}{{bJS('()')}} .{{langCasing(docFromCode)}}();

{{isJS('var','String')}} x = unit .{{langCasing(docToCode)}}{{bJS('()')}}; //{{convertMe(theNumericBaseUserInput, key, docFromCode, docToCode)}}

} catch ({{bJS('Exception ')}}e) {

}

try {

{{isJS('var','')}}{{bJS('UnitOf.')}}{{bJS( key)}} unit = {{bJS('new')}} UnitOf.{{key}}{{bJS('()')}};

unit = unit .{{langCasing(docFromCode)}}();

{{isJS('var','String')}} x = unit .{{langCasing(docToCode)}}{{bJS('()')}}; //{{convertMe(theNumericBaseUserInput, key, docFromCode, docToCode)}}

} catch ({{bJS('Exception ')}}e) {

}

Units Available

From (Initial Value and Unit Type)	To (Convert into)
{{k.replace('from','')}}	{{k.replace("from","")}}

Syntax

In using example

{{isJS('var','double')}} x = {{bJS('new')}} UnitOf.{{key}}{{bJS('()')}} .{{langCasing(docFromCode)}}() .{{langCasing(docToCode)}}{{bJS('()')}}; //{{convertMe(theUserInput, key, docFromCode, docToCode)}}

{{isJS('var','')}}{{bJS('UnitOf.')}}{{bJS( key)}} unit = {{bJS('new')}} UnitOf.{{key}}{{bJS('()')}} .{{langCasing(docFromCode)}}();

{{isJS('var','double')}} x = unit .{{langCasing(docToCode)}}{{bJS('()')}}; //{{convertMe(theUserInput, key, docFromCode, docToCode)}}

{{isJS('var','')}}{{bJS('UnitOf.')}}{{bJS( key)}} unit = {{bJS('new')}} UnitOf.{{key}}{{bJS('()')}};

unit = unit .{{langCasing(docFromCode)}}();

{{isJS('var','double')}} x = unit .{{langCasing(docToCode)}}{{bJS('()')}}; //{{convertMe(theUserInput, key, docFromCode, docToCode)}}

Units Available

From (Initial Value and Unit Type)	To (Convert into)
{{k.replace('from','')}}	{{k.replace("from","")}}

{{unitOfIs}}

Easiest and Fastest Measurement & Data Type Conversion Library.

- Available in Java, JavaScript, and C# -

{{category.name}}

{{UnitOfLength()}} Measurements in UnitOf

- Syntax, Units Available, and Examples -

Palindrome Conversion Algorithm

- How UnitOf converts under the hood -

Frequently Asked Questions