Convert

This package contains “soft” data converters. Soft data converters differ from the data conversion algorithms found in typical programming language, due to the fact that they support rare conversions between various data types (such as integer to timespan, timespan to string, and so on). These converters are useful due to the fact that data in enterprise systems is represented in various forms, requiring frequent conversion and at times in very difficult combinations.

Constants

TypeCode

Codes for the data types that can be converted using TypeConverter.


Classes

ArrayConverter

Converts arbitrary values into array objects.

BooleanConverter

Converts arbitrary values to boolean values using extended conversion rules:

  • Numbers: <>0 are true, =0 are false
  • Strings: “true”, “yes”, “T”, “Y”, “1” are true; “false”, “no”, “F”, “N” are false
  • DateTime: <>0 total milliseconds are true, =0 are false

DateTimeConverter

Converts arbitrary values into Date values using extended conversion rules:

  • Strings: converted using ISO time format
  • Numbers: converted using milliseconds since unix epoch

DoubleConverter

Converts arbitrary values into double using extended conversion rules:

  • Strings are converted to double values
  • DateTime: total number of milliseconds since unix epoch
  • Boolean: 1 for true and 0 for false

FloatConverter

Converts arbitrary values into float using extended conversion rules:

  • Strings are converted to float values
  • DateTime: total number of milliseconds since unix epoch
  • Boolean: 1 for true and 0 for false

IntegerConverter

Converts arbitrary values into integers using extended conversion rules:

  • Strings are converted to floats, then to integers
  • DateTime: total number of milliseconds since unix epoch
  • Boolean: 1 for true and 0 for false

JsonConverter

Converts arbitrary values into longs using extended conversion rules:

  • Strings are converted to floats, then to longs
  • DateTime: total number of milliseconds since unix epoch
  • Boolean: 1 for true and 0 for false

MapConverter

Converts arbitrary values into map objects using extended conversion rules:

  • Objects: property names as keys, property values as values
  • Arrays: element indexes as keys, elements as values

RecursiveMapConverter

Converts arbitrary values into map objects using extended conversion rules. This class is similar to MapConverter, but is recursively converts all values stored in objects and arrays.

StringConverter

Converts arbitrary values into strings using extended conversion rules:

  • Numbers: are converted with ‘.’ as decimal point
  • DateTime: using ISO format
  • Boolean: “true” for true and “false” for false
  • Arrays: as comma-separated list
  • Other objects: using to_string() method

TypeConverter

Converts arbitrary values into objects specific by TypeCodes. For each TypeCode this class calls corresponding converter which applies extended conversion rules to convert the values.