Date:: el Manip es unas rutinas de manipulación de fecha.

SINOPSIS

use la Fecha:: Manip;

$version = DateManipVersion;

$date = ParseDate (@args);
$date = ParseDate ($string);
$date = ParseDate ($string);

@date = UnixDate ($date, @format);
$date = UnixDate ($date, @format);

$delta = ParseDateDelta (@args);
$delta = ParseDateDelta ($string);
$delta = ParseDateDelta ($string);

@str = Delta_Format ($delta, $dec, @format);
$str = Delta_Format ($delta, $dec, @format);

$recur = ParseRecur ($string, $base, $date0, $date1, $flags);
@dates = ParseRecur ($string, $base, $date0, $date1, $flags);

$flag = Date_Cmp ($date1, $date2);

$d = DateCalc ($d1, $d2 [$errref] [$del]);

$date = Date_SetTime ($date, $hr, $min, $sec);
$date = Date_SetTime ($date, $time);

$date = Date_SetDateField ($date, $field, $val [$nocheck]);

$date = Date_GetPrev ($date, $dow, $today, $hr, $min, $sec);
$date = Date_GetPrev ($date, $dow, $today, $time);

$date = Date_GetNext ($date, $dow, $today, $hr, $min, $sec);
$date = Date_GetNext ($date, $dow, $today, $time);

$name = Date_IsHoliday ($date);

$listref = Events_List ($date);
$listref = Events_List ($date0, $date1);

$date = Date_ConvTZ ($date);
$date = Date_ConvTZ ($date, $from);
$date = Date_ConvTZ ($date,"", $to);
$date = Date_ConvTZ ($date, $from, $to);

$flag = Date_IsWorkDay ($date [$flag]);

$date = Date_NextWorkDay ($date, $off [$time]);

$date = Date_PrevWorkDay ($date, $off [$time]);

$date = Date_NearestWorkDay ($date [$tomorrowfirst]);

&Date_Init ();
&Date_Init ("VAR=VAL", "VAR=VAL"...);
@list = Date_Init ();
@list = Date_Init ("VAR=VAL", "VAR=VAL"...);

Las susodichas rutinas todo el control para asegurarse que Date_Init es llamado. Si esto hasnt sido, ellos lo llamarán automáticamente. Como consiguiente, no hay por lo general ninguna necesidad de llamar Date_Init explicitely a menos que usted quiera cambiar algunas variables config (descrito abajo). Ellos también hacen el error que verifica el insumo.

Las rutinas puestas en una lista abajo son queridas principalmente para el uso interno por otra Fecha:: Manip rutinas. Ellos hacen poca o ninguna comprobación de error, y no hacen explicitely llaman Date_Init. Aquellas funciones son todos hechas en la Fecha principal:: Manip rutinas encima.

Como ellos son considerablemente más rápidos que la Fecha llena:: Manip rutinas, ellos están disponibles para el uso con unas advertencias. Ya que poca o ninguna comprobación de error es hecha, es la responsabilidad del programador de asegurar que los datos válidos (y las fechas válidas) son pasados a ellos. El paso de datos inválidos (como un mes no numérico) o fechas inválidas (el 31 de febrero) fallará de modos imprevisibles (posiblemente devolviendo resultados erróneos). También, ya que Date_Init no es llamado por éstos, debe ser llamado explicitely por el programador antes de usar estas rutinas.

En las rutinas siguientes, el $y puede ser entrado como un 2 o como 4 año de dígito (será convertido a un 4 año de dígito basado en YYtoYYYY variable descrito abajo). El mes y el día deberían ser numéricos en todos los casos. La mayor parte (si no todos) de la información abajo puede ser conseguido de UnixDate que es realmente el modo que lo quise para ser conseguido, pero hay motivos de usar a éstos (éstos son considerablemente más rápidos).

$day = Date_DayOfWeek ($m, $d, $y);
$secs = Date_SecsSince1970 ($m, $d, $y, $h, $mn, $s);
$secs = Date_SecsSince1970GMT ($m, $d, $y, $h, $mn, $s);
$days = Date_DaysSince1BC ($m, $d, $y);
$day = Date_DayOfYear ($m, $d, $y);
($y, $m, $d, $h, $mn, $s) = Date_NthDayOfYear ($y, $n);
$days = Date_DaysInYear ($y);
$days = Date_DaysInMonth ($m, $y);
$wkno = Date_WeekOfYear ($m, $d, $y, $first);
$flag = Date_LeapYear ($y);
$day = Date_DaySuffix ($d);
$tz = Date_TimeZone ();