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

<!-- EN-Revision: 50dcf55ce543220dd8375df2fdb4f7db702b9c9f Maintainer: behzat Status: ready -->

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

<refnamediv>

<refname>date_parse</refname>

<refpurpose>Verilen tarih/zaman hakkındaki ayrıntılı bilgiyi ilişkisel dizi olarak döndürür</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>array</type><methodname>date_parse</methodname>

<methodparam><type>string</type><parameter>tarihzaman</parameter></methodparam>

</methodsynopsis>

<para>

<function>date_parse</function> belirtilen

<parameter>tarihzaman</parameter> dizgesini <function>strtotime</function>

ve <function>DateTimeImmutable::__construct</function>'ın bağlı olduğu

kurallara uygun olarak çözümler. Bir zaman damgası

(<function>strtotime</function> ile) veya

<classname>DateTimeImmutable</classname> nesnesi

(<function>DateTimeImmutable::__construct</function> ile) döndürmek

yerine, belirtilen <parameter>tarihzaman</parameter> dizgesinden saptanan

bilgiyi içeren bir ilişkisel dizi döndürür.

</para>

<para>

Belli öğelerle ilgili bilgi yoksa, ya bu dizi elemanlarına &false;

atanır ya da elemanlar dizide yer almaz. Bir zaman damgası veya

<classname>DateTimeImmutable</classname> nesnesi oluşturmak için

gerekliyse bazı alanlara &false;'tan farklı değerler atanabilir.

Bunun olduğu durumlar aşağıda örneklenmiştir.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>tarihzaman</parameter></term>

<listitem>

<para>

<function>DateTimeImmutable::__construct</function> işlevi tarafından

kabul edilen biçimde tarih/zaman.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Başarılı olduğunda çözümlenen tarih/zaman bilgilerini içeren diziyle döner.

</para>

<para>

Dönen dizinin anahtarları: <literal>year</literal>,

<literal>month</literal>, <literal>day</literal>, <literal>hour</literal>,

<literal>minute</literal>, <literal>second</literal>,

<literal>fraction</literal> ve <literal>is_localtime</literal>.

</para>

<para>

<literal>is_localtime</literal> mevcutsa<literal>zone_type</literal>

zaman dilimi türünü betimler. <literal>1</literal>. tür (UTC farkı)

için <literal>zone</literal>, <literal>is_dst</literal> alanları eklendi;

<literal>2</literal>. tür (kısaltma) için <literal>tz_abbr</literal>,

<literal>is_dst</literal> alanları eklendi; ve <literal>3</literal>.tür

(zaman dilimi betimleyici) için <literal>tz_abbr</literal>,

<literal>tz_id</literal> alanları eklendi.

</para>

<para>

<parameter>tarihzaman</parameter> dizgesi içinde, <literal>+3 days</literal>

(+3 gün) gibi göreli zaman elemanları mevcutsa, dönen dizi

<literal>relative</literal> anahtarlı gömülü bir dizi içerir. Bu dizinin

anahtarları <literal>year</literal>, <literal>month</literal>,

<literal>day</literal>, <literal>hour</literal>, <literal>minute</literal>,

<literal>second</literal> ve gerekiyorsa <literal>weekday</literal> ve

<literal>weekdays</literal> olup değerleri aktarılan dizgeye bağlıdır.

</para>

<para>

Dizi <literal>warning_count</literal> ve <literal>warnings</literal>

alanlarını içerir. İlki, gelen uyarı sayısıdır. <literal>warnings</literal>

dizisinin anahtarları uyarının kendisini açıklayan dizge değerini ve verilen

<parameter>tarihzaman</parameter> içinde uyarının oluştuğu konumu betimler.

</para>

<para>

Dizi ayrıca, <literal>error_count</literal> ve <literal>errors</literal>

alanlarını da içerir. İlki bulunan hata sayısıdır. <literal>errors</literal>

dizisinin anahtarları hatanın kendini açıklayan dizge değerini ve verilen

<parameter>tarihzaman</parameter> içinde hatanın oluştuğu konumu betimler.

</para>

<warning>

<para>

<literal>warnings</literal> ve <literal>errors</literal> dizilerindeki

eleman sayısı, ikisi de aynı konumda oluşmuşsa

<literal>warning_count</literal> veya <literal>error_count</literal>

değerlerinden küçük olmalıdır.

</para>

</warning>

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<para>

Tarih biçimi hatalı olduğu taktirde, dizinin 'errors' elemanı hata

iletilerini içerecektir.

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>7.2.0</entry>

<entry>

Dönen dizinin <literal>zone</literal> elemeanı artık dakika yerine

saniye sayısını gösteriyor, ayrıca işareti ters çevrildi. Örneğin,

<literal>-120</literal> yerine şimdi <literal>7200</literal> dönüyor.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>- Kapsamlı bir <parameter>tarihzaman</parameter> dizgesi ile

<function>date_parse</function> örneği</title>

<programlisting role="php">

<![CDATA[

<?php

var_dump(date_parse("2006-12-12 10:00:00.5"));

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

array(12) {

["year"]=>

int(2006)

["month"]=>

int(12)

["day"]=>

int(12)

["hour"]=>

int(10)

["minute"]=>

int(0)

["second"]=>

int(0)

["fraction"]=>

float(0.5)

["warning_count"]=>

int(0)

["warnings"]=>

array(0) {

}

["error_count"]=>

int(0)

["errors"]=>

array(0) {

}

["is_localtime"]=>

bool(false)

}

]]>

</screen>

</example>

</para>

<para>

Zaman dilimi elemanları yalnızca <parameter>tarihzaman</parameter>

