manuzhai Mon Mar 25 03:17:37 2002 EDT
Modified files:
/phpdoc/nl/functions datetime.xml
Log:
Updated until time() with en 1.68.
Index: phpdoc/nl/functions/datetime.xml
diff -u phpdoc/nl/functions/datetime.xml:1.9 phpdoc/nl/functions/datetime.xml:1.10
--- phpdoc/nl/functions/datetime.xml:1.9 Sat Feb 2 10:47:48 2002
+++ phpdoc/nl/functions/datetime.xml Mon Mar 25 03:17:37 2002
@@ -23,12 +23,12 @@
<itemizedlist>
<listitem>
<simpara>
- jaar tussen 1 en 32767 inclusive is
+ het jaar tussen 1 en 32767 inclusive is
</simpara>
</listitem>
<listitem>
<simpara>
- maand tussen 1 en 12 inclusive is
+ de maand tussen 1 en 12 inclusive is.
</simpara>
</listitem>
<listitem>
@@ -40,13 +40,16 @@
</listitem>
</itemizedlist>
</para>
+ <para>
+ Zie ook <function>mktime</function> en <function>strtotime</function>.
+ </para>
</refsect1>
</refentry>
<refentry id="function.date">
<refnamediv>
<refname>date</refname>
- <refpurpose>Formateer een local time/date</refpurpose>
+ <refpurpose>Formatteer een lokale date/time</refpurpose>
</refnamediv>
<refsect1>
<title>Omschrijving</title>
@@ -61,6 +64,20 @@
Geeft een geformatteerde string volgens de gegeven format string
gebruikmakend van <parameter>timestamp</parameter> of the huidige
local time als geen timestamp gegeven is.
+ <note>
+ <para>
+ The valid range of a timestamp is typically from Fri, 13 Dec 1901
+ 20:45:54 GMT to Tue, 19 Jan 2038 03:14:07 GMT. (These are
+ the dates that correspond to the minimum and maximum values for
+ a 32-bit signed integer.)
+ </para>
+ <para>
+ Om een timestamp te genereren uit een string representatie van een datum
+ kun je eventueel <function>strtotime</function> gebruiken. Bovendien hebben
+ sommige databases functies om hun dataum formaten om te zetten naar
+ timestamps (zoals MySQLs UNIX_TIMESTAMP functie).
+ </para>
+ </note>
</para>
<para>
De volgende karakters worden herkend in de format string:
@@ -159,6 +176,11 @@
n - maand zonder nul aan het begin; dus "1" tot "12"
</simpara>
</listitem>
+ <listitem>
+ <simpara>
+ O - Verschil met Greenwich tijd in uren; bijvoorbeeld "+0200"
+ </simpara>
+ </listitem>
<listitem>
<simpara>
r - RFC 822 geformatteerde date; dus "Thu, 21 Dec 2000 16:01:07
+0200"
@@ -171,7 +193,7 @@
</listitem>
<listitem>
<simpara>
- S - Engels ordinale suffix, textueel, 2 karakters; dus "th",
+ S - Engelse ordinale suffix voor de dag van de maand, textueel, 2 karakters;
+dus "th",
"nd"
</simpara>
</listitem>
@@ -196,6 +218,11 @@
(Zaterdag)
</simpara>
</listitem>
+ <listitem>
+ <simpara>
+ W - ISO-8601 weeknummer van het jaar, weken beginnend op maandag
+(toegevoegd in PHP 4.1.0)
+ </simpara>
+ </listitem>
<listitem>
<simpara>
Y - jaar, 4 cijfers; dus "1999"
@@ -225,34 +252,84 @@
<example>
<title><function>date</function> voorbeeld</title>
<programlisting role="php">
+<![CDATA[
print (date ("l dS of F Y h:i:s A"));
print ("July 1, 2000 is on a " . date ("l",
mktime(0,0,0,7,1,2000)));
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Je kunt ervoor zorgen dat een herkend karakter in een format string
+ niet wordt vervangen door het te escapen met een voorgaande backslash. Als
+ het karakter met een backslash al een speciaal teken is, moet je ook
+ de backslash escapen.
+ <example>
+ <title>Escapen van characters in <function>date</function></title>
+ <programlisting role="php">
+<![CDATA[
+ echo date("l \\t\h\e jS"); // prints something like 'Saturday the 8th'
+]]>
</programlisting>
</example>
</para>
<para>
Het is mogelijk om <function>date</function> en <function>mktime</function>
- samen te gebruiken om datums in de toekomst of verleden te vinden.
+ samen te gebruiken om data in de toekomst of het verleden te vinden.
<example>
<title>
- <function>date</function> en <function>mktime</function>
- voorbeeld
+ <function>date</function> en <function>mktime</function> voorbeeld
</title>
<programlisting>
+<![CDATA[
$tomorrow = mktime (0,0,0,date("m")
,date("d")+1,date("Y"));
$lastmonth = mktime (0,0,0,date("m")-1,date("d"),
date("Y"));
$nextyear = mktime (0,0,0,date("m"), date("d"),
date("Y")+1);
+]]>
+ </programlisting>
+ </example>
+ <note>
+ <para>
+ Dit kan betrouwbaarder zijn dan het simpelweg toevoegen of aftrekken
+ van het aantal seconden in een dag of een maand bij een timestamp door
+ de zomer- en wintertijd.
+ </para>
+ </note>
+ </para>
+ <para>
+ Een paar voorbeelden van <function>date</function> formatting. Let
+ erop dat je andere karakters moet escapen, omdat degenen
+ die momenteel een speciale betekenis hebben, en andere karakters
+ zullen een betekenis krijgen in toekomstige PHP versies. Wanneer
+ je escapet, zorg ervoor dat je enkele aanhalingstekens gebruikt
+ om ervoor te zorgen dat karakters zoals \n newlines worden.
+ <example>
+ <title><function>date</function> Formatting</title>
+ <programlisting role="php">
+<![CDATA[
+/* Today is March 10th, 2001, 5:16:18 pm */
+$today = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm
+$today = date("m.d.y"); // 03.10.01
+$today = date("j, n, Y"); // 10, 3, 2001
+$today = date("Ymd"); // 20010310
+$today = date('h-i-s, j-m-y, it is w Day z '); // 05-16-17, 10-03-01, 1631 1618 6
+Fripm01
+$today = date('\i\t \i\s \t\h\e jS \d\a\y.'); // It is the 10th day.
+$today = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001
+$today = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:17 m is month
+$today = date("H:i:s"); // 17:16:17
+]]>
</programlisting>
</example>
</para>
<para>
- Om datums te formatteren in andere talen dan engels, moet
+ Om data te formatteren in andere talen dan engels, moet
je de <function>setlocale</function> en <function>strftime</function>
- functies moeten gebruiken.
+ functies gebruiken.
</para>
<para>
- Zie ook <function>gmdate</function> en
- <function>mktime</function>.
+ Zie ook <function>getlastmod</function>, <function>gmdate</function>,
+ <function>mktime</function>, <function>strftime</function>
+ en <function>time</function>.
</para>
</refsect1>
</refentry>
@@ -269,10 +346,10 @@
<methodparam
choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam>
</methodsynopsis>
<para>
- Retourneert een associative array die informatie omtrent de date
+ Retourneert een associatieve array die informatie omtrent de date
van <parameter>timestamp</parameter> bevat, of de huidige lokale
- tijd als er geen timestamp is meegegeven, als de volgende array
- elementen:
+ tijd als er geen timestamp is meegegeven, als een array met de
+ volgende elementen:
<itemizedlist>
<listitem>
<simpara>
@@ -325,6 +402,20 @@
</simpara>
</listitem>
</itemizedlist>
+ <example>
+ <title>
+ <function>getdate</function> voorbeeld
+ </title>
+ <programlisting role="php">
+<![CDATA[
+$today = getdate();
+$month = $today['month'];
+$mday = $today['mday'];
+$year = $today['year'];
+echo "$month $mday, $year";
+]]>
+ </programlisting>
+ </example>
</para>
</refsect1>
</refentry>
@@ -332,7 +423,7 @@
<refentry id="function.gettimeofday">
<refnamediv>
<refname>gettimeofday</refname>
- <refpurpose>Verkrijg de huidige tijd</refpurpose>
+ <refpurpose>Geef de huidige tijd</refpurpose>
</refnamediv>
<refsect1>
<title>Omschrijving</title>
@@ -342,7 +433,7 @@
</methodsynopsis>
<para>
Dit is een interface naar gettimeofday(2). Het retourneert
- een associative array die de data die teruggegeven wordt van
+ een associatieve array met de data die teruggegeven wordt van
de system call.
<itemizedlist>
<listitem>
@@ -391,14 +482,16 @@
<example>
<title><function>gmdate</function> voorbeeld</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>
Zie ook <function>date</function>, <function>mktime</function>,
- en <function>gmmktime</function>.
+ <function>gmmktime</function> en <function>strftime</function>.
</para>
</refsect1>
</refentry>
@@ -444,15 +537,17 @@
<para>
Gedraagt zich hetzelfde als <function>strftime</function> behalve dat de
time wordt teruggegeven als Greenwich Mean Time (GMT). Bijvoorbeeld wanneer
- uitgevoerd in Eastern Standard Time (GMT -0500), de eerste regel hieronder
+ uitgevoerd in Eastern Standard Time (GMT -0500); de eerste regel hieronder
print "Dec 31 1998 20:00:00", terwijl de tweede print
"Jan 01 1999 01:00:00".
<example>
<title><function>gmstrftime</function> voorbeeld</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>
@@ -465,7 +560,7 @@
<refentry id="function.localtime">
<refnamediv>
<refname>localtime</refname>
- <refpurpose>Verkrijg de local time</refpurpose>
+ <refpurpose>Geef de local time</refpurpose>
</refnamediv>
<refsect1>
<title>Omschrijving</title>
@@ -487,7 +582,7 @@
<parameter>is_associative</parameter>, als die op 0 gezet is
of niet aanwezig is dan wordt de array geretourneerd als een normale,
numeriek geindexeerde array. Als het argument op 1 is gezet dan is
- <function>localtime</function> een associative array die alle
+ <function>localtime</function> een associatieve array die alle
verschillende elementen bevat van de structuur die door de C
functie call localtime geretourneerd wordt. De namen van de
verschillende keys van de associative array zijn als volgt:
@@ -560,9 +655,31 @@
January 1, 1970 GMT) is, en msec is het microseconden gedeelte.
Deze functie is alleen beschikbaar op operating systems die de
gettimeofday() system call ondersteunen.
+ <example>
+ <title><function>microtime</function> voorbeeld</title>
+ <programlisting role="php">
+<![CDATA[
+function getmicrotime() {
+ list($usec, $sec) = explode(" ",microtime());
+ return ((float)$usec + (float)$sec);
+}
+
+$time_start = getmicrotime();
+
+for ($i=0; $i < 1000; $i++){
+ // Doe 1000 keer niets
+}
+
+$time_end = getmicrotime();
+$time = $time_end - $time_start;
+
+echo "Niets gedaan in $time seconden";
+]]>
+ </programlisting>
+ </example>
</para>
<para>
- Zie ook <function>time</function>.
+ Zie ook: <function>time</function>.
</para>
</refsect1>
</refentry>
@@ -570,7 +687,7 @@
<refentry id="function.mktime">
<refnamediv>
<refname>mktime</refname>
- <refpurpose>Verkrijg UNIX timestamp voor een date</refpurpose>
+ <refpurpose>Geef UNIX timestamp voor een date</refpurpose>
</refnamediv>
<refsect1>
<title>Omschrijving</title>
@@ -623,16 +740,18 @@
<example>
<title><function>mktime</function> voorbeeld</title>
<programlisting>
+<![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>
<parameter>Year</parameter> mag zowel een twee als vier cijferige
waarde zijn, met waardes tussen 0-69 mapping naar 2000-2069 en
70-99 naar 1970-1999 (op systemen waar time_t een 32bit signed integer
- is, zoals gewoonlijk tegenwoordig, is de correcte range voor
+ is, zoals tegenwoordig gewoonlijk, is de correcte range voor
<parameter>year</parameter> ergens tussen 1902 en 2037).
</para>
<para>
@@ -642,16 +761,18 @@
<example>
<title>Laatste dag van volgende maand</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>
- Date waarbij year, month en day gelijk zijn aan nul wordt als
+ Data waarbij year, month en day gelijk zijn aan nul worden als
ongeldig beschouwd.
</simpara>
<para>
@@ -677,11 +798,11 @@
</parameter></methodparam>
</methodsynopsis>
<para>
- Retourneert een string geformatterd volgens de gegeven format
+ Retourneert een string geformatteerd volgens de gegeven format
string gebruikmakend van de gegeven <parameter>timestamp</parameter>
of de huidige lokale tijd als de timestamp niet is gegeven. Maand-
en weeknamen en andere taalafhankelijke strings respecteren de
- huidige locale die geset is met <function>setlocale</function>.
+ huidige locale die is ingesteld met <function>setlocale</function>.
</para>
<para>
De volgende conversie specifiers worden herkend in de format string:
@@ -734,6 +855,19 @@
voorafgegaan door een space (range ' 1' tot '31')
</simpara>
</listitem>
+ <listitem>
+ <simpara>
+ %g - zoals %G, maar zonder de eeuw.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ %G - Het viercijferige jaar dat correspondeert met het ISO
+ week nummer. Dit heeft hetzelfde formaat en waarde als %Y, alleen
+ als het ISO week nummer tot het vorige of volgende jaar behoort,
+ wordt dat jaar in plaats ervan gebruikt.
+ </simpara>
+ </listitem>
<listitem>
<simpara>
%h - hetzelfde als %b
@@ -807,7 +941,14 @@
%u - weekdag als een decimaal nummer [1,7], waar 1 de maandag
representeert.
</simpara>
- </listitem>
+ <warning>
+ <simpara>
+ Sun Solaris lijkt te beginnen met zondag als 1, hoewel
+ ISO 9889:1999 (de huidige C standaard) duidelijk
+ aangeeft dat het maandag moet zijn.
+ </simpara>
+ </warning>
+ </listitem>
<listitem>
<simpara>
%U - week nummer van het huidige jaar als een decimaal nummer,
@@ -819,7 +960,9 @@
%V - Het ISO 8601:1988 week nummer van het huidige jaar als een
decimaal nummer, range 01 tot 53, waar week 1 de eerste week is
die tenminste 4 dagen in het huidige jaar heeft, en met maandag
- als de eerste dag van de week.
+ als de eerste dag van de week. (Je kunt %G of %g of gebruiken om
+ het jaar te achterhalen dat correspondeert met het weeknummer voor
+ de gegeven timestamp.)
</simpara>
</listitem>
<listitem>
@@ -877,14 +1020,16 @@
<example>
<title><function>strftime</function> voorbeeld</title>
<programlisting role="php">
-setlocale ("LC_TIME", "C");
-print (strftime ("%A in Finnish is "));
-setlocale ("LC_TIME", "fi_FI");
-print (strftime ("%A, in French "));
-setlocale ("LC_TIME", "fr_CA");
-print (strftime ("%A and in German "));
-setlocale ("LC_TIME", "de_DE");
-print (strftime ("%A.\n"));
+<![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>
Dit voorbeeld werkt als je de respectievelijke locales hebt
@@ -902,7 +1047,7 @@
<refentry id="function.time">
<refnamediv>
<refname>time</refname>
- <refpurpose>geef de huidige UNIX timestamp</refpurpose>
+ <refpurpose>Geef de huidige UNIX timestamp</refpurpose>
</refnamediv>
<refsect1>
<title>Omschrijving</title>
