Skip to main content
Version: Python

to_j_period

to_j_period converts a date-time value into a Java Period, which is a length of time expressed as PnYnMnWnD, with n being numeric values for years, months, weeks, and days.

info

In query strings, users should choose the built-in function parsePeriod instead of to_j_period. For more information, see:

Syntax

to_j_period(dt: Union[None, Period, str, datetime.timedelta, numpy.timedelta64, pandas.Timedelta]) -> Period

Parameters

ParameterTypeDescription
sstr

A Python period or period string.

Period strings should be in the form of PnYnMnWnD, with n being numeric values; e.g., P1W for one week, P1M for one month, or P1W5D for one week plus five days.

Returns

Returns a Java Period.

Examples

from deephaven.time import to_j_period
import datetime
import numpy as np
import pandas as pd

p1 = datetime.timedelta(21)
p2 = np.timedelta64(1, "D")
p3 = pd.Timedelta(11, "d")

period_from_timedelta = to_j_period(p1)
period_from_timedelta64 = to_j_period(p2)
period_from_pd_timedelta = to_j_period(p3)
period_from_string = to_j_period("P1W5D")

print(period_from_timedelta)
print(period_from_timedelta64)
print(period_from_pd_timedelta)
print(period_from_string)