hikyuu2/hikyuu_pywrap/_TimeDelta.cpp

/*
 * _TimeDelta.cpp
 *
 *  Copyright (C) 2019 hikyuu.org
 *
 *  Created on: 2019-12-14
 *      Author: fasiondog
 */

#include <boost/python.hpp>
#include <hikyuu/serialization/TimeDelta_serialization.h>
#include "pickle_support.h"

using namespace boost::python;
using namespace hku;

double (TimeDelta::*TimeDelta_div_1)(TimeDelta) const = &TimeDelta::operator/;
TimeDelta (TimeDelta::*TimeDelta_div_2)(double) const = &TimeDelta::operator/;

TimeDelta (TimeDelta::*TimeDelta_pos)() const = &TimeDelta::operator+;
TimeDelta (TimeDelta::*TimeDelta_neg)() const = &TimeDelta::operator-;

void export_TimeDelta() {
    class_<TimeDelta>("TimeDelta",
                      R"(时间时长，用于时间计算。可通过以下方式构建：

    - 通过 datetime.timedelta 构建。TimdeDelta(timedelta实例)
    - TimeDelta(days=0, hours=0, minutes=0, seconds=0, milliseconds=0, microseconds=0)

        - -99999999 <= days <= 99999999
        - -100000 <= hours <= 100000
        - -100000 <= minutes <= 100000
        - -8639900 <= seconds <= 8639900
        - -86399000000 <= milliseconds <= 86399000000
        - -86399000000 <= microseconds <= 86399000000

    以上参数限制，主要为防止求总微秒数时可能出现溢出的情况。如只使用一个参数不希望存在上述限制时，可使用快捷函数：
    Days, Hours, Minutes, Seconds, Milliseconds, Microseconds)")

      .def(init<>())
      .def(init<int64_t, int64_t, int64_t, int64_t, int64_t, int64_t>(
        (arg("days") = 0, arg("hours") = 0, arg("minutes") = 0, arg("seconds") = 0,
         arg("milliseconds") = 0, arg("microseconds") = 0)))

      .def("__str__", &TimeDelta::str)
      .def("__repr__", &TimeDelta::repr)

      .add_property("days", &TimeDelta::days, "天数 [-99999999, 99999999]")
      .add_property("hours", &TimeDelta::hours, "小时数 [0, 23]")
      .add_property("minutes", &TimeDelta::minutes, "分钟数 [0, 59]")
      .add_property("seconds", &TimeDelta::seconds, "秒数 [0, 59]")
      .add_property("milliseconds", &TimeDelta::milliseconds, "毫秒数 [0, 999]")
      .add_property("microseconds", &TimeDelta::microseconds, "微秒数 [0, 999]")
      .add_property("ticks", &TimeDelta::ticks, "同总微秒数")

      .def("isNegative", &TimeDelta::isNegative, R"(isNegative(self)

    是否为负时长

    :rtype: bool)")

      .def("total_days", &TimeDelta::total_days, R"(total_days(self)

    获取带小数的总天数

    :rtype: float)")

      .def("total_hours", &TimeDelta::total_hours, R"(total_hours(self)

    获取带小数的总小时数

    :rtype: float)")

      .def("total_minutes", &TimeDelta::total_minutes, R"(total_minutes(self)

    获取带小数的总分钟数

    :rtype: float)")

      .def("total_seconds", &TimeDelta::total_seconds, R"(total_seconds(self)

    获取带小数的总秒数

    :rtype: float)")

      .def("total_milliseconds", &TimeDelta::total_milliseconds, R"(total_milliseconds(self)

    获取带小数的总毫秒数

    :rtype: float)")

      .def("max", &TimeDelta::max, R"(max()

    支持的最大时长

    :return: TimeDelta(99999999, 23, 59, 59, 999, 999))")
      .staticmethod("max")

      .def("min", &TimeDelta::min, R"(min()

    支持的最小时长

    :return: TimeDelta(-99999999, 0, 0, 0, 0, 0))")
      .staticmethod("min")

      .def("resolution", &TimeDelta::resolution, R"(resolution()

    支持的最小精度
        
    :return: TimeDelta(0, 0, 0, 0, 0, 1))")
      .staticmethod("resolution")

      .def("maxTicks", &TimeDelta::maxTicks, R"(maxTicks()

    支持的最大 ticks （即微秒数）

    :rtype: int)")
      .staticmethod("maxTicks")

      .def("minTicks", &TimeDelta::minTicks, R"(minTicks()

    支持的最小 ticks （即微秒数）

    :rtype: int)")
      .staticmethod("minTicks")

      .def("fromTicks", &TimeDelta::fromTicks, R"(fromTicks(ticks)

    使用 ticks（即微秒数） 值创建

    :param int ticks: 微秒数
    :rtype: TimeDelta)")
      .staticmethod("fromTicks")

      .def(self == self)
      .def(self != self)
      .def(self >= self)
      .def(self <= self)
      .def(self > self)
      .def(self < self)
      .def(-self)
      .def(+self)
      .def(self + self)
      .def(self - self)
      .def(self % self)
      .def(self * float())

      .def("__abs__", &TimeDelta::abs)
      .def("__rmul__", &TimeDelta::operator*)
      .def("__truediv__", TimeDelta_div_1)
      .def("__truediv__", TimeDelta_div_2)
      .def("__floordiv__", &TimeDelta::floorDiv)

#if HKU_PYTHON_SUPPORT_PICKLE
      .def_pickle(normal_pickle_suite<TimeDelta>())
#endif
      ;

    def("Days", Days, R"(Days(days)

      TimeDelta 快捷创建函数

      :param int days: 天数 [-99999999, 99999999]
      :rtype: TimeDelta)");

    def("Hours", Hours, R"(Hours(hours)

      TimeDelta 快捷创建函数

      :param int hours: 小时数
      :rtype: TimeDelta)");

    def("Minutes", Minutes, R"(Minutes(mins)

      TimeDelta 快捷创建函数

      :param int mins: 分钟数
      :rtype: TimeDelta)");

    def("Seconds", Seconds, R"(Seconds(secs)

      TimeDelta 快捷创建函数

      :param int secs: 秒数
      :rtype: TimeDelta)");

    def("Milliseconds", Milliseconds, R"(Milliseconds(milliseconds)

      TimeDelta 快捷创建函数

      :param int milliseconds: 毫秒数
      :rtype: TimeDelta)");

    def("Microseconds", Microseconds, R"(Microseconds(microsecs)

      TimeDelta 快捷创建函数

      :param int microsecs: 微秒数
      :rtype: TimeDelta)");
}