Struct FormatOptions 

pub struct FormatOptions<'a> {
    safe: bool,
    null: &'a str,
    date_format: Option<&'a str>,
    datetime_format: Option<&'a str>,
    timestamp_format: Option<&'a str>,
    timestamp_tz_format: Option<&'a str>,
    time_format: Option<&'a str>,
    duration_format: DurationFormat,
    types_info: bool,
    formatter_factory: Option<&'a dyn ArrayFormatterFactory>,
}

Options for formatting arrays

By default nulls are formatted as "" and temporal types formatted according to RFC3339

Equality

Most fields in FormatOptions are compared by value, except formatter_factory. As the trait does not require an Eq and Hash implementation, this struct only compares the pointer of the factories.

Fields

safe: bool

If set to true any formatting errors will be written to the output instead of being converted into a std::fmt::Error

null: &'a str

Format string for nulls

date_format: Option<&'a str>

Date format for date arrays

datetime_format: Option<&'a str>

Format for DateTime arrays

timestamp_format: Option<&'a str>

Timestamp format for timestamp arrays

timestamp_tz_format: Option<&'a str>

Timestamp format for timestamp with timezone arrays

time_format: Option<&'a str>

Time format for time arrays

duration_format: DurationFormat

Duration format

types_info: bool

Show types in visual representation batches

formatter_factory: Option<&'a dyn ArrayFormatterFactory>

Formatter factory used to instantiate custom ArrayFormatters. This allows users to provide custom formatters.

Implementations

impl<'a> FormatOptions<'a>

pub const fn new() -> Self

Creates a new set of format options

pub const fn with_display_error(self, safe: bool) -> Self

If set to true any formatting errors will be written to the output instead of being converted into a std::fmt::Error

pub const fn with_null(self, null: &'a str) -> Self

Overrides the string used to represent a null

Defaults to ""

pub const fn with_date_format(self, date_format: Option<&'a str>) -> Self

Overrides the format used for [DataType::Date32] columns

pub const fn with_datetime_format( self, datetime_format: Option<&'a str>, ) -> Self

Overrides the format used for [DataType::Date64] columns

pub const fn with_timestamp_format( self, timestamp_format: Option<&'a str>, ) -> Self

Overrides the format used for [DataType::Timestamp] columns without a timezone

pub const fn with_timestamp_tz_format( self, timestamp_tz_format: Option<&'a str>, ) -> Self

Overrides the format used for [DataType::Timestamp] columns with a timezone

pub const fn with_time_format(self, time_format: Option<&'a str>) -> Self

Overrides the format used for [DataType::Time32] and [DataType::Time64] columns

pub const fn with_duration_format(self, duration_format: DurationFormat) -> Self

Overrides the format used for duration columns

Defaults to DurationFormat::ISO8601

pub const fn with_types_info(self, types_info: bool) -> Self

Overrides if types should be shown

Defaults to false

pub const fn with_formatter_factory( self, formatter_factory: Option<&'a dyn ArrayFormatterFactory>, ) -> Self

Overrides the ArrayFormatterFactory used to instantiate custom ArrayFormatters.

Using None causes pretty-printers to use the default ArrayFormatters.

pub const fn safe(&self) -> bool

Returns whether formatting errors should be written to the output instead of being converted into a std::fmt::Error.

pub const fn null(&self) -> &'a str

Returns the string used for displaying nulls.

pub const fn date_format(&self) -> Option<&'a str>

Returns the format used for [DataType::Date32] columns.

pub const fn datetime_format(&self) -> Option<&'a str>

Returns the format used for [DataType::Date64] columns.

pub const fn timestamp_format(&self) -> Option<&'a str>

Returns the format used for [DataType::Timestamp] columns without a timezone.

pub const fn timestamp_tz_format(&self) -> Option<&'a str>

Returns the format used for [DataType::Timestamp] columns with a timezone.

pub const fn time_format(&self) -> Option<&'a str>

Returns the format used for [DataType::Time32] and [DataType::Time64] columns.

pub const fn duration_format(&self) -> DurationFormat

Returns the DurationFormat used for duration columns.

pub const fn types_info(&self) -> bool

Returns true if type info should be included in a visual representation of batches.

pub const fn formatter_factory(&self) -> Option<&'a dyn ArrayFormatterFactory>

Returns the ArrayFormatterFactory used to instantiate custom ArrayFormatters.

Trait Implementations

impl<'a> Clone for FormatOptions<'a>

fn clone(&self) -> FormatOptions<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for FormatOptions<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FormatOptions<'_>

fn default() -> Self

Returns the “default value” for a type.

impl Hash for FormatOptions<'_>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FormatOptions<'_>

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for FormatOptions<'_>