Dattel:: Manip ist Programme einer Dattelhandhabung.

SYNOPSE

Gebrauch Dattel:: 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“,…);

Die oben genannten Programme aller Check, zum zu überprüfen, ob Date_Init gerufen. Wenn es nicht gewesen, rufen sie es automatisch. Infolgedessen gibt es normalerweise keine Notwendigkeit, Date_Init ausdrücklich zu rufen, es sei denn Sie einige der Configvariablen ändern möchten (unten beschrieben). Sie tun auch die Fehlerprüfung auf dem Input.

Die Programme, die nachstehend aufgeführt, bestimmt Haupt- für internen Gebrauch bis zu anderer Dattel:: Manip Programme. Sie tun wenig oder keine Fehlerprüfung und nicht ausdrücklich rufen Date_Init. Jene Funktionen alle erfolgt in der Hauptdattel:: Manip Programme oben.

Weil sie beträchtlich schneller als sind, datieren die vollen:: Manip Programme, sind sie für Gebrauch mit einigen Einsprüchen erhältlich. Da wenig oder keine Fehlerprüfung erfolgt, ist es die Verantwortlichkeit des Programmierers, zu garantieren, dass gültige Daten (UND gültige Datteln) ihnen überschritten. Das Überschreiten der unzulässigen Daten (wie ein nicht numerischer Monat) oder der unzulässigen Datteln (31. Februar) ausfällt auf unvorhersehbare Arten sz (vielleicht zurückgehende falsche Resultate). Vor der Anwendung dieser Programme auch da Date_Init nicht durch diese gerufen, muß es vom Programmierer ausdrücklich gerufen werden.

In den folgenden Programmen kann $y als Jahr mit 2 oder 4 Digits (es konvertiert in ein Jahr mit 4 Digits, das auf dem variablen unten beschriebenen YYtoYYYY basiert) eingeführt werden entweder. Monat und Tag sollten in allen Fällen numerisch sein. Die meisten (wenn nicht alle) der Informationen unten können von UnixDate erhalten werden, das wirklich die Methode ist, die, ich erhalten zu werden beabsichtigte sie, aber es gibt Gründe, diese zu verwenden (diese sind beträchtlich schneller).

$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 ();