format.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: nilgun Status: ready -->
<refentry xml:id="intldateformatter.format" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>IntlDateFormatter::format</refname>
  <refname>datefmt_format</refname>
  <refpurpose>Tarih/saat değerini bir dizge olarak biçemler</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <para>
   &style.oop;
  </para>
 <methodsynopsis role="IntlDateFormatter">
   <modifier>public</modifier>
   <type class="union"><type>string</type><type>false</type></type><methodname>IntlDateFormatter::format</methodname>
   <methodparam><type class="union"><type>IntlCalendar</type><type>DateTimeInterface</type><type>array</type><type>string</type><type>int</type><type>float</type></type><parameter>değer</parameter></methodparam>
  </methodsynopsis>
  <para>
   &style.procedural;
  </para>
  <methodsynopsis>
   <type class="union"><type>string</type><type>false</type></type><methodname>datefmt_format</methodname>
   <methodparam><type>IntlDateFormatter</type><parameter>biçemleyici</parameter></methodparam>
   <methodparam><type class="union"><type>IntlCalendar</type><type>DateTimeInterface</type><type>array</type><type>string</type><type>int</type><type>float</type></type><parameter>değer</parameter></methodparam>
  </methodsynopsis>
  <para>
   Zaman değerini bir dizge olarak biçemler.
  </para>
  </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>biçemleyici</parameter></term>
     <listitem>
      <para>
       Biçemleyici nesne.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>değer</parameter></term>
     <listitem>
      <para>
       Biçemlenecek değer. Bu bir <classname>DateTimeInterface</classname>
       nesnesi, bir <classname>IntlCalendar</classname> nesnesi, Unix zaman
       başlangıcından itibaren saniye sayısını (muhtemelen kesirli) temsil
       eden sayısal bir tür veya <function>localtime</function> tarafından
       çıktılanan biçimde bir dizi olabilir.
      </para>
      <para>
       Değer olarak <classname>DateTime</classname> veya
       <classname>IntlCalendar</classname> nesnesi iletilirse, zaman dilimi
       dikkate alınmaz. Nesne, biçimlendiricinin yapılandırılmış zaman dilimi
       kullanılarak biçimlendirilir. Biçimlendirilecek nesnenin zaman dilimi
       kullanılmak istenirse,
       <function>IntlDateFormatter::setTimeZone</function> nesnenin zaman
       dilimiyle çağrılmalıdır. Veya, bunun yerine
       <function>IntlDateFormatter::formatObject</function> statik işlevi de
       kullanılabilir.
     </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>


 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Bir hata oluşmuşsa &false; aksi takdirde biçemli dizge.
  </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>7.1.5</entry>
       <entry>
        <parameter>değer</parameter> bağımsız değişkenine genel
        <classname>DateTimeInterface</classname> nesnelerinin aktarımı artık
        destekleniyor. Evvelce, sadece uygun <classname>DateTime</classname>
        nesneleri desteklenirdi.
       </entry>
      </row>
      <row>
       <entry>PECL 3.0.0</entry>
       <entry>
        <parameter>değer</parameter> bağımsız değişkenine artık
        <classname>IntlCalendar</classname> nesneleri belirtilebiliyor.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
   <example>
    <title>- <function>datefmt_format</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
$fmt = datefmt_create(
    "tr_TR",
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'Europe/Istanbul',
    IntlDateFormatter::GREGORIAN
);
echo "İlk biçemli çıktı: ".datefmt_format($fmt, 1234567890);

$fmt = datefmt_create(
    "en-US",
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'Europe/Istanbul',
    IntlDateFormatter::GREGORIAN
 );
echo "\nİkinci biçemli çıktı: ".datefmt_format($fmt, 1234567890);

$fmt = datefmt_create(
    "tr_TR",
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'Europe/Istanbul',
    IntlDateFormatter::GREGORIAN,
    "dd/MM/yyyy"
);
echo "\nİlk kalıbın çıktısı: ".datefmt_format( $fmt, 1234567890);

