Utils

Convert timestamp to milliseconds since epoch

cognite.client.utils.timestamp_to_ms(timestamp: int | float | str | datetime) int

Returns the ms representation of some timestamp given by milliseconds, time-ago format or datetime object

Parameters

timestamp (int | float | str | datetime) – Convert this timestamp to ms.

Returns

Milliseconds since epoch representation of timestamp

Return type

int

Convert milliseconds since epoch to datetime

cognite.client.utils.ms_to_datetime(ms: int | float) datetime

Converts valid Cognite timestamps, i.e. milliseconds since epoch, to datetime object.

Parameters

ms (int | float) – Milliseconds since epoch.

Raises

ValueError – On invalid Cognite timestamps.

Returns

Aware datetime object in UTC.

Return type

datetime

Convert datetime to milliseconds since epoch

cognite.client.utils.datetime_to_ms(dt: datetime) int

Converts a datetime object to milliseconds since epoch.

Parameters

dt (datetime) – Naive or aware datetime object. Naive datetimes are interpreted as local time.

Returns

Milliseconds since epoch (negative for time prior to 1970-01-01)

Return type

int