dizgesinde belirtilmişse dizide bulunur. Böyle bir durumda dizi daima

<literal>zone_type</literal> elemanını ve bununla ilgili bir kaç elemanı

daha içerecekir.

<example>

<title>- Zaman dilimi kısaltması içeren

<function>date_parse</function> örneği</title>

<programlisting role="php">

<![CDATA[

<?php

var_dump(date_parse("Mon, 29 Oct 1923 20:30:00 +0200"));

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

array(16) {

["year"]=>

int(2022)

["month"]=>

int(6)

["day"]=>

int(2)

["hour"]=>

int(10)

["minute"]=>

int(28)

["second"]=>

int(17)

["fraction"]=>

float(0)

["warning_count"]=>

int(0)

["warnings"]=>

array(0) {

}

["error_count"]=>

int(0)

["errors"]=>

array(0) {

}

["is_localtime"]=>

bool(true)

["zone_type"]=>

int(2)

["zone"]=>

int(0)

["is_dst"]=>

bool(true)

["tz_abbr"]=>

string(3) "BST"

}

]]>

</screen>

</example>

<example>

<title>- Zaman dilimi belirteci ile

<function>date_parse</function> örneği</title>

<programlisting role="php">

<![CDATA[

<?php

var_dump(date_parse("June 2nd, 2022, 10:28:17 Europe/London"));

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

array(14) {

["year"]=>

int(2022)

["month"]=>

int(6)

["day"]=>

int(2)

["hour"]=>

int(10)

["minute"]=>

int(28)

["second"]=>

int(17)

["fraction"]=>

float(0)

["warning_count"]=>

int(0)

["warnings"]=>

array(0) {

}

["error_count"]=>

int(0)

["errors"]=>

array(0) {

}

["is_localtime"]=>

bool(true)

["zone_type"]=>

int(3)

["tz_id"]=>

string(13) "Europe/London"

}

]]>

</screen>

</example>

</para>

<para>

Daha kısa bir <parameter>tarihzaman</parameter> dizgesi ile daha az bilgi

elde edilir. Bu örnekte, tüm zaman parçaları için &false; dönmektedir.

<example>

<title>- Kısa bir dizge ile <function>date_parse</function> örneği</title>

<programlisting role="php">

<![CDATA[

<?php

var_dump(date_parse("June 2nd, 2022"));

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

array(12) {

["year"]=>

int(2022)

["month"]=>

int(6)

["day"]=>

int(2)

["hour"]=>

bool(false)

["minute"]=>

bool(false)

["second"]=>

bool(false)

["fraction"]=>

bool(false)

["warning_count"]=>

int(0)

["warnings"]=>

array(0) {

}

["error_count"]=>

int(0)

["errors"]=>

array(0) {

}

["is_localtime"]=>

bool(false)

}

]]>

</screen>

</example>

</para>

<para>

<link linkend="datetime.formats.relative">Göreli biçimler</link>

"relative" öğeye ayrıştırılır ve mutlak biçimlerden ayrıştırılan

değerleri etkilemez.

<example>

<title>- Göreli biçimlerle <function>date_parse</function> örneği</title>

<programlisting role="php">

<![CDATA[

<?php

var_dump(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour"));

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

array(13) {

["year"]=>

int(2006)

["month"]=>

int(12)

["day"]=>

int(12)

["hour"]=>

int(10)

["minute"]=>

int(0)

["second"]=>

int(0)

["fraction"]=>

float(0.5)

["warning_count"]=>

int(0)

["warnings"]=>

array(0) {

}

["error_count"]=>

int(0)

["errors"]=>

array(0) {

}

["is_localtime"]=>

bool(false)

["relative"]=>

array(6) {

["year"]=>

int(0)

["month"]=>

int(0)

["day"]=>

int(7)

["hour"]=>

int(1)

["minute"]=>

int(0)

["second"]=>

int(0)

}

]]>

</screen>

</example>

</para>

<para>

<literal>Thursday</literal> gibi uyaklı parçalar için, dizgenin zaman

bölümüne <literal>0</literal> atanır. <literal>Thursday</literal>,

<function>DateTimeImmutable::__construct</function>) işlevine

aktarılsaydı, bu ayrıca, 'hour', 'minute', 'second' ve 'fraction'

öğelerine de <literal>0</literal> atanmasıyla sonuçlanırdı. Aşağıdaki

örnekte, 'year' öğesi &false; olarak bırakılmıştır.

<example>

<title>- Yan etkili <function>date_parse</function> örneği</title>

<programlisting role="php">

<![CDATA[

<?php

var_dump(date_parse("Thursday, June 2nd"));

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

array(13) {

["year"]=>

bool(false)

["month"]=>

int(6)

["day"]=>

int(2)

["hour"]=>

int(0)

["minute"]=>

int(0)

["second"]=>

int(0)

["fraction"]=>

float(0)

["warning_count"]=>

int(0)

["warnings"]=>

array(0) {

}

["error_count"]=>

int(0)

["errors"]=>

array(0) {

}

["is_localtime"]=>

bool(false)

["relative"]=>

array(7) {

["year"]=>

int(0)

["month"]=>

int(0)

["day"]=>

int(0)

["hour"]=>

int(0)

["minute"]=>

int(0)

["second"]=>

int(0)

["weekday"]=>

int(4)

}

}

]]>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>date_parse_from_format</function> (Belirli biçemlerin

<parameter>tarihzaman</parameter> dizgesinden ayrıştırılması

için)</member>

<member><function>checkdate</function> (Gregoryen tarih doğrulaması için)</member>

<member><function>getdate</function></member>

</simplelist>

</para>

</refsect1>

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->