Apache Arrow data types

These functions create type objects corresponding to Arrow types. Use them when defining a schema() or as inputs to other types, like struct. Most of these functions don't take arguments, but a few do.

int8()

int16()

int32()

int64()

uint8()

uint16()

uint32()

uint64()

float16()

halffloat()

float32()

float()

float64()

boolean()

bool()

utf8()

large_utf8()

binary()

large_binary()

fixed_size_binary(byte_width)

string()

date32()

date64()

time32(unit = c("ms", "s"))

time64(unit = c("ns", "us"))

null()

timestamp(unit = c("s", "ms", "us", "ns"), timezone = "")

decimal(precision, scale)

list_of(type)

large_list_of(type)

fixed_size_list_of(type, list_size)

struct(...)

Arguments

byte_width	byte width for FixedSizeBinary type.
unit	For time/timestamp types, the time unit. time32() can take either "s" or "ms", while time64() can be "us" or "ns". timestamp() can take any of those four values.
timezone	For timestamp(), an optional time zone string.
precision	For decimal(), precision
scale	For decimal(), scale
type	For list_of(), a data type to make a list-of-type
list_size	list size for FixedSizeList type.
...	For struct(), a named list of types to define the struct columns

Value

An Arrow type object inheriting from DataType.

Details

A few functions have aliases:

• utf8() and string()

• float16() and halffloat()

• float32() and float()

• bool() and boolean()

• Called from schema() or struct(), double() also is supported as a way of creating a float64()

date32() creates a datetime type with a "day" unit, like the R Date class. date64() has a "ms" unit.

See also

dictionary() for creating a dictionary (factor-like) type.

Examples

# \donttest{
bool()
#> Boolean
#> bool
struct(a = int32(), b = double())
#> StructType
#> struct<a: int32, b: double>
timestamp("ms", timezone = "CEST")
#> Timestamp
#> timestamp[ms, tz=CEST]
time64("ns")
#> Time64
#> time64[ns]
# }