A warning to others. Some keys will return with a default value where others will return as false if the date string has it omitted. Unsure if this is a bug or feature, but hopefully this will save someone some time.
<?php
///Example
$input = "Feb 2010";
$info = date_parse($input);
var_dump($info);
/*Returns:
array(12) {
["year"]=> int(2010)
["month"]=> int(2)
["day"]=> int(1) //<---expected false like below
["hour"]=> bool(false)
["minute"]=> bool(false)
["second"]=> bool(false)
["fraction"]=> bool(false)
["warning_count"]=> int(0)
["warnings"]=> array(0) { }
["error_count"]=> int(0)
["errors"]=> array(0) { }
["is_localtime"]=> bool(false)
}*/
?>
date_parse
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
date_parse — Liefert ein assoziatives Array mit detaillierten Informationen zu einem gegebenen Datum/Zeitpunkt
Beschreibung
date_parse() wertet die angegebene Zeichenkette
datetime nach den gleichen Regeln aus wie
strtotime() und
DateTimeImmutable::__construct(). Anstelle eines
Unix-Zeitstempels (mit strtotime()) oder eines
DateTimeImmutable-Objekts (mit
DateTimeImmutable::__construct()) gibt diese Funktion
ein assoziatives Array mit den Informationen zurück, die sie aus dem
angegebenen datetime ermitteln konnte.
Wenn über eine bestimmte Gruppe von Elementen keine Informationen gefunden
werden können, werden diese Array-Elemente auf false gesetzt oder sie
fehlen. Wenn sie benötigt werden, um einen Zeitstempel oder ein
DateTimeImmutable-Objekt aus dieser
datetime-Zeichenkette zu konstruieren, können
mehrere Felder auf einen anderen Wert als false gesetzt werden. Die
Beispiele zeigen, wo dies der Fall ist.
Parameter-Liste
-
datetime -
Datum und Uhrzeit in einem Format, das von DateTimeImmutable::__construct() akzeptiert wird.
Rückgabewerte
Gibt ein Array mit Informationen zu Datum und Uhrzeit zurück.
Das zurückgegebene Array hat Schlüssel für year,
month, day, hour,
minute, second,
fraction und is_localtime.
Wenn is_localtime angegeben ist, gibt
zone_type den Typ der Zeitzone an. Für Typ
1 (UTC-Offset) werden die Felder zone
und is_dst hinzugefügt; für Typ 2
(Zeitzonen-Abkürzung) werden die Felder tz_abbr und
is_dst hinzugefügt; und für Typ 3
(Zeitzonen-Kennung) werden die Felder tz_abbr und
tz_id hinzugefügt.
Wenn relative Zeitelemente in der Zeichenkette
datetime vorhanden sind, z. B.
+3 days, dann enthält das zurückgegebene Array ein
untergeordnetes Array mit dem Schlüssel relative. Dieses
Array enthält dann die Schlüssel year,
month, day, hour,
minute, second und, abhängig von der
übergebenen Zeichenkette, weekday und
weekdays.
Das Array enthält die Felder warning_count und
warnings. Das erste gibt an, wie viele Warnungen es gab.
Die Schlüssel des Arrays warnings geben die Positionen
im angegebenen datetime an, an denen die Warnungen
aufgetreten sind, während die Werte die Warnungen selbst beschreiben.
Das Array enthält auch die Felder error_count und
errors. Das erste Feld gibt an, wie viele Fehler
gefunden wurden. Die Schlüssel des Arrays errors geben
die Positionen im angegebenen datetime an, an denen
die Fehler aufgetreten sind, während die Werte die Fehler selbst
beschreiben.
Warnung
Die Anzahl der Array-Elemente in den Arrays warnings
und errors kann kleiner sein als
warning_count oder error_count, wenn
die Warnungen bzw. Fehler an derselben Stelle aufgetreten sind.
Fehler/Exceptions
Falls das Datums-/Zeitformat fehlerhaft ist, enthält das Element 'errors' die Fehlermeldungen.
Changelog
| Version | Beschreibung |
|---|---|
| 7.2.0 |
Das Element zone des zurückgegebenen Arrays stellt
nun Sekunden statt Minuten dar und das Vorzeichen ist umgekehrt. Zum
Beispiel wird aus -120 nun 7200.
|
Beispiele
Beispiel #1
Ein date_parse()-Beispiel mit einer vollständigen
datetime-Zeichenkette
<?php
var_dump(date_parse("2006-12-12 10:00:00.5"));
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
array(12) {
["year"]=>
int(2006)
["month"]=>
int(12)
["day"]=>
int(12)
["hour"]=>
int(10)
["minute"]=>
int(0)
["second"]=>
int(0)
["fraction"]=>
float(0.5)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(false)
}
Die Zeitzonen-Elemente werden nur angezeigt, wenn sie in der angegebenen
datetime-Zeichenkette enthalten sind. In diesem Fall
gibt es immer ein Element zone_type und ein paar andere,
die von seinem Wert abhängen.
Beispiel #2 date_parse() mit Zeitzonenkürzel
<?php
var_dump(date_parse("June 2nd, 2022, 10:28:17 BST"));
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
array(16) {
["year"]=>
int(2022)
["month"]=>
int(6)
["day"]=>
int(2)
["hour"]=>
int(10)
["minute"]=>
int(28)
["second"]=>
int(17)
["fraction"]=>
float(0)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(true)
["zone_type"]=>
int(2)
["zone"]=>
int(0)
["is_dst"]=>
bool(true)
["tz_abbr"]=>
string(3) "BST"
}
Beispiel #3 date_parse() mit Zeitzonenkennung
<?php
var_dump(date_parse("June 2nd, 2022, 10:28:17 Europe/London"));
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
array(14) {
["year"]=>
int(2022)
["month"]=>
int(6)
["day"]=>
int(2)
["hour"]=>
int(10)
["minute"]=>
int(28)
["second"]=>
int(17)
["fraction"]=>
float(0)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(true)
["zone_type"]=>
int(3)
["tz_id"]=>
string(13) "Europe/London"
}
Wenn eine kürzere datetime-Zeichenkette ausgewertet
wird, stehen weniger Informationen zur Verfügung. In diesem Beispiel werden
alle Bestandteile der Uhrzeit als false zurückgegeben.
Beispiel #4 date_parse() mit einer minimalen Zeichenkette
<?php
var_dump(date_parse("June 2nd, 2022"));
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
array(12) {
["year"]=>
int(2022)
["month"]=>
int(6)
["day"]=>
int(2)
["hour"]=>
bool(false)
["minute"]=>
bool(false)
["second"]=>
bool(false)
["fraction"]=>
bool(false)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(false)
}
Relative Formate haben keinen Einfluss auf die Werte, die aus absoluten Formaten gewonnen werden, sondern werden in das Element "relativ" eingefügt.
Beispiel #5 date_parse() mit relativen Formaten
<?php
var_dump(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour"));
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
array(13) {
["year"]=>
int(2006)
["month"]=>
int(12)
["day"]=>
int(12)
["hour"]=>
int(10)
["minute"]=>
int(0)
["second"]=>
int(0)
["fraction"]=>
float(0.5)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(false)
["relative"]=>
array(6) {
["year"]=>
int(0)
["month"]=>
int(0)
["day"]=>
int(7)
["hour"]=>
int(1)
["minute"]=>
int(0)
["second"]=>
int(0)
}
}
Einige Textbausteine, z. B. Thursday, setzen den
Zeitanteil der Zeichenkette auf 0. Wenn
Thursday an
DateTimeImmutable::__construct() übergeben wird, führt
dies ebenfalls dazu, dass hour, minute, second und fraction auf
0 gesetzt werden. Im folgenden Beispiel wird das
Element year jedoch auf false belassen.
Beispiel #6 date_parse() mit Nebeneffekten
<?php
var_dump(date_parse("Thursday, June 2nd"));
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
array(13) {
["year"]=>
bool(false)
["month"]=>
int(6)
["day"]=>
int(2)
["hour"]=>
int(0)
["minute"]=>
int(0)
["second"]=>
int(0)
["fraction"]=>
float(0)
["warning_count"]=>
int(0)
["warnings"]=>
array(0) {
}
["error_count"]=>
int(0)
["errors"]=>
array(0) {
}
["is_localtime"]=>
bool(false)
["relative"]=>
array(7) {
["year"]=>
int(0)
["month"]=>
int(0)
["day"]=>
int(0)
["hour"]=>
int(0)
["minute"]=>
int(0)
["second"]=>
int(0)
["weekday"]=>
int(4)
}
}
Siehe auch
- date_parse_from_format() - Ermittelt Informationen über das angegebene Datum anhand des angegebenen Formats - Ermittelt Informationen über das angegebene Datum anhand des angegebenen Formats
- checkdate() - Prüft ein Gregorianisches Datum auf Gültigkeit für die Überprüfung eines gregorianischen Datums
- getdate() - Liefert Datums- und Zeitinformationen
add a note
User Contributed Notes 11 notes
admin at torntech dot com ¶
14 years ago
alvaro at demogracia dot com ¶
13 years ago
Be aware that date_parse() is happy with just a time zone and it can be pretty counter-intuitive. E.g.:
<?php
var_dump( date_parse('Europe/Madrid') );
?>
... prints an array where year, month, day... are FALSE. But so do these:
<?php
var_dump( date_parse('A') );
var_dump( date_parse('B') );
var_dump( date_parse('X') );
?>
Don't forget to further validate date_parse()'s output even when it isn't FALSE and the 'errors' key is empty.
thisismelennart dot borgman at gmail dot com ¶
10 years ago
Here is a workaround for the "Feb 2010" problem. It also handles "2014".
http://stackoverflow.com/questions/27052374/php-date-parsefeb-2010-gives-day-1/27068409
edg at greenberg dot org ¶
6 years ago
Passing "YYYY-MM" results in a valid date. Be careful to validate that your submitted date passed YOUR requirements.
paul at juniperwebcraft dot com ¶
7 years ago
It's sometimes useful to be able to store incomplete dates, for example when all you know of someone's birthdate is the year or the month and day.
date_parse() handles (and MySQL accepts) dates containing zero-value elements such as "2017-00-00" and "0000-03-29", leaving it up to the parent application to determine when to require and how to handle missing date elements. date_parse() correctly reports zero values for zero-value date elements, reports an 'invalid date' warning, and does not report an error.
Example 1: Year only
<?php print_r( date_parse( '2017-00-00' ) );?>
generates:
<?php
Array
(
[year] => 2017
[month] => 0
[day] => 0
[hour] =>
[minute] =>
[second] =>
[fraction] =>
[warning_count] => 1
[warnings] => Array
(
[11] => The parsed date was invalid
)
[error_count] => 0
[errors] => Array
(
)
[is_localtime] =>
)
?>
Example 2: Month and day only
<?php print_r( date_parse( '0000-03-29' ) )?>
generates:
<?php
Array
(
[year] => 0
[month] => 3
[day] => 29
[hour] =>
[minute] =>
[second] =>
[fraction] =>
[warning_count] => 1
[warnings] => Array
(
[11] => The parsed date was invalid
)
[error_count] => 0
[errors] => Array
(
)
[is_localtime] =>
)
?>
However, simply omitting date elements gives PHP too much discretion in second-guessing our intentions:
Example 3: Truncated date:
<?php print_r( date_parse( '2017-03' ) )?>
generates:
<?php
Array
(
[year] => 2017
[month] => 3
[day] => 1
[hour] =>
[minute] =>
[second] =>
[fraction] =>
[warning_count] => 0
[warnings] => Array
(
)
[error_count] => 0
[errors] => Array
(
)
[is_localtime] =>
)?>
In this case, PHP supplies a day value of 1 and does not report a warning.
Similarly, this feature of accepting zero date elements does not carry over to timestamps:
<?php $dDate = strtotime( '2017-03-00' );
print_r( getdate( $dDate ) ); ?>
displays:
<?php Array
(
[seconds] => 0
[minutes] => 0
[hours] => 0
[mday] => 28
[wday] => 2
[mon] => 2
[year] => 2017
[yday] => 58
[weekday] => Tuesday
[month] => February
[0] => 1488268800
)
?>
In this case, PHP interprets the "zeroth" day of March to be the last day of February.
y dot adounis at gmail dot com ¶
4 years ago
Developers, be aware that using "now" will return an empty array, ex :
<?php
date_parse("now");
?>
Will return :
Array
(
[year] =>
[month] =>
[day] =>
[hour] =>
[minute] =>
[second] =>
[fraction] =>
[warning_count] => 0
[warnings] => Array
(
)
[error_count] => 0
[errors] => Array
(
)
[is_localtime] =>
)
ryan_a_martin at yahoo dot com ¶
13 years ago
See checkdate() at http://php.net/manual/en/function.checkdate.php for Gregorian date validation.
gpayne at galenaparkisd com ¶
17 years ago
Careful - date_parse is perfectly happy with something like this:
date_parse("2006-2-31");
adamm at extratech dot com ¶
12 years ago
A warning to some
<?php
$time = "00:14:38"
$parse_date = date_parse($time);
echo var_dump($parse_date) ."<br>";
//here you will get what you expect
$time = "-00:14:38"
$parse_date = date_parse($time);
echo var_dump($parse_date) ."<br>";
//here you will recieve hours minutes and seconds as booleans and as false and you will get error set to "Unexpected character"
$time = "00:-14:38"
$parse_date = date_parse($time);
echo var_dump($parse_date) ."<br>";
//here you will recieve the same as the above
$time = "00:14:-38"
$parse_date = date_parse($time);
echo var_dump($parse_date) ."<br>";
//here you will receive hours as 00 minutes as 14 and seconds as 0. The error will get set as the same as above. Meaning "Unexpected character"
?>
alan at wilcoxengineering dot com ¶
15 years ago
Caution: date_parse expects months 1..12 only.
date_parse("13/1/5769") for month=13, Ehul in Jewish calendar, results in month==3 instead of month==13.
It does, however, report the error array showing "Unexpected Character."
It would be nice if date_parse could handle the months properly (just report back a "13" for the month). The older approach of substr() is my workaround.
eugene at ultimatecms dot co dot za ¶
14 years ago
<?php
$ida = '091122671325';
$idb = '091123671325';
// This function will match the identity number up to the day, but only for a maximum of 99years+364days.
// Will not work when checking persons older than 100years-1day.
function idtodate($id)
{
$year = date("Y");
$month = date("m");
$day = date("d");
$nc = substr($year, 0, 2);
$ny = substr($year, 2, 2);
$y = substr($id, 0, 2);
$m = substr($id, 2, 2);
$d = substr($id, 4, 2);
if($y.$m.$d <= $ny.$month.$day-1) {
$newc = $nc;
} else {
$newc = $nc-1;
}
$new = $newc.$y;
return array('year' => $new, 'month' => $m, 'day' => $d);
}
echo 'ID: '.$ida.'<br>';
print_r(idtodate($ida));
echo '<br><br>';
echo 'ID: '.$idb.'<br>';
print_r(idtodate($idb));
?>
Output:
1. If the year-month-day is smaller than today (2009-11-23), but bigger than 1999: year => 2009
ID: 091122671325
Array ( [year] => 2009 [month] => 11 [day] => 22 )
2. If the year-month-day is the same as, or bigger than today, but smaller than 2000: year => 1909
ID: 091123671325
Array ( [year] => 1909 [month] => 11 [day] => 23 )
