cvs: phpdoc /nl/functions datetime.xml
| From: | Dirkjan Ochtman | Date: | Mon, 25 Mar 2002 08:17:37 +0000 |
| Subject: | cvs: phpdoc /nl/functions datetime.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969343418@lists.php.net to get a copy of this message | ||
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>
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>