intlcal_get_error_code(3) [php man page]

INTLCAL_GET_ERROR_CODE(3)						 1						 INTLCAL_GET_ERROR_CODE(3)

IntlCalendar::getErrorCode - Get last error code on the object

       Object oriented style (method):

SYNOPSIS

       public int IntlCalendar::getErrorCode (void  )

DESCRIPTION

       Procedural style:
       int intlcal_get_error_code (IntlCalendar  $calendar)

	Returns the numeric ICU error code for the last call on this object (including cloning) or the IntlCalendar given for the $calendar param-
       eter (in the proceduralstyle version). This may indicate only a warning (negative error code) or no  error  at  all  (  U_ZERO_ERROR).  The
       actual presence of an error can be tested with intl_is_failure(3).

	Invalid  arguments detected on the PHP side (before invoking functions of the ICU library) are not recorded for the purposes of this func-
       tion.

	The last error that occurred in any call to a function of the intl extension, including  early	argument  errors,  can	be  obtained  with
       intl_get_error_code(3). This function resets the global error code, but not the objects error code.

PARAMETERS

	      o $calendar
		- The calendar object, on the procedural style interface.

RETURN VALUES

	An ICU error code indicating either success, failure or a warning.

EXAMPLES

       Example #1

	      intlcal_get_error_code(3) and IntlCalendar.getErrorMessage(3)

	      <?php
	      ini_set("intl.error_level", E_WARNING);
	      ini_set("intl.default_locale", "nl");

	      $intlcal = new IntlGregorianCalendar(2012, 1, 29);
	      var_dump(
		  $intlcal->getErrorCode(),
		  $intlcal->getErrorMessage()
	      );
	      $intlcal->fieldDifference(-1e100, IntlCalendar::FIELD_SECOND);

	      var_dump(
		  $intlcal->getErrorCode(),
		  $intlcal->getErrorMessage()
	      );

	      The above example will output:

	      int(0)
	      string(12) "U_ZERO_ERROR"

	      Warning: IntlCalendar::fieldDifference(): intlcal_field_difference: Call to ICU method has failed in /home/glopes/php/ws/example.php on line 10
	      int(1)
	      string(81) "intlcal_field_difference: Call to ICU method has failed: U_ILLEGAL_ARGUMENT_ERROR"

SEE ALSO

       IntlCalendar::getErrorMessage, intl_is_failure, intl_error_name, intl_get_error_code, intl_get_error_message.

PHP Documentation Group 												 INTLCAL_GET_ERROR_CODE(3)

INTLDATEFORMATTER.SETCALENDAR(3)					 1					  INTLDATEFORMATTER.SETCALENDAR(3)

IntlDateFormatter::setCalendar - Sets the calendar type used by the formatter

	Object oriented style

SYNOPSIS

       bool IntlDateFormatter::setCalendar (mixed  $which)

DESCRIPTION

	Procedural style
       bool datefmt_set_calendar (IntlDateFormatter  $fmt, mixed  $which)

	Sets the calendar or calendar type used by the formatter.

PARAMETERS

	      o $fmt
		- The formatter resource.

	      o $which
		-  This can either be: the calendar type to use (default is IntlDateFormatter::GREGORIAN, which is also used if NULL is specified)
		or an IntlCalendar object.  Any IntlCalendar object passed in will be cloned; no  modifications  will  be  made  to  the  argument
		object.   The timezone of the formatter will only be kept if an IntlCalendar object is not passed, otherwise the new timezone will
		be that of the passed object.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

CHANGELOG

       +-----------------+---------------------------------------------------+
       |    Version	 |						     |
       |		 |						     |
       |		 |		      Description		     |
       |		 |						     |
       +-----------------+---------------------------------------------------+
       |5.5.0/PECL 3.0.0 |						     |
       |		 |						     |
       |		 |  It	became	possible  to  pass  an	IntlCalendar |
       |		 | object.					     |
       |		 |						     |
       +-----------------+---------------------------------------------------+
EXAMPLES

       Example #1

	      datefmt_set_calendar(3) example

	      <?php
	      $fmt = datefmt_create(
		  'en_US',
		  IntlDateFormatter::FULL,
		  IntlDateFormatter::FULL,
		  'America/Los_Angeles',
		  IntlDateFormatter::GREGORIAN
	      );
	      echo 'calendar of the formatter is : ' . datefmt_get_calendar($fmt);
	      datefmt_set_calendar($fmt, IntlDateFormatter::TRADITIONAL);
	      echo 'Now calendar of the formatter is : ' . datefmt_get_calendar($fmt);
	      ?>

       Example #2

	      OO example

	      <?php
	      $fmt = new IntlDateFormatter(
		  'en_US',
		  IntlDateFormatter::FULL,
		  IntlDateFormatter::FULL,
		  'America/Los_Angeles',
		  IntlDateFormatter::GREGORIAN
	      );
	      echo 'calendar of the formatter is : ' . $fmt->getCalendar();
	      $fmt->setCalendar(IntlDateFormatter::TRADITIONAL);
	      echo 'Now calendar of the formatter is : ' . $fmt->getCalendar();
	      ?>

       The above example will output:

       calendar of the formatter is : 1
       Now calendar of the formatter is : 0

       Example #3

	      Example with IntlCalendar argument

	      <?php
	      $time = strtotime("2013-03-03 00:00:00 UTC");
	      $formatter = IntlDateFormatter::create("en_US", NULL, NULL, "Europe/Amsterdam");

	      echo "before: ", $formatter->format($time), "
";

	      /* note that the calendar's locale is not used! */
	      $formatter->setCalendar(IntlCalendar::createInstance(
			     "America/New_York", "pt_PT@calendar=islamic"));

	      echo "after:  ", $formatter->format($time), "
";

	      The above example will output:

	      before: Sunday, March 3, 2013 at 1:00:00 AM Central European Standard Time
	      after:  Saturday, Rabi II 20, 1434 at 7:00:00 PM Eastern Standard Time

SEE ALSO

       datefmt_get_calendar(3), datefmt_get_calendar_object(3), datefmt_create(3).

PHP Documentation Group 											  INTLDATEFORMATTER.SETCALENDAR(3)