Things to be aware of when using week numbers with years.
<?php
echo date("YW", strtotime("2011-01-07")); // gives 201101
echo date("YW", strtotime("2011-12-31")); // gives 201152
echo date("YW", strtotime("2011-01-01")); // gives 201152 too
?>
BUT
<?php
echo date("oW", strtotime("2011-01-07")); // gives 201101
echo date("oW", strtotime("2011-12-31")); // gives 201152
echo date("oW", strtotime("2011-01-01")); // gives 201052 (Year is different than previous example)
?>
Reason:
Y is year from the date
o is ISO-8601 year number
W is ISO-8601 week number of year
Conclusion:
if using 'W' for the week number use 'o' for the year.
date
(PHP 4, PHP 5)
date — Formatează o oră/dată
Descrierea
Întoarce un string formatat în conformitate cu string-ul de formatare dat, utilizând timestamp-ul întreg dat, sau data și ora curentă dacă nu este furnizat nici un timestamp. Cu alte cuvinte, timestamp este opțional și implicit are valoarea întoarsă de time().
Parametri
- format
-
Reprezintă formatul string-ului din care se obține data la ieșire. Vedeți opțiunile de formatare de mai jos. Există de asemenea și câteva constante predefinite ale datelor ce pot fi utilizate în loc, deci spre exemplu DATE_RSS conține șirul de formatare 'D, d M Y H:i:s'.
Următoarele caractere sunt recunoscute în parametrul format Caracterul de format Descriere Exemple de valori întoarse Ziua --- --- d Ziua lunii, 2 cifre cu zero la început De la 01 până la 31 D Reprezentarea textuală a zilei în limba engleză, trei litere De la Mon până la Sun j Ziua lunii fără zero la început De la 1 până la 31 l (litera minusculă 'L') Reprezentarea textuală deplină a zilei săptămânii în limba engleză De la Sunday până la Saturday N Reprezentarea numerică a zilei săptămânii conform standardului ISO-8601 (adăugat în PHP 5.1.0) De la 1 (pentru Luni) până la 7 (pentru Duminică) S Sufixul ordinal al zilei din lună în limba engleză, 2 caractere st, nd, rd sau th. Funcționează bine cu j w Reprezentarea numerică a zilei săptămânii De la 0 (pentru Duminică) până la 6 (pentru Sâmbătă) z Ziua anului (începând de la 0) De la 0 până la 365 Săptămâna --- --- W Numărul săptămânii în an conform standardului ISO-8601, săptămânile încep Luni (adăugat în PHP 4.1.0) Exemplu: 42 (a 42-a săptămână a anului) Luna --- --- F Reprezentarea textuală deplină a lunii în limba engleză De la January până la December m Reprezentarea numerică a lunii, cu zero la început De la 01 până la 12 M Reprezentarea textuală prescurtată a lunii în limba engleză, trei litere De la Jan până la Dec n Reprezentarea numerică a lunii, fără zero la început De la 1 până la 12 t Numărul de zile în luna dată De la 28 până la 31 Anul --- --- L Indică dacă anul este bisect 1 dacă anul este bisect, 0 în caz contrar. o Reprezentarea numerică a anului conform standardului ISO-8601. Aceasta are aceeași valoare ca și Y, cu excepția că dacă numărul săptămânii după ISO (W) aparține anului precedent sau următor, acel an este considerat în loc. (adăugat în PHP 5.1.0) Exemple: 1999 sau 2003 Y Reprezentarea numerică deplină a anului, 4 cifre Exemple: 1999 sau 2003 y Reprezentarea din două cifre a anului Exemple: 99 sau 03 Ora --- --- a Ante meridiem sau Post meridiem cu litere minuscule am sau pm A Ante meridiem sau Post meridiem cu litere majuscule AM sau PM B Ora Swatch Internet De la 000 până la 999 g Reprezentarea orei în format de 12 ore, fără zero la început De la 1 până la 12 G Reprezentarea orei în format de 24 ore, fără zero la început De la 0 până la 23 h Reprezentarea orei în format de 12 ore, cu zero la început De la 01 până la 12 H Reprezentarea orei în format de 24 ore, cu zero la început De la 00 până la 23 i Minutele cu zero la început De la 00 până la 59 s Secundele cu zero la început De la 00 până la 59 u Microsecundele (adăugat în PHP 5.2.2) Exemplu: 654321 Fusul orar --- --- e Identificatorul fusului orar (adăugat în PHP 5.1.0) Exemple: UTC, GMT, Atlantic/Azores I (litera majusculă i) Determină dacă este activ timpul de vară 1 dacă este activ timpul de vară, 0 în caz contrar. O Diferența față de ora Greenwich (GMT) în ore Exemplu: +0200 P Diferența față de ora Greenwich (GMT) cu două puncte între ore și minute (adăugat în PHP 5.1.3) Exemplu: +02:00 T Abreviatura fusului orar Exemple: EST, MDT ... Z Deplasamentul în secunde a fusului orar. Deplasamentul fuselor orare dinspre Vest de UTC este întotdeauna negativ, iar a celor dinspre Est de UTC este întotdeauna pozitiv. De la -43200 până la 50400 Data/Ora deplină --- --- c Data în reprezentare ISO 8601 (adăugată în PHP 5) 2004-02-12T15:19:21+00:00 r Data formatată conform » RFC 2822 Exemplu: Thu, 21 Dec 2000 16:01:07 +0200 U Secunde de la Epoca Unix (1 Ianuarie 1970 00:00:00 GMT) Vezi de asemenea time() Caracterele nerecunoscute din string-ul de formatare vor fi afișate așa cum sunt. Formatul Z întotdeauna va întoarce 0 la utilizarea gmdate().
Notă:
Deoarece această funcție acceptă doar timestamp-uri integer, caracterul de formatare u este util doar când se utilizează funcția date_format() cu timestamp-uri ale utilizatorului create cu date_create().
- timestamp
-
Parametrul opțional timestamp este un integer și este un moment de timp Unix și are valoarea implicită a orei locale, dacă parametrul timestamp nu este indicat. Cu alte cuvinte, valoarea implicită este cea a funcției time().
Valorile întoarse
Întoarce un string cu dată formatat. Dacă este utilizată o valoare non-numerică pentru timestamp, este întors FALSE și este emisă o eroare de nivel E_WARNING.
Erori/Excepții
Fiecare apel al unei funcții de dată/oră va genera o E_NOTICE dacă zona orară nu este validă și/sau un mesaj E_STRICT sau E_WARNING dacă se utilizează setările sistemului sau variabila de mediu TZ. Vedeți de asemenea date_default_timezone_set()
Istoria schimbărilor
| Versiunea | Descriere |
|---|---|
| 5.1.0 | Domeniul valid al unui timestamp este de obicei de la Fri, 13 Dec 1901 20:45:54 GMT până la Tue, 19 Jan 2038 03:14:07 GMT. (Acestea sunt datele ce corespund valorilor minimă și maximă pentru un întreg cu semn pe 32 de biți). Însă înainte de PHP 5.1.0 acest domeniu era limitat de la 01-01-1970 până la 19-01-2038 pe unele sisteme (de ex. Windows). |
| 5.1.0 | Acum generează erori ale zonei orare de tip E_STRICT și E_NOTICE. |
| 5.1.1 | Există constante utile pentru formate standarde de date/ore, ce pot fi utilizate pentru a specifica parametrul format. |
Exemple
Example #1 Exemple date()
<?php
// Stabilește fusul orar implicit. Disponibil începând cu PHP 5.1
date_default_timezone_set('UTC');
// Afișează ceva de felul: Monday
echo date("l");
// Afișează ceva de felul: Monday 8th of August 2005 03:12:46 PM
echo date('l jS \of F Y h:i:s A');
// Afișează: July 1, 2000 is on a Saturday
echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000));
/* utilizarea constantelor în parametrul format */
// Afișează ceva de felul: Mon, 15 Aug 2005 15:12:46 UTC
echo date(DATE_RFC822);
// Afișează ceva de felul: 2000-07-01T00:00:00+00:00
echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000));
?>
Puteți preveni ca un caracter recunoscut în string-ul de formatare să fie expandat prin prefixarea lui cu un backslash. Dacă caracterul cu backslash de acum este o secvență specială, va trebui de asemenea să prefixați backslash-ul.
Example #2 Evadarea caracterelor în date()
<?php
// Afișează ceva de felul: Wednesday the 15th
echo date("l \\t\h\e jS");
?>
Este posibil de utilizat date() și mktime() împreună pentru a afla date din trecut sau viitor.
Example #3 Exemplu date() și mktime()
<?php
$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);
?>
Notă:
Aceasta poate fi mai sigur decât simpla adăugare sau scădere a numărului de secunde în zi sau lună la un timestamp din cauza timpului de vară.
Unele exemple de formatare date(). Observați că trebuie să evadați caracterele suplimentare, deoarece cele ce au o însemnătate specială vor produce rezultate nedorite, iar celelalte caractere pot căpăta o însemnătate specială în versiunile viitoare ale PHP. Când evadați, aveți grijă să utilizați ghilimele singulare pentru a preveni caractere ca \n să devină newline.
Example #4 Formatarea date()
<?php
// Presupunem că astăzi este: March 10th, 2001, 5:16:18 pm
// și ne aflăm în fusul orar Mountain Standard Time (MST)
$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'); // 05-16-18, 10-03-01, 1631 1618 6 Satpm01
$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 17:16:18 MST 2001
$today = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:18 m is month
$today = date("H:i:s"); // 17:16:18
?>
Pentru a formata date în alte limbi, trebuie să utilizați funcțiile setlocale() și strftime() în loc de date().
Note
Notă:
Pentru a genera un timestamp dintr-o reprezentare string a datei, puteți utiliza strtotime(). În plus, unele baze de date au funcții pentru a converti formatele lor de date în timestamp-uri (cum ar fi funcția » UNIX_TIMESTAMP la MySQL).
Timestamp-ul începutului interpelării este disponibil în variabila $_SERVER['REQUEST_TIME'] începând cu PHP 5.1.
Vedeți de asemenea
- gmdate() - Formatează o dată/oră GMT/UTC
- idate() - Format a local time/date as integer
- getdate() - Obține informația despre dată/oră
- getlastmod() - Gets time of last page modification
- mktime() - Obține timestamp-ul Unix pentru o dată și oră
- strftime() - Formatează o oră/dată locală în conformitate cu setările locale
- time() - Întoarce timpul curent Unix
- Constante DateTime predefinite
It was oblivious and discouraging that it dont mentioned in docs. If you will use W to get week number be aware:
first days of year can be in a week of previous year, and week number always has leading zero
<?php
echo date("YW", strtotime("2011-01-07")); // gives 201101
echo date("YW", strtotime("2011-01-01")); // gives 201152
echo date("YW", strtotime("2011-12-31")); // gives 201152 too
?>
so you can`t rely on number of week given from this function inside your program if you want to use it for some logic
Most spreadsheet programs have a rather nice little built-in function called NETWORKDAYS to calculate the number of business days (i.e. Monday-Friday, excluding holidays) between any two given dates. I couldn't find a simple way to do that in PHP, so I threw this together. It replicates the functionality of OpenOffice's NETWORKDAYS function - you give it a start date, an end date, and an array of any holidays you want skipped, and it'll tell you the number of business days (inclusive of the start and end days!) between them.
I've tested it pretty strenuously but date arithmetic is complicated and there's always the possibility I missed something, so please feel free to check my math.
The function could certainly be made much more powerful, to allow you to set different days to be ignored (e.g. "skip all Fridays and Saturdays but include Sundays") or to set up dates that should always be skipped (e.g. "skip July 4th in any year, skip the first Monday in September in any year"). But that's a project for another time.
<?php
function networkdays($s, $e, $holidays = array()) {
// If the start and end dates are given in the wrong order, flip them.
if ($s > $e)
return networkdays($e, $s, $holidays);
// Find the ISO-8601 day of the week for the two dates.
$sd = date("N", $s);
$ed = date("N", $e);
// Find the number of weeks between the dates.
$w = floor(($e - $s)/(86400*7)); # Divide the difference in the two times by seven days to get the number of weeks.
if ($ed >= $sd) { $w--; } # If the end date falls on the same day of the week or a later day of the week than the start date, subtract a week.
// Calculate net working days.
$nwd = max(6 - $sd, 0); # If the start day is Saturday or Sunday, add zero, otherewise add six minus the weekday number.
$nwd += min($ed, 5); # If the end day is Saturday or Sunday, add five, otherwise add the weekday number.
$nwd += $w * 5; # Add five days for each week in between.
// Iterate through the array of holidays. For each holiday between the start and end dates that isn't a Saturday or a Sunday, remove one day.
foreach ($holidays as $h) {
$h = strtotime($h);
if ($h > $s && $h < $e && date("N", $h) < 6)
$nwd--;
}
return $nwd;
}
$start = strtotime("1 January 2010");
$end = strtotime("13 December 2010");
// Add as many holidays as desired.
$holidays = array();
$holidays[] = "4 July 2010"; // Falls on a Sunday; doesn't affect count
$holidays[] = "6 September 2010"; // Falls on a Monday; reduces count by one
echo networkdays($start, $end, $holidays); // Returns 246
?>
Or, if you just want to know how many work days there are in any given year, here's a quick function for that one:
<?php
function workdaysinyear($y) {
$j1 = mktime(0,0,0,1,1,$y);
if (date("L", $j1)) {
if (date("N", $j1) == 6)
return 260;
elseif (date("N", $j1) == 5 or date("N", $j1) == 7)
return 261;
else
return 262;
}
else {
if (date("N", $j1) == 6 or date("N", $j1) == 7)
return 260;
else
return 261;
}
}
?>
If you want to use HTML5's <date> tag, the following code will generate the machine-readable value for the 'datetime' attribute:
<?php
/**
* formats the date passed into format required by 'datetime' attribute of <date> tag
* if no intDate supplied, uses current date.
* @param intDate integer optional
* @return string
**/
function getDateTimeValue( $intDate = null ) {
$strFormat = 'Y-m-d\TH:i:s.uP';
$strDate = $intDate ? date( $strFormat, $intDate ) : date( $strFormat ) ;
return $strDate;
}
echo getDateTimeValue();
?>
Not sure why this got ignored the first time, but this is an even simpler way to check leap year:
<?php
function isLeapYear($year)
{ return ((($year%4==0) && ($year%100)) || $year%400==0) ? (true):(false); }
?>
To actually make use ot the "u" (microsecond) you need to use the DateTime object and not the date() function.
For example
<?php
$t = microtime(true);
$micro = sprintf("%06d",($t - floor($t)) * 1000000);
$d = new DateTime( date('Y-m-d H:i:s.'.$micro,$t) );
print $d->format("Y-m-d H:i:s.u");
?>
In order to determine if a year is a leap year an earlier poster suggested simply checking to see if the year is a multiple of four:
<?php
function is_leapyear_broken($year = 2004) {
return ($year%4)==0;
}
?>
While this will work for the majority of years it will not work on years that are multiples of 100 but not multiples of 400 i.e.(2100).
A function not using php's date() function that will also account for this small anomaly in leap years:
<?php
function is_leapyear_working($year = 2004) {
if((($year%4==0) && ($year%100!=0)) || $year%400==0) {
return true;
}
return false;
}
?>
While is_leapyear_working will not return true for the few non-leap years divisible by four I couldn't tell you if this is more or less efficient than using php's date() as an even earlier poster suggested:
<?php
function is_leapyear($year = 2004) {
$is_leap = date('L', strtotime("$year-1-1"));
return $is_leap;
}
?>
Thanks to tcasparr at gmail dot com for the great idea (at least for me) ;)
I changed the code a little to replicate the functionality of date_parse_from_format, once I don't have PHP 5.3.0 yet. This might be useful for someone. Hope you don't mind changing your code tcasparr at gmail dot com.
<?php
/*******************************************************
* Simple function to take in a date format and return array of associated
* formats for each date element
*
* @return array
* @param string $strFormat
*
* Example: Y/m/d g:i:s becomes
* Array
* (
* [year] => Y
* [month] => m
* [day] => d
* [hour] => g
* [minute] => i
* [second] => s
* )
*
* This function is needed for PHP < 5.3.0
********************************************************/
function dateParseFromFormat($stFormat, $stData)
{
$aDataRet = array();
$aPieces = split('[:/.\ \-]', $stFormat);
$aDatePart = split('[:/.\ \-]', $stData);
foreach($aPieces as $key=>$chPiece)
{
switch ($chPiece)
{
case 'd':
case 'j':
$aDataRet['day'] = $aDatePart[$key];
break;
case 'F':
case 'M':
case 'm':
case 'n':
$aDataRet['month'] = $aDatePart[$key];
break;
case 'o':
case 'Y':
case 'y':
$aDataRet['year'] = $aDatePart[$key];
break;
case 'g':
case 'G':
case 'h':
case 'H':
$aDataRet['hour'] = $aDatePart[$key];
break;
case 'i':
$aDataRet['minute'] = $aDatePart[$key];
break;
case 's':
$aDataRet['second'] = $aDatePart[$key];
break;
}
}
return $aDataRet;
}
?>
Also, if you need to change the format of dates:
<?php
function changeDateFormat($stDate,$stFormatFrom,$stFormatTo)
{
// When PHP 5.3.0 becomes available to me
//$date = date_parse_from_format($stFormatFrom,$stDate);
//For now I use the function above
$date = dateParseFromFormat($stFormatFrom,$stDate);
return date($stFormatTo,mktime($date['hour'],
$date['minute'],
$date['second'],
$date['month'],
$date['day'],
$date['year']));
}
?>
date(DATE_RFC822) and date(DATE_RFC2822) both work. note that RFC 822 is obsoleted by RFC 2822. The main difference is the year being 08 in RFC 822 and is 2008 in RFC 2822.
To use date(DATE_RFC2822), a short form is date('r').
Correct format for a MySQL DATETIME column is
<?php $mysqltime = date ("Y-m-d H:i:s", $phptime); ?>
<?php
// A demonstration of the new DateTime class for those
// trying to use dates before 1970 or after 2038.
?>
<h2>PHP 2038 date bug demo (php version <?php echo phpversion(); ?>)</h1>
<div style='float:left;margin-right:3em;'>
<h3>OLD Buggy date()</h3>
<?php
$format='F j, Y';
for ( $i = 1900; $i < 2050; $i++) {
$datep = "$i-01-01";
?>
Trying: <?php echo $datep; ?> = <?php echo date($format, strtotime($datep)); ?><br>
<?php
}
?></div>
<div style='float:left;'>
<h3>NEW DateTime Class (v 5.2+)</h3><?php
for ( $i = 1900; $i < 2050; $i++) {
$datep = "$i-01-01";
$date = new DateTime($datep);
?>
Trying: <?php echo $datep; ?> = <?php echo $date->format($format); ?><br>
<?php
}
?></div>
Found this helpful when converting unix dates for use with the ical file format.
<?php
// Converts a unix timestamp to iCal format (UTC) - if no timezone is
// specified then it presumes the uStamp is already in UTC format.
// tzone must be in decimal such as 1hr 45mins would be 1.75, behind
// times should be represented as negative decimals 10hours behind
// would be -10
function unixToiCal($uStamp = 0, $tzone = 0.0) {
$uStampUTC = $uStamp + ($tzone * 3600);
$stamp = date("Ymd\THis\Z", $uStampUTC);
return $stamp;
}
?>
<?php
/**
* Checks wether a date is between an interval
*
* Usage:
*
* // check if today is older than 2008/12/31
* var_dump(currentDayIsInInterval('2008/12/31'));
* // check if today is younger than 2008/12/31
* var_dump(currentDayIsInInterval(null,'2008/12/31'));
* // check if today is between 2008/12/01 and 2008/12/31
* var_dump(currentDayIsInInterval('2008/12/01','2008/12/31'));
*
* Will trigger errors if date is in wrong format, notices if $begin > $end
*
* @param string $begin Date string as YYYY/mm/dd
* @param string $end Date string as YYYY/mm/dd
* @return bool
*/
function currentDayIsInInterval($begin = '',$end = '')
{
$preg_exp = '"[0-9][0-9][0-9][0-9]/[0-9][0-9]/[0-9][0-9]"';
$preg_error = 'Wrong parameter passed to function '.__FUNCTION__.' : Invalide date
format. Please use YYYY/mm/dd.';
$interval_error = 'First parameter in '.__FUNCTION__.' should be smaller than
second.';
if(empty($begin))
{
$begin = 0;
}
else
{
if(preg_match($preg_exp,$begin))
{
$begin = (int)str_replace('/','',$begin);
}
else
{
trigger_error($preg_error,E_USER_ERROR);
}
}
if(empty($end))
{
$end = 99999999;
}
else
{
if(preg_match($preg_exp,$end))
{
$end = (int)str_replace('/','',$end);
}
else
{
trigger_error($preg_error,E_USER_ERROR);
}
}
if($end < $begin)
{
trigger_error($interval_error,E_USER_WARNING);
}
$time = time();
$now = (int)(date('Y',$time).date('m',$time).date('j',$time));
if($now > $end or $now < $begin)
{
return false;
}
return true;
}
?>
date("W") returns the iso8601 week number, while date("Y") returns the _current_ year. This can lead to odd results. For example today (dec 31, 2007) it returns 1 for the week and of course 2007 for the year. This is not wrong in a strict sense because iso defines this week as the first of 2008 while we still have 2007.
So, if you don't have another way to safely retrieve the year according to the iso8061 week-date - strftime("%G") doesn't work on some systems -, you should be careful when working with date("W").
For most cases strftime("%W") should be a safe replacement.
[edit: Much easier is to use "o" (lower case O) instead of "Y"]
I've been flicking through the comments looking for some succinct date code and have noticed an alarming number of questions and over-burdened examples related to date mathematics. One of the most useful skills you can utilize when performing date math is taking full advantage of the UNIX timestamp. The UNIX timestamp was built for this kind of work.
An example of this relates to a comment made by james at bandit-dot-co-dot-en-zed. James was looking for a way to calculate the number of days which have passed since a certain date. Rather than using mktime() and a loop, James can subtract the current timestamp from the timestamp of the date in question and divide that by the number of seconds in a day:
<?php
$days = floor((time() - strtotime("01-Jan-2006"))/86400);
print("$days days have passed.\n");
?>
Another usage could find itself in a class submitted by Kyle M Hall which aids in the creation of timestamps from the recent past for use with MySQL. Rather than the looping and fine tuning of a date, Kyle can use the raw UNIX timestamps (this is untested code):
<?php
$ago = 14; // days
$timestamp = time() - ($ago * 86400);
?>
Hopefully these two examples of "UNIX-style" timestamp usage will help those finding date mathematics more elusive than it should be.
The following function will return the date (on the Gregorian calendar) for Orthodox Easter (Pascha). Note that incorrect results will be returned for years less than 1601 or greater than 2399. This is because the Julian calendar (from which the Easter date is calculated) deviates from the Gregorian by one day for each century-year that is NOT a leap-year, i.e. the century is divisible by 4 but not by 10. (In the old Julian reckoning, EVERY 4th year was a leap-year.)
This algorithm was first proposed by the mathematician/physicist Gauss. Its complexity derives from the fact that the calculation is based on a combination of solar and lunar calendars.
<?php
function getOrthodoxEaster($date){
/*
Takes any Gregorian date and returns the Gregorian
date of Orthodox Easter for that year.
*/
$year = date("Y", $date);
$r1 = $year % 19;
$r2 = $year % 4;
$r3 = $year % 7;
$ra = 19 * $r1 + 16;
$r4 = $ra % 30;
$rb = 2 * $r2 + 4 * $r3 + 6 * $r4;
$r5 = $rb % 7;
$rc = $r4 + $r5;
//Orthodox Easter for this year will fall $rc days after April 3
return strtotime("3 April $year + $rc days");
}
?>