$fmt = datefmt_create(
    "en-US",
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'Europe/Istanbul',
    IntlDateFormatter::GREGORIAN,
    "MM/dd/yyyy"
);
echo "\nİkinci kalıbın çıktısı: ".datefmt_format($fmt, 1234567890);
?>
]]>
    </programlisting>
   </example>
   <example>
    <title>- &style.oop; örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
$fmt = new IntlDateFormatter(
    "tr_TR",
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'Europe/Istanbul',
    IntlDateFormatter::GREGORIAN
);
echo "İlk biçemli çıktı: ".$fmt->format(1234567890);

$fmt = new IntlDateFormatter(
    "en-US",
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'Europe/Istanbul',
    IntlDateFormatter::GREGORIAN
);
echo "\nİkinci biçemli çıktı: ".$fmt->format(1234567890);

$fmt = new IntlDateFormatter(
    "tr_TR",
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'Europe/Istanbul',
    IntlDateFormatter::GREGORIAN,
    "dd/MM/yyyy"
);
echo "\nİlk kalıbın çıktısı: ".$fmt->format(1234567890);

$fmt = new IntlDateFormatter(
    "en-US",
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'Europe/Istanbul',
    IntlDateFormatter::GREGORIAN,
    "MM/dd/yyyy"
);
echo "\nİkinci kalıbın çıktısı: ".$fmt->format(1234567890);
?>
]]>
    </programlisting>
   </example>
   &example.outputs;
   <screen>
<![CDATA[
İlk biçemli çıktı: 14 Şubat 2009 Cumartesi 01:31:30 Doğu Avrupa Standart Saati
İkinci biçemli çıktı: Saturday, February 14, 2009 at 1:31:30 AM Eastern European Standard Time
İlk kalıbın çıktısı: 14/02/2009
İkinci kalıbın çıktısı: 02/14/2009
]]>
   </screen>
   <example>
   <title>- <classname>IntlCalendar</classname> nesnesi ile</title>
    <programlisting role="php">
<![CDATA[
<?php
$tz = reset(iterator_to_array(IntlTimeZone::createEnumeration('FR')));
$formatter = IntlDateFormatter::create(
    'tr_TR',
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    $tz,
    IntlDateFormatter::GREGORIAN
);

$cal = IntlCalendar::createInstance($tz, '@calendar=islamic-civil');
$cal->set(IntlCalendar::FIELD_MONTH, 8); //9. ay, Ramazan
$cal->set(IntlCalendar::FIELD_DAY_OF_MONTH, 1); //İlk gün
$cal->clear(IntlCalendar::FIELD_HOUR_OF_DAY);
$cal->clear(IntlCalendar::FIELD_MINUTE);
$cal->clear(IntlCalendar::FIELD_SECOND);
$cal->clear(IntlCalendar::FIELD_MILLISECOND);

echo "İslami yılda Ramazan başlangıcı:\n\t",
        $formatter->format($cal), "\n";

// Biçemleyici zaman dilimi değişirse
$formatter->setTimeZone('Asia/Tokyo');
echo "Zaman dilimi değiştiğinde:\n\t",
        $formatter->format($cal), "\n";

// Örnek hatalı... Gün doğru; saat yanlış.
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
İslami yılda Ramazan başlangıcı:
        13 Nisan 2021 Salı 15:00:00 Orta Avrupa Yaz Saati
Zaman dilimi değiştiğinde:
        13 Nisan 2021 Salı 22:00:00 Japonya Standart Saati
]]>
    </screen>
   </example>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>datefmt_create</function></member>
    <member><function>datefmt_parse</function></member>
    <member><function>datefmt_get_error_code</function></member>
    <member><function>datefmt_get_error_message</function></member>
    <member><function>datefmt_format_object</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
-->