Curriculum
Course: PHP Basic
Login

Curriculum

PHP Basic

PHP Install

0/1

PHP Casting

0/1

PHP Constants

0/1

PHP Magic Constants

0/1

PHP Operators

0/1

PHP Reference

0/276
Text lesson

date()

Example

Rephrase: Format a local date and time and return it as a formatted date string.

<?php
// Prints the day
echo date(“l”) . “<br>”;

// Prints the day, date, month, year, time, AM or PM
echo date(“l jS \of F Y h:i:s A”);
?>

Definition and Usage

The date() function formats a local date and time and returns the result as a formatted date string.

Syntax

date(format, timestamp)

Parameter Values

Parameter

Description

format

The format of the outputted date string in PHP’s date() function can be specified using various characters. Here are the available options:

  • d: Day of the month (01 to 31)
  • D: A textual representation of a day (three letters)
  • j: Day of the month without leading zeros (1 to 31)
  • l (lowercase ‘L’): Full textual representation of a day
  • N: ISO-8601 numeric representation of a day (1 for Monday, 7 for Sunday)
  • S: English ordinal suffix for the day of the month (2 characters: st, nd, rd, or th. Works well with j)
  • w: Numeric representation of the day (0 for Sunday, 6 for Saturday)
  • z: Day of the year (0 through 365)
  • W: ISO-8601 week number of the year (weeks starting on Monday)
  • F: Full textual representation of a month (January through December)
  • m: Numeric representation of a month (01 to 12)
  • M: Short textual representation of a month (three letters)
  • n: Numeric representation of a month, without leading zeros (1 to 12)
  • t: Number of days in the given month
  • L: Whether it’s a leap year (1 if it is a leap year, 0 otherwise)
  • o: ISO-8601 year number
  • Y: Four-digit representation of a year
  • y: Two-digit representation of a year
  • a: Lowercase am or pm
  • A: Uppercase AM or PM
  • B: Swatch Internet time (000 to 999)
  • g: 12-hour format of an hour (1 to 12)
  • G: 24-hour format of an hour (0 to 23)
  • h: 12-hour format of an hour (01 to 12)
  • H: 24-hour format of an hour (00 to 23)
  • i: Minutes with leading zeros (00 to 59)
  • s: Seconds with leading zeros (00 to 59)
  • u: Microseconds (added in PHP 5.2.2)
  • e: Timezone identifier (e.g., UTC, GMT, Atlantic/Azores)
  • I (capital i): Whether the date is in daylight savings time (1 if Daylight Savings Time, 0 otherwise)
  • O: Difference to Greenwich time (GMT) in hours (e.g., +0100)
  • P: Difference to Greenwich time (GMT) in hours

(added in PHP 5.1.3)

  • T: Timezone abbreviations (e.g., EST, MDT)
  • Z: Timezone offset in seconds (negative for timezones west of UTC, -43200 to 50400)
  • c: ISO-8601 date (e.g., 2013-05-05T16:34:42+00:00)
  • r: RFC 2822 formatted date (e.g., Fri, 12 Apr 2013 12:01:05 +0200)
  • U: Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT)

Additionally, the following predefined constants can be used (available since PHP 5.1.0):

  • DATE_ATOM: Atom (e.g., 2013-04-12T15:52:01+00:00)
  • DATE_COOKIE: HTTP Cookies (e.g., Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_ISO8601: ISO-8601 (e.g., 2013-04-12T15:52:01+0000)
  • DATE_RFC822: RFC 822 (e.g., Fri, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC850: RFC 850 (e.g., Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_RFC1036: RFC 1036 (e.g., Fri, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC1123: RFC 1123 (e.g., Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC2822: RFC 2822 (e.g., Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC3339: Same as DATE_ATOM (since PHP 5.1.3)
  • DATE_RSS: RSS (e.g., Fri, 12 Aug 2013 15:52:01 +0000)
  • DATE_W3C: World Wide Web Consortium (e.g., 2013-04-12T15:52:01+00:00)

timestamp

Optional. Specifies an integer Unix timestamp. By default, it uses the current local time (time()).

Technical Details

Return Value:

Returns a formatted date string on success, or FALSE on failure along with an E_WARNING.

PHP Version:

4+

Changelog:

PHP 5.1.0: Introduced E_STRICT and E_NOTICE time zone errors. The valid timestamp range is now from Fri, 13 Dec 1901 20:45:54 GMT to Tue, 19 Jan 2038 03:14:07 GMT. In earlier versions (before 5.1.0), the timestamp range was limited from 01-01-1970 to 19-01-2038 on some systems, such as Windows.

PHP 5.1.1: Added constants for standard date/time formats that can be used as the format parameter.