Zaman aralığını biçimler

Açıklama

public string DateInterval::format ( string $biçem )

Zaman aralığını biçimlendirir.

Değiştirgeler

biçem

*`biçem`* dizgesinde tanınan karakterler aşağıda listelenmiştir. Her biçem karakterinin başına bir yüzde (%) işareti konmalıdır.
Karakter	Açıklama	Örnek değerler
%	% iminin kendisi	%
Y	Başına 0 getirilerek iki haneli yıl	01, 03
y	0 ile öncelenmeksizin yıl	1, 3
M	Başına 0 getirilerek iki haneli ay	01, 03, 12
m	0 ile öncelenmeksizin ay	1, 3, 12
D	Başına 0 getirilerek iki haneli ayın günü	01, 03, 31
d	0 ile öncelenmeksizin ayın günü	1, 3, 31
a	Toplam gün sayısı	4, 18, 8123
H	Başına 0 getirilerek iki haneli saat	01, 03, 23
h	0 ile öncelenmeksizin saat	1, 3, 23
I	Başına 0 getirilerek iki haneli dakika	01, 03, 59
i	0 ile öncelenmeksizin dakika	1, 3, 59
S	Başına 0 getirilerek iki haneli saniye	01, 03, 57
s	0 ile öncelenmeksizin saniye	1, 3, 57
R	Negatifse "-", pozitifse "+" imi	-, +
r	Negatifse "-", pozitifse boş dizge	-,

Dönen Değerler

Biçimlendirilmiş zaman aralığını bir dizge olarak döndürür.

Notlar

Bilginize:
DateInterval::format() yöntemi ne zaman dizgelerinde ne de tarih bölümlerinde tehir edilen kısımları yeniden hesaplar. Bunun sebebi "32 gün" gibi büyük değerlerin olanaksız oluşudur. Olanaklı olsaydı böyle bir değer "1 ay 4 gün" ile "1 ay 1 gün" arasında bir değer olarak yorumlanabilirdi.

Örnekler

Örnek 1 - DateInterval örneği


<?php

$interval = new DateInterval('P2Y4DT6H8M');
echo $interval->format('%d gün');

?>

Yukarıdaki örneğin çıktısı:

4 gün

Örnek 2 - DateInterval ve büyük değerler


<?php

$interval = new DateInterval('P32D');
echo $interval->format('%d gün');

?>

Yukarıdaki örneğin çıktısı:

32 gün

Örnek 3 - DateInterval ve DateTime::diff() ile %a ve %d değiştiricileri


<?php

$january = new DateTime('2010-01-01');
$february = new DateTime('2010-02-01');
$interval = $february->diff($january);

// %a toplam gün sayısını çıktılar.
echo $interval->format('toplam %a gün')."\n";

// %d ise aya dahil olmayan gün sayısını çıktılar.
echo $interval->format('%m ay, %d gün');

?>

Yukarıdaki örneğin çıktısı:

toplam 31 gün
1 ay, 0 gün