intldateformatter(3) [php man page]

INTLDATEFORMATTER(3)							 1						      INTLDATEFORMATTER(3)

The IntlDateFormatter 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

       IntlDateFormatter

       IntlDateFormatter

       Methods

       o public IntlDateFormatter::__construct (string	$locale, int  $datetype, int  $timetype, [mixed  $timezone = NULL],  [mixed   $calendar  =
	 NULL], [string  $pattern = ""])

       o publicstatic  IntlDateFormatter  IntlDateFormatter::create  (string   $locale, int  $datetype, int  $timetype, [mixed	$timezone = NULL],
	 [mixed  $calendar = NULL], [string  $pattern = ""])

       o public string IntlDateFormatter::format (mixed  $value)

       o publicstatic string IntlDateFormatter::formatObject (object  $object, [mixed  $format = NULL], [string  $locale = NULL])

       o

	 int IntlDateFormatter::getCalendar (void  )

       o public int IntlDateFormatter::getDateType (void  )

       o public int IntlDateFormatter::getErrorCode (void  )

       o public string IntlDateFormatter::getErrorMessage (void  )

       o public string IntlDateFormatter::getLocale ([int  $which])

       o public string IntlDateFormatter::getPattern (void  )

       o public int IntlDateFormatter::getTimeType (void  )

       o public string IntlDateFormatter::getTimeZoneId (void  )

       o public IntlCalendar IntlDateFormatter::getCalendarObject (void  )

       o public IntlTimeZone IntlDateFormatter::getTimeZone (void  )

       o public bool IntlDateFormatter::isLenient (void  )

       o public array IntlDateFormatter::localtime (string  $value, [int  &$position])

       o public int IntlDateFormatter::parse (string  $value, [int  &$position])

       o

	 bool IntlDateFormatter::setCalendar (mixed  $which)

       o public bool IntlDateFormatter::setLenient (bool  $lenient)

       o public bool IntlDateFormatter::setPattern (string  $pattern)

       o public bool IntlDateFormatter::setTimeZoneId (string  $zone)

       o public boolean IntlDateFormatter::setTimeZone (mixed  $zone)

SEE ALSO

	      oICU Date formatter

	      oICU Date formats

PREDEFINED CONSTANTS

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

	      o IntlDateFormatter::NONE ( integer) -Do not include this element

	      o IntlDateFormatter::FULL ( integer) -Completely specified style (Tuesday, April 12, 1952 AD or 3:30:42pm PST)

	      o IntlDateFormatter::LONG ( integer) -Long style (January 12, 1952 or 3:30:32pm)

	      o IntlDateFormatter::MEDIUM ( integer) -Medium style (Jan 12, 1952)

	      o IntlDateFormatter::SHORT ( integer) -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-Grego-
       rian calendars need to be specified in locale. Examples might include locale="hi@calendar=BUDDHIST".

	      o IntlDateFormatter::TRADITIONAL ( integer) -Non-Gregorian Calendar

	      o IntlDateFormatter::GREGORIAN ( integer) -Gregorian Calendar

PHP Documentation Group 												      INTLDATEFORMATTER(3)

Check Out this Related Man Page

DATEFMT_FORMAT_OBJECT(3)						 1						  DATEFMT_FORMAT_OBJECT(3)

IntlDateFormatter::formatObject - Formats an object

	Object oriented style

SYNOPSIS

       publicstatic string IntlDateFormatter::formatObject (object  $object, [mixed  $format = NULL], [string  $locale = NULL])

DESCRIPTION

	Procedural style string datefmt_format_object (object  $object, [mixed	$format = NULL], [string  $locale = NULL])

	This function allows formatting an IntlCalendar or DateTime object without first explicitly creating a IntlDateFormatter object.

	The  temporary IntlDateFormatter that will be created will take the timezone from the passed in object. The timezone database bundled with
       PHP will not be used - ICU's will be used instead. The timezone identifier used in DateTime objects must  therefore  also  exist  in  ICU's
       database.

PARAMETERS

	      o $object
		- An object of type IntlCalendar or DateTime. The timezone information in the object will be used.

	      o $format
		-  How	to  format  the date/time. This can either be an array with two elements (first the date style, then the time style, these
		being one of the constants IntlDateFormatter::NONE, IntlDateFormatter::SHORT, IntlDateFormatter::MEDIUM,  IntlDateFormatter::LONG,
		IntlDateFormatter::FULL), a long with the value of one of these constants (in which case it will be used both for the time and the
		date) or a string with the format described in the ICU documentation. If NULL, the default style will be used.

	      o $locale
		- The locale to use, or NULL to use the default one.

RETURN VALUES

	A string with result or FALSE on failure.

EXAMPLES

       Example #1

	      datefmt_format_object(3) examples

	      <?php
	      /* default timezone is irrelevant; timezone taken from the object */
	      ini_set('date.timezone', 'UTC');
	      /* default locale is taken from this ini setting */
	      ini_set('intl.default_locale', 'fr_FR');

	      $cal = IntlCalendar::fromDateTime("2013-06-06 17:05:06 Europe/Dublin");
	      echo "default:
	",
		      IntlDateFormatter::formatObject($cal),
		      "
";

	      echo "long $format (full):
	",
		      IntlDateFormatter::formatObject($cal, IntlDateFormatter::FULL),
		      "
";

	      echo "array $format (none, full):
	",
		      IntlDateFormatter::formatObject($cal, array(
			      IntlDateFormatter::NONE,
			      IntlDateFormatter::FULL)),
		      "
";

	      echo "string $format (d 'of' MMMM y):
	",
		      IntlDateFormatter::formatObject($cal, "d 'of' MMMM y", 'en_US'),
		      "
";

	      echo "with DateTime:
	",
		      IntlDateFormatter::formatObject(
			      new DateTime("2013-09-09 09:09:09 Europe/Madrid"),
			      IntlDateFormatter::FULL,
			      'es_ES'),
		      "
";

	      The above example will output:

	      default:
		  6 juin 2013 17:05:06
	      long $format (full):
		  jeudi 6 juin 2013 17:05:06 heure d'ete irlandaise
	      array $format (none, full):
		  17:05:06 heure d'ete irlandaise
	      string $format (d 'of' MMMM y):
		  6 of June 2013
	      with DateTime:
		  lunes, 9 de septiembre de 2013 09:09:09 Hora de verano de Europa central

PHP Documentation Group 												  DATEFMT_FORMAT_OBJECT(3)

Linux and UNIX Man Pages

intldateformatter(3) [php man page]

Check Out this Related Man Page