intl
DateFormatter::create
intl
PHP Manual

# The DateFormatter class

## Introduction

Date Formatter is a concrete class that enables locale-dependent formatting/parsing of dates using pattern strings and/or canned patterns.

This class represents the ICU date formatting functionality. It allows users to display dates in a localized format or to parse strings into PHP date values using pattern strings and/or canned patterns.

## Class synopsis

DateFormatter
/* Methods */
__construct ( string `$locale` , integer `$datetype` , integer `$timetype` [, string `$timezone` [, integer `$calendar` [, string `$pattern` ]]] )
static DateFormatter create ( string `$locale` , integer `$datetype` , integer `$timetype` [, string `$timezone` [, integer `$calendar` [, string `$pattern` ]]] )
string format ( mixed `$value` )
integer getCalendar ( void )
integer getDateType ( void )
integer getErrorCode ( void )
string getErrorMessage ( void )
string getLocale ([ integer `$which` ] )
string getPattern ( void )
integer getTimeType ( void )
string getTimeZoneId ( void )
boolean isLenient ( void )
array localtime ( string `$value` , integer `$parse_pos` )
integer parse ( string `$value` , integer `$parse_pos` )
boolean setCalendar ( integer `$which` )
boolean setLenient ( boolean `$lenient` )
boolean setPattern ( string `$pattern` )
boolean setTimeZoneId ( string `$zone` )

## See Also

- » ICU Date formatter

## Predefined Constants

These constants are used to specify different formats in the constructor for DateType and TimeType.

`DateFormatter::NONE` (string)
  Do not include this element
`DateFormatter::FULL` (string)
  Completely specified style (Tuesday, April 12, 1952 AD or 3:30:42pm PST)
`DateFormatter::LONG` (string)
  Long style (January 12, 1952 or 3:30:32pm)
`DateFormatter::MEDIUM` (string)
  Medium style (Jan 12, 1952)
`DateFormatter::SHORT` (string)
  Most abbreviated style, only essential data (12/13/52 or 3:30pm)

The following int constants are used to specify the calendar. These calendars are all based directly on the Gregorian calendar. Non-Gregorian calendars need to be specified in locale. Examples might include locale="hi@calendar=BUDDHIST".

`DateFormatter::TRADITIONAL` (string)
  Non-Gregorian Calendar
`DateFormatter::GREGORIAN` (string)
  Gregorian Calendar

## Table of Contents

- DateFormatter::create — Create a date formatter
- DateFormatter::format — Format the date/time value as a string
- DateFormatter::getCalendar — Get the calendar used for the DateFormatter
- DateFormatter::getDateType — Get the datetype used for the DateFormatter
- DateFormatter::getErrorCode — Get the error code from last operation
- DateFormatter::getErrorMessage — Get the error text from the last operation.
- DateFormatter::getLocale — Get the locale used by formatter
- DateFormatter::getPattern — Get the pattern used for the DateFormatter
- DateFormatter::getTimeType — Get the timetype used for the DateFormatter
- DateFormatter::getTimeZoneId — Get the timezone-id used for the DateFormatter
- DateFormatter::isLenient — Get the lenient used for the DateFormatter
- DateFormatter::localtime — Parse string to a field-based time value
- DateFormatter::parse — Parse string to a timestamp value
- DateFormatter::setCalendar — sets the calendar used to the appropriate calendar, which must be
- DateFormatter::setLenient — Set the leniency of the parser
- DateFormatter::setPattern — Set the pattern used for the DateFormatter
- DateFormatter::setTimeZoneId — Sets the time zone to use

intl
DateFormatter::create
intl
PHP Manual