php8.5
Home/ Manual/ reference / datetime/ Date and Time

Date and Time

The DateTimeImmutable and related classes allow you represent date/time information. The objects can be created by passing in a string presentation of date/time information, or from the current system's time.

Intro

The DateTimeImmutable and related classes allow you represent date/time information. The objects can be created by passing in a string presentation of date/time information, or from the current system's time.

A rich set of methods is supplied to modify and format this information as well, including handling timezones and DST transitions.

The date/time features in PHP implements the ISO 8601 calendar, which is a proleptic Gregorian calendar which implements the current leap-day rules from before the Gregorian calendar was in place, and also includes the year 0 as the year number in between -1 BCE and 1 CE. Leap seconds are not supported.

The date and time information is internally stored as a 64-bit number so all conceivably useful dates (including negative years) are supported. The range is from about 292 billion years in the past to the same in the future.

Note

The timezones referenced in this section can be found in the timezones.

Setup Constants Examples Datetime Datetimeimmutable Datetimeinterface Datetimezone Dateinterval Dateperiod Reference

Date/Time Errors and Exceptions

  • DateError (extends Error)

    • DateObjectError

      DateRangeError

  • DateException (extends Exception)

      • DateInvalidOperationException
      • DateInvalidTimezoneException
      • DateMalformedIntervalStringException
      • DateMalformedPeriodStringException
      • DateMalformedStringException

Formats Timezones Dateerror Dateobjecterror Daterangeerror Dateexception Dateinvalidoperationexception Dateinvalidtimezoneexception Datemalformedintervalstringexception Datemalformedperiodstringexception Datemalformedstringexception

Source: reference/datetime/book.xml · from the official PHP manual (php/doc-en)