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

<section xml:id="datetime.configuration" xmlns="http://docbook.org/ns/docbook">

&reftitle.runtime;

&extension.runtime;

<para>

<table>

<title>Date/Time Configuration Options</title>

<tgroup cols="4">

<thead>

<row>

<entry>&Name;</entry>

<entry>&Default;</entry>

<entry>&Changeable;</entry>

<entry>&Changelog;</entry>

</row>

</thead>

<tbody xml:id="datetime.configuration.list">

<row>

<entry><link linkend="ini.date.default-latitude">date.default_latitude</link></entry>

<entry>"31.7667"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.date.default-longitude">date.default_longitude</link></entry>

<entry>"35.2333"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link></entry>

<entry>"90.833333"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>Prior to PHP 8.0.0, the default was "90.583333"</entry>

</row>

<row>

<entry><link linkend="ini.date.sunset-zenith">date.sunset_zenith</link></entry>

<entry>"90.833333"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>Prior to PHP 8.0.0, the default was "90.583333"</entry>

</row>

<row>

<entry><link linkend="ini.date.timezone">date.timezone</link></entry>

<entry>"UTC"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>From PHP 8.2, a warning is emitted when setting this to an invalid

value or an empty string.</entry>

</row>

</tbody>

</tgroup>

</table>

&ini.php.constants;

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.date.default-latitude">

<term>

<parameter>date.default_latitude</parameter>

<type>float</type>

</term>

<listitem>

<para>

The default latitude

ranging from <literal>0</literal> at the equator,

to <literal>+90</literal> northward, and <literal>-90</literal> southward.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.date.default-longitude">

<term>

<parameter>date.default_longitude</parameter>

<type>float</type>

</term>

<listitem>

<para>

The default longitude

ranging from <literal>0</literal> at the prime meridian

to <literal>+180</literal> eastward and <literal>−180</literal> westward.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.date.sunrise-zenith">

<term>

<parameter>date.sunrise_zenith</parameter>

<type>float</type>

</term>

<listitem>

<para>

The default sunrise zenith.

</para>

<para>

The default value is 90°50'. The additional 50' is due to two

components: the Sun's radius, which is 16', and the atmospheric

refraction, which is 34'.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.date.sunset-zenith">

<term>

<parameter>date.sunset_zenith</parameter>

<type>float</type>

</term>

<listitem>

<para>

The default sunset zenith.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.date.timezone">

<term>

<parameter>date.timezone</parameter>

<type>string</type>

</term>

<listitem>

<para>

The default timezone used by all date/time functions.

The precedence order for which timezone is used if none

is explicitly mentioned is described in the

<function>date_default_timezone_get</function> page. See <xref

linkend="timezones"/> for a list of supported timezones.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

<note>

<simpara>

The first four configuration options are currently only used by

<function>date_sunrise</function> and <function>date_sunset</function>.

</simpara>

</note>

</section>