time_table

The time_table method creates a time table that adds new rows at a specified interval. The resulting table has one date-time column, Timestamp.

Syntax

time_table(
  period: Union[dtypes.Duration, int, str, datetime.timedelta, np.timedelta64, pd.Timdelta],
  start_time: Union[None, str, datetime.datetime, np.datetime64] = None,
  blink_table: bool = False,
  ) -> Table

Parameters

Parameter	Type	Description
period	Union[dtypes.Duration, int, str, datetime.timedelta, np.timedelta64, pd.Timdelta]	The time interval between new row additions. Can be given as: Duration string such as "PT1S" or "PT00:01:00". Integer format is in nanoseconds. String input format is "PT00:00:00:00.001" - days, hours, minutes, seconds, and milliseconds. A datetime.timedelta object. A numpy.timedelta64 object. A pandas.Timedelta object.
start_time optional	Union[None, str, datetime.datetime, np.datetime64	The value of the date-time in the first row of the table. String inputs must be given in syntax matching YYYY-MM-DDThh:mm:ss.dddddddd TZ. danger Setting start_time sufficiently far in the past, coupled with a short period, can cause the time table to instantly populate with a very large number of rows.
blink_table optional	bool	If the time table should be a blink table; defaults to False.

Returns

A ticking time table that adds new rows at the specified interval.

Example

The following example creates a time table that adds one new row every second.

from deephaven import time_table

result = time_table("PT1S")

Related documentation

• Create a table with time_table
• How to reduce the update frequency of ticking tables
• How to capture the history of ticking tables
• empty_table
• new_table
• dh_now
• to_j_duration
• Pydoc