adiju Thu Mar 14 02:37:19 2002 EDT
Added files:
/phpdoc/ro/functions datetime.xml
Log:
First romanian version of datetime.xml.
Index: phpdoc/ro/functions/datetime.xml
+++ phpdoc/ro/functions/datetime.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- $Revision: 1.1 $ -->
<reference id="ref.datetime">
<title>Func�ii de timp �i dat�</title>
<titleabbrev>Date/time</titleabbrev>
<refentry id="function.checkdate">
<refnamediv>
<refname>checkdate</refname>
<refpurpose>Valideaz� o dat�/or� gregorian�</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>bool</type><methodname>checkdate</methodname>
<methodparam><type>int</type><parameter>luna</parameter></methodparam>
<methodparam><type>int</type><parameter>ziua</parameter></methodparam>
<methodparam><type>int</type><parameter>anul</parameter></methodparam>
</methodsynopsis>
<para>
Returneaz� &true; dac� data este valid�; �n caz contrar returneaz� &false;.
Verific� validitatea datei format� din argumente. O dat� este considerat� valid� dac�:
<itemizedlist>
<listitem>
<simpara>
<parameter>anul</parameter> este �ntre 1 �i 32767, inclusiv
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>luna</parameter> este �ntre 1 �i 12 inclusiv
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>ziua</parameter> este �n perioada 1 - num�rul maxim de zile pentru
<parameter>luna</parameter> dat�. Dac� <parameter>anul</parameter> este bisect, acest
lucru este luat �n considerare.
</simpara>
</listitem>
</itemizedlist>
</para>
<para>
Vezi <function>mktime</function> �i <function>strtotime</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.date">
<refnamediv>
<refname>date</refname>
<refpurpose>Formateaz� data/timpul local</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>string</type><methodname>date</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>
timestamp
</parameter></methodparam>
</methodsynopsis>
<para>
Returneaz� un �ir formatat conform cu formatul transmis ca parametru al func�iei,
utiliz�nd �ntregul <parameter>timestamp</parameter> sau timpul local dac� nu este
utilizat parametrul <parameter>timestamp</parameter>.
<note>
<para>
Perioada valid� a <parameter>timestamp</parameter> este cuprins�, de regul�,
�ntre vineri, 13 Decembrie 1901 20:45:54 GMT �i mar�i, 19 ianuarie 2038 03:14:07 GMT.
(Acestea sunt datele care corespund minimului, respectiv maximului unui �ntreg cu semn
reprezentat pe 32 de bi�i.)
</para>
<para>
Pentru a genera un <parameter>timestamp</parameter> dintr-un �ir reprezent�nd o
dat�, pute�i utiliza func�ia <function>strtotime</function>. De asemenea, unele
sisteme de gestiune a bazelor de date au func�ii care pot converti formatul lor de
dat� �n timestamps (cum ar fi func�ia MySQL UNIX_TIMESTAMP).
</para>
</note>
</para>
<para>
Urm�toarele caractere sunt recunoscute �n �irul <parameter>format</parameter>:
<itemizedlist>
<listitem>
<simpara>
a - "am" sau "pm"
</simpara>
</listitem>
<listitem>
<simpara>
A - "AM" sau "PM"
</simpara>
</listitem>
<listitem>
<simpara>
B - timpul Swatch Internet
</simpara>
</listitem>
<listitem>
<simpara>
d - ziua din lun�, 2 cifre cu zero ini�ial; de exemplu "01"
to "31"
</simpara>
</listitem>
<listitem>
<simpara>
D - ziua din s�pt�m�n�, �n englez�, textual, 3 litere; de exemplu "Fri"
</simpara>
</listitem>
<listitem>
<simpara>
F - month, textual, long; de exemplu "January"
</simpara>
</listitem>
<listitem>
<simpara>
g - ora, format de 12 ore, f�r� zero ini�ial; de exemplu "1" p�n� la "12"
</simpara>
</listitem>
<listitem>
<simpara>
G - ora, format de 24 de ore, f�r� zero ini�ial; de exemplu "0" p�n� la "23"
</simpara>
</listitem>
<listitem>
<simpara>
h - ora, format 12 ore, cu zero ini�ial; de exemplu "01" p�n� la "12"
</simpara>
</listitem>
<listitem>
<simpara>
H - ora, format 24 de ore, cu zero ini�ial; de exemplu "00" p�n� la "23"
</simpara>
</listitem>
<listitem>
<simpara>
i - minute, cu zero ini�ial; de exemplu "00" p�n� la "59"
</simpara>
</listitem>
<listitem>
<simpara>
I (litera i majuscul�) - "1" ora de var�, "0" �n caz contrar.
</simpara>
</listitem>
<listitem>
<simpara>
j - ziua din lun�, f�r� zero ini�ial; de exemplu "1" p�n� la "31"
</simpara>
</listitem>
<listitem>
<simpara>
l (litera 'L' minuscul�) - ziua din s�pt�m�n�, textual, �n englez�, scurt; de
exemplu "Friday"
</simpara>
</listitem>
<listitem>
<simpara>
L - valoare boolean� pentru anii bisec�i; de exemplu "0" dac� nu e an bisect
sau "1" dac� este an bisect
</simpara>
</listitem>
<listitem>
<simpara>
m - luna, cu zero ini�ial; de exemplu "01" p�n� la "12"
</simpara>
</listitem>
<listitem>
<simpara>
M - luna, textual, �n englez�, 3 litere; de exemplu "Jan"
</simpara>
</listitem>
<listitem>
<simpara>
n - luna f�r� zero ini�ial; de exemplu "1" p�n� la "12"
</simpara>
</listitem>
<listitem>
<simpara>
O - diferen�a p�n� la ora Greenwich �n ore; de exemplu "+0200"
</simpara>
</listitem>
<listitem>
<simpara>
r - data formatat� conform recomand�rii RFC 822; de exemplu "Thu, 21 Dec 2000
16:01:07 +0200" (ad�ugat� �n PHP 4.0.4)
</simpara>
</listitem>
<listitem>
<simpara>
s - secunde; de exemplu "00" p�n� la "59"
</simpara>
</listitem>
<listitem>
<simpara>
S - sufixul ordinal englezesc pentru ziua din lun�, 2 caractere; de exemplu
"th", "nd"
</simpara>
</listitem>
<listitem>
<simpara>
t - num�rul de zile dintr-o lun� dat�; de exemplu "28" p�n� la "31"
</simpara>
</listitem>
<listitem>
<simpara>
T - set�rile de reprezentare a timpului pe un calculator; de exemplu "MDT"
</simpara>
</listitem>
<listitem>
<simpara>
U - secunde de la �nceputul epocii UNIX
</simpara>
</listitem>
<listitem>
<simpara>
w - ziua din s�pt�m�n�, numeric�, de exemplu "0" (duminic�) p�n� la "6"
(s�mb�t�)
</simpara>
</listitem>
<listitem>
<simpara>
W - num�rul s�pt�m�nii din an conform ISO-8601; s�pt�m�na �ncepe lunea
(ad�ugat� �n PHP 4.1.0)
</simpara>
</listitem>
<listitem>
<simpara>
Y - anul, 4 cifre; de exemplu "1999"
</simpara>
</listitem>
<listitem>
<simpara>
y - anul, 2 cifre; de exemplu "99"
</simpara>
</listitem>
<listitem>
<simpara>
z - ziua din an; de exemplu "0" p�n� la "365"
</simpara>
</listitem>
<listitem>
<simpara>
Z - diferen�a de timp fa�� de UTC, �n secunde (de exemplu "-43200" p�n� la
"43200"). Diferen�ele pentru zonele aflate la vest de UTC sunt �ntotdeauna negative �i
celelalte sunt �ntotdeauna pozitive.
</simpara>
</listitem>
</itemizedlist>
Caracterele nerecunoscute din format vor fi afi�ate ca atare. Formatul "Z" va
returna �ntotdeauna "0" c�nd se folose�te <function>gmdate</function>.
</para>
<para>
<example>
<title>Exemplu <function>date</function></title>
<programlisting role="php">
<![CDATA[
echo date ("l dS of F Y h:i:s A");
echo "July 1, 2000 este �ntr-o zi de " . date ("l", mktime(0,0,0,7,1,2000));
]]>
</programlisting>
</example>
</para>
<para>
Pute�i preveni expandarea unui caracter de formatare preced�ndu-l cu un
backslash. Dac� astfel ia na�tere un caracter escape predefinit este necesar�
ad�ugarea �nc� unui backslash.
<example>
<title>Caractere escape �n func�ia <function>date</function></title>
<programlisting role="php">
<![CDATA[
echo date("l \e\s\\t\e \i\\n j"); // va afi�a ceva de genul 'Saturday este in 8'
]]>
</programlisting>
</example>
</para>
<para>
Este posibil s� utiliza�i func�iile <function>date</function> �i
<function>mktime</function> �mpreun� pentru a g�si date �n viitor sau �n trecut.
<example>
<title>Exemplu <function>date</function> �i <function>mktime</function></title>
<programlisting role="php">
<![CDATA[
$miine = mktime (0,0,0,date("m") ,date("d")+1,date("Y"));
$luna_trecuta = mktime (0,0,0,date("m")-1,date("d"), date("Y"));
$anul_viitor = mktime (0,0,0,date("m"), date("d"), date("Y")+1);
]]>
</programlisting>
</example>
<note>
<para>
Aceast� modalitate de g�sire a datelor din trecut sau viitor este mai demn� de
�ncredere dec�t simpla ad�ugare sau sc�dere de secunde la un timestamp, datorit� orei
de var�.
</para>
</note>
</para>
<para>
C�teva exemple de formatare a datei utiliz�nd func�ia <function>date</function>.
Este recomandat s� face�i escape la toate caracterele din �irul de formatare pe care
nu dori�i ca func�ia s� le expandeze, precum �i la cele care momentan nu au o
semnifica�ie, din cel pu�in dou� motive: pot ap�rea rezultate nea�teptate; alte
caractere pot avea o semnifica�ie �n versiuni viitoare ale PHP. C�nd face�i escape
�ine�i cont c� unele caractere (n, t) cap�t� semnifica�ii speciale. Pentru a preveni
acest lucru utiliza�i apostroful pentru �ncadrarea �irului de formatare.
<example>
<title>
Formatare cu func�ia <function>date</function>
</title>
<programlisting role="php">
<![CDATA[
/* Today is March 10th, 2001, 5:16:18 pm */
$azi = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm
$azi = date("m.d.y"); // 03.10.01
$azi = date("j, m, Y"); // 10, 3, 2001
$azi = date("Ymd"); // 20010310
$azi = date('h-i-s, j-m-y, it is w Day z '); // 05-16-17, 10-03-01, 1631 1618 6
Fripm01
$azi = date('\e\s\t\e \z\i\u\a \d\e j.'); // este ziua de 10.
$azi = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001
$azi = date('H:m:s \l \e\s\t\e \l\u\n\a'); // 17:03:17 l este luna
$azi = date("H:i:s"); // 17:16:17
]]>
</programlisting>
</example>
</para>
<para>
Pentru a formata datele �n alte limbi trebuie s� utiliza�i func�iile
<function>setlocale</function> �i <function>strftime</function>.
</para>
<para>
Vezi, de asemenea, <function>getlastmod</function>, <function>gmdate</function>,
<function>mktime</function>, <function>strftime</function> �i
<function>time</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.getdate">
<refnamediv>
<refname>getdate</refname>
<refpurpose>Cite�te informa�ii despre dat�/timp</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>array</type><methodname>getdate</methodname>
<methodparam
choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
</methodsynopsis>
<para>
Returneaz� un tablou asociativ con�in�nd informa�ii despre dat� din
<parameter>timestamp</parameter>, sau timpul local curent dac� nu este dat
<parameter>timestamp</parameter>; tabloul returnat are urm�toarele chei asociative:
<itemizedlist>
<listitem>
<simpara>
"seconds" - secunde
</simpara>
</listitem>
<listitem>
<simpara>
"minutes" - minute
</simpara>
</listitem>
<listitem>
<simpara>
"hours" - ore
</simpara>
</listitem>
<listitem>
<simpara>
"mday" - ziua din lun�
</simpara>
</listitem>
<listitem>
<simpara>
"wday" - ziua din s�pt�m�n�, numeric: de la 0 ca duminic� p�n� la 6 ca s�mb�t�
</simpara>
</listitem>
<listitem>
<simpara>
"mon" - luna, numeric
</simpara>
</listitem>
<listitem>
<simpara>
"year" - anul, numeric
</simpara>
</listitem>
<listitem>
<simpara>
"yday" - ziua din an, numeric; de exemplu "299"
</simpara>
</listitem>
<listitem>
<simpara>
"weekday" - ziua din s�pt�m�n�, textual, �n englez�, complet; de exemplu
"Friday"
</simpara>
</listitem>
<listitem>
<simpara>
"month" - luna, textual, �n englez�, complet; de exemplu "January"
</simpara>
</listitem>
</itemizedlist>
<example>
<title>
Exemplu <function>getdate</function>
</title>
<programlisting role="php">
<![CDATA[
$azi = getdate();
$luna = $azi['month'];
$ziua = $azi['mday'];
$anul = $azi['year'];
echo "$luna $ziua, $anul";
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.gettimeofday">
<refnamediv>
<refname>gettimeofday</refname>
<refpurpose>Cite�te timpul curent</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>array</type><methodname>gettimeofday</methodname>
<void/>
</methodsynopsis>
<para>
Aceasta este o interfa�� pentru gettimeofday(2). Returneaz� un tablou asociativ
con�in�nd data returnat� de un apel sistem.
<itemizedlist>
<listitem>
<simpara>
"sec" - secunde
</simpara>
</listitem>
<listitem>
<simpara>
"usec" - microsecunde
</simpara>
</listitem>
<listitem>
<simpara>
"minuteswest" - minute la vest de Greenwich
</simpara>
</listitem>
<listitem>
<simpara>
"dsttime" - tipul corec�iei dst
</simpara>
</listitem>
</itemizedlist>
</para>
</refsect1>
</refentry>
<refentry id="function.gmdate">
<refnamediv>
<refname>gmdate</refname>
<refpurpose>Formateaz� data/timpul GMT/CUT</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>string</type><methodname>gmdate</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
</methodsynopsis>
<para>
Este identic� cu func�ia <function>date</function> cu excep�ia faptului c� timpul
rezultat este Greenwich Mean Time (GMT). De exemplu, c�nd este rulat �n Romania (GMT
+0300), prima linie de mai jos va afi�a "Jan 01 1998 00:00:00", �n vreme ce a doua va
afi�a "Dec 31 1997 22:00:00".
<example>
<title>Exemplu <function>gmdate</function></title>
<programlisting role="php">
<![CDATA[
echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998));
echo gmdate ("M d Y H:i:s", mktime (0,0,0,1,1,1998));
]]>
</programlisting>
</example>
</para>
<para>
Vezi, de asemenea, <function>date</function>, <function>mktime</function>,
<function>gmmktime</function> �i <function>strftime</function>
</para>
</refsect1>
</refentry>
<refentry id="function.gmmktime">
<refnamediv>
<refname>gmmktime</refname>
<refpurpose>Cite�te un timestamp UNIX pentru o dat� GMT</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>int</type><methodname>gmmktime</methodname>
<methodparam><type>int</type><parameter>hour</parameter></methodparam>
<methodparam><type>int</type><parameter>minute</parameter></methodparam>
<methodparam><type>int</type><parameter>second</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam>
</methodsynopsis>
<para>
Identic� cu <function>mktime</function> cu excep�ia faptului c� parametrii
reprezint� o dat� GMT.
</para>
</refsect1>
</refentry>
<refentry id="function.gmstrftime">
<refnamediv>
<refname>gmstrftime</refname>
<refpurpose>Formateaz� data/timpul GMT/CUT conform cu set�rile locale</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>string</type><methodname>gmstrftime</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
</methodsynopsis>
<para>
Se comport� la fel ca <function>strftime</function> except�nd faptul c� timpul
returnat este Greenwich Mean Time (GMT). De exemplu, c�nd este rulat �n Timpul
Standard Estic (GMT -0500), prima linie de mai jos va afi�a "Dec 31 1998 20:00:00", �n
timp ce a doua va afi�a "Jan 01 1999 01:00:00".
<example>
<title>Exemplu <function>gmstrftime</function></title>
<programlisting role="php">
<![CDATA[
setlocale ('LC_TIME', 'en_US');
echo strftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n";
echo gmstrftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n";
]]>
</programlisting>
</example>
</para>
<para>
Vezi, de asemenea, <function>strftime</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.localtime">
<refnamediv>
<refname>localtime</refname>
<refpurpose>Cite�te timpul local</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>array</type><methodname>localtime</methodname>
<methodparam choice="opt"><type>int</type><parameter>
timestamp
</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>
is_associative
</parameter></methodparam>
</methodsynopsis>
<para>
Func�ia <function>localtime</function> returneaz� un tablou identic cu cel al
structurii returnate de un apel al func�iei C. Primul argument al
<function>localtime</function> este timestamp; dac� nu este dat, se utilizeaz� timpul
curent. Al doilea argument al func�iei <function>localtime</function> este
<parameter>is_associative</parameter>; dac� este 0 sau nu este dat atunci tabloul
returnat va fi unul obi�nuit, av�nd chei numerice. Dac� acest argument este 1 atunci
<function>localtime</function> este un tablou asociativ con�in�nd toate elementele
structurii returnate de apelul func�iei C. Numele cheilor din tabloul asociativ sunt
dup� cum urmeaz�:
<itemizedlist>
<listitem>
<simpara>
"tm_sec" - secunde
</simpara>
</listitem>
<listitem>
<simpara>
"tm_min" - minute
</simpara>
</listitem>
<listitem>
<simpara>
"tm_hour" - ore
</simpara>
</listitem>
<listitem>
<simpara>
"tm_mday" - ziua din lun�
</simpara>
</listitem>
<listitem>
<simpara>
"tm_mon" - luna din an �ncep�nd cu 0 pentru ianuarie
</simpara>
</listitem>
<listitem>
<simpara>
"tm_year" - anii �ncep�nd cu 1900
</simpara>
</listitem>
<listitem>
<simpara>
"tm_wday" - ziua din s�pt�m�n�
</simpara>
</listitem>
<listitem>
<simpara>
"tm_yday" - ziua din an
</simpara>
</listitem>
<listitem>
<simpara>
"tm_isdst" - este activ� ora de var�
</simpara>
</listitem>
</itemizedlist>
</para>
</refsect1>
</refentry>
<refentry id="function.microtime">
<refnamediv>
<refname>microtime</refname>
<refpurpose>Returneaz� timestamp-ul curent UNIX cu microsecunde</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>string</type><methodname>microtime</methodname>
<void/>
</methodsynopsis>
<para>
Returneaz� �irul "msec sec" unde sec este timpul curent m�surat �n secunde de la
�nceputul Epocii UNIX (0:00:00 January 1, 1970 GMT), �i msec este partea reprezent�nd
microsecndele. Aceast� func�ie este valabil� pe sistemele de operare care suport�
apelul sistem gettimeofday().
</para>
<para>
Ambele p�r�i ale �irului sunt returnate �n unit��i de secunde.
<example>
<title>Exemplu <function>microtime</function></title>
<programlisting role="php">
<![CDATA[
function getmicrotime(){
list($usec, $sec) = explode(" ",microtime());
return ((float)$usec + (float)$sec);
}
$start_t = getmicrotime();
for ($i=0; $i < 1000; $i++){
//do nothing, 1000 times
}
$stop_t = getmicrotime();
$timp = $stop_t - $start_t;
echo "N-am facut nimic timp de $time secunde";
]]>
</programlisting>
</example>
</para>
<para>
Vezi, de asemenea, <function>time</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.mktime">
<refnamediv>
<refname>mktime</refname>
<refpurpose>Cite�te valoarea UNIX timestamp pentru o dat�</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>int</type><methodname>mktime</methodname>
<methodparam><type>int</type><parameter>hour</parameter></methodparam>
<methodparam><type>int</type><parameter>minute</parameter></methodparam>
<methodparam><type>int</type><parameter>second</parameter></methodparam>
<methodparam><type>int</type><parameter>month</parameter></methodparam>
<methodparam><type>int</type><parameter>day</parameter></methodparam>
<methodparam><type>int</type><parameter>year</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam>
</methodsynopsis>
<para>
<emphasis>Aten�ie:</emphasis> Observa�i ordinea ciudat� a argumentelor, care
difer� de ordinea argumentelor �ntr-un apel normal al func�iei UNIX mktime(); �n cazul
�n care aceast� ordine nu este respectat� vor fi furnizate rezultate aleatoare (vezi
mai jos). Acest tip de eroare este una comun�.
</para>
<para>
Retureaz� valoarea UNIX timestamp corespunz�toare argumentelor. Acest timestamp
este un �ntreg lung (long integer) care con�ine num�rul de secunde �ntre �nceputul
Epocii UNIX (1 ianuarie 1970) �i timpul specificat.
</para>
<para>
Se poate renun�a la argumente �ncep�nd de la dreapta la st�nga; orice argument
astfel omis va fi setat la valoarea curent� �n conformitate cu data �i timpul locale.
</para>
<para>
<parameter>Is_dst</parameter> poate fi setat la 1 dac� timpul este �n perioada �n
care este activ� ora de iarn�, 0 �n caz contrar, sau -1 (implicit) �n caz c� nu se
�tie.
</para>
<note>
<para>
<parameter>Is_dst</parameter> a fost ad�ugat �n 3.0.10.
</para>
</note>
<para>
Func�ia <function>mktime</function> este folositoare pentru efectuarea de calcule
�i valid�ri ale datei, �i va produce rezultate corecte chiar �n cazul unor invalide.
De exemplu, fiecare dintre urm�toarele linii va produce �irul de caractere
"Jan-01-1998".
<example>
<title><function>mktime</function> example</title>
<programlisting role="php">
<![CDATA[
echo date ("M-d-Y", mktime (0,0,0,12,32,1997));
echo date ("M-d-Y", mktime (0,0,0,13,1,1997));
echo date ("M-d-Y", mktime (0,0,0,1,1,1998));
echo date ("M-d-Y", mktime (0,0,0,1,1,98));
]]>
</programlisting>
</example>
Parametrul <parameter>year</parameter> poate fi format din dou� sau patru cifre,
cu valori �ntre 0-69 pentru anii 2000-2069 �i 70-99 pentru anii 1970-1999 (pentru
sistemele pe care time_t este reprezentat ca un �ntreg cu semn pe 32 de bi�i, cum sunt
cele de acum, intervalul valid pentru <parameter>year</parameter> este undeva �ntre
1902 �i 2037).
</para>
<para>
Ultima zi a unei luni va fi exprimat� ca ziua "0" a lunii urm�toare nu ca ziua
-1. Ambele exemple de mai jos vor produce acela�i rezultat: �irul de caractere "The
last day in Feb 2000 is: 29".
<example>
<title>Ultima zi din lun�</title>
<programlisting role="php">
<![CDATA[
$lastday = mktime (0,0,0,3,0,2000);
echo strftime ("Last day in Feb 2000 is: %d", $lastday);
$lastday = mktime (0,0,0,4,-31,2000);
echo strftime ("Last day in Feb 2000 is: %d", $lastday);
]]>
</programlisting>
</example>
</para>
<simpara>
Datele cu anul, luna �i ziua egale cu zero sunt considerate ilegale (dealtfel vor
produce rezultatul 30.11.1999, ceea ce reprezint� un comportament ciudat).
</simpara>
<para>
Vezi, de asemenea, <function>date</function> �i <function>time</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.strftime">
<refnamediv>
<refname>strftime</refname>
<refpurpose>
Formateaz� data/timpul local conform cu set�rile locale
</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>string</type><methodname>strftime</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>
timestamp
</parameter></methodparam>
</methodsynopsis>
<para>
Returneaz� un �ir formatat conform parametrului <parameter>format</parameter>
utiliz�nd parametrul op�ional <parameter>timestamp</parameter> sau timpul curent local
dac� func�ia nu a fost apelat� cu timestamp. Numele lunilor �i zilelor s�pt�m�nii,
precum �i alte �iruri dependente de limb� respect� set�rile locale stabilite cu
func�ia <function>setlocale</function>.
</para>
<para>
Specificatori de conversie recunoscu�i �n �irul <parameter>format</parameter>:
<itemizedlist>
<listitem>
<simpara>
%a - numele zilei din s�pt�m�n�, abreviat
</simpara>
</listitem>
<listitem>
<simpara>
%A - numele zilei din s�pt�m�n�, complet
</simpara>
</listitem>
<listitem>
<simpara>
%b - numele lunii, abreviat
</simpara>
</listitem>
<listitem>
<simpara>
%B - numele lunii, complet
</simpara>
</listitem>
<listitem>
<simpara>
%c - reprezentarea preferat� a datei �i timpului pentru set�rile locale curente
</simpara>
</listitem>
<listitem>
<simpara>
%C - secolul (anul divizat la 100 �i trunchiat la un �ntreg, �n intervalul 00
- 99)
</simpara>
</listitem>
<listitem>
<simpara>
%d - ziua din lun� ca num�r zecimal (interval 01 - 31)
</simpara>
</listitem>
<listitem>
<simpara>
%D - identic cu %m/%d/%y
</simpara>
</listitem>
<listitem>
<simpara>
%e - ziua din lun�, num�r zecimal, zero ini�ial �nclocuit de un spa�iu
(interval ' 1' - '31')
</simpara>
</listitem>
<listitem>
<simpara>
%g - ca �i %G, dar f�r� secol
</simpara>
</listitem>
<listitem>
<simpara>
%G - anul format din 4 cifre corespunz�tor num�rului ISO al s�pt�m�nii (vezi
%V). Are acela�i format �i aceea�i valoare ca �i %Y, cu o singur� excep�ie: dac�
num�rul ISO al s�pt�m�nii apar�ine anului precedent sau urm�tor, va fi utilizat acel
an.
</simpara>
</listitem>
<listitem>
<simpara>
%h - la fel ca %b
</simpara>
</listitem>
<listitem>
<simpara>
%H - ora ca num�r zecimal utiliz�nd formatul de 24 de ore (interval 00 - 23)
</simpara>
</listitem>
<listitem>
<simpara>
%I - ora ca num�r zecimal utiliz�nd formatul de 12 de ore (interval 00 - 12)
</simpara>
</listitem>
<listitem>
<simpara>
%j - ziua din an ca num�r zecimal (interval 001 - 366)
</simpara>
</listitem>
<listitem>
<simpara>
%m - luna ca num�r zecimal (interval 01 - 12)
</simpara>
</listitem>
<listitem>
<simpara>
%M - minutul ca num�r zecimal
</simpara>
</listitem>
<listitem>
<simpara>
%n - caracter de r�nd nou
</simpara>
</listitem>
<listitem>
<simpara>
%p - `am' sau `pm' �n func�ie de valoarea timpului, sau de �irul corespunz�tor
din set�rile locale
</simpara>
</listitem>
<listitem>
<simpara>
%r - timpul �n formatul a.m. �i p.m.
</simpara>
</listitem>
<listitem>
<simpara>
%R - timpul �n formatul de 24 de ore
</simpara>
</listitem>
<listitem>
<simpara>
%S - secunda ca num�r zecimal
</simpara>
</listitem>
<listitem>
<simpara>
%t - caracterul tab
</simpara>
</listitem>
<listitem>
<simpara>
%T - timpul curent, egal cu %H:%M:%S
</simpara>
</listitem>
<listitem>
<simpara>
%u - ziua din s�pt�m�n� ca num�r zecimal [1,7], unde 1 reprezint� ziua de luni
</simpara>
<warning>
<simpara>
Sta�iile Sun Solaris par s� porneasc� s�pt�m�na cu ziua de duminic�
corespunz�nd valorii 1, de�i ISO 9889:1999 (standardul curent C) specific� �n mod clar
c� ar trebui s� fie luni.
</simpara>
</warning>
</listitem>
<listitem>
<simpara>
%U - num�rul s�pt�m�nii din anul curent, reprezentat ca num�r zecimal; prima
duminic� din an este prima zi a primei s�pt�m�ni
</simpara>
</listitem>
<listitem>
<simpara>
%V - num�rul s�pt�m�nii din anul curent conform ISO 8601:1988, reprezentat ca
num�r zecimal �n intervalul 01 - 53, unde s�pt�m�na 1 este prima s�pt�m�n� care are
cel pu�in 4 zile, iar prima zi a s�pt�m�nii este socotit� lunea. (Utiliza�i %G sau %g
pentru componenta din an care corespunde num�rului s�pt�m�nii pentru valoarea
timestamp specificat�.)
</simpara>
</listitem>
<listitem>
<simpara>
%W - num�rul s�pt�m�nii din anul curent, reprezentat ca num�r zecimal; prima
luni din an este prima zi a primei s�pt�m�ni
</simpara>
</listitem>
<listitem>
<simpara>
%w - ziua din s�pt�m�n� ca num�r zecimal, duminic� este 0
</simpara>
</listitem>
<listitem>
<simpara>
%x - reprezentarea preferat� a datei conform set�rilor locale f�r� timp
</simpara>
</listitem>
<listitem>
<simpara>
%X - reprezentarea preferat� a timpului conform set�rilor locale f�r� dat�
</simpara>
</listitem>
<listitem>
<simpara>
%y - anul ca num�r zecimal, f�r� secol (interval 00 -
99)
</simpara>
</listitem>
<listitem>
<simpara>
%Y - anul ca num�r zecimal incluz�nd secolul
</simpara>
</listitem>
<listitem>
<simpara>
%Z - zona, numele sau abrevierea de timp
</simpara>
</listitem>
<listitem>
<simpara>
%% - caracterul `%'
</simpara>
</listitem>
</itemizedlist>
<note>
<para>
Nu to�i specificatorii de format vor fi suporta�i de libr�ria C pe care o
ave�i instalat�, caz �n care ace�tia nu vor fi suporta�i de func�ia PHP
<function>strftime</function>.
</para>
</note>
<example>
<title>Exemplu <function>strftime</function></title>
<programlisting role="php">
<![CDATA[
setlocale (LC_TIME, "C");
print (strftime ("%A in Finnish is "));
setlocale (LC_TIME, "fi_FI");
print (strftime ("%A, in French "));
setlocale (LC_TIME, "fr_FR");
print (strftime ("%A and in German "));
setlocale (LC_TIME, "de_DE");
print (strftime ("%A.\n"));
]]>
</programlisting>
</example>
Acest exemplu func�ioneaz� dac� ave�i instalate localele respective �n sistem.
</para>
<para>
Vezi, de asemenea, <function>setlocale</function> �i <function>mktime</function>
precum �i <ulink url="&spec.strftime;"> specifica�iile Open Group pentru
<function>strftime</function></ulink>.
</para>
</refsect1>
</refentry>
<refentry id="function.time">
<refnamediv>
<refname>time</refname>
<refpurpose>Returneaz� valoarea UNIX timestamp curent�</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>int</type><methodname>time</methodname>
<void/>
</methodsynopsis>
<para>
Returneaz� timpul curent m�surat �n num�r de secunde �ncep�nd cu Epoca UNIX
(1 ianuarie 1970 00:00:00 GMT).
</para>
<para>
Vezi, de asemenea, <function>date</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.strtotime">
<refnamediv>
<refname>strtotime</refname>
<refpurpose>
Converte�te aproape orice reprezentare textual� a datei/timpului �n valoarea UNIX
timestamp corespunz�toare
</refpurpose>
</refnamediv>
<refsect1>
<title>Descriere</title>
<methodsynopsis>
<type>int</type><methodname>strtotime</methodname>
<methodparam><type>string</type><parameter>time</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>now</parameter></methodparam>
</methodsynopsis>
<simpara>
Func�ia a�teapt� un �ir con�in�nd o dat� �n format englezesc pe care va
�ncerca s� o converteasc� la valoarea UNIX timestamp �n func�ie de parametrul
<parameter>now</parameter>; dac� <parameter>now</parameter> nu este dat se folose�te
timpul curent. �n caz de e�ec este returnat� valoarea <literal>-1</literal>.
</simpara>
<simpara>
Datorit� faptului c� <function>strtotime</function> se comport� conforma
specifica�iilor de sintax� a datei GNU, arunca�i o privire la pagina de manual
intitulat� <ulink url="&url.gnu.man.date-input;">Date Input Formats</ulink>. Aici este
descris� o sintax� valid� pentru parametrul <parameter>time</parameter>.
</simpara>
<para>
<example>
<title>Exemple <function>strtotime</function></title>
<programlisting role="php">
<![CDATA[
echo strtotime ("now"), "\n";
echo strtotime ("10 September 2000"), "\n";
echo strtotime ("+1 day"), "\n";
echo strtotime ("+1 week"), "\n";
echo strtotime ("+1 week 2 days 4 hours 2 seconds"), "\n";
echo strtotime ("next Thursday"), "\n";
echo strtotime ("last Monday"), "\n";
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Verificarea e�ecului</title>
<programlisting role="php">
<![CDATA[
$str = 'Not Good';
if (($timestamp = strtotime($str)) === -1) {
echo "The string ($str) is bogus";
} else {
echo "$str == ". date('l dS of F Y h:i:s A',$timestamp);
}
]]>
</programlisting>
</example>
</para>
<note>
<para>
Intervalul valid este, de regul�, Vineri, 13 Dec 1901 20:45:54 GMT - Mar�i, 19
Ian 2038 03:14:07 GMT. (Acestea sunt datele corespunz�toare valorilor minime �i maxime
ale unui �ntreg cu semn pe 32 de bi�i.)
</para>
</note>
</refsect1>
</refentry>
</reference>
<!-- 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:"../../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
-->
