mirror of
https://github.com/php/doc-tr.git
synced 2026-03-24 15:22:23 +01:00
506 lines
12 KiB
XML
506 lines
12 KiB
XML
<?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
|
||
-->
|