com doc/tr: update for sync with English docs.: reference/datetime/functions/date-default-timezone-get.xml
reference/datetime/functions/date-default-timezone-set.xml reference/datetime/functions/date-parse.xml reference/datetime/functions/date-sun-info.xml
reference/datetime/functions/date-sunrise.xml reference/datetime/functions/date-sunset.xml reference/datetime/functions/date.xml
reference/datetime/functions/getdate.xml reference/datetime/func
| From: | Nilgün Belma Bugüner | Date: | Thu, 25 Mar 2021 14:28:30 +0000 |
| Subject: | com doc/tr: update for sync with English docs.: reference/datetime/functions/date-default-timezone-get.xml reference/datetime/functions/date-default-timezone-set.xml reference/datetime/functions/date-parse.xml reference/datetime/functions/date-sun-info.xml reference/datetime/functions/date-sunrise.xml reference/datetime/functions/date-sunset.xml reference/datetime/functions/date.xml reference/datetime/functions/getdate.xml reference/datetime/func |
||
| Groups: | php.doc.tr | ||
| Request: | Send a blank email to doc-tr+get-2628@lists.php.net to get a copy of this message | ||
Commit: 1a28125bb1004ae0d2070090fba393f70f56c107
Author: Nilgün Belma Bugüner <nilgun@php.net> Thu, 25 Mar 2021 17:28:30 +0300
Parents: d7809425bd525defb12eaddb1d79966d3a01db82
Branches: master
Link: http://git.php.net/?p=doc/tr.git;a=commitdiff;h=1a28125bb1004ae0d2070090fba393f70f56c107
Log:
update for sync with English docs.
Changed paths:
M reference/datetime/functions/date-default-timezone-get.xml
M reference/datetime/functions/date-default-timezone-set.xml
M reference/datetime/functions/date-parse.xml
M reference/datetime/functions/date-sun-info.xml
M reference/datetime/functions/date-sunrise.xml
M reference/datetime/functions/date-sunset.xml
M reference/datetime/functions/date.xml
M reference/datetime/functions/getdate.xml
M reference/datetime/functions/idate.xml
diff --git a/reference/datetime/functions/date-default-timezone-get.xml b/reference/datetime/functions/date-default-timezone-get.xml index f49f2c12..4f5153a8 100644 --- a/reference/datetime/functions/date-default-timezone-get.xml +++ b/reference/datetime/functions/date-default-timezone-get.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-default-timezone-get" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_default_timezone_get</refname> @@ -26,7 +26,8 @@ </listitem> <listitem> <para> - <varname>TZ</varname> ortam değişkenindeki değerle (boş değilse). + <emphasis>Sadece</emphasis> PHP 5.4.0 öncesinde: <varname>TZ</varname> + ortam değişkenindeki değerle (boş değilse). </para> </listitem> <listitem> @@ -37,8 +38,16 @@ </listitem> <listitem> <para> - Ev sahibi işletim sistemini sorgulayarak (işletim sistemi destekliyor - ve izin veriyorsa). + <emphasis>Sadece</emphasis> PHP 5.4.0 öncesinde: Konak işletim + sistemini sorgulayarak (işletim sistemi destekliyor ve izin veriyorsa). + Bunun için, zaman dilimini tahmin etmesi gereken bir algoritma + kullanılır. Ancak bu her durumda doğru çalışacağı anlamına gelmez. Bu + aşamaya ulaşıldığında bir uyarı gösterilir. Tahminin doğruluğuna + güvenilmez. Bu bakımdan, <link + linkend="ini.date.timezone">date.timezone</link> doğru saat dilimine + ayarlanmalıdır. + + </para> </listitem> </itemizedlist> diff --git a/reference/datetime/functions/date-default-timezone-set.xml b/reference/datetime/functions/date-default-timezone-set.xml index 75339e22..cece51be 100644 --- a/reference/datetime/functions/date-default-timezone-set.xml +++ b/reference/datetime/functions/date-default-timezone-set.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 0a10abc50524fcbb21807b5e6ebffb3b86d45907 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-default-timezone-set" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_default_timezone_set</refname> @@ -19,15 +19,6 @@ <function>date_default_timezone_set</function> işlevi, tüm tarih/zaman işlevleri tarafından kullanılan öntanımlı zaman dilimini ayarlar. </para> - <note> - <para> - PHP 5.1.0 sürümünden beri (tarih/zaman işlevleri yeniden yazıldığından - beri), bir tarih/zaman işlevinin her çağrılışında, eğer zaman dilimi - geçerli değilse bir <constant>E_NOTICE</constant>, eğer sistem ayarları - ya da <varname>TZ</varname> ortam değişkeni kullanılıyorsa bir - <constant>E_WARNING</constant> iletisi üretilmektedir. - </para> - </note> <para> Öntanımlı zaman dilimini ayarlamak için, bu işlevi betiğinizde kullanmak yerine, INI ayarlarındaki <link linkend="ini.date.timezone" @@ -44,6 +35,7 @@ <listitem> <para> Zaman dilimi belirteci, <literal>UTC</literal> ya da + <literal>Africa/Lagos</literal>, <literal>Asia/Hong_Kong</literal>, <literal>Europe/Istanbul</literal> gibi bir değer olabilir. Geçerli belirteçlerin listesi <xref linkend="timezones"/> bölümünde bulunmaktadır. @@ -86,38 +78,6 @@ if (strcmp($betik_zd, ini_get('date.timezone'))){ </para> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; - <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.3.0</entry> - <entry> - Artık <constant>E_STRICT</constant> yerine - <constant>E_WARNING</constant> oluşuyor. - </entry> - </row> - <row> - <entry>5.1.2</entry> - <entry> - İşlev, <parameter>zamandilimi_belirteci</parameter> değiştirgesini - kullanmaya başladı. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="seealso"> &reftitle.seealso; <para> diff --git a/reference/datetime/functions/date-parse.xml b/reference/datetime/functions/date-parse.xml index d433870e..cf7092af 100644 --- a/reference/datetime/functions/date-parse.xml +++ b/reference/datetime/functions/date-parse.xml @@ -1,16 +1,16 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-parse" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_parse</refname> - <refpurpose>Verilen tarih hakkındaki ayrıntılı bilgiyi ilişkisel dizi olarak döndürür</refpurpose> + <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>tarih</parameter></methodparam> + <methodparam><type>string</type><parameter>tarihzaman</parameter></methodparam> </methodsynopsis> </refsect1> @@ -19,10 +19,11 @@ <para> <variablelist> <varlistentry> - <term><parameter>tarih</parameter></term> + <term><parameter>tarihzaman</parameter></term> <listitem> <para> - <function>strtotime</function> işlevi tarafından kabul edilen biçimde tarih. + <function>DateTimeImmutable::__construct</function> işlevi tarafından + kabul edilen biçimde tarih/zaman. </para> </listitem> </varlistentry> @@ -33,7 +34,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda çözümlenen tarihin bilgilerini içeren diziyle, + Başarılı olduğunda çözümlenen tarih/zaman bilgilerini içeren diziyle, başarısız olduğunda &false; değeriyle döner. </para> </refsect1> @@ -46,6 +47,30 @@ </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> @@ -80,12 +105,63 @@ Array </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 +print_r(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour")); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Array +( + [year] => 2006 + [month] => 12 + [day] => 12 + [hour] => 10 + [minute] => 0 + [second] => 0 + [fraction] => 0.5 + [warning_count] => 0 + [warnings] => Array + ( + ) + + [error_count] => 0 + [errors] => Array + ( + ) + + [is_localtime] => + [relative] => Array + ( + [year] => 0 + [month] => 0 + [day] => 7 + [hour] => 1 + [minute] => 0 + [second] => 0 + ) + +)]]> + </screen> + </example> + </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> + <member><function>checkdate</function></member> <member><function>getdate</function></member> </simplelist> </para> diff --git a/reference/datetime/functions/date-sun-info.xml b/reference/datetime/functions/date-sun-info.xml index 321a576c..bff22337 100644 --- a/reference/datetime/functions/date-sun-info.xml +++ b/reference/datetime/functions/date-sun-info.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-sun-info" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_sun_info</refname> @@ -11,7 +11,7 @@ &reftitle.description; <methodsynopsis> <type>array</type><methodname>date_sun_info</methodname> - <methodparam><type>int</type><parameter>zaman</parameter></methodparam> + <methodparam><type>int</type><parameter>zaman_damgası</parameter></methodparam> <methodparam><type>float</type><parameter>enlem</parameter></methodparam> <methodparam><type>float</type><parameter>boylam</parameter></methodparam> </methodsynopsis> @@ -22,7 +22,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>zaman</parameter></term> + <term><parameter>zaman_damgası</parameter></term> <listitem> <para> Zaman damgası. @@ -53,7 +53,96 @@ &reftitle.returnvalues; <para> Başarılı olduğunda diziyi, başarısız olduğunda &false; değerini döndürür. + Dönen dizinin yapısı: </para> + <para> + <variablelist> + <varlistentry> + <term><literal>sunrise</literal></term> + <listitem> + <simpara> + Güneşin doğuşunun zaman damgası (başucu açısı = 90° 35'). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>sunset</literal></term> + <listitem> + <simpara> + Güneşin batışının zaman damgası (başucu açısı = 90° 35'). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>transit</literal></term> + <listitem> + <simpara> + Güneşin başucunda olduğu, yani en üst noktasına ulaştığı zamanın + damgası. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>civil_twilight_begin</literal></term> + <listitem> + <simpara> + Sivil şafağın başlangıcı (başucu açısı = 96°). Gün doğumunda + (<literal>sunrise</literal>) biter. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>civil_twilight_end</literal></term> + <listitem> + <simpara> + Sivil alacakaranlığın sonu (başucu açısı = 96°). Gün batımında + (<literal>sunset</literal>) başlar. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>nautical_twilight_begin</literal></term> + <listitem> + <simpara> + Denizde şafağın başlangıcı (başucu açısı = 102°). Şafağın başlangıcında + (<literal>civil_twilight_begin</literal>) biter. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>nautical_twilight_end</literal></term> + <listitem> + <simpara> + Deniz alacakaranlığının sonu (başucu açısı = 102°). + <literal>civil_twilight_end</literal>'de başlar. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>astronomical_twilight_begin</literal></term> + <listitem> + <simpara> + Astronomik şafağın başlangıcı (başucu açısı = 108°). + <literal>nautical_twilight_begin</literal>'de biter. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>astronomical_twilight_end</literal></term> + <listitem> + <simpara> + Astronomik alacakaranlığın sonu (başucu açısı = 108°). + <literal>nautical_twilight_end</literal>'de başlar. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Dizi elemanlarının değerleri, ya UNIX zaman damgasıdır, ya da güneş + günün tamamında ilgili başucunun altındaysa &false;, güneş günün tamamında + ilgili başucunun üstündeyse &true;'dur. +</para> </refsect1> <refsect1 role="examples"> @@ -87,6 +176,76 @@ astronomical_twilight_end: 18:09:14 </screen> </example> </para> + <example> + <title>- Kutup gecesi</title> + <programlisting role="php"> +<![CDATA[ +<?php +var_dump(date_sun_info(strtotime("2017-12-21"), 90, 0)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +array(9) { + ["sunrise"]=> + bool(false) + ["sunset"]=> + bool(false) + ["transit"]=> + int(1513857490) + ["civil_twilight_begin"]=> + bool(false) + ["civil_twilight_end"]=> + bool(false) + ["nautical_twilight_begin"]=> + bool(false) + ["nautical_twilight_end"]=> + bool(false) + ["astronomical_twilight_begin"]=> + bool(false) + ["astronomical_twilight_end"]=> + bool(false) +} +]]> + </screen> + </example> + <example> + <title>- Gece yarısı güneşi</title> + <programlisting role="php"> +<![CDATA[ +<?php +var_dump(date_sun_info(strtotime("2017-06-21"), 90, 0)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +array(9) { + ["sunrise"]=> + bool(true) + ["sunset"]=> + bool(true) + ["transit"]=> + int(1498046510) + ["civil_twilight_begin"]=> + bool(true) + ["civil_twilight_end"]=> + bool(true) + ["nautical_twilight_begin"]=> + bool(true) + ["nautical_twilight_end"]=> + bool(true) + ["astronomical_twilight_begin"]=> + bool(true) + ["astronomical_twilight_end"]=> + bool(true) +} +]]> + </screen> + </example> </refsect1> <refsect1 role="seealso"> diff --git a/reference/datetime/functions/date-sunrise.xml b/reference/datetime/functions/date-sunrise.xml index 80f7d60b..88f134e3 100644 --- a/reference/datetime/functions/date-sunrise.xml +++ b/reference/datetime/functions/date-sunrise.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: behzat Status: ready --> +<!-- EN-Revision: a41128675051f3b8ea0fc722a243455611087e55 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-sunrise" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_sunrise</refname> @@ -11,13 +11,12 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>mixed</type><methodname>date_sunrise</methodname> - <methodparam><type>int</type><parameter>zamandamgası</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>biçim</parameter><initializer>SUNFUNCS_RET_STRING</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>enlem</parameter><initializer>ini_get("date.default_latitude")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>boylam</parameter><initializer>ini_get("date.default_longitude")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>başucu</parameter><initializer>ini_get("date.sunrise_zenith")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>gmt_farkı</parameter><initializer>0</initializer></methodparam> + <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunrise</methodname> + <methodparam choice="opt"><type>int</type><parameter>dönüş_biçimi</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>enlem</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>boylam</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>başucu</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>utc_farkı</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <function>date_sunrise</function> işlevi, verilen gün @@ -39,11 +38,11 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>biçim</parameter></term> + <term><parameter>dönüş_biçimi</parameter></term> <listitem> <para> <table> - <title><parameter>biçim</parameter> sabitleri</title> + <title><parameter>dönüş_biçimi</parameter> sabitleri</title> <tgroup cols="2"> <thead> <row> @@ -78,8 +77,8 @@ <term><parameter>enlem</parameter></term> <listitem> <para> - Kuzey yarımküre öntanımlıdır. Güney yarımküre için negatif değer girin. - Ayrıca bakınız: <literal>date.default_latitude</literal> + Kuzey yarımküre öntanımlıdır. Güney yarımküre için negatif değer girilir. + Ayrıca bakınız: <link linkend="ini.date.default-latitude">date.default_latitude</link> </para> </listitem> </varlistentry> @@ -87,8 +86,9 @@ <term><parameter>boylam</parameter></term> <listitem> <para> - Doğu yarımküre öntanımlıdır. Batı yarımküre için negatif değer girin. - Ayrıca bakınız: <literal>date.default_longitude</literal> + Doğu yarımküre öntanımlıdır. Batı yarımküre için negatif değer + girilir. Ayrıca bakınız: + <link linkend="ini.date.default-longitude">date.default_longitude</link> </para> </listitem> </varlistentry> @@ -96,15 +96,52 @@ <term><parameter>başucu</parameter></term> <listitem> <para> - Öntanımlı: <literal>date.sunrise_zenith</literal> + <parameter>başucu</parameter>, güneşin merkezi ile dünya yüzeyine dik + bir çizgi arasındaki açıdır. Öntanımlı değer: + <link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link> + <table> + <title>Bazı <parameter>başucu</parameter> açıları</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Açı</entry> + <entry>Açıklama</entry> + </row> + </thead> + <tbody> + <row> + <entry>90°50'</entry> + <entry>Gündoğumu: Güneşin görünür hale geldiği nokta.</entry> + </row> + <row> + <entry>96°</entry> + <entry>Sivil alacakaranlık: Geleneksel olarak şafağın başlangıcını + belirtmek için kullanılır.</entry> + </row> + <row> + <entry>102°</entry> + <entry>Deniz alacakaranlığı: Ufkun denizde görünmeye başladığı + nokta.</entry> + </row> + <row> + <entry>108°</entry> + <entry>Astronomik alacakaranlık: Güneşin herhangi bir + aydınlatmanın kaynağı olmaya başladığı nokta.</entry> + </row> + </tbody> + </tgroup> + </table> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>gmt_farkı</parameter></term> + <term><parameter>utc_farkı</parameter></term> <listitem> <para> Saat cinsinden belirtilir. + <parameter>dönüş_biçimi</parameter> değeri + <constant>SUNFUNCS_RET_TIMESTAMP</constant> ise + <parameter>utc_farkı</parameter> yoksayılır. </para> </listitem> </varlistentry> @@ -115,17 +152,16 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda, <parameter>biçim</parameter> değiştirgesiyle - belirlenen biçimde şafak zamanını, başarız olduğunda &false; değerini - döndürür. + Başarılı olduğunda, <parameter>dönüş_biçimi</parameter> değiştirgesiyle + belirlenen biçimde şafak zamanı,&return.falseforfailure;. Başarısızlığın + olası nedeni, yılın bir bölümünde kutup dairesinin içinde güneşin hiç + doğmamasıdır. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; - - &date.timezone.errors.description; - + &date.timezone.errors.description; </refsect1> <refsect1 role="changelog"> @@ -140,9 +176,14 @@ </row> </thead> <tbody> - - &date.timezone.errors.changelog; - + <row> + <entry>8.0.0</entry> + <entry> + <parameter>enlem</parameter>, <parameter>botlam</parameter>, + <parameter>başucu</parameter> ve <parameter>utc_farkı</parameter> + artık &null; olabiliyor. + </entry> + </row> </tbody> </tgroup> </informaltable> @@ -177,6 +218,23 @@ Fri Dec 12 2008, şafak: 07:25 ]]> </screen> </example> + <example> + <title>- Güneşin doğmaması</title> + <programlisting role="php"> +<![CDATA[ +<?php +$solstice = strtotime('2017-12-21'); +var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +bool(false) +]]> + </screen> + </example> </para> </refsect1> @@ -185,6 +243,7 @@ Fri Dec 12 2008, şafak: 07:25 <para> <simplelist> <member><function>date_sunset</function></member> + <member><function>date_sun_info</function></member> </simplelist> </para> </refsect1> diff --git a/reference/datetime/functions/date-sunset.xml b/reference/datetime/functions/date-sunset.xml index d0c1fb00..929710d4 100644 --- a/reference/datetime/functions/date-sunset.xml +++ b/reference/datetime/functions/date-sunset.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: behzat Status: ready --> -<refentry xml:id="function.date-sunset" xmlns="http://docbook.org/ns/docbook"> +<!-- EN-Revision: a41128675051f3b8ea0fc722a243455611087e55 Maintainer: behzat Status: ready --> +<refentry xml:id="function.date-sunset" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>date_sunset</refname> <refpurpose> @@ -12,13 +12,12 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>mixed</type><methodname>date_sunset</methodname> - <methodparam><type>int</type><parameter>zamandamgası</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>biçim</parameter><initializer>SUNFUNCS_RET_STRING</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>enlem</parameter><initializer>ini_get("date.default_latitude")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>boylam</parameter><initializer>ini_get("date.default_longitude")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>başucu</parameter><initializer>ini_get("date.sunset_zenith")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>gmt_farkı</parameter><initializer>0</initializer></methodparam> + <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunset</methodname> + <methodparam choice="opt"><type>int</type><parameter>dönüş_biçimi</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>enlem</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>boylam</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>başucu</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>utc_farkı</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <function>date_sunset</function> işlevi, verilen gün @@ -40,11 +39,11 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>biçim</parameter></term> + <term><parameter>dönüş_biçimi</parameter></term> <listitem> <para> <table> - <title><parameter>biçim</parameter> sabitleri</title> + <title><parameter>dönüş_biçimi</parameter> sabitleri</title> <tgroup cols="2"> <thead> <row> @@ -79,8 +78,9 @@ <term><parameter>enlem</parameter></term> <listitem> <para> - Kuzey yarımküre öntanımlıdır. Güney yarımküre için negatif değer girin. - Ayrıca bakınız: <literal>date.default_latitude</literal> + Kuzey yarımküre öntanımlıdır. Güney yarımküre için negatif değer + girilir. Ayrıca bakınız: + <link linkend="ini.date.default-latitude">date.default_latitude</link> </para> </listitem> </varlistentry> @@ -88,8 +88,8 @@ <term><parameter>boylam</parameter></term> <listitem> <para> - Doğu yarımküre öntanımlıdır. Batı yarımküre için negatif değer girin. - Ayrıca bakınız: <literal>date.default_longitude</literal> + Doğu yarımküre öntanımlıdır. Batı yarımküre için negatif değer girilir. Ayrıca bakınız: + <link linkend="ini.date.default-longitude">date.default_longitude</link> </para> </listitem> </varlistentry> @@ -97,15 +97,52 @@ <term><parameter>başucu</parameter></term> <listitem> <para> - Öntanımlı: <literal>date.sunset_zenith</literal> + <parameter>başucu</parameter>, güneşin merkezi ile dünya yüzeyine dik + bir çizgi arasındaki açıdır. Öntanımlı değer: + <link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link> + <table> + <title>Bazı <parameter>başucu</parameter> açıları</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Açı</entry> + <entry>Açıklama</entry> + </row> + </thead> + <tbody> + <row> + <entry>90°50'</entry> + <entry>Gündoğumu: Güneşin görünür hale geldiği nokta.</entry> + </row> + <row> + <entry>96°</entry> + <entry>Sivil alacakaranlık: Geleneksel olarak şafağın başlangıcını + belirtmek için kullanılır.</entry> + </row> + <row> + <entry>102°</entry> + <entry>Deniz alacakaranlığı: Ufkun denizde görünmeye başladığı + nokta.</entry> + </row> + <row> + <entry>108°</entry> + <entry>Astronomik alacakaranlık: Güneşin herhangi bir + aydınlatmanın kaynağı olmaya başladığı nokta.</entry> + </row> + </tbody> + </tgroup> + </table> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>gmt_farkı</parameter></term> + <term><parameter>utc_farkı</parameter></term> <listitem> <para> Saat cinsinden belirtilir. + <parameter>dönüş_biçimi</parameter> değeri + <constant>SUNFUNCS_RET_TIMESTAMP</constant> ise + <parameter>utc_farkı</parameter> yoksayılır. </para> </listitem> </varlistentry> @@ -115,9 +152,7 @@ <refsect1 role="errors"> &reftitle.errors; - &date.timezone.errors.description; - </refsect1> <refsect1 role="changelog"> @@ -132,9 +167,14 @@ </row> </thead> <tbody> - - &date.timezone.errors.changelog; - + <row> + <entry>8.0.0</entry> + <entry> + <parameter>enlem</parameter>, <parameter>botlam</parameter>, + <parameter>başucu</parameter> ve <parameter>utc_farkı</parameter> + artık &null; olabiliyor. + </entry> + </row> </tbody> </tgroup> </informaltable> @@ -144,9 +184,10 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda, <parameter>biçim</parameter> değiştirgesiyle - belirlenen biçemde gün batımı zamanını, başarız olduğunda &false; değerini - döndürür. + Başarılı olduğunda, <parameter>dönüş_biçimi</parameter> değiştirgesiyle + belirlenen biçimde şafak zamanı,&return.falseforfailure;. Başarısızlığın + olası nedeni, yılın bir bölümünde kutup dairesinin içinde güneşin hiç + doğmamasıdır. </para> </refsect1> @@ -178,6 +219,23 @@ Thu Dec 11 2008, günbatımı: 16:33 ]]> </screen> </example> + <example> + <title>- Güneşin doğmaması</title> + <programlisting role="php"> +<![CDATA[ +<?php +$solstice = strtotime('2017-12-21'); +var_dump(date_sunset($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +bool(false) +]]> + </screen> + </example> </para> </refsect1> @@ -186,6 +244,7 @@ Thu Dec 11 2008, günbatımı: 16:33 <para> <simplelist> <member><function>date_sunrise</function></member> + <member><function>date_sun_info</function></member> </simplelist> </para> </refsect1> diff --git a/reference/datetime/functions/date.xml b/reference/datetime/functions/date.xml index a0337513..7744634a 100644 --- a/reference/datetime/functions/date.xml +++ b/reference/datetime/functions/date.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.date" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>date</refname> @@ -12,7 +12,7 @@ <methodsynopsis> <type>string</type><methodname>date</methodname> <methodparam><type>string</type><parameter>biçim</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <parameter>zaman_damgası</parameter> değiştirgesi ile belirtilen zamanı ya @@ -25,309 +25,18 @@ <refsect1 role="parameters"> &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>biçim</parameter></term> - <listitem> - <para> - Çıktılanan zamanın <type>string</type> türünden biçimi. Biçimlendirme - seçenekleri için aşağıya bakınız. Ayrıca burada kullanılabilecek - önceden tanımlanmış çeşitli <link linkend="datetime.constants.types"> - tarih sabitleri</link> vardır. Örneğin, <constant>DATE_RSS</constant> - sabiti <literal>'D, d M Y H:i:s'</literal> biçemini içerir. - </para> - <para> - <table> - <title>Aşağıdaki karakterler <parameter>biçim</parameter> değiştirge - dizgesi içinde tanınır.</title> - <tgroup cols="3"> - <thead> - <row> - <entry><parameter>biçim</parameter> karakteri</entry> - <entry>Açıklama</entry> - <entry>Örnek sonuç</entry> - </row> - </thead> - <tbody> - <row> - <entry align="center"><emphasis>Gün</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>d</literal></entry> - <entry>Ay günlerinin sıfır dolgulu iki haneli gösterimi</entry> - <entry><literal>01</literal>'den <literal>31</literal>'e</entry> - </row> - <row> - <entry><literal>D</literal></entry> - <entry>Ay günlerinin üç harfli metinsel gösterimi</entry> - <entry><literal>Pzt</literal>'den <literal>Paz</literal>'a</entry> - </row> - <row> - <entry><literal>j</literal></entry> - <entry>Ay günlerinin sıfır dolgusuz gösterimi</entry> - <entry><literal>1</literal>'den <literal>31</literal>'e</entry> - </row> - <row> - <entry><literal>l</literal> (küçük 'L' harfi)</entry> - <entry>Hafta günlerinin tam metinsel gösterimi</entry> - <entry><literal>Pazar</literal>'dan - <literal>Cumartesi</literal>'ye</entry> - </row> - <row> - <entry><literal>N</literal></entry> - <entry>Hafta günlerinin ISO-8601 standardında sayısal gösterimi - (PHP 5.1.0'da eklenmiştir)</entry> - <entry><literal>1</literal>'den (Pazartesi için) - <literal>7</literal>'ye (Pazar için)</entry> - </row> - <row> - <entry><literal>S</literal></entry> - <entry>Ay günleri için 2 karakterli İngilizce sıralama ekleri - </entry> - <entry> - <literal>st</literal>, <literal>nd</literal>, - <literal>rd</literal> ya da <literal>th</literal>. - <literal>j</literal> ile uyumlu çalışmaktadır. - </entry> - </row> - <row> - <entry><literal>w</literal></entry> - <entry>Hafta günlerinin sayısal gösterimi</entry> - <entry><literal>0</literal>'dan (Pazar için) - <literal>6</literal>'ya (Cumartesi için)</entry> - </row> - <row> - <entry><literal>z</literal></entry> - <entry>Yılın günleri (0'dan başlar)</entry> - <entry><literal>0</literal>'dan <literal>365</literal>'e</entry> - </row> - <row> - <entry align="center"><emphasis>Hafta</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>W</literal></entry> - <entry>ISO-8601 standartına göre yılın hafta numarası, hafta - başlangıcı Pazartesi'dir (PHP 4.1.0 sürümüyle eklenmiştir)</entry> - <entry>Örneğin: <literal>42</literal> (Yılın 42'inci - haftası)</entry> - </row> - <row> - <entry align="center"><emphasis>Ay</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>F</literal></entry> - <entry>Ayın tam metinsel gösterimi, Ocak ya da Mart gibi</entry> - <entry><literal>January</literal>'den <literal>December</literal>'a - </entry> - </row> - <row> - <entry><literal>m</literal></entry> - <entry>Ayın sıfır dolgulu sayısal gösterimi</entry> - <entry><literal>01</literal>'den <literal>12</literal>'ye</entry> - </row> - <row> - <entry><literal>M</literal></entry> - <entry>Ayın üç karakterli, metinsel kısa gösterimi</entry> - <entry><literal>Jan</literal>'dan <literal>Dec</literal>'e kadar - </entry> - </row> - <row> - <entry><literal>n</literal></entry> - <entry>Ayın sıfır dolgusuz sayısal gösterimi</entry> - <entry><literal>1</literal>'den <literal>12</literal>'ye kadar - </entry> - </row> - <row> - <entry><literal>t</literal></entry> - <entry>Belirtilen ayın gün sayısı</entry> - <entry><literal>28</literal>'den <literal>31</literal>'e</entry> - </row> - <row> - <entry align="center"><emphasis>Yıl</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>L</literal></entry> - <entry>Artık yıl olduğunda</entry> - <entry>Eğer artık yılsa <literal>1</literal>, değilse - <literal>0</literal>.</entry> - </row> - <row> - <entry><literal>o</literal></entry> - <entry>ISO-8601 standardı yıl numarası. ISO hafta numaralarının - (<literal>W</literal>) ait olduğu yılın gösterilmesi dışında - <literal>Y</literal> ile aynı değere sahiptir. (PHP 5.1.0 sürümünde - eklenmiştir)</entry> - <entry>Örnekler: <literal>1999</literal> ya da - <literal>2003</literal> gibi</entry> - </row> - <row> - <entry><literal>Y</literal></entry> - <entry>Yılın 4 haneli sayısal, tam gösterimi</entry> - <entry>Örnekler: <literal>1999</literal> ya da - <literal>2003</literal> gibi</entry> - </row> - <row> - <entry><literal>y</literal></entry> - <entry>Yılın iki haneli gösterimi</entry> - <entry>Örnekler: <literal>99</literal> ya da <literal>03</literal> - gibi</entry> - </row> - <row> - <entry align="center"><emphasis>Saat</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>a</literal></entry> - <entry>Küçük harfli öğleden önce ve öğleden sonra</entry> - <entry><literal>am</literal> ya da <literal>pm</literal></entry> - </row> - <row> - <entry><literal>A</literal></entry> - <entry>Büyük harfli öğleden önce ve öğleden sonra</entry> - <entry><literal>AM</literal> ya da <literal>PM</literal></entry> - </row> - <row> - <entry><literal>B</literal></entry> - <entry>Swatch İnternet saati</entry> - <entry><literal>000</literal>'dan <literal>999</literal>'a</entry> - </row> - <row> - <entry><literal>g</literal></entry> - <entry>Saatin, 12-saatlik sıfır dolgusuz gösterimi</entry> - <entry><literal>1</literal>'den <literal>12</literal>'ye</entry> - </row> - <row> - <entry><literal>G</literal></entry> - <entry>Saatin, 24-saatlik sıfır dolgusuz gösterimi</entry> - <entry><literal>0</literal>'dan <literal>23</literal>'e</entry> - </row> - <row> - <entry><literal>h</literal></entry> - <entry>Saatin, 12-saatlik sıfır dolgulu gösterimi</entry> - <entry><literal>01</literal>'den <literal>12</literal>'ye</entry> - </row> - <row> - <entry><literal>H</literal></entry> - <entry>Saatin, 24-saatlik sıfır dolgulu gösterimi</entry> - <entry><literal>00</literal>'dan <literal>23</literal>'e</entry> - </row> - <row> - <entry><literal>i</literal></entry> - <entry>Sıfır dolgulu dakika gösterimi</entry> - <entry><literal>00</literal> ile <literal>59</literal> arasında - </entry> - </row> - <row> - <entry><literal>s</literal></entry> - <entry>Sıfır dolgulu saniye gösterimi</entry> - <entry><literal>00</literal> ile <literal>59</literal> arasında - </entry> - </row> - <row> - <entry><literal>u</literal></entry> - <entry>Mikrosaniye (PHP 5.2.2 sürümüyle eklenmiştir)</entry> - <entry>Örneğin: <literal>654321</literal></entry> - </row> - <row> - <entry align="center"><emphasis>Zaman dilimi</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>e</literal></entry> - <entry>Zaman dilimi belirteci (PHP 5.1.0 sürümüyle eklenmiştir) - </entry> - <entry>Örnekler: <literal>UTC</literal>, <literal>GMT</literal>, - <literal>Europe/Istanbul</literal></entry> - </row> - <row> - <entry><literal>I</literal> (büyük ı)</entry> - <entry>Yaz saati uygulaması var mı?</entry> - <entry>Varsa <literal>1</literal>, yoksa <literal>0</literal>. - </entry> - </row> - <row> - <entry><literal>O</literal></entry> - <entry>Saat olarak Greenwich zamanı (GMT) farkı</entry> - <entry>Örneğin: <literal>+0200</literal></entry> - </row> - <row> - <entry><literal>P</literal></entry> - <entry>Saat ve dakika olarak Greenwich zamanı (GMT) farkı (PHP - 5.1.3 sürümüyle eklenmiştir)</entry> - <entry>Örneğin: <literal>+02:00</literal></entry> - </row> - <row> - <entry><literal>T</literal></entry> - <entry>Zaman dilimi kısaltması</entry> - <entry>Örnekler: <literal>EST</literal>, <literal>EET</literal> - gibi</entry> - </row> - <row> - <entry><literal>Z</literal></entry> - <entry>Saniye cinsinden saat farkı. UTC'nin batısı daima negatif, - doğusu ise daima pozitif değerlidir.</entry> - <entry><literal>-43200</literal>'den <literal>50400</literal>'e - </entry> - </row> - <row> - <entry align="center"><emphasis>Tam Tarih/Saat</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>c</literal></entry> - <entry>ISO 8601 standardı tarih (PHP 5'te' eklenmiştir)</entry> - <entry>2004-02-12T15:19:21+00:00</entry> - </row> - <row> - <entry><literal>r</literal></entry> - <entry><link xlink:href="&url.rfc;2822">RFC 2822</link> biçiminde - tarih</entry> - <entry>Örneğin: <literal>Thu, 21 Dec 2000 16:01:07 +0200</literal> - </entry> - </row> - <row> - <entry><literal>U</literal></entry> - <entry>Unix Zaman Başlangıcından (1 Ocak 1970 00:00:00 GMT) - itibaren geçen saniye sayısı</entry> - <entry><function>time</function> işlevine bakınız</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - Biçim dizgesinde tanınmayan karakterler olduğu gibi yazdırılacaktır. - <literal>Z</literal> biçimi <function>gmdate</function> işleviyle - kullanıldığında daima <literal>0</literal> değerini döndürür. - </para> - <note> - <para> - Bu işlev sadece <type>integer</type> türünde zaman damgalarını kabul - etmektedir. <literal>u</literal> biçim karakteri sadece - <function>date_format</function> işlevinde, - <function>date_create</function> işleviyle kullanıcı tabanlı bir zaman - damgası oluşturulduğunda kullanılabilir. - </para> - </note> - </listitem> - </varlistentry> - - &date.timestamp.description; - - </variablelist> - </para> + <variablelist> + <varlistentry> + <term><parameter>biçim</parameter></term> + <listitem> + <para> + <function>DateTimeInterface::format</function> tarafından kabul + edilen biçim. + </para> + </listitem> + </varlistentry> + &date.timestamp.description; + </variablelist> </refsect1> <refsect1 role="returnvalues"> @@ -342,9 +51,7 @@ <refsect1 role="errors"> &reftitle.errors; - &date.timezone.errors.description; - </refsect1> <refsect1 role="changelog"> @@ -360,25 +67,9 @@ </thead> <tbody> <row> - <entry>5.1.0</entry> - <entry> - Zaman damgasının geçerlilik aralığı, genellikle Cum, 13 Ara 1901 - 20:45:54 GMT ile Per, 19 Oca 2038 03:14:07 GMT arasındadır. (Bu tarih - değerleri aynı zamanda en küçük ve en büyük 32-bit işaretli - tamsayıları temsil etmektedir.) Bununla birikte, PHP 5.1.0'den önce bu - aralık bazı sistemlerde 01-01-1970 ile 19-01-2038 arasıyla sınırlıydı. - (ör: Windows). - </entry> - </row> - - &date.timezone.errors.changelog; - - <row> - <entry>5.1.1</entry> + <entry>8.0.0</entry> <entry> - Standart tarih/zaman biçimleri için, <parameter>biçim</parameter> - değiştirgesinde kullanılabilecek yararlı <link - linkend="datetime.constants">sabitler</link> devreye girdi. + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. </entry> </row> </tbody> @@ -409,8 +100,8 @@ echo date('l jS \of F Y h:i:s A'); echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000)); /* biçim değiştirgesi için sabit kullanımı*/ -// Şöyle bir şey basar: Mon, 15 Aug 2005 15:12:46 UTC -echo date(DATE_RFC822); +// Şöyle bir şey basar: Wed, 25 Sep 2013 15:28:57 -0700 +echo date(DATE_RFC2822); // Şöyle bir şey basar: 2000-07-01T00:00:00+00:00 echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000)); @@ -430,7 +121,7 @@ echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000)); <![CDATA[ <?php // Şöyle bir şey basar: Wednesday the 15th -echo date("l \\t\h\e jS"); +echo date('l \t\h\e jS'); ?> ]]> </programlisting> @@ -484,6 +175,7 @@ $bugün = date('\i\t \i\s \t\h\e jS \d\a\y.'); // it is the 10th day. $bugün = date("D M j G:i:s T Y"); // Sat Mar 10 17:16:18 MST 2001 $bugün = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:18 m is month $bugün = date("H:i:s"); // 17:16:18 +$bugün = date("Y-m-d H:i:s"); // 2001-03-10 17:16:18 (MySQL DATETIME biçimi) ?> ]]> </programlisting> @@ -526,6 +218,7 @@ $bugün = date("H:i:s"); // 17:16:18 <member><function>mktime</function></member> <member><function>strftime</function></member> <member><function>time</function></member> + <member><function>DateTimeImmutable::__construct</function></member> <member><link linkend="datetime.constants.types">Öntanımlı Tarih/Saat Sabitleri</link></member> diff --git a/reference/datetime/functions/getdate.xml b/reference/datetime/functions/getdate.xml index 9e3b84e2..44b9de89 100644 --- a/reference/datetime/functions/getdate.xml +++ b/reference/datetime/functions/getdate.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.getdate" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -12,7 +12,7 @@ &reftitle.description; <methodsynopsis> <type>array</type><methodname>getdate</methodname> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter><initializer>time()</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> Değiştirgeyle çağrılmışsa <parameter>zaman_damgası</parameter>'na karşılık @@ -25,9 +25,7 @@ &reftitle.parameters; <para> <variablelist> - &date.timestamp.description; - </variablelist> </para> </refsect1> @@ -128,6 +126,30 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -170,6 +192,7 @@ Array <simplelist> <member><function>date</function></member> <member><function>idate</function></member> + <member><function>localtime</function></member> <member><function>time</function></member> <member><function>setlocale</function></member> </simplelist> diff --git a/reference/datetime/functions/idate.xml b/reference/datetime/functions/idate.xml index 627ad02e..2e681f69 100644 --- a/reference/datetime/functions/idate.xml +++ b/reference/datetime/functions/idate.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.idate" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>idate</refname> @@ -10,9 +10,9 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>idate</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>idate</methodname> <methodparam><type>string</type><parameter>biçem</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter><initializer>time()</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <parameter>zaman_damgası</parameter> ile belirtilen zaman için @@ -134,10 +134,11 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - <type>integer</type> türünde bir değer döner. + Başarı durumunda <type>int</type> türünde bir + değer,&return.falseforfailure;. </para> <para> - <function>idate</function> işlevi daima <type>integer</type> türünde değer + <function>idate</function> işlevi daima <type>int</type> türünde değer döndürse de bu değerler "0" ile başlayamaz. <function>idate</function> işlevi beklediğinizden daha az karakter döndürebilir. Aşağıdaki örneğe bakınız. @@ -163,9 +164,12 @@ </row> </thead> <tbody> - - &date.timezone.errors.changelog; - + <row> + <entry>8.0.0</entry> + <entry> + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. + </entry> + </row> </tbody> </tgroup> </informaltable>
diff --git a/reference/datetime/functions/date-default-timezone-get.xml b/reference/datetime/functions/date-default-timezone-get.xml index f49f2c12..4f5153a8 100644 --- a/reference/datetime/functions/date-default-timezone-get.xml +++ b/reference/datetime/functions/date-default-timezone-get.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-default-timezone-get" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_default_timezone_get</refname> @@ -26,7 +26,8 @@ </listitem> <listitem> <para> - <varname>TZ</varname> ortam değişkenindeki değerle (boş değilse). + <emphasis>Sadece</emphasis> PHP 5.4.0 öncesinde: <varname>TZ</varname> + ortam değişkenindeki değerle (boş değilse). </para> </listitem> <listitem> @@ -37,8 +38,16 @@ </listitem> <listitem> <para> - Ev sahibi işletim sistemini sorgulayarak (işletim sistemi destekliyor - ve izin veriyorsa). + <emphasis>Sadece</emphasis> PHP 5.4.0 öncesinde: Konak işletim + sistemini sorgulayarak (işletim sistemi destekliyor ve izin veriyorsa). + Bunun için, zaman dilimini tahmin etmesi gereken bir algoritma + kullanılır. Ancak bu her durumda doğru çalışacağı anlamına gelmez. Bu + aşamaya ulaşıldığında bir uyarı gösterilir. Tahminin doğruluğuna + güvenilmez. Bu bakımdan, <link + linkend="ini.date.timezone">date.timezone</link> doğru saat dilimine + ayarlanmalıdır. + + </para> </listitem> </itemizedlist> diff --git a/reference/datetime/functions/date-default-timezone-set.xml b/reference/datetime/functions/date-default-timezone-set.xml index 75339e22..cece51be 100644 --- a/reference/datetime/functions/date-default-timezone-set.xml +++ b/reference/datetime/functions/date-default-timezone-set.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 0a10abc50524fcbb21807b5e6ebffb3b86d45907 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-default-timezone-set" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_default_timezone_set</refname> @@ -19,15 +19,6 @@ <function>date_default_timezone_set</function> işlevi, tüm tarih/zaman işlevleri tarafından kullanılan öntanımlı zaman dilimini ayarlar. </para> - <note> - <para> - PHP 5.1.0 sürümünden beri (tarih/zaman işlevleri yeniden yazıldığından - beri), bir tarih/zaman işlevinin her çağrılışında, eğer zaman dilimi - geçerli değilse bir <constant>E_NOTICE</constant>, eğer sistem ayarları - ya da <varname>TZ</varname> ortam değişkeni kullanılıyorsa bir - <constant>E_WARNING</constant> iletisi üretilmektedir. - </para> - </note> <para> Öntanımlı zaman dilimini ayarlamak için, bu işlevi betiğinizde kullanmak yerine, INI ayarlarındaki <link linkend="ini.date.timezone" @@ -44,6 +35,7 @@ <listitem> <para> Zaman dilimi belirteci, <literal>UTC</literal> ya da + <literal>Africa/Lagos</literal>, <literal>Asia/Hong_Kong</literal>, <literal>Europe/Istanbul</literal> gibi bir değer olabilir. Geçerli belirteçlerin listesi <xref linkend="timezones"/> bölümünde bulunmaktadır. @@ -86,38 +78,6 @@ if (strcmp($betik_zd, ini_get('date.timezone'))){ </para> </refsect1> - <refsect1 role="changelog"> - &reftitle.changelog; - <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.3.0</entry> - <entry> - Artık <constant>E_STRICT</constant> yerine - <constant>E_WARNING</constant> oluşuyor. - </entry> - </row> - <row> - <entry>5.1.2</entry> - <entry> - İşlev, <parameter>zamandilimi_belirteci</parameter> değiştirgesini - kullanmaya başladı. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - <refsect1 role="seealso"> &reftitle.seealso; <para> diff --git a/reference/datetime/functions/date-parse.xml b/reference/datetime/functions/date-parse.xml index d433870e..cf7092af 100644 --- a/reference/datetime/functions/date-parse.xml +++ b/reference/datetime/functions/date-parse.xml @@ -1,16 +1,16 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-parse" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_parse</refname> - <refpurpose>Verilen tarih hakkındaki ayrıntılı bilgiyi ilişkisel dizi olarak döndürür</refpurpose> + <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>tarih</parameter></methodparam> + <methodparam><type>string</type><parameter>tarihzaman</parameter></methodparam> </methodsynopsis> </refsect1> @@ -19,10 +19,11 @@ <para> <variablelist> <varlistentry> - <term><parameter>tarih</parameter></term> + <term><parameter>tarihzaman</parameter></term> <listitem> <para> - <function>strtotime</function> işlevi tarafından kabul edilen biçimde tarih. + <function>DateTimeImmutable::__construct</function> işlevi tarafından + kabul edilen biçimde tarih/zaman. </para> </listitem> </varlistentry> @@ -33,7 +34,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda çözümlenen tarihin bilgilerini içeren diziyle, + Başarılı olduğunda çözümlenen tarih/zaman bilgilerini içeren diziyle, başarısız olduğunda &false; değeriyle döner. </para> </refsect1> @@ -46,6 +47,30 @@ </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> @@ -80,12 +105,63 @@ Array </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 +print_r(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour")); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Array +( + [year] => 2006 + [month] => 12 + [day] => 12 + [hour] => 10 + [minute] => 0 + [second] => 0 + [fraction] => 0.5 + [warning_count] => 0 + [warnings] => Array + ( + ) + + [error_count] => 0 + [errors] => Array + ( + ) + + [is_localtime] => + [relative] => Array + ( + [year] => 0 + [month] => 0 + [day] => 7 + [hour] => 1 + [minute] => 0 + [second] => 0 + ) + +)]]> + </screen> + </example> + </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> + <member><function>checkdate</function></member> <member><function>getdate</function></member> </simplelist> </para> diff --git a/reference/datetime/functions/date-sun-info.xml b/reference/datetime/functions/date-sun-info.xml index 321a576c..bff22337 100644 --- a/reference/datetime/functions/date-sun-info.xml +++ b/reference/datetime/functions/date-sun-info.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-sun-info" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_sun_info</refname> @@ -11,7 +11,7 @@ &reftitle.description; <methodsynopsis> <type>array</type><methodname>date_sun_info</methodname> - <methodparam><type>int</type><parameter>zaman</parameter></methodparam> + <methodparam><type>int</type><parameter>zaman_damgası</parameter></methodparam> <methodparam><type>float</type><parameter>enlem</parameter></methodparam> <methodparam><type>float</type><parameter>boylam</parameter></methodparam> </methodsynopsis> @@ -22,7 +22,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>zaman</parameter></term> + <term><parameter>zaman_damgası</parameter></term> <listitem> <para> Zaman damgası. @@ -53,7 +53,96 @@ &reftitle.returnvalues; <para> Başarılı olduğunda diziyi, başarısız olduğunda &false; değerini döndürür. + Dönen dizinin yapısı: </para> + <para> + <variablelist> + <varlistentry> + <term><literal>sunrise</literal></term> + <listitem> + <simpara> + Güneşin doğuşunun zaman damgası (başucu açısı = 90° 35'). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>sunset</literal></term> + <listitem> + <simpara> + Güneşin batışının zaman damgası (başucu açısı = 90° 35'). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>transit</literal></term> + <listitem> + <simpara> + Güneşin başucunda olduğu, yani en üst noktasına ulaştığı zamanın + damgası. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>civil_twilight_begin</literal></term> + <listitem> + <simpara> + Sivil şafağın başlangıcı (başucu açısı = 96°). Gün doğumunda + (<literal>sunrise</literal>) biter. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>civil_twilight_end</literal></term> + <listitem> + <simpara> + Sivil alacakaranlığın sonu (başucu açısı = 96°). Gün batımında + (<literal>sunset</literal>) başlar. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>nautical_twilight_begin</literal></term> + <listitem> + <simpara> + Denizde şafağın başlangıcı (başucu açısı = 102°). Şafağın başlangıcında + (<literal>civil_twilight_begin</literal>) biter. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>nautical_twilight_end</literal></term> + <listitem> + <simpara> + Deniz alacakaranlığının sonu (başucu açısı = 102°). + <literal>civil_twilight_end</literal>'de başlar. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>astronomical_twilight_begin</literal></term> + <listitem> + <simpara> + Astronomik şafağın başlangıcı (başucu açısı = 108°). + <literal>nautical_twilight_begin</literal>'de biter. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><literal>astronomical_twilight_end</literal></term> + <listitem> + <simpara> + Astronomik alacakaranlığın sonu (başucu açısı = 108°). + <literal>nautical_twilight_end</literal>'de başlar. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Dizi elemanlarının değerleri, ya UNIX zaman damgasıdır, ya da güneş + günün tamamında ilgili başucunun altındaysa &false;, güneş günün tamamında + ilgili başucunun üstündeyse &true;'dur. +</para> </refsect1> <refsect1 role="examples"> @@ -87,6 +176,76 @@ astronomical_twilight_end: 18:09:14 </screen> </example> </para> + <example> + <title>- Kutup gecesi</title> + <programlisting role="php"> +<![CDATA[ +<?php +var_dump(date_sun_info(strtotime("2017-12-21"), 90, 0)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +array(9) { + ["sunrise"]=> + bool(false) + ["sunset"]=> + bool(false) + ["transit"]=> + int(1513857490) + ["civil_twilight_begin"]=> + bool(false) + ["civil_twilight_end"]=> + bool(false) + ["nautical_twilight_begin"]=> + bool(false) + ["nautical_twilight_end"]=> + bool(false) + ["astronomical_twilight_begin"]=> + bool(false) + ["astronomical_twilight_end"]=> + bool(false) +} +]]> + </screen> + </example> + <example> + <title>- Gece yarısı güneşi</title> + <programlisting role="php"> +<![CDATA[ +<?php +var_dump(date_sun_info(strtotime("2017-06-21"), 90, 0)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +array(9) { + ["sunrise"]=> + bool(true) + ["sunset"]=> + bool(true) + ["transit"]=> + int(1498046510) + ["civil_twilight_begin"]=> + bool(true) + ["civil_twilight_end"]=> + bool(true) + ["nautical_twilight_begin"]=> + bool(true) + ["nautical_twilight_end"]=> + bool(true) + ["astronomical_twilight_begin"]=> + bool(true) + ["astronomical_twilight_end"]=> + bool(true) +} +]]> + </screen> + </example> </refsect1> <refsect1 role="seealso"> diff --git a/reference/datetime/functions/date-sunrise.xml b/reference/datetime/functions/date-sunrise.xml index 80f7d60b..88f134e3 100644 --- a/reference/datetime/functions/date-sunrise.xml +++ b/reference/datetime/functions/date-sunrise.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: behzat Status: ready --> +<!-- EN-Revision: a41128675051f3b8ea0fc722a243455611087e55 Maintainer: behzat Status: ready --> <refentry xml:id="function.date-sunrise" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>date_sunrise</refname> @@ -11,13 +11,12 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>mixed</type><methodname>date_sunrise</methodname> - <methodparam><type>int</type><parameter>zamandamgası</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>biçim</parameter><initializer>SUNFUNCS_RET_STRING</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>enlem</parameter><initializer>ini_get("date.default_latitude")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>boylam</parameter><initializer>ini_get("date.default_longitude")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>başucu</parameter><initializer>ini_get("date.sunrise_zenith")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>gmt_farkı</parameter><initializer>0</initializer></methodparam> + <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunrise</methodname> + <methodparam choice="opt"><type>int</type><parameter>dönüş_biçimi</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>enlem</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>boylam</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>başucu</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>utc_farkı</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <function>date_sunrise</function> işlevi, verilen gün @@ -39,11 +38,11 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>biçim</parameter></term> + <term><parameter>dönüş_biçimi</parameter></term> <listitem> <para> <table> - <title><parameter>biçim</parameter> sabitleri</title> + <title><parameter>dönüş_biçimi</parameter> sabitleri</title> <tgroup cols="2"> <thead> <row> @@ -78,8 +77,8 @@ <term><parameter>enlem</parameter></term> <listitem> <para> - Kuzey yarımküre öntanımlıdır. Güney yarımküre için negatif değer girin. - Ayrıca bakınız: <literal>date.default_latitude</literal> + Kuzey yarımküre öntanımlıdır. Güney yarımküre için negatif değer girilir. + Ayrıca bakınız: <link linkend="ini.date.default-latitude">date.default_latitude</link> </para> </listitem> </varlistentry> @@ -87,8 +86,9 @@ <term><parameter>boylam</parameter></term> <listitem> <para> - Doğu yarımküre öntanımlıdır. Batı yarımküre için negatif değer girin. - Ayrıca bakınız: <literal>date.default_longitude</literal> + Doğu yarımküre öntanımlıdır. Batı yarımküre için negatif değer + girilir. Ayrıca bakınız: + <link linkend="ini.date.default-longitude">date.default_longitude</link> </para> </listitem> </varlistentry> @@ -96,15 +96,52 @@ <term><parameter>başucu</parameter></term> <listitem> <para> - Öntanımlı: <literal>date.sunrise_zenith</literal> + <parameter>başucu</parameter>, güneşin merkezi ile dünya yüzeyine dik + bir çizgi arasındaki açıdır. Öntanımlı değer: + <link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link> + <table> + <title>Bazı <parameter>başucu</parameter> açıları</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Açı</entry> + <entry>Açıklama</entry> + </row> + </thead> + <tbody> + <row> + <entry>90°50'</entry> + <entry>Gündoğumu: Güneşin görünür hale geldiği nokta.</entry> + </row> + <row> + <entry>96°</entry> + <entry>Sivil alacakaranlık: Geleneksel olarak şafağın başlangıcını + belirtmek için kullanılır.</entry> + </row> + <row> + <entry>102°</entry> + <entry>Deniz alacakaranlığı: Ufkun denizde görünmeye başladığı + nokta.</entry> + </row> + <row> + <entry>108°</entry> + <entry>Astronomik alacakaranlık: Güneşin herhangi bir + aydınlatmanın kaynağı olmaya başladığı nokta.</entry> + </row> + </tbody> + </tgroup> + </table> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>gmt_farkı</parameter></term> + <term><parameter>utc_farkı</parameter></term> <listitem> <para> Saat cinsinden belirtilir. + <parameter>dönüş_biçimi</parameter> değeri + <constant>SUNFUNCS_RET_TIMESTAMP</constant> ise + <parameter>utc_farkı</parameter> yoksayılır. </para> </listitem> </varlistentry> @@ -115,17 +152,16 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda, <parameter>biçim</parameter> değiştirgesiyle - belirlenen biçimde şafak zamanını, başarız olduğunda &false; değerini - döndürür. + Başarılı olduğunda, <parameter>dönüş_biçimi</parameter> değiştirgesiyle + belirlenen biçimde şafak zamanı,&return.falseforfailure;. Başarısızlığın + olası nedeni, yılın bir bölümünde kutup dairesinin içinde güneşin hiç + doğmamasıdır. </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; - - &date.timezone.errors.description; - + &date.timezone.errors.description; </refsect1> <refsect1 role="changelog"> @@ -140,9 +176,14 @@ </row> </thead> <tbody> - - &date.timezone.errors.changelog; - + <row> + <entry>8.0.0</entry> + <entry> + <parameter>enlem</parameter>, <parameter>botlam</parameter>, + <parameter>başucu</parameter> ve <parameter>utc_farkı</parameter> + artık &null; olabiliyor. + </entry> + </row> </tbody> </tgroup> </informaltable> @@ -177,6 +218,23 @@ Fri Dec 12 2008, şafak: 07:25 ]]> </screen> </example> + <example> + <title>- Güneşin doğmaması</title> + <programlisting role="php"> +<![CDATA[ +<?php +$solstice = strtotime('2017-12-21'); +var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +bool(false) +]]> + </screen> + </example> </para> </refsect1> @@ -185,6 +243,7 @@ Fri Dec 12 2008, şafak: 07:25 <para> <simplelist> <member><function>date_sunset</function></member> + <member><function>date_sun_info</function></member> </simplelist> </para> </refsect1> diff --git a/reference/datetime/functions/date-sunset.xml b/reference/datetime/functions/date-sunset.xml index d0c1fb00..929710d4 100644 --- a/reference/datetime/functions/date-sunset.xml +++ b/reference/datetime/functions/date-sunset.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: behzat Status: ready --> -<refentry xml:id="function.date-sunset" xmlns="http://docbook.org/ns/docbook"> +<!-- EN-Revision: a41128675051f3b8ea0fc722a243455611087e55 Maintainer: behzat Status: ready --> +<refentry xml:id="function.date-sunset" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>date_sunset</refname> <refpurpose> @@ -12,13 +12,12 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>mixed</type><methodname>date_sunset</methodname> - <methodparam><type>int</type><parameter>zamandamgası</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>biçim</parameter><initializer>SUNFUNCS_RET_STRING</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>enlem</parameter><initializer>ini_get("date.default_latitude")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>boylam</parameter><initializer>ini_get("date.default_longitude")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>başucu</parameter><initializer>ini_get("date.sunset_zenith")</initializer></methodparam> - <methodparam choice="opt"><type>float</type><parameter>gmt_farkı</parameter><initializer>0</initializer></methodparam> + <type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunset</methodname> + <methodparam choice="opt"><type>int</type><parameter>dönüş_biçimi</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>enlem</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>boylam</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>başucu</parameter><initializer>&null;</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>utc_farkı</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <function>date_sunset</function> işlevi, verilen gün @@ -40,11 +39,11 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>biçim</parameter></term> + <term><parameter>dönüş_biçimi</parameter></term> <listitem> <para> <table> - <title><parameter>biçim</parameter> sabitleri</title> + <title><parameter>dönüş_biçimi</parameter> sabitleri</title> <tgroup cols="2"> <thead> <row> @@ -79,8 +78,9 @@ <term><parameter>enlem</parameter></term> <listitem> <para> - Kuzey yarımküre öntanımlıdır. Güney yarımküre için negatif değer girin. - Ayrıca bakınız: <literal>date.default_latitude</literal> + Kuzey yarımküre öntanımlıdır. Güney yarımküre için negatif değer + girilir. Ayrıca bakınız: + <link linkend="ini.date.default-latitude">date.default_latitude</link> </para> </listitem> </varlistentry> @@ -88,8 +88,8 @@ <term><parameter>boylam</parameter></term> <listitem> <para> - Doğu yarımküre öntanımlıdır. Batı yarımküre için negatif değer girin. - Ayrıca bakınız: <literal>date.default_longitude</literal> + Doğu yarımküre öntanımlıdır. Batı yarımküre için negatif değer girilir. Ayrıca bakınız: + <link linkend="ini.date.default-longitude">date.default_longitude</link> </para> </listitem> </varlistentry> @@ -97,15 +97,52 @@ <term><parameter>başucu</parameter></term> <listitem> <para> - Öntanımlı: <literal>date.sunset_zenith</literal> + <parameter>başucu</parameter>, güneşin merkezi ile dünya yüzeyine dik + bir çizgi arasındaki açıdır. Öntanımlı değer: + <link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link> + <table> + <title>Bazı <parameter>başucu</parameter> açıları</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Açı</entry> + <entry>Açıklama</entry> + </row> + </thead> + <tbody> + <row> + <entry>90°50'</entry> + <entry>Gündoğumu: Güneşin görünür hale geldiği nokta.</entry> + </row> + <row> + <entry>96°</entry> + <entry>Sivil alacakaranlık: Geleneksel olarak şafağın başlangıcını + belirtmek için kullanılır.</entry> + </row> + <row> + <entry>102°</entry> + <entry>Deniz alacakaranlığı: Ufkun denizde görünmeye başladığı + nokta.</entry> + </row> + <row> + <entry>108°</entry> + <entry>Astronomik alacakaranlık: Güneşin herhangi bir + aydınlatmanın kaynağı olmaya başladığı nokta.</entry> + </row> + </tbody> + </tgroup> + </table> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>gmt_farkı</parameter></term> + <term><parameter>utc_farkı</parameter></term> <listitem> <para> Saat cinsinden belirtilir. + <parameter>dönüş_biçimi</parameter> değeri + <constant>SUNFUNCS_RET_TIMESTAMP</constant> ise + <parameter>utc_farkı</parameter> yoksayılır. </para> </listitem> </varlistentry> @@ -115,9 +152,7 @@ <refsect1 role="errors"> &reftitle.errors; - &date.timezone.errors.description; - </refsect1> <refsect1 role="changelog"> @@ -132,9 +167,14 @@ </row> </thead> <tbody> - - &date.timezone.errors.changelog; - + <row> + <entry>8.0.0</entry> + <entry> + <parameter>enlem</parameter>, <parameter>botlam</parameter>, + <parameter>başucu</parameter> ve <parameter>utc_farkı</parameter> + artık &null; olabiliyor. + </entry> + </row> </tbody> </tgroup> </informaltable> @@ -144,9 +184,10 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Başarılı olduğunda, <parameter>biçim</parameter> değiştirgesiyle - belirlenen biçemde gün batımı zamanını, başarız olduğunda &false; değerini - döndürür. + Başarılı olduğunda, <parameter>dönüş_biçimi</parameter> değiştirgesiyle + belirlenen biçimde şafak zamanı,&return.falseforfailure;. Başarısızlığın + olası nedeni, yılın bir bölümünde kutup dairesinin içinde güneşin hiç + doğmamasıdır. </para> </refsect1> @@ -178,6 +219,23 @@ Thu Dec 11 2008, günbatımı: 16:33 ]]> </screen> </example> + <example> + <title>- Güneşin doğmaması</title> + <programlisting role="php"> +<![CDATA[ +<?php +$solstice = strtotime('2017-12-21'); +var_dump(date_sunset($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +bool(false) +]]> + </screen> + </example> </para> </refsect1> @@ -186,6 +244,7 @@ Thu Dec 11 2008, günbatımı: 16:33 <para> <simplelist> <member><function>date_sunrise</function></member> + <member><function>date_sun_info</function></member> </simplelist> </para> </refsect1> diff --git a/reference/datetime/functions/date.xml b/reference/datetime/functions/date.xml index a0337513..7744634a 100644 --- a/reference/datetime/functions/date.xml +++ b/reference/datetime/functions/date.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.date" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>date</refname> @@ -12,7 +12,7 @@ <methodsynopsis> <type>string</type><methodname>date</methodname> <methodparam><type>string</type><parameter>biçim</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <parameter>zaman_damgası</parameter> değiştirgesi ile belirtilen zamanı ya @@ -25,309 +25,18 @@ <refsect1 role="parameters"> &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>biçim</parameter></term> - <listitem> - <para> - Çıktılanan zamanın <type>string</type> türünden biçimi. Biçimlendirme - seçenekleri için aşağıya bakınız. Ayrıca burada kullanılabilecek - önceden tanımlanmış çeşitli <link linkend="datetime.constants.types"> - tarih sabitleri</link> vardır. Örneğin, <constant>DATE_RSS</constant> - sabiti <literal>'D, d M Y H:i:s'</literal> biçemini içerir. - </para> - <para> - <table> - <title>Aşağıdaki karakterler <parameter>biçim</parameter> değiştirge - dizgesi içinde tanınır.</title> - <tgroup cols="3"> - <thead> - <row> - <entry><parameter>biçim</parameter> karakteri</entry> - <entry>Açıklama</entry> - <entry>Örnek sonuç</entry> - </row> - </thead> - <tbody> - <row> - <entry align="center"><emphasis>Gün</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>d</literal></entry> - <entry>Ay günlerinin sıfır dolgulu iki haneli gösterimi</entry> - <entry><literal>01</literal>'den <literal>31</literal>'e</entry> - </row> - <row> - <entry><literal>D</literal></entry> - <entry>Ay günlerinin üç harfli metinsel gösterimi</entry> - <entry><literal>Pzt</literal>'den <literal>Paz</literal>'a</entry> - </row> - <row> - <entry><literal>j</literal></entry> - <entry>Ay günlerinin sıfır dolgusuz gösterimi</entry> - <entry><literal>1</literal>'den <literal>31</literal>'e</entry> - </row> - <row> - <entry><literal>l</literal> (küçük 'L' harfi)</entry> - <entry>Hafta günlerinin tam metinsel gösterimi</entry> - <entry><literal>Pazar</literal>'dan - <literal>Cumartesi</literal>'ye</entry> - </row> - <row> - <entry><literal>N</literal></entry> - <entry>Hafta günlerinin ISO-8601 standardında sayısal gösterimi - (PHP 5.1.0'da eklenmiştir)</entry> - <entry><literal>1</literal>'den (Pazartesi için) - <literal>7</literal>'ye (Pazar için)</entry> - </row> - <row> - <entry><literal>S</literal></entry> - <entry>Ay günleri için 2 karakterli İngilizce sıralama ekleri - </entry> - <entry> - <literal>st</literal>, <literal>nd</literal>, - <literal>rd</literal> ya da <literal>th</literal>. - <literal>j</literal> ile uyumlu çalışmaktadır. - </entry> - </row> - <row> - <entry><literal>w</literal></entry> - <entry>Hafta günlerinin sayısal gösterimi</entry> - <entry><literal>0</literal>'dan (Pazar için) - <literal>6</literal>'ya (Cumartesi için)</entry> - </row> - <row> - <entry><literal>z</literal></entry> - <entry>Yılın günleri (0'dan başlar)</entry> - <entry><literal>0</literal>'dan <literal>365</literal>'e</entry> - </row> - <row> - <entry align="center"><emphasis>Hafta</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>W</literal></entry> - <entry>ISO-8601 standartına göre yılın hafta numarası, hafta - başlangıcı Pazartesi'dir (PHP 4.1.0 sürümüyle eklenmiştir)</entry> - <entry>Örneğin: <literal>42</literal> (Yılın 42'inci - haftası)</entry> - </row> - <row> - <entry align="center"><emphasis>Ay</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>F</literal></entry> - <entry>Ayın tam metinsel gösterimi, Ocak ya da Mart gibi</entry> - <entry><literal>January</literal>'den <literal>December</literal>'a - </entry> - </row> - <row> - <entry><literal>m</literal></entry> - <entry>Ayın sıfır dolgulu sayısal gösterimi</entry> - <entry><literal>01</literal>'den <literal>12</literal>'ye</entry> - </row> - <row> - <entry><literal>M</literal></entry> - <entry>Ayın üç karakterli, metinsel kısa gösterimi</entry> - <entry><literal>Jan</literal>'dan <literal>Dec</literal>'e kadar - </entry> - </row> - <row> - <entry><literal>n</literal></entry> - <entry>Ayın sıfır dolgusuz sayısal gösterimi</entry> - <entry><literal>1</literal>'den <literal>12</literal>'ye kadar - </entry> - </row> - <row> - <entry><literal>t</literal></entry> - <entry>Belirtilen ayın gün sayısı</entry> - <entry><literal>28</literal>'den <literal>31</literal>'e</entry> - </row> - <row> - <entry align="center"><emphasis>Yıl</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>L</literal></entry> - <entry>Artık yıl olduğunda</entry> - <entry>Eğer artık yılsa <literal>1</literal>, değilse - <literal>0</literal>.</entry> - </row> - <row> - <entry><literal>o</literal></entry> - <entry>ISO-8601 standardı yıl numarası. ISO hafta numaralarının - (<literal>W</literal>) ait olduğu yılın gösterilmesi dışında - <literal>Y</literal> ile aynı değere sahiptir. (PHP 5.1.0 sürümünde - eklenmiştir)</entry> - <entry>Örnekler: <literal>1999</literal> ya da - <literal>2003</literal> gibi</entry> - </row> - <row> - <entry><literal>Y</literal></entry> - <entry>Yılın 4 haneli sayısal, tam gösterimi</entry> - <entry>Örnekler: <literal>1999</literal> ya da - <literal>2003</literal> gibi</entry> - </row> - <row> - <entry><literal>y</literal></entry> - <entry>Yılın iki haneli gösterimi</entry> - <entry>Örnekler: <literal>99</literal> ya da <literal>03</literal> - gibi</entry> - </row> - <row> - <entry align="center"><emphasis>Saat</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>a</literal></entry> - <entry>Küçük harfli öğleden önce ve öğleden sonra</entry> - <entry><literal>am</literal> ya da <literal>pm</literal></entry> - </row> - <row> - <entry><literal>A</literal></entry> - <entry>Büyük harfli öğleden önce ve öğleden sonra</entry> - <entry><literal>AM</literal> ya da <literal>PM</literal></entry> - </row> - <row> - <entry><literal>B</literal></entry> - <entry>Swatch İnternet saati</entry> - <entry><literal>000</literal>'dan <literal>999</literal>'a</entry> - </row> - <row> - <entry><literal>g</literal></entry> - <entry>Saatin, 12-saatlik sıfır dolgusuz gösterimi</entry> - <entry><literal>1</literal>'den <literal>12</literal>'ye</entry> - </row> - <row> - <entry><literal>G</literal></entry> - <entry>Saatin, 24-saatlik sıfır dolgusuz gösterimi</entry> - <entry><literal>0</literal>'dan <literal>23</literal>'e</entry> - </row> - <row> - <entry><literal>h</literal></entry> - <entry>Saatin, 12-saatlik sıfır dolgulu gösterimi</entry> - <entry><literal>01</literal>'den <literal>12</literal>'ye</entry> - </row> - <row> - <entry><literal>H</literal></entry> - <entry>Saatin, 24-saatlik sıfır dolgulu gösterimi</entry> - <entry><literal>00</literal>'dan <literal>23</literal>'e</entry> - </row> - <row> - <entry><literal>i</literal></entry> - <entry>Sıfır dolgulu dakika gösterimi</entry> - <entry><literal>00</literal> ile <literal>59</literal> arasında - </entry> - </row> - <row> - <entry><literal>s</literal></entry> - <entry>Sıfır dolgulu saniye gösterimi</entry> - <entry><literal>00</literal> ile <literal>59</literal> arasında - </entry> - </row> - <row> - <entry><literal>u</literal></entry> - <entry>Mikrosaniye (PHP 5.2.2 sürümüyle eklenmiştir)</entry> - <entry>Örneğin: <literal>654321</literal></entry> - </row> - <row> - <entry align="center"><emphasis>Zaman dilimi</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>e</literal></entry> - <entry>Zaman dilimi belirteci (PHP 5.1.0 sürümüyle eklenmiştir) - </entry> - <entry>Örnekler: <literal>UTC</literal>, <literal>GMT</literal>, - <literal>Europe/Istanbul</literal></entry> - </row> - <row> - <entry><literal>I</literal> (büyük ı)</entry> - <entry>Yaz saati uygulaması var mı?</entry> - <entry>Varsa <literal>1</literal>, yoksa <literal>0</literal>. - </entry> - </row> - <row> - <entry><literal>O</literal></entry> - <entry>Saat olarak Greenwich zamanı (GMT) farkı</entry> - <entry>Örneğin: <literal>+0200</literal></entry> - </row> - <row> - <entry><literal>P</literal></entry> - <entry>Saat ve dakika olarak Greenwich zamanı (GMT) farkı (PHP - 5.1.3 sürümüyle eklenmiştir)</entry> - <entry>Örneğin: <literal>+02:00</literal></entry> - </row> - <row> - <entry><literal>T</literal></entry> - <entry>Zaman dilimi kısaltması</entry> - <entry>Örnekler: <literal>EST</literal>, <literal>EET</literal> - gibi</entry> - </row> - <row> - <entry><literal>Z</literal></entry> - <entry>Saniye cinsinden saat farkı. UTC'nin batısı daima negatif, - doğusu ise daima pozitif değerlidir.</entry> - <entry><literal>-43200</literal>'den <literal>50400</literal>'e - </entry> - </row> - <row> - <entry align="center"><emphasis>Tam Tarih/Saat</emphasis></entry> - <entry>---</entry> - <entry>---</entry> - </row> - <row> - <entry><literal>c</literal></entry> - <entry>ISO 8601 standardı tarih (PHP 5'te' eklenmiştir)</entry> - <entry>2004-02-12T15:19:21+00:00</entry> - </row> - <row> - <entry><literal>r</literal></entry> - <entry><link xlink:href="&url.rfc;2822">RFC 2822</link> biçiminde - tarih</entry> - <entry>Örneğin: <literal>Thu, 21 Dec 2000 16:01:07 +0200</literal> - </entry> - </row> - <row> - <entry><literal>U</literal></entry> - <entry>Unix Zaman Başlangıcından (1 Ocak 1970 00:00:00 GMT) - itibaren geçen saniye sayısı</entry> - <entry><function>time</function> işlevine bakınız</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - Biçim dizgesinde tanınmayan karakterler olduğu gibi yazdırılacaktır. - <literal>Z</literal> biçimi <function>gmdate</function> işleviyle - kullanıldığında daima <literal>0</literal> değerini döndürür. - </para> - <note> - <para> - Bu işlev sadece <type>integer</type> türünde zaman damgalarını kabul - etmektedir. <literal>u</literal> biçim karakteri sadece - <function>date_format</function> işlevinde, - <function>date_create</function> işleviyle kullanıcı tabanlı bir zaman - damgası oluşturulduğunda kullanılabilir. - </para> - </note> - </listitem> - </varlistentry> - - &date.timestamp.description; - - </variablelist> - </para> + <variablelist> + <varlistentry> + <term><parameter>biçim</parameter></term> + <listitem> + <para> + <function>DateTimeInterface::format</function> tarafından kabul + edilen biçim. + </para> + </listitem> + </varlistentry> + &date.timestamp.description; + </variablelist> </refsect1> <refsect1 role="returnvalues"> @@ -342,9 +51,7 @@ <refsect1 role="errors"> &reftitle.errors; - &date.timezone.errors.description; - </refsect1> <refsect1 role="changelog"> @@ -360,25 +67,9 @@ </thead> <tbody> <row> - <entry>5.1.0</entry> - <entry> - Zaman damgasının geçerlilik aralığı, genellikle Cum, 13 Ara 1901 - 20:45:54 GMT ile Per, 19 Oca 2038 03:14:07 GMT arasındadır. (Bu tarih - değerleri aynı zamanda en küçük ve en büyük 32-bit işaretli - tamsayıları temsil etmektedir.) Bununla birikte, PHP 5.1.0'den önce bu - aralık bazı sistemlerde 01-01-1970 ile 19-01-2038 arasıyla sınırlıydı. - (ör: Windows). - </entry> - </row> - - &date.timezone.errors.changelog; - - <row> - <entry>5.1.1</entry> + <entry>8.0.0</entry> <entry> - Standart tarih/zaman biçimleri için, <parameter>biçim</parameter> - değiştirgesinde kullanılabilecek yararlı <link - linkend="datetime.constants">sabitler</link> devreye girdi. + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. </entry> </row> </tbody> @@ -409,8 +100,8 @@ echo date('l jS \of F Y h:i:s A'); echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000)); /* biçim değiştirgesi için sabit kullanımı*/ -// Şöyle bir şey basar: Mon, 15 Aug 2005 15:12:46 UTC -echo date(DATE_RFC822); +// Şöyle bir şey basar: Wed, 25 Sep 2013 15:28:57 -0700 +echo date(DATE_RFC2822); // Şöyle bir şey basar: 2000-07-01T00:00:00+00:00 echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000)); @@ -430,7 +121,7 @@ echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000)); <![CDATA[ <?php // Şöyle bir şey basar: Wednesday the 15th -echo date("l \\t\h\e jS"); +echo date('l \t\h\e jS'); ?> ]]> </programlisting> @@ -484,6 +175,7 @@ $bugün = date('\i\t \i\s \t\h\e jS \d\a\y.'); // it is the 10th day. $bugün = date("D M j G:i:s T Y"); // Sat Mar 10 17:16:18 MST 2001 $bugün = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:18 m is month $bugün = date("H:i:s"); // 17:16:18 +$bugün = date("Y-m-d H:i:s"); // 2001-03-10 17:16:18 (MySQL DATETIME biçimi) ?> ]]> </programlisting> @@ -526,6 +218,7 @@ $bugün = date("H:i:s"); // 17:16:18 <member><function>mktime</function></member> <member><function>strftime</function></member> <member><function>time</function></member> + <member><function>DateTimeImmutable::__construct</function></member> <member><link linkend="datetime.constants.types">Öntanımlı Tarih/Saat Sabitleri</link></member> diff --git a/reference/datetime/functions/getdate.xml b/reference/datetime/functions/getdate.xml index 9e3b84e2..44b9de89 100644 --- a/reference/datetime/functions/getdate.xml +++ b/reference/datetime/functions/getdate.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.getdate" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -12,7 +12,7 @@ &reftitle.description; <methodsynopsis> <type>array</type><methodname>getdate</methodname> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter><initializer>time()</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> Değiştirgeyle çağrılmışsa <parameter>zaman_damgası</parameter>'na karşılık @@ -25,9 +25,7 @@ &reftitle.parameters; <para> <variablelist> - &date.timestamp.description; - </variablelist> </para> </refsect1> @@ -128,6 +126,30 @@ </para> </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -170,6 +192,7 @@ Array <simplelist> <member><function>date</function></member> <member><function>idate</function></member> + <member><function>localtime</function></member> <member><function>time</function></member> <member><function>setlocale</function></member> </simplelist> diff --git a/reference/datetime/functions/idate.xml b/reference/datetime/functions/idate.xml index 627ad02e..2e681f69 100644 --- a/reference/datetime/functions/idate.xml +++ b/reference/datetime/functions/idate.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 2fd3f0c96d9d221fe37109775af4df4cf949d5d8 Maintainer: behzat Status: ready --> +<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: behzat Status: ready --> <refentry xml:id="function.idate" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>idate</refname> @@ -10,9 +10,9 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>int</type><methodname>idate</methodname> + <type class="union"><type>int</type><type>false</type></type><methodname>idate</methodname> <methodparam><type>string</type><parameter>biçem</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>zaman_damgası</parameter><initializer>time()</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>zaman_damgası</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <parameter>zaman_damgası</parameter> ile belirtilen zaman için @@ -134,10 +134,11 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - <type>integer</type> türünde bir değer döner. + Başarı durumunda <type>int</type> türünde bir + değer,&return.falseforfailure;. </para> <para> - <function>idate</function> işlevi daima <type>integer</type> türünde değer + <function>idate</function> işlevi daima <type>int</type> türünde değer döndürse de bu değerler "0" ile başlayamaz. <function>idate</function> işlevi beklediğinizden daha az karakter döndürebilir. Aşağıdaki örneğe bakınız. @@ -163,9 +164,12 @@ </row> </thead> <tbody> - - &date.timezone.errors.changelog; - + <row> + <entry>8.0.0</entry> + <entry> + <parameter>zaman_damgası</parameter> artık &null; olabiliyor. + </entry> + </row> </tbody> </tgroup> </informaltable>