sparkling - v1.1.0

sparkling/types

Types

DateTime64

</>

DateTime64 with configurable precision and timezone.

Precision: 0-9 digits after decimal point (subsecond precision). Timezone: optional timezone identifier (e.g. “UTC”, “America/New_York”).

pub type DateTime64 {
  DateTime64(
    value: String,
    precision: Int,
    timezone: option.Option(String),
  )
}

Constructors 

  • DateTime64(
  value: String,
  precision: Int,
  timezone: option.Option(String),
)

Decimal

opaque </>

Decimal value with precision and scale preservation.

Stored as string to avoid floating-point precision loss. Use helper functions to convert to/from numeric types when needed.

pub opaque type Decimal

Enum16

</>

Enum16 type mapping (Int16 range: -32768..32767).

pub type Enum16 {
  Enum16(mappings: List(#(String, Int)))
}

Constructors 

  • Enum16(mappings: List(#(String, Int)))

Enum8

</>

Enum8 type mapping (Int8 range: -128..127).

pub type Enum8 {
  Enum8(mappings: List(#(String, Int)))
}

Constructors 

  • Enum8(mappings: List(#(String, Int)))

LowCardinality

opaque </>

LowCardinality wrapper for values with low cardinality.

This is a performance hint to ClickHouse for storage optimization.

pub opaque type LowCardinality

UUID

opaque </>

UUID type (128-bit identifier).

Standard format: 8-4-4-4-12 hex digits (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

pub opaque type UUID

Values

datetime64

</> 
pub fn datetime64(
  value: String,
  precision: Int,
  timezone: option.Option(String),
) -> Result(DateTime64, String)

Create a DateTime64 from an ISO 8601 string or epoch string.

datetime64_from_epoch

</> 
pub fn datetime64_from_epoch(
  epoch_seconds: Int,
  precision: Int,
  timezone: option.Option(String),
) -> Result(DateTime64, String)

Create a DateTime64 from Unix epoch (seconds).

datetime64_timezone

</> 
pub fn datetime64_timezone(
  dt: DateTime64,
) -> option.Option(String)

Get the timezone of a DateTime64.

datetime64_to_string

</> 
pub fn datetime64_to_string(dt: DateTime64) -> String

Get the string representation of a DateTime64.

decimal

</> 
pub fn decimal(value: String) -> Result(Decimal, String)

Create a Decimal from a string representation.

decimal_from_float

</> 
pub fn decimal_from_float(
  value: Float,
) -> Result(Decimal, String)

Create a Decimal from a float. Returns an error for values that cannot be represented as a plain decimal string (e.g. very large floats). Note: floats may lose precision; prefer decimal/1 with an explicit string.

decimal_from_int

</> 
pub fn decimal_from_int(value: Int) -> Decimal

Create a Decimal from an integer.

decimal_to_string

</> 
pub fn decimal_to_string(d: Decimal) -> String

Get the string representation of a Decimal.

enum16_from_string

</> 
pub fn enum16_from_string(
  mappings: List(#(String, Int)),
  value: String,
) -> Result(Int, String)

Look up an Enum16 value by string label. Returns an error if the label is not found or the mapped value is out of Int16 range [-32768, 32767].

enum8_from_string

</> 
pub fn enum8_from_string(
  mappings: List(#(String, Int)),
  value: String,
) -> Result(Int, String)

Look up an Enum8 value by string label. Returns an error if the label is not found or the mapped value is out of Int8 range [-128, 127].

low_cardinality_string

</> 
pub fn low_cardinality_string(value: String) -> LowCardinality

Create a LowCardinality from a string value.

low_cardinality_value

</> 
pub fn low_cardinality_value(lc: LowCardinality) -> String

Get the value from a LowCardinality wrapper.

uuid

</> 
pub fn uuid(value: String) -> Result(UUID, String)

Create a UUID from string representation.

uuid_to_string

</> 
pub fn uuid_to_string(u: UUID) -> String

Get the string representation of a UUID.

✨ Search Document