pyarrow.TimestampType#
- class pyarrow.TimestampType#
Bases:
DataType
Concrete class for timestamp data types.
Examples
>>> import pyarrow as pa
Create an instance of timestamp type:
>>> pa.timestamp('us') TimestampType(timestamp[us])
Create an instance of timestamp type with timezone:
>>> pa.timestamp('s', tz='UTC') TimestampType(timestamp[s, tz=UTC])
- __init__(*args, **kwargs)#
Methods
__init__
(*args, **kwargs)equals
(self, other, *[, check_metadata])Return true if type is equivalent to passed value.
field
(self, i)- Parameters:
to_pandas_dtype
(self)Return the equivalent NumPy / Pandas dtype.
Attributes
Bit width for fixed width type.
Number of data buffers required to construct Array type excluding children.
The number of child fields.
The timestamp time zone, if any, or None.
The timestamp unit ('s', 'ms', 'us' or 'ns').
- bit_width#
Bit width for fixed width type.
Examples
>>> import pyarrow as pa >>> pa.int64() DataType(int64) >>> pa.int64().bit_width 64
- equals(self, other, *, check_metadata=False)#
Return true if type is equivalent to passed value.
- Parameters:
- Returns:
- is_equalbool
Examples
>>> import pyarrow as pa >>> pa.int64().equals(pa.string()) False >>> pa.int64().equals(pa.int64()) True
- id#
- num_buffers#
Number of data buffers required to construct Array type excluding children.
Examples
>>> import pyarrow as pa >>> pa.int64().num_buffers 2 >>> pa.string().num_buffers 3
- num_fields#
The number of child fields.
Examples
>>> import pyarrow as pa >>> pa.int64() DataType(int64) >>> pa.int64().num_fields 0 >>> pa.list_(pa.string()) ListType(list<item: string>) >>> pa.list_(pa.string()).num_fields 1 >>> struct = pa.struct({'x': pa.int32(), 'y': pa.string()}) >>> struct.num_fields 2
- to_pandas_dtype(self)#
Return the equivalent NumPy / Pandas dtype.
Examples
>>> import pyarrow as pa >>> pa.int64().to_pandas_dtype() <class 'numpy.int64'>
- tz#
The timestamp time zone, if any, or None.
Examples
>>> import pyarrow as pa >>> t = pa.timestamp('s', tz='UTC') >>> t.tz 'UTC'
- unit#
The timestamp unit (‘s’, ‘ms’, ‘us’ or ‘ns’).
Examples
>>> import pyarrow as pa >>> t = pa.timestamp('us') >>> t.unit 'us'