reference/calendar/functions/jdtounix.xml
789af834328bf5d492ed174a4fedb226ccaf4b27
...
...
@@ -10,15 +10,12 @@
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
12
<type>int</type><methodname>jdtounix</methodname>
13
-
<methodparam><type>int</type><parameter>jday</parameter></methodparam>
13
+
<methodparam><type>int</type><parameter>julian_day</parameter></methodparam>
14
14
</methodsynopsis>
15
15
<para>
16
16
This function will return a Unix timestamp corresponding to the
17
-
Julian Day given in <parameter>jday</parameter> or &false; if
18
-
<parameter>jday</parameter> is not inside the Unix epoch
19
-
(Gregorian years between 1970 and 2037 or 2440588 &lt;=
20
-
<parameter>jday</parameter> &lt;= 2465342 ). The time returned is
21
-
localtime (and not GMT).
17
+
Julian Day given in <parameter>julian_day</parameter>. The time returned is
18
+
UTC.
22
19
</para>
23
20
</refsect1>
24
21

...
...
@@ -27,10 +24,11 @@
27
24
<para>
28
25
<variablelist>
29
26
<varlistentry>
30
-
<term><parameter>jday</parameter></term>
27
+
<term><parameter>julian_day</parameter></term>
31
28
<listitem>
32
29
<para>
33
-
A julian day number between 2440588 and 2465342.
30
+
A julian day number between <literal>2440588</literal> and <literal>106751993607888</literal>
31
+
on 64bit systems, or between <literal>2440588</literal> and <literal>2465443</literal> on 32bit systems.
34
32
</para>
35
33
</listitem>
36
34
</varlistentry>
...
...
@@ -41,10 +39,48 @@
41
39
<refsect1 role="returnvalues">
42
40
&reftitle.returnvalues;
43
41
<para>
44
-
The unix timestamp for the start of the given julian day.
42
+
The unix timestamp for the start (midnight, not noon) of the given Julian day
45
43
</para>
46
44
</refsect1>
47
45

46
+
<refsect1 role="errors">
47
+
&reftitle.errors;
48
+
<para>
49
+
If <parameter>julian_day</parameter> is outside of the allowed range,
50
+
a <classname>ValueError</classname> is thrown.
51
+
</para>
52
+
</refsect1>
53
+

54
+
<refsect1 role="changelog">
55
+
&reftitle.changelog;
56
+
<informaltable>
57
+
<tgroup cols="2">
58
+
<thead>
59
+
<row>
60
+
<entry>&Version;</entry>
61
+
<entry>&Description;</entry>
62
+
</row>
63
+
</thead>
64
+
<tbody>
65
+
<row>
66
+
<entry>8.0.0</entry>
67
+
<entry>
68
+
This function no longer returns &false; on failure, but raises a
69
+
<classname>ValueError</classname> instead.
70
+
</entry>
71
+
</row>
72
+
<row>
73
+
<entry>7.3.24, 7.4.12</entry>
74
+
<entry>
75
+
The upper limit of <parameter>julian_day</parameter> has been extended. Previously,
76
+
it was <literal>2465342</literal> regardless of the architecture.
77
+
</entry>
78
+
</row>
79
+
</tbody>
80
+
</tgroup>
81
+
</informaltable>
82
+
</refsect1>
83
+

48
84
<refsect1 role="seealso">
49
85
&reftitle.seealso;
50
86
<para>
...
...
@@ -54,7 +90,6 @@
54
90
</para>
55
91
</refsect1>
56
92
</refentry>
57
-

58
93
<!-- Keep this comment at the end of the file
59
94
Local variables:
60
95
mode: sgml
61
96