DateTimeImmutable 클래스

DateTimeImmutable 클래스는 DateTime의 불변 버전입니다. 이 클래스는 어떠한 수정 시에도 새로운 객체를 생성하므로 작업 시 예측 가능성이 높고 안전합니다.

현재 시각

현재 날짜와 시간을 가진 DateTimeImmutable 객체를 생성해 봅시다:

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

특정 날짜

지정된 날짜로 DateTimeImmutable 객체를 생성해 봅시다:

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

특정 날짜와 시간

지정된 날짜와 시간으로 DateTimeImmutable 객체를 생성해 봅시다:

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

출력 형식 지정

생성된 날짜는 format 메서드를 사용하여 지정된 형식으로 출력할 수 있습니다. 현재 시각에 대해 이를 수행해 봅시다:

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

결과 (실행 시점에 따라 변경됨):

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

지정된 날짜 형식 지정

지정된 날짜의 형식을 지정해 봅시다:

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

코드 실행 결과:

'31.12.2025'

간격 추가

날짜에 간격을 추가하는 것은 add 메서드를 통해 수행됩니다:

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

코드 실행 결과:

'2025-05-25'

간격 빼기

날짜에서 간격을 빼는 것은 sub 메서드를 통해 수행됩니다:

<?php
	$date = new DateTimeImmutable('2025-05-15');
	$interval = new DateInterval('P1M2D'); // 1개월 2일
	$newDate = $date->sub($interval);
	echo $newDate->format('Y-m-d');
?>

코드 실행 결과:

'2025-04-13'

새 날짜 설정

DateTimeImmutable 객체에 새로운 날짜를 설정할 수 있습니다. 이는 setDate 메서드를 통해 수행됩니다:

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

코드 실행 결과:

'2024-12-31'

시간 설정

DateTimeImmutable 객체에 새로운 시간을 설정할 수 있습니다. 이는 setTime 메서드를 통해 수행됩니다:

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

코드 실행 결과:

'15:30:00'

날짜 비교

날짜 객체를 비교할 수 있습니다:

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

시간대를 가진 객체 생성

DateTimeImmutable 객체를 생성할 때 시간대를 지정할 수 있습니다:

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

코드 실행 결과:

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

함께 보기

시간 간격을 지정하는 클래스 DateInterval
시간대를 지정하는 클래스 DateTimeZone