DateTime Klas

Die klas DateTime is die hoofinstrument vir die werk met datums en tye in OOP-styl. Dit laat jou toe om datum/tyd-objekte te skep, dit te wysig en die uitvoer te formateer.

Huidige oomblik van tyd

Kom ons skep 'n DateTime objek met die huidige datum en tyd:

<?php
	$date = new DateTime();
?>

Spesifieke datum

Kom ons skep 'n DateTime objek met 'n gespesifiseerde datum:

<?php
	$date = new DateTime('2025-12-31');
?>

Spesifieke datum en tyd

Kom ons skep 'n DateTime objek met 'n gespesifiseerde datum en tyd:

<?php
	$date = new DateTime('2025-12-31 12:59:59');
?>

Formatering van uitvoer

Die geskepte datum kan in 'n gegewe formaat uitgevoer word deur die format metode te gebruik. Kom ons doen dit vir die huidige oomblik van tyd:

<?php
	$date = new DateTime();
	echo $date->format('Y-m-d H:i:s');
?>

Resultaat (sal verander afhangende van die uitvoeringstyd):

'2025-11-15 14:25:00'

Formatering van 'n gegewe datum

Kom ons formateer 'n gegewe datum:

<?php
	$date = new DateTime('2025-12-31');
	echo $date->format('d.m.Y');
?>

Resultaat van kode-uitvoering:

'31.12.2025'

Byvoeging van 'n interval

Byvoeging van 'n interval by 'n datum geskied deur die add metode:

<?php
	$date = new DateTime('2025-05-15');
	$interval = new DateInterval('P10D'); // 10 dae
	$date->add($interval);
	echo $date->format('Y-m-d');
?>

Resultaat van kode-uitvoering:

'2025-05-25'

Aftrekking van 'n interval

Aftrekking van 'n interval van 'n datum geskied deur die sub metode:

<?php
	$date = new DateTime('2025-05-15');
	$interval = new DateInterval('P1M2D'); // 1 maand en 2 dae
	$date->sub($interval);
	echo $date->format('Y-m-d');
?>

Resultaat van kode-uitvoering:

'2025-04-13'

Stel van nuwe datum

Jy kan 'n nuwe datum instel vir die DateTime objek. Dit word gedoen deur die setDate metode:

<?php
	$date = new DateTime();
	$date->setDate(2025, 12, 31);
	echo $date->format('Y-m-d');
?>

Resultaat van kode-uitvoering:

'2025-12-31'

Stel van tyd

Jy kan 'n nuwe tyd instel vir die DateTime objek. Dit word gedoen deur die setTime metode:

<?php
	$date = new DateTime();
	$date->setTime(15, 30, 0);
	echo $date->format('H:i:s');
?>

Resultaat van kode-uitvoering:

'15:30:00'

Vergelyking van datums

Jy kan objekte met datums vergelyk:

<?php
	$date1 = new DateTime('2025-01-01');
	$date2 = new DateTime('2025-02-01');
	
	if ($date1 < $date2) {
		echo '+++';
	} else {
		echo '---';
	}
?>

Verskil tussen datums

Met die diff metode kan jy die verskil tussen datums bereken. Die verskil word teruggegee as 'n objek van DateInterval:

<?php
	$date1 = new DateTime('2023-01-01');
	$date2 = new DateTime('2023-02-15');
	
	$interval = $date1->diff($date2);
	echo $interval->format('%m maande %d dae');
?>

Resultaat van kode-uitvoering:

'1 maande 14 dae'

Tydsone

Wanneer jy 'n DateTime objek skep kan jy 'n tydsone spesifiseer:

<?php
	$timeZone = new DateTimeZone('Europe/Moscow');
	$date = new DateTime('2025-12-31 23:59:59', $timeZone);
	
	echo $date->format('Y-m-d H:i:s e');
?>

Resultaat van kode-uitvoering:

'2025-12-31 23:59:59 Europe/Moscow'

Sien ook

klas DateTimeImmutable,
wat 'n onveranderlike datum skep
klas DateInterval,
wat 'n tydinterval spesifiseer
klas DateTimeZone,
wat 'n tydsone spesifiseer