You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@arrow.apache.org by we...@apache.org on 2018/08/07 01:02:31 UTC

[16/51] [partial] arrow-site git commit: Update documentation for 0.10.0

http://git-wip-us.apache.org/repos/asf/arrow-site/blob/7f9d5fdc/docs/cpp/datetime_8h_source.html
----------------------------------------------------------------------
diff --git a/docs/cpp/datetime_8h_source.html b/docs/cpp/datetime_8h_source.html
index 5103def..d852146 100644
--- a/docs/cpp/datetime_8h_source.html
+++ b/docs/cpp/datetime_8h_source.html
@@ -70,17 +70,18 @@ $(function() {
 <div class="title">datetime.h</div>  </div>
 </div><!--header-->
 <div class="contents">
-<a href="datetime_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span>&#160;<span class="comment">// Licensed to the Apache Software Foundation (ASF) under one</span></div><div class="line"><a name="l00002"></a><span class="lineno">    2</span>&#160;<span class="comment">// or more contributor license agreements.  See the NOTICE file</span></div><div class="line"><a name="l00003"></a><span class="lineno">    3</span>&#160;<span class="comment">// distributed with this work for additional information</span></div><div class="line"><a name="l00004"></a><span class="lineno">    4</span>&#160;<span class="comment">// regarding copyright ownership.  The ASF licenses this file</span></div><div class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span class="comment">// to you under the Apache License, Version 2.0 (the</span></div><div class="line"><a name="l00006"></a><span clas
 s="lineno">    6</span>&#160;<span class="comment">// &quot;License&quot;); you may not use this file except in compliance</span></div><div class="line"><a name="l00007"></a><span class="lineno">    7</span>&#160;<span class="comment">// with the License.  You may obtain a copy of the License at</span></div><div class="line"><a name="l00008"></a><span class="lineno">    8</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00009"></a><span class="lineno">    9</span>&#160;<span class="comment">//   http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="comment">// Unless required by applicable law or agreed to in writing,</span></div><div class="line"><a name="l00012"></a><span class="lineno">   12</span>&#160;<span class="comment">// software distributed 
 under the License is distributed on an</span></div><div class="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="comment">// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="comment">// KIND, either express or implied.  See the License for the</span></div><div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;<span class="comment">// specific language governing permissions and limitations</span></div><div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;<span class="comment">// under the License.</span></div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;</div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#ifndef PYARROW_UTIL_DATETIME_H</span></div><div class="line"><a name="l00019"></a><span class="lin
 eno">   19</span>&#160;<span class="preprocessor">#define PYARROW_UTIL_DATETIME_H</span></div><div class="line"><a name="l00020"></a><span class="lineno">   20</span>&#160;</div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="preprocessor">#include &lt;algorithm&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span class="preprocessor">#include &lt;sstream&gt;</span></div><div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;</div><div class="line"><a name="l00024"></a><span class="lineno">   24</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="datetime_8h.html">datetime.h</a>&gt;</span></div><div class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="platform_8h.html">arrow/python/platform.h</a>&quot;</span></div><div class="line"><a name="l00026"></a><span class="li
 neno">   26</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="status_8h.html">arrow/status.h</a>&quot;</span></div><div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="logging_8h.html">arrow/util/logging.h</a>&quot;</span></div><div class="line"><a name="l00028"></a><span class="lineno">   28</span>&#160;</div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespacearrow.html">arrow</a> {</div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;<span class="keyword">namespace </span>py {</div><div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;</div><div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;<span class="comment">// The following code is adapted from</span></div><div class="line"><a name="l0003
 3"></a><span class="lineno">   33</span>&#160;<span class="comment">// https://github.com/numpy/numpy/blob/master/numpy/core/src/multiarray/datetime.c</span></div><div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;</div><div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;<span class="comment">// Days per month, regular year and leap year</span></div><div class="line"><a name="l00036"></a><span class="lineno">   36</span>&#160;<span class="keyword">static</span> int64_t _days_per_month_table[2][12] = {</div><div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;    {31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31},</div><div class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;    {31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}};</div><div class="line"><a name="l00039"></a><span class="lineno">   39</span>&#160;</div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&
 #160;<span class="keyword">static</span> <span class="keywordtype">bool</span> is_leapyear(int64_t year) {</div><div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;  <span class="keywordflow">return</span> (year &amp; 0x3) == 0 &amp;&amp;  <span class="comment">// year % 4 == 0</span></div><div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;         ((year % 100) != 0 || (year % 400) == 0);</div><div class="line"><a name="l00043"></a><span class="lineno">   43</span>&#160;}</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;</div><div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;<span class="comment">// Calculates the days offset from the 1970 epoch.</span></div><div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;<span class="keyword">static</span> int64_t get_days_from_date(int64_t date_year, int64_t date_month,</div><div class="line"><a name="l0
 0047"></a><span class="lineno">   47</span>&#160;                                  int64_t date_day) {</div><div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;  int64_t i, month;</div><div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;  int64_t year, days = 0;</div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;  int64_t* month_lengths;</div><div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;</div><div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;  year = date_year - 1970;</div><div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;  days = year * 365;</div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;</div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;  <span class="comment">// Adjust for leap years</span></div><div class="line"><a name="l00056"></a><span cl
 ass="lineno">   56</span>&#160;  <span class="keywordflow">if</span> (days &gt;= 0) {</div><div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;    <span class="comment">// 1968 is the closest leap year before 1970.</span></div><div class="line"><a name="l00058"></a><span class="lineno">   58</span>&#160;    <span class="comment">// Exclude the current year, so add 1.</span></div><div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;    year += 1;</div><div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;    <span class="comment">// Add one day for each 4 years</span></div><div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;    days += year / 4;</div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;    <span class="comment">// 1900 is the closest previous year divisible by 100</span></div><div class="line"><a name="l00063"></a><span class="lineno">   63</s
 pan>&#160;    year += 68;</div><div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;    <span class="comment">// Subtract one day for each 100 years</span></div><div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;    days -= year / 100;</div><div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;    <span class="comment">// 1600 is the closest previous year divisible by 400</span></div><div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;    year += 300;</div><div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;    <span class="comment">// Add one day for each 400 years</span></div><div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;    days += year / 400;</div><div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;  } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00071"></a><span class
 ="lineno">   71</span>&#160;    <span class="comment">// 1972 is the closest later year after 1970.</span></div><div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;    <span class="comment">// Include the current year, so subtract 2.</span></div><div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;    year -= 2;</div><div class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;    <span class="comment">// Subtract one day for each 4 years</span></div><div class="line"><a name="l00075"></a><span class="lineno">   75</span>&#160;    days += year / 4;</div><div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;    <span class="comment">// 2000 is the closest later year divisible by 100</span></div><div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;    year -= 28;</div><div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;    <span class="comment"
 >// Add one day for each 100 years</span></div><div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;    days -= year / 100;</div><div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;    <span class="comment">// 2000 is also the closest later year divisible by 400</span></div><div class="line"><a name="l00081"></a><span class="lineno">   81</span>&#160;    <span class="comment">// Subtract one day for each 400 years</span></div><div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;    days += year / 400;</div><div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;  }</div><div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;</div><div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;  month_lengths = _days_per_month_table[is_leapyear(date_year)];</div><div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;  month = da
 te_month - 1;</div><div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;</div><div class="line"><a name="l00088"></a><span class="lineno">   88</span>&#160;  <span class="comment">// Add the months</span></div><div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;  <span class="keywordflow">for</span> (i = 0; i &lt; month; ++i) {</div><div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;    days += month_lengths[i];</div><div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;  }</div><div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;</div><div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;  <span class="comment">// Add the days</span></div><div class="line"><a name="l00094"></a><span class="lineno">   94</span>&#160;  days += date_day - 1;</div><div class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;</div><div c
 lass="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;  <span class="keywordflow">return</span> days;</div><div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;}</div><div class="line"><a name="l00098"></a><span class="lineno">   98</span>&#160;</div><div class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;<span class="comment">// Modifies &#39;*days_&#39; to be the day offset within the year,</span></div><div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;<span class="comment">// and returns the year.</span></div><div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;<span class="keyword">static</span> int64_t days_to_yearsdays(int64_t* days_) {</div><div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;  <span class="keyword">const</span> int64_t days_per_400years = (400 * 365 + 100 - 4 + 1);</div><div class="line"><a name="l00103"></a><span clas
 s="lineno">  103</span>&#160;  <span class="comment">// Adjust so it&#39;s relative to the year 2000 (divisible by 400)</span></div><div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;  int64_t days = (*days_) - (365 * 30 + 7);</div><div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;  int64_t year;</div><div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;</div><div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;  <span class="comment">// Break down the 400 year cycle to get the year and day within the year</span></div><div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;  <span class="keywordflow">if</span> (days &gt;= 0) {</div><div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;    year = 400 * (days / days_per_400years);</div><div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;    days = days % days_p
 er_400years;</div><div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;  } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;    year = 400 * ((days - (days_per_400years - 1)) / days_per_400years);</div><div class="line"><a name="l00113"></a><span class="lineno">  113</span>&#160;    days = days % days_per_400years;</div><div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;    <span class="keywordflow">if</span> (days &lt; 0) {</div><div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;      days += days_per_400years;</div><div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;    }</div><div class="line"><a name="l00117"></a><span class="lineno">  117</span>&#160;  }</div><div class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;</div><div class="line"><a name="l00119"></a><span class="lineno"> 
  119</span>&#160;  <span class="comment">// Work out the year/day within the 400 year cycle</span></div><div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;  <span class="keywordflow">if</span> (days &gt;= 366) {</div><div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;    year += 100 * ((days - 1) / (100 * 365 + 25 - 1));</div><div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;    days = (days - 1) % (100 * 365 + 25 - 1);</div><div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;    <span class="keywordflow">if</span> (days &gt;= 365) {</div><div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;      year += 4 * ((days + 1) / (4 * 365 + 1));</div><div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;      days = (days + 1) % (4 * 365 + 1);</div><div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;      <span
  class="keywordflow">if</span> (days &gt;= 366) {</div><div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;        year += (days - 1) / 365;</div><div class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;        days = (days - 1) % 365;</div><div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;      }</div><div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;    }</div><div class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;  }</div><div class="line"><a name="l00132"></a><span class="lineno">  132</span>&#160;</div><div class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;  *days_ = days;</div><div class="line"><a name="l00134"></a><span class="lineno">  134</span>&#160;  <span class="keywordflow">return</span> year + 2000;</div><div class="line"><a name="l00135"></a><span class="lineno">  135</span>&#160;}</div><div class="line"><a name="l00136">
 </a><span class="lineno">  136</span>&#160;</div><div class="line"><a name="l00137"></a><span class="lineno">  137</span>&#160;<span class="comment">// Extracts the month and year and day number from a number of days</span></div><div class="line"><a name="l00138"></a><span class="lineno">  138</span>&#160;<span class="keyword">static</span> <span class="keywordtype">void</span> get_date_from_days(int64_t days, int64_t* date_year, int64_t* date_month,</div><div class="line"><a name="l00139"></a><span class="lineno">  139</span>&#160;                               int64_t* date_day) {</div><div class="line"><a name="l00140"></a><span class="lineno">  140</span>&#160;  int64_t *month_lengths, i;</div><div class="line"><a name="l00141"></a><span class="lineno">  141</span>&#160;</div><div class="line"><a name="l00142"></a><span class="lineno">  142</span>&#160;  *date_year = days_to_yearsdays(&amp;days);</div><div class="line"><a name="l00143"></a><span class="lineno">  143</span>&#160;
   month_lengths = _days_per_month_table[is_leapyear(*date_year)];</div><div class="line"><a name="l00144"></a><span class="lineno">  144</span>&#160;</div><div class="line"><a name="l00145"></a><span class="lineno">  145</span>&#160;  <span class="keywordflow">for</span> (i = 0; i &lt; 12; ++i) {</div><div class="line"><a name="l00146"></a><span class="lineno">  146</span>&#160;    <span class="keywordflow">if</span> (days &lt; month_lengths[i]) {</div><div class="line"><a name="l00147"></a><span class="lineno">  147</span>&#160;      *date_month = i + 1;</div><div class="line"><a name="l00148"></a><span class="lineno">  148</span>&#160;      *date_day = days + 1;</div><div class="line"><a name="l00149"></a><span class="lineno">  149</span>&#160;      <span class="keywordflow">return</span>;</div><div class="line"><a name="l00150"></a><span class="lineno">  150</span>&#160;    } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00151"></a><span class="lineno">
   151</span>&#160;      days -= month_lengths[i];</div><div class="line"><a name="l00152"></a><span class="lineno">  152</span>&#160;    }</div><div class="line"><a name="l00153"></a><span class="lineno">  153</span>&#160;  }</div><div class="line"><a name="l00154"></a><span class="lineno">  154</span>&#160;</div><div class="line"><a name="l00155"></a><span class="lineno">  155</span>&#160;  <span class="comment">// Should never get here</span></div><div class="line"><a name="l00156"></a><span class="lineno">  156</span>&#160;  <span class="keywordflow">return</span>;</div><div class="line"><a name="l00157"></a><span class="lineno">  157</span>&#160;}</div><div class="line"><a name="l00158"></a><span class="lineno">  158</span>&#160;</div><div class="line"><a name="l00159"></a><span class="lineno">  159</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyTime_to_us(PyObject* pytime) {</div><div class="line"><a name="l00160"></a><span class="
 lineno">  160</span>&#160;  <span class="keywordflow">return</span> (static_cast&lt;int64_t&gt;(PyDateTime_TIME_GET_HOUR(pytime)) * 3600000000LL +</div><div class="line"><a name="l00161"></a><span class="lineno">  161</span>&#160;          static_cast&lt;int64_t&gt;(PyDateTime_TIME_GET_MINUTE(pytime)) * 60000000LL +</div><div class="line"><a name="l00162"></a><span class="lineno">  162</span>&#160;          static_cast&lt;int64_t&gt;(PyDateTime_TIME_GET_SECOND(pytime)) * 1000000LL +</div><div class="line"><a name="l00163"></a><span class="lineno">  163</span>&#160;          PyDateTime_TIME_GET_MICROSECOND(pytime));</div><div class="line"><a name="l00164"></a><span class="lineno">  164</span>&#160;}</div><div class="line"><a name="l00165"></a><span class="lineno">  165</span>&#160;</div><div class="line"><a name="l00166"></a><span class="lineno">  166</span>&#160;<span class="comment">// Splitting time quantities, for example splitting total seconds into</span></div><div class="line"
 ><a name="l00167"></a><span class="lineno">  167</span>&#160;<span class="comment">// minutes and remaining seconds. After we run</span></div><div class="line"><a name="l00168"></a><span class="lineno">  168</span>&#160;<span class="comment">// int64_t remaining = split_time(total, quotient, &amp;next)</span></div><div class="line"><a name="l00169"></a><span class="lineno">  169</span>&#160;<span class="comment">// we have</span></div><div class="line"><a name="l00170"></a><span class="lineno">  170</span>&#160;<span class="comment">// total = next * quotient + remaining. Handles negative values by propagating</span></div><div class="line"><a name="l00171"></a><span class="lineno">  171</span>&#160;<span class="comment">// them: If total is negative, next will be negative and remaining will</span></div><div class="line"><a name="l00172"></a><span class="lineno">  172</span>&#160;<span class="comment">// always be non-negative.</span></div><div class="line"><a name="l00173"></a><span
  class="lineno">  173</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t split_time(int64_t total, int64_t quotient, int64_t* next) {</div><div class="line"><a name="l00174"></a><span class="lineno">  174</span>&#160;  int64_t r = total % quotient;</div><div class="line"><a name="l00175"></a><span class="lineno">  175</span>&#160;  <span class="keywordflow">if</span> (r &lt; 0) {</div><div class="line"><a name="l00176"></a><span class="lineno">  176</span>&#160;    *next = total / quotient - 1;</div><div class="line"><a name="l00177"></a><span class="lineno">  177</span>&#160;    <span class="keywordflow">return</span> r + quotient;</div><div class="line"><a name="l00178"></a><span class="lineno">  178</span>&#160;  } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00179"></a><span class="lineno">  179</span>&#160;    *next = total / quotient;</div><div class="line"><a name="l00180"></a><span class="lineno">  180</spa
 n>&#160;    <span class="keywordflow">return</span> r;</div><div class="line"><a name="l00181"></a><span class="lineno">  181</span>&#160;  }</div><div class="line"><a name="l00182"></a><span class="lineno">  182</span>&#160;}</div><div class="line"><a name="l00183"></a><span class="lineno">  183</span>&#160;</div><div class="line"><a name="l00184"></a><span class="lineno">  184</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> Status PyTime_convert_int(int64_t val, <span class="keyword">const</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ff">TimeUnit::type</a> unit,</div><div class="line"><a name="l00185"></a><span class="lineno">  185</span>&#160;                                        int64_t* hour, int64_t* minute, int64_t* second,</div><div class="line"><a name="l00186"></a><span class="lineno">  186</span>&#160;                                        int64_t* microsecond) {</div><div class="line"><a
  name="l00187"></a><span class="lineno">  187</span>&#160;  <span class="keywordflow">switch</span> (unit) {</div><div class="line"><a name="l00188"></a><span class="lineno">  188</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffa88a677627c74df18d59f1aa6cd1c88d5">TimeUnit::NANO</a>:</div><div class="line"><a name="l00189"></a><span class="lineno">  189</span>&#160;      <span class="keywordflow">if</span> (val % 1000 != 0) {</div><div class="line"><a name="l00190"></a><span class="lineno">  190</span>&#160;        std::stringstream ss;</div><div class="line"><a name="l00191"></a><span class="lineno">  191</span>&#160;        ss &lt;&lt; <span class="stringliteral">&quot;Value &quot;</span> &lt;&lt; val &lt;&lt; <span class="stringliteral">&quot; has non-zero nanoseconds&quot;</span>;</div><div class="line"><a name="l00192"></a><span class="lineno">  192</span>&#160;        <span class="keyword
 flow">return</span> <a class="code" href="classarrow_1_1_status.html#aaaa6c0ddc3021415c238ab07353f3195">Status::Invalid</a>(ss.str());</div><div class="line"><a name="l00193"></a><span class="lineno">  193</span>&#160;      }</div><div class="line"><a name="l00194"></a><span class="lineno">  194</span>&#160;      val /= 1000;</div><div class="line"><a name="l00195"></a><span class="lineno">  195</span>&#160;    <span class="comment">// fall through</span></div><div class="line"><a name="l00196"></a><span class="lineno">  196</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffaf8ce7e9dc4001c956488dd701d567cb1">TimeUnit::MICRO</a>:</div><div class="line"><a name="l00197"></a><span class="lineno">  197</span>&#160;      *microsecond = split_time(val, 1000000LL, &amp;val);</div><div class="line"><a name="l00198"></a><span class="lineno">  198</span>&#160;      *second = split_time(val, 60, &amp;val)
 ;</div><div class="line"><a name="l00199"></a><span class="lineno">  199</span>&#160;      *minute = split_time(val, 60, hour);</div><div class="line"><a name="l00200"></a><span class="lineno">  200</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00201"></a><span class="lineno">  201</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffadc3335445f7fa1b26f9c78754a1f217b">TimeUnit::MILLI</a>:</div><div class="line"><a name="l00202"></a><span class="lineno">  202</span>&#160;      *microsecond = split_time(val, 1000, &amp;val) * 1000;</div><div class="line"><a name="l00203"></a><span class="lineno">  203</span>&#160;    <span class="comment">// fall through</span></div><div class="line"><a name="l00204"></a><span class="lineno">  204</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f
 8f86f5bc4ec1ffa1c81ae790d85d35422c1757e0b20be7a">TimeUnit::SECOND</a>:</div><div class="line"><a name="l00205"></a><span class="lineno">  205</span>&#160;      *second = split_time(val, 60, &amp;val);</div><div class="line"><a name="l00206"></a><span class="lineno">  206</span>&#160;      *minute = split_time(val, 60, hour);</div><div class="line"><a name="l00207"></a><span class="lineno">  207</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00208"></a><span class="lineno">  208</span>&#160;    <span class="keywordflow">default</span>:</div><div class="line"><a name="l00209"></a><span class="lineno">  209</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00210"></a><span class="lineno">  210</span>&#160;  }</div><div class="line"><a name="l00211"></a><span class="lineno">  211</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="classarrow_1_1_status.html#a5c0b0031db6eeec3dcc70
 485d24cfe03">Status::OK</a>();</div><div class="line"><a name="l00212"></a><span class="lineno">  212</span>&#160;}</div><div class="line"><a name="l00213"></a><span class="lineno">  213</span>&#160;</div><div class="line"><a name="l00214"></a><span class="lineno">  214</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> Status PyTime_from_int(int64_t val, <span class="keyword">const</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ff">TimeUnit::type</a> unit,</div><div class="line"><a name="l00215"></a><span class="lineno">  215</span>&#160;                                     PyObject** out) {</div><div class="line"><a name="l00216"></a><span class="lineno">  216</span>&#160;  int64_t hour = 0, minute = 0, second = 0, microsecond = 0;</div><div class="line"><a name="l00217"></a><span class="lineno">  217</span>&#160;  <a class="code" href="status_8h.html#a0a03bcf7fdbd9a96c67afa05fc0a545d">RETURN_NOT_OK</a>(P
 yTime_convert_int(val, unit, &amp;hour, &amp;minute, &amp;second, &amp;microsecond));</div><div class="line"><a name="l00218"></a><span class="lineno">  218</span>&#160;  *out = PyTime_FromTime(static_cast&lt;int32_t&gt;(hour), static_cast&lt;int32_t&gt;(minute),</div><div class="line"><a name="l00219"></a><span class="lineno">  219</span>&#160;                         static_cast&lt;int32_t&gt;(second), static_cast&lt;int32_t&gt;(microsecond));</div><div class="line"><a name="l00220"></a><span class="lineno">  220</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="classarrow_1_1_status.html#a5c0b0031db6eeec3dcc70485d24cfe03">Status::OK</a>();</div><div class="line"><a name="l00221"></a><span class="lineno">  221</span>&#160;}</div><div class="line"><a name="l00222"></a><span class="lineno">  222</span>&#160;</div><div class="line"><a name="l00223"></a><span class="lineno">  223</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</sp
 an> Status PyDateTime_from_int(int64_t val, <span class="keyword">const</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ff">TimeUnit::type</a> unit,</div><div class="line"><a name="l00224"></a><span class="lineno">  224</span>&#160;                                         PyObject** out) {</div><div class="line"><a name="l00225"></a><span class="lineno">  225</span>&#160;  int64_t hour = 0, minute = 0, second = 0, microsecond = 0;</div><div class="line"><a name="l00226"></a><span class="lineno">  226</span>&#160;  <a class="code" href="status_8h.html#a0a03bcf7fdbd9a96c67afa05fc0a545d">RETURN_NOT_OK</a>(PyTime_convert_int(val, unit, &amp;hour, &amp;minute, &amp;second, &amp;microsecond));</div><div class="line"><a name="l00227"></a><span class="lineno">  227</span>&#160;  int64_t total_days = 0;</div><div class="line"><a name="l00228"></a><span class="lineno">  228</span>&#160;  hour = split_time(hour, 24, &amp;total_days);</div><div class="
 line"><a name="l00229"></a><span class="lineno">  229</span>&#160;  int64_t year = 0, month = 0, day = 0;</div><div class="line"><a name="l00230"></a><span class="lineno">  230</span>&#160;  get_date_from_days(total_days, &amp;year, &amp;month, &amp;day);</div><div class="line"><a name="l00231"></a><span class="lineno">  231</span>&#160;  *out = PyDateTime_FromDateAndTime(</div><div class="line"><a name="l00232"></a><span class="lineno">  232</span>&#160;      static_cast&lt;int32_t&gt;(year), static_cast&lt;int32_t&gt;(month), static_cast&lt;int32_t&gt;(day),</div><div class="line"><a name="l00233"></a><span class="lineno">  233</span>&#160;      static_cast&lt;int32_t&gt;(hour), static_cast&lt;int32_t&gt;(minute),</div><div class="line"><a name="l00234"></a><span class="lineno">  234</span>&#160;      static_cast&lt;int32_t&gt;(second), static_cast&lt;int32_t&gt;(microsecond));</div><div class="line"><a name="l00235"></a><span class="lineno">  235</span>&#160;  <span class="keywor
 dflow">return</span> <a class="code" href="classarrow_1_1_status.html#a5c0b0031db6eeec3dcc70485d24cfe03">Status::OK</a>();</div><div class="line"><a name="l00236"></a><span class="lineno">  236</span>&#160;}</div><div class="line"><a name="l00237"></a><span class="lineno">  237</span>&#160;</div><div class="line"><a name="l00238"></a><span class="lineno">  238</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDate_to_s(PyDateTime_Date* pydate) {</div><div class="line"><a name="l00239"></a><span class="lineno">  239</span>&#160;  <span class="keywordflow">return</span> get_days_from_date(PyDateTime_GET_YEAR(pydate), PyDateTime_GET_MONTH(pydate),</div><div class="line"><a name="l00240"></a><span class="lineno">  240</span>&#160;                            PyDateTime_GET_DAY(pydate));</div><div class="line"><a name="l00241"></a><span class="lineno">  241</span>&#160;}</div><div class="line"><a name="l00242"></a><span class="lineno">  242</spa
 n>&#160;</div><div class="line"><a name="l00243"></a><span class="lineno">  243</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDate_to_ms(PyDateTime_Date* pydate) {</div><div class="line"><a name="l00244"></a><span class="lineno">  244</span>&#160;  int64_t total_seconds = 0;</div><div class="line"><a name="l00245"></a><span class="lineno">  245</span>&#160;  total_seconds += PyDateTime_DATE_GET_SECOND(pydate);</div><div class="line"><a name="l00246"></a><span class="lineno">  246</span>&#160;  total_seconds += PyDateTime_DATE_GET_MINUTE(pydate) * 60;</div><div class="line"><a name="l00247"></a><span class="lineno">  247</span>&#160;  total_seconds += PyDateTime_DATE_GET_HOUR(pydate) * 3600;</div><div class="line"><a name="l00248"></a><span class="lineno">  248</span>&#160;  int64_t days =</div><div class="line"><a name="l00249"></a><span class="lineno">  249</span>&#160;      get_days_from_date(PyDateTime_GET_YEAR(pydate), PyDateTime_G
 ET_MONTH(pydate),</div><div class="line"><a name="l00250"></a><span class="lineno">  250</span>&#160;                         PyDateTime_GET_DAY(pydate));</div><div class="line"><a name="l00251"></a><span class="lineno">  251</span>&#160;  total_seconds += days * 24 * 3600;</div><div class="line"><a name="l00252"></a><span class="lineno">  252</span>&#160;  <span class="keywordflow">return</span> total_seconds * 1000;</div><div class="line"><a name="l00253"></a><span class="lineno">  253</span>&#160;}</div><div class="line"><a name="l00254"></a><span class="lineno">  254</span>&#160;</div><div class="line"><a name="l00255"></a><span class="lineno">  255</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDateTime_to_s(PyDateTime_DateTime* pydatetime) {</div><div class="line"><a name="l00256"></a><span class="lineno">  256</span>&#160;  <span class="keywordflow">return</span> PyDate_to_ms(reinterpret_cast&lt;PyDateTime_Date*&gt;(pydatetime)) 
 / 1000LL;</div><div class="line"><a name="l00257"></a><span class="lineno">  257</span>&#160;}</div><div class="line"><a name="l00258"></a><span class="lineno">  258</span>&#160;</div><div class="line"><a name="l00259"></a><span class="lineno">  259</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDateTime_to_ms(PyDateTime_DateTime* pydatetime) {</div><div class="line"><a name="l00260"></a><span class="lineno">  260</span>&#160;  int64_t date_ms = PyDate_to_ms(reinterpret_cast&lt;PyDateTime_Date*&gt;(pydatetime));</div><div class="line"><a name="l00261"></a><span class="lineno">  261</span>&#160;  <span class="keywordtype">int</span> ms = PyDateTime_DATE_GET_MICROSECOND(pydatetime) / 1000;</div><div class="line"><a name="l00262"></a><span class="lineno">  262</span>&#160;  <span class="keywordflow">return</span> date_ms + ms;</div><div class="line"><a name="l00263"></a><span class="lineno">  263</span>&#160;}</div><div class="line"><a nam
 e="l00264"></a><span class="lineno">  264</span>&#160;</div><div class="line"><a name="l00265"></a><span class="lineno">  265</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDateTime_to_us(PyDateTime_DateTime* pydatetime) {</div><div class="line"><a name="l00266"></a><span class="lineno">  266</span>&#160;  int64_t ms = PyDate_to_ms(reinterpret_cast&lt;PyDateTime_Date*&gt;(pydatetime));</div><div class="line"><a name="l00267"></a><span class="lineno">  267</span>&#160;  <span class="keywordtype">int</span> us = PyDateTime_DATE_GET_MICROSECOND(pydatetime);</div><div class="line"><a name="l00268"></a><span class="lineno">  268</span>&#160;  <span class="keywordflow">return</span> ms * 1000 + us;</div><div class="line"><a name="l00269"></a><span class="lineno">  269</span>&#160;}</div><div class="line"><a name="l00270"></a><span class="lineno">  270</span>&#160;</div><div class="line"><a name="l00271"></a><span class="lineno">  271</span>&#
 160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDateTime_to_ns(PyDateTime_DateTime* pydatetime) {</div><div class="line"><a name="l00272"></a><span class="lineno">  272</span>&#160;  <span class="keywordflow">return</span> PyDateTime_to_us(pydatetime) * 1000;</div><div class="line"><a name="l00273"></a><span class="lineno">  273</span>&#160;}</div><div class="line"><a name="l00274"></a><span class="lineno">  274</span>&#160;</div><div class="line"><a name="l00275"></a><span class="lineno">  275</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int32_t PyDate_to_days(PyDateTime_Date* pydate) {</div><div class="line"><a name="l00276"></a><span class="lineno">  276</span>&#160;  <span class="keywordflow">return</span> <span class="keyword">static_cast&lt;</span>int32_t<span class="keyword">&gt;</span>(PyDate_to_ms(pydate) / 86400000LL);</div><div class="line"><a name="l00277"></a><span class="lineno">  277</span>&#
 160;}</div><div class="line"><a name="l00278"></a><span class="lineno">  278</span>&#160;</div><div class="line"><a name="l00279"></a><span class="lineno">  279</span>&#160;}  <span class="comment">// namespace py</span></div><div class="line"><a name="l00280"></a><span class="lineno">  280</span>&#160;}  <span class="comment">// namespace arrow</span></div><div class="line"><a name="l00281"></a><span class="lineno">  281</span>&#160;</div><div class="line"><a name="l00282"></a><span class="lineno">  282</span>&#160;<span class="preprocessor">#endif  // PYARROW_UTIL_DATETIME_H</span></div><div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ffa1c81ae790d85d35422c1757e0b20be7a"><div class="ttname"><a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffa1c81ae790d85d35422c1757e0b20be7a">arrow::TimeUnit::SECOND</a></div><div class="ttdef"><b>Definition:</b> type.h:598</div></div>
+<a href="datetime_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span>&#160;<span class="comment">// Licensed to the Apache Software Foundation (ASF) under one</span></div><div class="line"><a name="l00002"></a><span class="lineno">    2</span>&#160;<span class="comment">// or more contributor license agreements.  See the NOTICE file</span></div><div class="line"><a name="l00003"></a><span class="lineno">    3</span>&#160;<span class="comment">// distributed with this work for additional information</span></div><div class="line"><a name="l00004"></a><span class="lineno">    4</span>&#160;<span class="comment">// regarding copyright ownership.  The ASF licenses this file</span></div><div class="line"><a name="l00005"></a><span class="lineno">    5</span>&#160;<span class="comment">// to you under the Apache License, Version 2.0 (the</span></div><div class="line"><a name="l00006"></a><span clas
 s="lineno">    6</span>&#160;<span class="comment">// &quot;License&quot;); you may not use this file except in compliance</span></div><div class="line"><a name="l00007"></a><span class="lineno">    7</span>&#160;<span class="comment">// with the License.  You may obtain a copy of the License at</span></div><div class="line"><a name="l00008"></a><span class="lineno">    8</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00009"></a><span class="lineno">    9</span>&#160;<span class="comment">//   http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="comment">//</span></div><div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="comment">// Unless required by applicable law or agreed to in writing,</span></div><div class="line"><a name="l00012"></a><span class="lineno">   12</span>&#160;<span class="comment">// software distributed 
 under the License is distributed on an</span></div><div class="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="comment">// &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span></div><div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="comment">// KIND, either express or implied.  See the License for the</span></div><div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;<span class="comment">// specific language governing permissions and limitations</span></div><div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;<span class="comment">// under the License.</span></div><div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;</div><div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="preprocessor">#ifndef PYARROW_UTIL_DATETIME_H</span></div><div class="line"><a name="l00019"></a><span class="lin
 eno">   19</span>&#160;<span class="preprocessor">#define PYARROW_UTIL_DATETIME_H</span></div><div class="line"><a name="l00020"></a><span class="lineno">   20</span>&#160;</div><div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;<span class="preprocessor">#include &lt;algorithm&gt;</span></div><div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;<span class="preprocessor">#include &lt;sstream&gt;</span></div><div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;</div><div class="line"><a name="l00024"></a><span class="lineno">   24</span>&#160;<span class="preprocessor">#include &lt;<a class="code" href="datetime_8h.html">datetime.h</a>&gt;</span></div><div class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="platform_8h.html">arrow/python/platform.h</a>&quot;</span></div><div class="line"><a name="l00026"></a><span class="li
 neno">   26</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="status_8h.html">arrow/status.h</a>&quot;</span></div><div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="logging_8h.html">arrow/util/logging.h</a>&quot;</span></div><div class="line"><a name="l00028"></a><span class="lineno">   28</span>&#160;</div><div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;<span class="keyword">namespace </span><a class="code" href="namespacearrow.html">arrow</a> {</div><div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;<span class="keyword">namespace </span>py {</div><div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;</div><div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;<span class="comment">// The following code is adapted from</span></div><div class="line"><a name="l0003
 3"></a><span class="lineno">   33</span>&#160;<span class="comment">// https://github.com/numpy/numpy/blob/master/numpy/core/src/multiarray/datetime.c</span></div><div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;</div><div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;<span class="comment">// Days per month, regular year and leap year</span></div><div class="line"><a name="l00036"></a><span class="lineno">   36</span>&#160;<span class="keyword">static</span> int64_t _days_per_month_table[2][12] = {</div><div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;    {31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31},</div><div class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;    {31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}};</div><div class="line"><a name="l00039"></a><span class="lineno">   39</span>&#160;</div><div class="line"><a name="l00040"></a><span class="lineno">   40</span>&
 #160;<span class="keyword">static</span> <span class="keywordtype">bool</span> is_leapyear(int64_t year) {</div><div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;  <span class="keywordflow">return</span> (year &amp; 0x3) == 0 &amp;&amp;  <span class="comment">// year % 4 == 0</span></div><div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;         ((year % 100) != 0 || (year % 400) == 0);</div><div class="line"><a name="l00043"></a><span class="lineno">   43</span>&#160;}</div><div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;</div><div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;<span class="comment">// Calculates the days offset from the 1970 epoch.</span></div><div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;<span class="keyword">static</span> int64_t get_days_from_date(int64_t date_year, int64_t date_month,</div><div class="line"><a name="l0
 0047"></a><span class="lineno">   47</span>&#160;                                  int64_t date_day) {</div><div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;  int64_t i, month;</div><div class="line"><a name="l00049"></a><span class="lineno">   49</span>&#160;  int64_t year, days = 0;</div><div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;  int64_t* month_lengths;</div><div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;</div><div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;  year = date_year - 1970;</div><div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;  days = year * 365;</div><div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;</div><div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;  <span class="comment">// Adjust for leap years</span></div><div class="line"><a name="l00056"></a><span cl
 ass="lineno">   56</span>&#160;  <span class="keywordflow">if</span> (days &gt;= 0) {</div><div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;    <span class="comment">// 1968 is the closest leap year before 1970.</span></div><div class="line"><a name="l00058"></a><span class="lineno">   58</span>&#160;    <span class="comment">// Exclude the current year, so add 1.</span></div><div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;    year += 1;</div><div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;    <span class="comment">// Add one day for each 4 years</span></div><div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;    days += year / 4;</div><div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;    <span class="comment">// 1900 is the closest previous year divisible by 100</span></div><div class="line"><a name="l00063"></a><span class="lineno">   63</s
 pan>&#160;    year += 68;</div><div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;    <span class="comment">// Subtract one day for each 100 years</span></div><div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;    days -= year / 100;</div><div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;    <span class="comment">// 1600 is the closest previous year divisible by 400</span></div><div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;    year += 300;</div><div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;    <span class="comment">// Add one day for each 400 years</span></div><div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;    days += year / 400;</div><div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;  } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00071"></a><span class
 ="lineno">   71</span>&#160;    <span class="comment">// 1972 is the closest later year after 1970.</span></div><div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;    <span class="comment">// Include the current year, so subtract 2.</span></div><div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;    year -= 2;</div><div class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;    <span class="comment">// Subtract one day for each 4 years</span></div><div class="line"><a name="l00075"></a><span class="lineno">   75</span>&#160;    days += year / 4;</div><div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;    <span class="comment">// 2000 is the closest later year divisible by 100</span></div><div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;    year -= 28;</div><div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;    <span class="comment"
 >// Add one day for each 100 years</span></div><div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;    days -= year / 100;</div><div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;    <span class="comment">// 2000 is also the closest later year divisible by 400</span></div><div class="line"><a name="l00081"></a><span class="lineno">   81</span>&#160;    <span class="comment">// Subtract one day for each 400 years</span></div><div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;    days += year / 400;</div><div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;  }</div><div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;</div><div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;  month_lengths = _days_per_month_table[is_leapyear(date_year)];</div><div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;  month = da
 te_month - 1;</div><div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;</div><div class="line"><a name="l00088"></a><span class="lineno">   88</span>&#160;  <span class="comment">// Add the months</span></div><div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;  <span class="keywordflow">for</span> (i = 0; i &lt; month; ++i) {</div><div class="line"><a name="l00090"></a><span class="lineno">   90</span>&#160;    days += month_lengths[i];</div><div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;  }</div><div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;</div><div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;  <span class="comment">// Add the days</span></div><div class="line"><a name="l00094"></a><span class="lineno">   94</span>&#160;  days += date_day - 1;</div><div class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;</div><div c
 lass="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;  <span class="keywordflow">return</span> days;</div><div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;}</div><div class="line"><a name="l00098"></a><span class="lineno">   98</span>&#160;</div><div class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;<span class="comment">// Modifies &#39;*days_&#39; to be the day offset within the year,</span></div><div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;<span class="comment">// and returns the year.</span></div><div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;<span class="keyword">static</span> int64_t days_to_yearsdays(int64_t* days_) {</div><div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;  <span class="keyword">const</span> int64_t days_per_400years = (400 * 365 + 100 - 4 + 1);</div><div class="line"><a name="l00103"></a><span clas
 s="lineno">  103</span>&#160;  <span class="comment">// Adjust so it&#39;s relative to the year 2000 (divisible by 400)</span></div><div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;  int64_t days = (*days_) - (365 * 30 + 7);</div><div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;  int64_t year;</div><div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;</div><div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;  <span class="comment">// Break down the 400 year cycle to get the year and day within the year</span></div><div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;  <span class="keywordflow">if</span> (days &gt;= 0) {</div><div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;    year = 400 * (days / days_per_400years);</div><div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;    days = days % days_p
 er_400years;</div><div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;  } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;    year = 400 * ((days - (days_per_400years - 1)) / days_per_400years);</div><div class="line"><a name="l00113"></a><span class="lineno">  113</span>&#160;    days = days % days_per_400years;</div><div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;    <span class="keywordflow">if</span> (days &lt; 0) {</div><div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;      days += days_per_400years;</div><div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;    }</div><div class="line"><a name="l00117"></a><span class="lineno">  117</span>&#160;  }</div><div class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;</div><div class="line"><a name="l00119"></a><span class="lineno"> 
  119</span>&#160;  <span class="comment">// Work out the year/day within the 400 year cycle</span></div><div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;  <span class="keywordflow">if</span> (days &gt;= 366) {</div><div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;    year += 100 * ((days - 1) / (100 * 365 + 25 - 1));</div><div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;    days = (days - 1) % (100 * 365 + 25 - 1);</div><div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;    <span class="keywordflow">if</span> (days &gt;= 365) {</div><div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;      year += 4 * ((days + 1) / (4 * 365 + 1));</div><div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;      days = (days + 1) % (4 * 365 + 1);</div><div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;      <span
  class="keywordflow">if</span> (days &gt;= 366) {</div><div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;        year += (days - 1) / 365;</div><div class="line"><a name="l00128"></a><span class="lineno">  128</span>&#160;        days = (days - 1) % 365;</div><div class="line"><a name="l00129"></a><span class="lineno">  129</span>&#160;      }</div><div class="line"><a name="l00130"></a><span class="lineno">  130</span>&#160;    }</div><div class="line"><a name="l00131"></a><span class="lineno">  131</span>&#160;  }</div><div class="line"><a name="l00132"></a><span class="lineno">  132</span>&#160;</div><div class="line"><a name="l00133"></a><span class="lineno">  133</span>&#160;  *days_ = days;</div><div class="line"><a name="l00134"></a><span class="lineno">  134</span>&#160;  <span class="keywordflow">return</span> year + 2000;</div><div class="line"><a name="l00135"></a><span class="lineno">  135</span>&#160;}</div><div class="line"><a name="l00136">
 </a><span class="lineno">  136</span>&#160;</div><div class="line"><a name="l00137"></a><span class="lineno">  137</span>&#160;<span class="comment">// Extracts the month and year and day number from a number of days</span></div><div class="line"><a name="l00138"></a><span class="lineno">  138</span>&#160;<span class="keyword">static</span> <span class="keywordtype">void</span> get_date_from_days(int64_t days, int64_t* date_year, int64_t* date_month,</div><div class="line"><a name="l00139"></a><span class="lineno">  139</span>&#160;                               int64_t* date_day) {</div><div class="line"><a name="l00140"></a><span class="lineno">  140</span>&#160;  int64_t *month_lengths, i;</div><div class="line"><a name="l00141"></a><span class="lineno">  141</span>&#160;</div><div class="line"><a name="l00142"></a><span class="lineno">  142</span>&#160;  *date_year = days_to_yearsdays(&amp;days);</div><div class="line"><a name="l00143"></a><span class="lineno">  143</span>&#160;
   month_lengths = _days_per_month_table[is_leapyear(*date_year)];</div><div class="line"><a name="l00144"></a><span class="lineno">  144</span>&#160;</div><div class="line"><a name="l00145"></a><span class="lineno">  145</span>&#160;  <span class="keywordflow">for</span> (i = 0; i &lt; 12; ++i) {</div><div class="line"><a name="l00146"></a><span class="lineno">  146</span>&#160;    <span class="keywordflow">if</span> (days &lt; month_lengths[i]) {</div><div class="line"><a name="l00147"></a><span class="lineno">  147</span>&#160;      *date_month = i + 1;</div><div class="line"><a name="l00148"></a><span class="lineno">  148</span>&#160;      *date_day = days + 1;</div><div class="line"><a name="l00149"></a><span class="lineno">  149</span>&#160;      <span class="keywordflow">return</span>;</div><div class="line"><a name="l00150"></a><span class="lineno">  150</span>&#160;    } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00151"></a><span class="lineno">
   151</span>&#160;      days -= month_lengths[i];</div><div class="line"><a name="l00152"></a><span class="lineno">  152</span>&#160;    }</div><div class="line"><a name="l00153"></a><span class="lineno">  153</span>&#160;  }</div><div class="line"><a name="l00154"></a><span class="lineno">  154</span>&#160;</div><div class="line"><a name="l00155"></a><span class="lineno">  155</span>&#160;  <span class="comment">// Should never get here</span></div><div class="line"><a name="l00156"></a><span class="lineno">  156</span>&#160;  <span class="keywordflow">return</span>;</div><div class="line"><a name="l00157"></a><span class="lineno">  157</span>&#160;}</div><div class="line"><a name="l00158"></a><span class="lineno">  158</span>&#160;</div><div class="line"><a name="l00159"></a><span class="lineno">  159</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyTime_to_us(<a class="code" href="python__to__arrow_8h.html#ae19630c1f4ca6d5236b30719d914
 0013">PyObject</a>* pytime) {</div><div class="line"><a name="l00160"></a><span class="lineno">  160</span>&#160;  <span class="keywordflow">return</span> (static_cast&lt;int64_t&gt;(PyDateTime_TIME_GET_HOUR(pytime)) * 3600000000LL +</div><div class="line"><a name="l00161"></a><span class="lineno">  161</span>&#160;          static_cast&lt;int64_t&gt;(PyDateTime_TIME_GET_MINUTE(pytime)) * 60000000LL +</div><div class="line"><a name="l00162"></a><span class="lineno">  162</span>&#160;          static_cast&lt;int64_t&gt;(PyDateTime_TIME_GET_SECOND(pytime)) * 1000000LL +</div><div class="line"><a name="l00163"></a><span class="lineno">  163</span>&#160;          PyDateTime_TIME_GET_MICROSECOND(pytime));</div><div class="line"><a name="l00164"></a><span class="lineno">  164</span>&#160;}</div><div class="line"><a name="l00165"></a><span class="lineno">  165</span>&#160;</div><div class="line"><a name="l00166"></a><span class="lineno">  166</span>&#160;<span class="comment">// Splitting 
 time quantities, for example splitting total seconds into</span></div><div class="line"><a name="l00167"></a><span class="lineno">  167</span>&#160;<span class="comment">// minutes and remaining seconds. After we run</span></div><div class="line"><a name="l00168"></a><span class="lineno">  168</span>&#160;<span class="comment">// int64_t remaining = split_time(total, quotient, &amp;next)</span></div><div class="line"><a name="l00169"></a><span class="lineno">  169</span>&#160;<span class="comment">// we have</span></div><div class="line"><a name="l00170"></a><span class="lineno">  170</span>&#160;<span class="comment">// total = next * quotient + remaining. Handles negative values by propagating</span></div><div class="line"><a name="l00171"></a><span class="lineno">  171</span>&#160;<span class="comment">// them: If total is negative, next will be negative and remaining will</span></div><div class="line"><a name="l00172"></a><span class="lineno">  172</span>&#160;<span class="comme
 nt">// always be non-negative.</span></div><div class="line"><a name="l00173"></a><span class="lineno">  173</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t split_time(int64_t total, int64_t quotient, int64_t* next) {</div><div class="line"><a name="l00174"></a><span class="lineno">  174</span>&#160;  int64_t r = total % quotient;</div><div class="line"><a name="l00175"></a><span class="lineno">  175</span>&#160;  <span class="keywordflow">if</span> (r &lt; 0) {</div><div class="line"><a name="l00176"></a><span class="lineno">  176</span>&#160;    *next = total / quotient - 1;</div><div class="line"><a name="l00177"></a><span class="lineno">  177</span>&#160;    <span class="keywordflow">return</span> r + quotient;</div><div class="line"><a name="l00178"></a><span class="lineno">  178</span>&#160;  } <span class="keywordflow">else</span> {</div><div class="line"><a name="l00179"></a><span class="lineno">  179</span>&#160;    *next = total 
 / quotient;</div><div class="line"><a name="l00180"></a><span class="lineno">  180</span>&#160;    <span class="keywordflow">return</span> r;</div><div class="line"><a name="l00181"></a><span class="lineno">  181</span>&#160;  }</div><div class="line"><a name="l00182"></a><span class="lineno">  182</span>&#160;}</div><div class="line"><a name="l00183"></a><span class="lineno">  183</span>&#160;</div><div class="line"><a name="l00184"></a><span class="lineno">  184</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> Status PyTime_convert_int(int64_t val, <span class="keyword">const</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ff">TimeUnit::type</a> unit,</div><div class="line"><a name="l00185"></a><span class="lineno">  185</span>&#160;                                        int64_t* hour, int64_t* minute, int64_t* second,</div><div class="line"><a name="l00186"></a><span class="lineno">  186</span>&#160;  
                                       int64_t* microsecond) {</div><div class="line"><a name="l00187"></a><span class="lineno">  187</span>&#160;  <span class="keywordflow">switch</span> (unit) {</div><div class="line"><a name="l00188"></a><span class="lineno">  188</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffa88a677627c74df18d59f1aa6cd1c88d5">TimeUnit::NANO</a>:</div><div class="line"><a name="l00189"></a><span class="lineno">  189</span>&#160;      <span class="keywordflow">if</span> (val % 1000 != 0) {</div><div class="line"><a name="l00190"></a><span class="lineno">  190</span>&#160;        std::stringstream ss;</div><div class="line"><a name="l00191"></a><span class="lineno">  191</span>&#160;        ss &lt;&lt; <span class="stringliteral">&quot;Value &quot;</span> &lt;&lt; val &lt;&lt; <span class="stringliteral">&quot; has non-zero nanoseconds&quot;</span>;</div><div class="line"><
 a name="l00192"></a><span class="lineno">  192</span>&#160;        <span class="keywordflow">return</span> <a class="code" href="classarrow_1_1_status.html#aaaa6c0ddc3021415c238ab07353f3195">Status::Invalid</a>(ss.str());</div><div class="line"><a name="l00193"></a><span class="lineno">  193</span>&#160;      }</div><div class="line"><a name="l00194"></a><span class="lineno">  194</span>&#160;      val /= 1000;</div><div class="line"><a name="l00195"></a><span class="lineno">  195</span>&#160;    <span class="comment">// fall through</span></div><div class="line"><a name="l00196"></a><span class="lineno">  196</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffaf8ce7e9dc4001c956488dd701d567cb1">TimeUnit::MICRO</a>:</div><div class="line"><a name="l00197"></a><span class="lineno">  197</span>&#160;      *microsecond = split_time(val, 1000000LL, &amp;val);</div><div class="line"><a name="l00198"><
 /a><span class="lineno">  198</span>&#160;      *second = split_time(val, 60, &amp;val);</div><div class="line"><a name="l00199"></a><span class="lineno">  199</span>&#160;      *minute = split_time(val, 60, hour);</div><div class="line"><a name="l00200"></a><span class="lineno">  200</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00201"></a><span class="lineno">  201</span>&#160;    <span class="keywordflow">case</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffadc3335445f7fa1b26f9c78754a1f217b">TimeUnit::MILLI</a>:</div><div class="line"><a name="l00202"></a><span class="lineno">  202</span>&#160;      *microsecond = split_time(val, 1000, &amp;val) * 1000;</div><div class="line"><a name="l00203"></a><span class="lineno">  203</span>&#160;    <span class="comment">// fall through</span></div><div class="line"><a name="l00204"></a><span class="lineno">  204</span>&#160;    <span class="keywordflo
 w">case</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffa1c81ae790d85d35422c1757e0b20be7a">TimeUnit::SECOND</a>:</div><div class="line"><a name="l00205"></a><span class="lineno">  205</span>&#160;      *second = split_time(val, 60, &amp;val);</div><div class="line"><a name="l00206"></a><span class="lineno">  206</span>&#160;      *minute = split_time(val, 60, hour);</div><div class="line"><a name="l00207"></a><span class="lineno">  207</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00208"></a><span class="lineno">  208</span>&#160;    <span class="keywordflow">default</span>:</div><div class="line"><a name="l00209"></a><span class="lineno">  209</span>&#160;      <span class="keywordflow">break</span>;</div><div class="line"><a name="l00210"></a><span class="lineno">  210</span>&#160;  }</div><div class="line"><a name="l00211"></a><span class="lineno">  211</span>&#160;  <span class="keywordflow
 ">return</span> <a class="code" href="classarrow_1_1_status.html#a5c0b0031db6eeec3dcc70485d24cfe03">Status::OK</a>();</div><div class="line"><a name="l00212"></a><span class="lineno">  212</span>&#160;}</div><div class="line"><a name="l00213"></a><span class="lineno">  213</span>&#160;</div><div class="line"><a name="l00214"></a><span class="lineno">  214</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> Status PyTime_from_int(int64_t val, <span class="keyword">const</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ff">TimeUnit::type</a> unit,</div><div class="line"><a name="l00215"></a><span class="lineno">  215</span>&#160;                                     <a class="code" href="python__to__arrow_8h.html#ae19630c1f4ca6d5236b30719d9140013">PyObject</a>** out) {</div><div class="line"><a name="l00216"></a><span class="lineno">  216</span>&#160;  int64_t hour = 0, minute = 0, second = 0, microsecond = 0;</d
 iv><div class="line"><a name="l00217"></a><span class="lineno">  217</span>&#160;  <a class="code" href="status_8h.html#a0a03bcf7fdbd9a96c67afa05fc0a545d">RETURN_NOT_OK</a>(PyTime_convert_int(val, unit, &amp;hour, &amp;minute, &amp;second, &amp;microsecond));</div><div class="line"><a name="l00218"></a><span class="lineno">  218</span>&#160;  *out = PyTime_FromTime(static_cast&lt;int32_t&gt;(hour), static_cast&lt;int32_t&gt;(minute),</div><div class="line"><a name="l00219"></a><span class="lineno">  219</span>&#160;                         static_cast&lt;int32_t&gt;(second), static_cast&lt;int32_t&gt;(microsecond));</div><div class="line"><a name="l00220"></a><span class="lineno">  220</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="classarrow_1_1_status.html#a5c0b0031db6eeec3dcc70485d24cfe03">Status::OK</a>();</div><div class="line"><a name="l00221"></a><span class="lineno">  221</span>&#160;}</div><div class="line"><a name="l00222"></a><span class="line
 no">  222</span>&#160;</div><div class="line"><a name="l00223"></a><span class="lineno">  223</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> Status PyDateTime_from_int(int64_t val, <span class="keyword">const</span> <a class="code" href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ff">TimeUnit::type</a> unit,</div><div class="line"><a name="l00224"></a><span class="lineno">  224</span>&#160;                                         <a class="code" href="python__to__arrow_8h.html#ae19630c1f4ca6d5236b30719d9140013">PyObject</a>** out) {</div><div class="line"><a name="l00225"></a><span class="lineno">  225</span>&#160;  int64_t hour = 0, minute = 0, second = 0, microsecond = 0;</div><div class="line"><a name="l00226"></a><span class="lineno">  226</span>&#160;  <a class="code" href="status_8h.html#a0a03bcf7fdbd9a96c67afa05fc0a545d">RETURN_NOT_OK</a>(PyTime_convert_int(val, unit, &amp;hour, &amp;minute, &amp;second, &amp;microsecond
 ));</div><div class="line"><a name="l00227"></a><span class="lineno">  227</span>&#160;  int64_t total_days = 0;</div><div class="line"><a name="l00228"></a><span class="lineno">  228</span>&#160;  hour = split_time(hour, 24, &amp;total_days);</div><div class="line"><a name="l00229"></a><span class="lineno">  229</span>&#160;  int64_t year = 0, month = 0, day = 0;</div><div class="line"><a name="l00230"></a><span class="lineno">  230</span>&#160;  get_date_from_days(total_days, &amp;year, &amp;month, &amp;day);</div><div class="line"><a name="l00231"></a><span class="lineno">  231</span>&#160;  *out = PyDateTime_FromDateAndTime(</div><div class="line"><a name="l00232"></a><span class="lineno">  232</span>&#160;      static_cast&lt;int32_t&gt;(year), static_cast&lt;int32_t&gt;(month), static_cast&lt;int32_t&gt;(day),</div><div class="line"><a name="l00233"></a><span class="lineno">  233</span>&#160;      static_cast&lt;int32_t&gt;(hour), static_cast&lt;int32_t&gt;(minute),</div><div 
 class="line"><a name="l00234"></a><span class="lineno">  234</span>&#160;      static_cast&lt;int32_t&gt;(second), static_cast&lt;int32_t&gt;(microsecond));</div><div class="line"><a name="l00235"></a><span class="lineno">  235</span>&#160;  <span class="keywordflow">return</span> <a class="code" href="classarrow_1_1_status.html#a5c0b0031db6eeec3dcc70485d24cfe03">Status::OK</a>();</div><div class="line"><a name="l00236"></a><span class="lineno">  236</span>&#160;}</div><div class="line"><a name="l00237"></a><span class="lineno">  237</span>&#160;</div><div class="line"><a name="l00238"></a><span class="lineno">  238</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDate_to_s(PyDateTime_Date* pydate) {</div><div class="line"><a name="l00239"></a><span class="lineno">  239</span>&#160;  <span class="keywordflow">return</span> get_days_from_date(PyDateTime_GET_YEAR(pydate), PyDateTime_GET_MONTH(pydate),</div><div class="line"><a name="l00240"
 ></a><span class="lineno">  240</span>&#160;                            PyDateTime_GET_DAY(pydate));</div><div class="line"><a name="l00241"></a><span class="lineno">  241</span>&#160;}</div><div class="line"><a name="l00242"></a><span class="lineno">  242</span>&#160;</div><div class="line"><a name="l00243"></a><span class="lineno">  243</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDate_to_ms(PyDateTime_Date* pydate) {</div><div class="line"><a name="l00244"></a><span class="lineno">  244</span>&#160;  int64_t total_seconds = 0;</div><div class="line"><a name="l00245"></a><span class="lineno">  245</span>&#160;  total_seconds += PyDateTime_DATE_GET_SECOND(pydate);</div><div class="line"><a name="l00246"></a><span class="lineno">  246</span>&#160;  total_seconds += PyDateTime_DATE_GET_MINUTE(pydate) * 60;</div><div class="line"><a name="l00247"></a><span class="lineno">  247</span>&#160;  total_seconds += PyDateTime_DATE_GET_HOUR(pyda
 te) * 3600;</div><div class="line"><a name="l00248"></a><span class="lineno">  248</span>&#160;  int64_t days =</div><div class="line"><a name="l00249"></a><span class="lineno">  249</span>&#160;      get_days_from_date(PyDateTime_GET_YEAR(pydate), PyDateTime_GET_MONTH(pydate),</div><div class="line"><a name="l00250"></a><span class="lineno">  250</span>&#160;                         PyDateTime_GET_DAY(pydate));</div><div class="line"><a name="l00251"></a><span class="lineno">  251</span>&#160;  total_seconds += days * 24 * 3600;</div><div class="line"><a name="l00252"></a><span class="lineno">  252</span>&#160;  <span class="keywordflow">return</span> total_seconds * 1000;</div><div class="line"><a name="l00253"></a><span class="lineno">  253</span>&#160;}</div><div class="line"><a name="l00254"></a><span class="lineno">  254</span>&#160;</div><div class="line"><a name="l00255"></a><span class="lineno">  255</span>&#160;<span class="keyword">static</span> <span class="keyword">inli
 ne</span> int64_t PyDateTime_to_s(PyDateTime_DateTime* pydatetime) {</div><div class="line"><a name="l00256"></a><span class="lineno">  256</span>&#160;  <span class="keywordflow">return</span> PyDate_to_ms(reinterpret_cast&lt;PyDateTime_Date*&gt;(pydatetime)) / 1000LL;</div><div class="line"><a name="l00257"></a><span class="lineno">  257</span>&#160;}</div><div class="line"><a name="l00258"></a><span class="lineno">  258</span>&#160;</div><div class="line"><a name="l00259"></a><span class="lineno">  259</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDateTime_to_ms(PyDateTime_DateTime* pydatetime) {</div><div class="line"><a name="l00260"></a><span class="lineno">  260</span>&#160;  int64_t date_ms = PyDate_to_ms(reinterpret_cast&lt;PyDateTime_Date*&gt;(pydatetime));</div><div class="line"><a name="l00261"></a><span class="lineno">  261</span>&#160;  <span class="keywordtype">int</span> ms = PyDateTime_DATE_GET_MICROSECOND(pydatetime) 
 / 1000;</div><div class="line"><a name="l00262"></a><span class="lineno">  262</span>&#160;  <span class="keywordflow">return</span> date_ms + ms;</div><div class="line"><a name="l00263"></a><span class="lineno">  263</span>&#160;}</div><div class="line"><a name="l00264"></a><span class="lineno">  264</span>&#160;</div><div class="line"><a name="l00265"></a><span class="lineno">  265</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDateTime_to_us(PyDateTime_DateTime* pydatetime) {</div><div class="line"><a name="l00266"></a><span class="lineno">  266</span>&#160;  int64_t ms = PyDate_to_ms(reinterpret_cast&lt;PyDateTime_Date*&gt;(pydatetime));</div><div class="line"><a name="l00267"></a><span class="lineno">  267</span>&#160;  <span class="keywordtype">int</span> us = PyDateTime_DATE_GET_MICROSECOND(pydatetime);</div><div class="line"><a name="l00268"></a><span class="lineno">  268</span>&#160;  <span class="keywordflow">return</span> ms 
 * 1000 + us;</div><div class="line"><a name="l00269"></a><span class="lineno">  269</span>&#160;}</div><div class="line"><a name="l00270"></a><span class="lineno">  270</span>&#160;</div><div class="line"><a name="l00271"></a><span class="lineno">  271</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int64_t PyDateTime_to_ns(PyDateTime_DateTime* pydatetime) {</div><div class="line"><a name="l00272"></a><span class="lineno">  272</span>&#160;  <span class="keywordflow">return</span> PyDateTime_to_us(pydatetime) * 1000;</div><div class="line"><a name="l00273"></a><span class="lineno">  273</span>&#160;}</div><div class="line"><a name="l00274"></a><span class="lineno">  274</span>&#160;</div><div class="line"><a name="l00275"></a><span class="lineno">  275</span>&#160;<span class="keyword">static</span> <span class="keyword">inline</span> int32_t PyDate_to_days(PyDateTime_Date* pydate) {</div><div class="line"><a name="l00276"></a><span class="lineno"
 >  276</span>&#160;  <span class="keywordflow">return</span> <span class="keyword">static_cast&lt;</span>int32_t<span class="keyword">&gt;</span>(PyDate_to_ms(pydate) / 86400000LL);</div><div class="line"><a name="l00277"></a><span class="lineno">  277</span>&#160;}</div><div class="line"><a name="l00278"></a><span class="lineno">  278</span>&#160;</div><div class="line"><a name="l00279"></a><span class="lineno">  279</span>&#160;}  <span class="comment">// namespace py</span></div><div class="line"><a name="l00280"></a><span class="lineno">  280</span>&#160;}  <span class="comment">// namespace arrow</span></div><div class="line"><a name="l00281"></a><span class="lineno">  281</span>&#160;</div><div class="line"><a name="l00282"></a><span class="lineno">  282</span>&#160;<span class="preprocessor">#endif  // PYARROW_UTIL_DATETIME_H</span></div><div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ffa1c81ae790d85d35422c1757e0b20be7a"><div class="ttname">
 <a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffa1c81ae790d85d35422c1757e0b20be7a">arrow::TimeUnit::SECOND</a></div><div class="ttdef"><b>Definition:</b> type.h:600</div></div>
 <div class="ttc" id="platform_8h_html"><div class="ttname"><a href="platform_8h.html">platform.h</a></div></div>
 <div class="ttc" id="logging_8h_html"><div class="ttname"><a href="logging_8h.html">logging.h</a></div></div>
-<div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ff"><div class="ttname"><a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ff">arrow::TimeUnit::type</a></div><div class="ttdeci">type</div><div class="ttdef"><b>Definition:</b> type.h:598</div></div>
+<div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ff"><div class="ttname"><a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ff">arrow::TimeUnit::type</a></div><div class="ttdeci">type</div><div class="ttdef"><b>Definition:</b> type.h:600</div></div>
 <div class="ttc" id="datetime_8h_html"><div class="ttname"><a href="datetime_8h.html">datetime.h</a></div></div>
-<div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ffaf8ce7e9dc4001c956488dd701d567cb1"><div class="ttname"><a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffaf8ce7e9dc4001c956488dd701d567cb1">arrow::TimeUnit::MICRO</a></div><div class="ttdef"><b>Definition:</b> type.h:598</div></div>
-<div class="ttc" id="status_8h_html_a0a03bcf7fdbd9a96c67afa05fc0a545d"><div class="ttname"><a href="status_8h.html#a0a03bcf7fdbd9a96c67afa05fc0a545d">RETURN_NOT_OK</a></div><div class="ttdeci">#define RETURN_NOT_OK(s)</div><div class="ttdef"><b>Definition:</b> status.h:43</div></div>
-<div class="ttc" id="classarrow_1_1_status_html_a5c0b0031db6eeec3dcc70485d24cfe03"><div class="ttname"><a href="classarrow_1_1_status.html#a5c0b0031db6eeec3dcc70485d24cfe03">arrow::Status::OK</a></div><div class="ttdeci">static Status OK()</div><div class="ttdef"><b>Definition:</b> status.h:106</div></div>
-<div class="ttc" id="classarrow_1_1_status_html_aaaa6c0ddc3021415c238ab07353f3195"><div class="ttname"><a href="classarrow_1_1_status.html#aaaa6c0ddc3021415c238ab07353f3195">arrow::Status::Invalid</a></div><div class="ttdeci">static Status Invalid(const std::string &amp;msg)</div><div class="ttdef"><b>Definition:</b> status.h:129</div></div>
-<div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ffa88a677627c74df18d59f1aa6cd1c88d5"><div class="ttname"><a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffa88a677627c74df18d59f1aa6cd1c88d5">arrow::TimeUnit::NANO</a></div><div class="ttdef"><b>Definition:</b> type.h:598</div></div>
-<div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ffadc3335445f7fa1b26f9c78754a1f217b"><div class="ttname"><a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffadc3335445f7fa1b26f9c78754a1f217b">arrow::TimeUnit::MILLI</a></div><div class="ttdef"><b>Definition:</b> type.h:598</div></div>
+<div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ffaf8ce7e9dc4001c956488dd701d567cb1"><div class="ttname"><a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffaf8ce7e9dc4001c956488dd701d567cb1">arrow::TimeUnit::MICRO</a></div><div class="ttdef"><b>Definition:</b> type.h:600</div></div>
+<div class="ttc" id="status_8h_html_a0a03bcf7fdbd9a96c67afa05fc0a545d"><div class="ttname"><a href="status_8h.html#a0a03bcf7fdbd9a96c67afa05fc0a545d">RETURN_NOT_OK</a></div><div class="ttdeci">#define RETURN_NOT_OK(s)</div><div class="ttdef"><b>Definition:</b> status.h:44</div></div>
+<div class="ttc" id="classarrow_1_1_status_html_a5c0b0031db6eeec3dcc70485d24cfe03"><div class="ttname"><a href="classarrow_1_1_status.html#a5c0b0031db6eeec3dcc70485d24cfe03">arrow::Status::OK</a></div><div class="ttdeci">static Status OK()</div><div class="ttdef"><b>Definition:</b> status.h:123</div></div>
+<div class="ttc" id="classarrow_1_1_status_html_aaaa6c0ddc3021415c238ab07353f3195"><div class="ttname"><a href="classarrow_1_1_status.html#aaaa6c0ddc3021415c238ab07353f3195">arrow::Status::Invalid</a></div><div class="ttdeci">static Status Invalid(const std::string &amp;msg)</div><div class="ttdef"><b>Definition:</b> status.h:146</div></div>
+<div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ffa88a677627c74df18d59f1aa6cd1c88d5"><div class="ttname"><a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffa88a677627c74df18d59f1aa6cd1c88d5">arrow::TimeUnit::NANO</a></div><div class="ttdef"><b>Definition:</b> type.h:600</div></div>
+<div class="ttc" id="python__to__arrow_8h_html_ae19630c1f4ca6d5236b30719d9140013"><div class="ttname"><a href="python__to__arrow_8h.html#ae19630c1f4ca6d5236b30719d9140013">PyObject</a></div><div class="ttdeci">_object PyObject</div><div class="ttdef"><b>Definition:</b> python_to_arrow.h:30</div></div>
+<div class="ttc" id="structarrow_1_1_time_unit_html_a561ef51c3755bd873f8f86f5bc4ec1ffadc3335445f7fa1b26f9c78754a1f217b"><div class="ttname"><a href="structarrow_1_1_time_unit.html#a561ef51c3755bd873f8f86f5bc4ec1ffadc3335445f7fa1b26f9c78754a1f217b">arrow::TimeUnit::MILLI</a></div><div class="ttdef"><b>Definition:</b> type.h:600</div></div>
 <div class="ttc" id="namespacearrow_html"><div class="ttname"><a href="namespacearrow.html">arrow</a></div><div class="ttdoc">Top-level namespace for Apache Arrow C++ API. </div><div class="ttdef"><b>Definition:</b> adapter.h:32</div></div>
 <div class="ttc" id="status_8h_html"><div class="ttname"><a href="status_8h.html">status.h</a></div></div>
 </div><!-- fragment --></div><!-- contents -->