date_parse

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

date_parse ā€” Verilen tarih/zaman hakkındaki ayrıntılı bilgiyi ilişkisel dizi olarak dƶndĆ¼rĆ¼r

AƧıklama

function date_parse(string $tarihzaman): array

date_parse() belirtilen tarihzaman dizgesini strtotime() ve DateTimeImmutable::__construct()'ın bağlı olduğu kurallara uygun olarak ƧƶzĆ¼mler. Bir zaman damgası (strtotime() ile) veya DateTimeImmutable nesnesi (DateTimeImmutable::__construct() ile) dƶndĆ¼rmek yerine, belirtilen tarihzaman dizgesinden saptanan bilgiyi iƧeren bir ilişkisel dizi dƶndĆ¼rĆ¼r.

Belli Ć¶ÄŸelerle ilgili bilgi yoksa, ya bu dizi elemanlarına false atanır ya da elemanlar dizide yer almaz. Bir zaman damgası veya DateTimeImmutable nesnesi oluşturmak iƧin gerekliyse bazı alanlara false'tan farklı değerler atanabilir. Bunun olduğu durumlar aşağıda ƶrneklenmiştir.

Bağımsız Değişkenler

tarihzaman

DateTimeImmutable::__construct() işlevi tarafından kabul edilen biƧimde tarih/zaman.

Dƶnen Değerler

Başarılı olduğunda ƧƶzĆ¼mlenen tarih/zaman bilgilerini iƧeren diziyle dƶner.

Dƶnen dizinin anahtarları: year, month, day, hour, minute, second, fraction ve is_localtime.

is_localtime mevcutsazone_type zaman dilimi tĆ¼rĆ¼nĆ¼ betimler. 1. tĆ¼r (UTC farkı) iƧin zone, is_dst alanları eklendi; 2. tĆ¼r (kısaltma) iƧin tz_abbr, is_dst alanları eklendi; ve 3.tĆ¼r (zaman dilimi betimleyici) iƧin tz_abbr, tz_id alanları eklendi.

tarihzaman dizgesi iƧinde, +3 days (+3 gĆ¼n) gibi gƶreli zaman elemanları mevcutsa, dƶnen dizi relative anahtarlı gƶmĆ¼lĆ¼ bir dizi iƧerir. Bu dizinin anahtarları year, month, day, hour, minute, second ve gerekiyorsa weekday ve weekdays olup değerleri aktarılan dizgeye bağlıdır.

Dizi warning_count ve warnings alanlarını iƧerir. Ä°lki, gelen uyarı sayısıdır. warnings dizisinin anahtarları uyarının kendisini aƧıklayan dizge değerini ve verilen tarihzaman iƧinde uyarının oluştuğu konumu betimler.

Dizi ayrıca, error_count ve errors alanlarını da iƧerir. Ä°lki bulunan hata sayısıdır. errors dizisinin anahtarları hatanın kendini aƧıklayan dizge değerini ve verilen tarihzaman iƧinde hatanın oluştuğu konumu betimler.

Uyarı

warnings ve errors dizilerindeki eleman sayısı, ikisi de aynı konumda oluşmuşsa warning_count veya error_count değerlerinden kĆ¼Ć§Ć¼k olmalıdır.

Hatalar/Ä°stisnalar

Tarih biƧimi hatalı olduğu taktirde, dizinin 'errors' elemanı hata iletilerini iƧerecektir.

SĆ¼rĆ¼m Bilgisi

SĆ¼rĆ¼m: AƧıklama
7.2.0 Dƶnen dizinin zone elemeanı artık dakika yerine saniye sayısını gƶsteriyor, ayrıca işareti ters Ƨevrildi. Ɩrneğin, -120 yerine şimdi 7200 dƶnĆ¼yor.

Ɩrnekler

Ɩrnek 1 - Kapsamlı bir tarihzaman dizgesi ile date_parse() ƶrneği

<?php
var_dump(date_parse("2006-12-12 10:00:00.5"));
?>

Yukarıdaki ƶrneğin Ƨıktısı:

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)
}

Zaman dilimi elemanları yalnızca tarihzaman dizgesinde belirtilmişse dizide bulunur. Bƶyle bir durumda dizi daima zone_type elemanını ve bununla ilgili bir kaƧ elemanı daha iƧerecekir.

Ɩrnek 2 - Zaman dilimi kısaltması iƧeren date_parse() ƶrneği

<?php
var_dump(date_parse("Mon, 29 Oct 1923 20:30:00 +0200"));
?>

Yukarıdaki ƶrneğin Ƨıktısı:

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"
}

Ɩrnek 3 - Zaman dilimi belirteci ile date_parse() ƶrneği

<?php
var_dump(date_parse("June 2nd, 2022, 10:28:17 Europe/London"));
?>

Yukarıdaki ƶrneğin Ƨıktısı:

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"
}

Daha kısa bir tarihzaman dizgesi ile daha az bilgi elde edilir. Bu ƶrnekte, tĆ¼m zaman parƧaları iƧin false dƶnmektedir.

Ɩrnek 4 - Kısa bir dizge ile date_parse() ƶrneği

<?php
var_dump(date_parse("June 2nd, 2022"));
?>

Yukarıdaki ƶrneğin Ƨıktısı:

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)
}

Gƶreli biƧimler "relative" Ć¶ÄŸeye ayrıştırılır ve mutlak biƧimlerden ayrıştırılan değerleri etkilemez.

Ɩrnek 5 - Gƶreli biƧimlerle date_parse() ƶrneği

<?php
var_dump(date_parse("2006-12-12 10:00:00.5 +1 week +1 hour"));
?>

Yukarıdaki ƶrneğin Ƨıktısı:

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)
}

Thursday gibi uyaklı parƧalar iƧin, dizgenin zaman bƶlĆ¼mĆ¼ne 0 atanır. Thursday, DateTimeImmutable::__construct()) işlevine aktarılsaydı, bu ayrıca, 'hour', 'minute', 'second' ve 'fraction' Ć¶ÄŸelerine de 0 atanmasıyla sonuƧlanırdı. Aşağıdaki ƶrnekte, 'year' Ć¶ÄŸesi false olarak bırakılmıştır.

Ɩrnek 6 - Yan etkili date_parse() ƶrneği

<?php
var_dump(date_parse("Thursday, June 2nd"));
?>

Yukarıdaki ƶrneğin Ƨıktısı:

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)
  }
}

Ayrıca Bakınız

  • date_parse_from_format() - Belirtildiği gibi biƧimlendirilmiş olarak tarih hakkında bilgi verir (Belirli biƧemlerin tarihzaman dizgesinden ayrıştırılması iƧin)
  • checkdate() - Miladi tarihi doğrular (Gregoryen tarih doğrulaması iƧin)
  • getdate() - Tarih/zaman bilgisi getirir

Found A Problem?

Learn How To Improve This Page ā€¢ Submit a Pull Request ā€¢ Report a Bug
ļ¼‹add a note

User Contributed Notes

There are no user contributed notes for this page.