<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.gregoriantojd" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>gregoriantojd</refname>

<refpurpose>

Преобразовывает дату по григорианскому календарю в количество дней

в юлианском летоисчислении

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>int</type><methodname>gregoriantojd</methodname>

<methodparam><type>int</type><parameter>month</parameter></methodparam>

<methodparam><type>int</type><parameter>day</parameter></methodparam>

<methodparam><type>int</type><parameter>year</parameter></methodparam>

</methodsynopsis>

<para>

Разрешённый диапазон дат для григорианского календаря с 25 ноября 4714 года до

н. э. по 31 декабря 9999 год н. э.

</para>

<para>

Несмотря на возможность обработки дат вплоть до 4714 года до н. э.,

такое использование имеет мало смысла. Григорианский календарь не

существовал до 15 октября 1582 года (или 5 октября 1582 в юлианском

календаре). Некоторые страны не переходили на этот календарь очень

долгое время. Например, Великобритания совершила переход в 1752 году,

СССР в 1918 г., Греция в 1923 г. Большинство стран Европы предпочитали

юлианский календарь григорианскому.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>month</parameter></term>

<listitem>

<para>

Месяц в виде числа от 1 (январь) до 12 (декабрь)

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>day</parameter></term>

<listitem>

<para>

День в виде числа от 1 до 31.

Если в месяце меньше дней, чем передано, то

произойдёт переполнение; смотрите пример ниже.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>year</parameter></term>

<listitem>

<para>

Года в виде числа от -4714 до 9999.

Отрицательные числа означают года до н. э.,

положительные - н. э.

Обратите внимание, что не существует года

<literal>0</literal>; 31 декабря 1 года

до н. э. следует сразу после 1 января

1 года н. э.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Возвращает количество дней в юлианском летоисчислении для даты по григорианскому

календарю.

Даты за пределами допустимого диапазона

вернут <literal>0</literal>.

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>

Календарные функции

</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

<example>

<title>Поведение при переполнении</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>jdtogregorian</function></member>

<member><function>cal_to_jd</function></member>

</simplelist>

</para>

</refsect1>

</refentry>