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

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

<refnamediv>

<refname>unixtojd</refname>

<refpurpose>将 Unix 时间戳转换为儒略日数</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>int</type><type>false</type></type><methodname>unixtojd</methodname>

<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>

</methodsynopsis>

<para>

根据指定的 Unix <parameter>timestamp</parameter> （自 1970 年 1 月 1 日以来的秒数）返回儒略日数。如果没有指定时间戳则返回当前日期的儒略日数。

无论哪种方式，时间都被视为当地时间（不是 UTC）。

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>timestamp</parameter></term>

<listitem>

<para>

用于转换的 unix 时间戳。

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

int 类型的儒略日数，&return.falseforfailure;。

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.0.0</entry>

<entry>

<parameter>timestamp</parameter> 现在可以为 null。

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>jdtounix</function></member>

</simplelist>

</para>

</refsect1>

</refentry>