reference/calendar/functions/gregoriantojd.xml
cca0f0ce480de21a3fe73bb3369de36129873496
...
...
@@ -15,7 +15,7 @@
15
15
<methodparam><type>int</type><parameter>year</parameter></methodparam>
16
16
</methodsynopsis>
17
17
<para>
18
-
Valid Range for Gregorian Calendar 4714 B.C. to 9999 A.D.</para>
18
+
The valid range for the Gregorian calendar is from November 25, 4714 B.C. to at least December 31, 9999 A.D.</para>
19
19
<para>
20
20
Although this function can handle dates all the way back to 4714
21
21
B.C., such use may not be meaningful. The Gregorian calendar was
...
...
@@ -43,7 +43,9 @@
43
43
<term><parameter>day</parameter></term>
44
44
<listitem>
45
45
<para>
46
-
The day as a number from 1 to 31
46
+
The day as a number from 1 to 31.
47
+
If the month has less days then given, overflow occurs; see the example
48
+
below.
47
49
</para>
48
50
</listitem>
49
51
</varlistentry>
...
...
@@ -51,7 +53,10 @@
51
53
<term><parameter>year</parameter></term>
52
54
<listitem>
53
55
<para>
54
-
The year as a number between -4714 and 9999
56
+
The year as a number between -4714 and 9999.
57
+
Negative numbers mean years B.C., positive numbers mean years A.D.
58
+
Note that there is no year <literal>0</literal>; December 31, 1 B.C. is
59
+
immediately followed by January 1, 1 A.D.
55
60
</para>
56
61
</listitem>
57
62
</varlistentry>
...
...
@@ -63,6 +68,7 @@
63
68
&reftitle.returnvalues;
64
69
<para>
65
70
The julian day for the given gregorian date as an integer.
71
+
Dates outside the valid range return <literal>0</literal>.
66
72
</para>
67
73
</refsect1>
68
74

...
...
@@ -74,13 +80,38 @@
74
80
<programlisting role="php">
75
81
<![CDATA[
76
82
<?php
77
-
$jd = GregorianToJD(10, 11, 1970);
83
+
$jd = gregoriantojd(10, 11, 1970);
78
84
echo "$jd\n";
79
-
$gregorian = JDToGregorian($jd);
85
+
$gregorian = jdtogregorian($jd);
80
86
echo "$gregorian\n";
81
87
?>
82
88
]]>
83
89
</programlisting>
90
+
&example.outputs;
91
+
<screen>
92
+
<![CDATA[
93
+
2440871
94
+
10/11/1970
95
+
]]>
96
+
</screen>
97
+
</example>
98
+
<example>
99
+
<title>Overflow behavior</title>
100
+
<programlisting role="php">
101
+
<![CDATA[
102
+
<?php
103
+
echo gregoriantojd(2, 31, 2018), PHP_EOL,
104
+
gregoriantojd(3, 3, 2018), PHP_EOL;
105
+
?>
106
+
]]>
107
+
</programlisting>
108
+
&example.outputs;
109
+
<screen>
110
+
<![CDATA[
111
+
2458181
112
+
2458181
113
+
]]>
114
+
</screen>
84
115
</example>
85
116
</para>
86
117
</refsect1>
87
118