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

<reference xml:id="class.dateinterval" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

<title>DateInterval sınıfı</title>

<titleabbrev>DateInterval</titleabbrev>

<partintro>

<section xml:id="dateinterval.intro">

&reftitle.intro;

<para>

Bir tarih aralığı gösterir.

</para>

<para>

Ya sabit bir süre (yıl, ay, gün saat sayısı gibi) ya da

<classname>DateTimeImmutable</classname> ve

<classname>DateTime</classname> kurucusunun desteklediği biçemde

göreli bir zaman dizgesi saklanır.

</para>

<para>

Daha açıkçası, bir <classname>DateInterval</classname> nesnesindeki bilgiler,

bir tarih/saatten başka bir tarih/saate gitme talimatıdır.

Bu işlem her zaman tersine çevrilebilir değildir.

</para>

<para>

<classname>DateInterval</classname> nesnesi oluşturmanın yaygın yolu,

<methodname>DateTimeInterface::diff</methodname> aracılığıyla iki

tarih/saat nesnesi arasındaki farkı hesaplamaktır.

</para>

<para>

Tarih aralıklarını karşılaştırmak için uygun bir yöntem bulunmadığından

<classname>DateInterval</classname> örneklerinin

<link linkend="language.operators.comparison.incomparable">eşsiz</link>

olduğu varsayılır.

</para>

</section>

<section xml:id="dateinterval.synopsis">

&reftitle.classsynopsis;

<classsynopsis class="class">

<ooclass>

<classname>DateInterval</classname>

</ooclass>

<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>

<fieldsynopsis>

<modifier>public</modifier>

<type>int</type>

<varname linkend="dateinterval.props.y">y</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>int</type>

<varname linkend="dateinterval.props.m">m</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>int</type>

<varname linkend="dateinterval.props.d">d</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>int</type>

<varname linkend="dateinterval.props.h">h</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>int</type>

<varname linkend="dateinterval.props.i">i</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>int</type>

<varname linkend="dateinterval.props.s">s</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>float</type>

<varname linkend="dateinterval.props.f">f</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>int</type>

<varname linkend="dateinterval.props.invert">invert</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>mixed</type>

<varname linkend="dateinterval.props.days">days</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>bool</type>

<varname linkend="dateinterval.props.from-string">from_string</varname>

</fieldsynopsis>

<fieldsynopsis>

<modifier>public</modifier>

<type>string</type>

<varname linkend="dateinterval.props.date-string">date_string</varname>

</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dateinterval')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='DateInterval'])">

<xi:fallback/>

</xi:include>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dateinterval')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DateInterval'])">

<xi:fallback/>

</xi:include>

</classsynopsis>

</section>

<section xml:id="dateinterval.props">

&reftitle.properties;

<warning>

<para>

Aşağıda sıralanmış özellikler PHP sürümüne bağlı olup

<emphasis>salt-okunur</emphasis> olarak ele alınmalıdır.

</para>

</warning>

<variablelist>

<varlistentry xml:id="dateinterval.props.y">

<term><varname>y</varname></term>

<listitem>

<para>

Yıl sayısı.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.m">

<term><varname>m</varname></term>

<listitem>

<para>

Ay sayısı.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.d">

<term><varname>d</varname></term>

<listitem>

<para>

Gün sayısı.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.h">

<term><varname>h</varname></term>

<listitem>

<para>

Saat sayısı.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.i">

<term><varname>i</varname></term>

<listitem>

<para>

Dakika sayısı.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.s">

<term><varname>s</varname></term>

<listitem>

<para>

Saniye sayısı.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.f">

<term><varname>f</varname></term>

<listitem>

<para>

Saniyenin kesri olarak mikrosaniye.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.invert">

<term><varname>invert</varname></term>

<listitem>

<para>

Zaman aralığı negatifse <literal>1</literal> değilse

<literal>0</literal> Bakınız:

<methodname>DateInterval::format</methodname>.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.days">

<term><varname>days</varname></term>

<listitem>

<para>

DateInterval nesnesi <methodname>DateTimeImmutable::diff</methodname>

veya <function>DateTime::diff</function> tarafından oluşturulmuşsa,

başlangıç ve son tarihler arasındaki toplam tam gün sayısıdır.

Aksi takdirde, <varname>days</varname> &false;'dır.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.from-string">

<term><varname>from_string</varname></term>

<listitem>

<para>

DateInterval nesnesi

<methodname>DateInterval::createFromDateString</methodname>

tarafından oluşturulmuşsa, özelliğin değeri &true; olur ve

<varname>date_string</varname> özelliği oluşturulur. Aksi takdirde

değer &false; olur ve <varname>y</varname>'den <varname>f</varname>'ye

kadar özellikler ile <varname>invert</varname> ve

<varname>days</varname> özellikleri oluşturulur.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="dateinterval.props.date-string">

<term><varname>date_string</varname></term>

<listitem>

<para>

Dizge <methodname>DateInterval::createFromDateString</methodname>

için bir bağımsız değişken olarak kullanılır.

</para>

</listitem>

</varlistentry>

</variablelist>

</section>

<section role="changelog" xml:id="dateinterval.changelog"><!-- {{{ -->

&reftitle.changelog;

<para>

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.2.0</entry>

<entry>

<methodname>DateInterval::createFromDateString</methodname>

yöntemiyle oluşturulan <classname>DateInterval</classname> nesneleri

için <varname>from_string</varname> ve <varname>date_string</varname>

özellikleri eklendi.

</entry>

</row>

<row>

<entry>8.2.0</entry>

<entry>

Yalnızca <literal>y</literal>'den <literal>f</literal>'ye kadar,

<literal>invert</literal> ve <literal>days</literal> görünür olacaktır.

</entry>

</row>

<row>

<entry>7.4.0</entry>

<entry>

Artık, <classname>DateInterval</classname> örneklerinin eşsiz olduğu

varsayılıyor; evvelce tüm <classname>DateInterval</classname>

örneklerinin eşit olduğu varsayılırdı.

</entry>

</row>

<row>

<entry>7.1.0</entry>

<entry><varname>f</varname> özelliği eklendi.</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</para>

</section><!-- }}} -->

</partintro>

&reference.datetime.entities.dateinterval;

</reference>