IntlCalendar::getErrorCode

intlcal_get_error_code

Get last error code on the object

Description

Object-oriented style (method):

public intfalse IntlCalendar::getErrorCode()

Procedural style:

intfalse 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 parameter (in the procedural‒style 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.

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

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. This function resets the global error code, but not the objectʼs error code.

Parameters

calendar

The calendar object, on the procedural style interface.

Return Values

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

Examples

Example #1 IntlCalendar::getErrorCode and IntlCalendar::getErrorMessage

<?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