Added DateTime[Immutable]::createFromTimestamp / date_create_[immutable]_from_timestamp

Author: marc-mabe

ext/date/php_date.c

@@ -2500,6 +2500,40 @@ PHPAPI bool php_date_initialize(php_date_obj *dateobj, const char *time_str, siz
 	return 1;
 } /* }}} */
 
+PHPAPI void php_date_initialize_from_ts_long(php_date_obj *dateobj, zend_long sec, int usec) /* {{{ */
+{
+	dateobj->time = timelib_time_ctor();
+	dateobj->time->zone_type = TIMELIB_ZONETYPE_OFFSET;
+	dateobj->time->z = (timelib_sll)0;
+	dateobj->time->have_relative = 0;
+
+	timelib_unixtime2gmt(dateobj->time, (timelib_sll)sec);
+	timelib_update_ts(dateobj->time, NULL);
+	php_date_set_time_fraction(dateobj->time, usec);
+} /* }}} */
+
+PHPAPI bool php_date_initialize_from_ts_double(php_date_obj *dateobj, double ts) /* {{{ */
+{
+	zend_long sec;
+	int usec;
+
+	if (UNEXPECTED(isnan(ts) || !ZEND_DOUBLE_FITS_LONG(ts))) {
+		return 0;
+	}
+
+	sec = (zend_long)ts;
+	usec = (int)(fmod(ts, 1) * 1000000);
+
+	if (UNEXPECTED(usec < 0)) {
+		sec = sec - 1;
+		usec = 1000000 + usec;
+	}
+
+	php_date_initialize_from_ts_long(dateobj, sec, usec);
+
+	return 1;
+} /* }}} */
+
 /* {{{ Returns new DateTime object */
 PHP_FUNCTION(date_create)
 {
@@ -2564,7 +2598,7 @@ PHP_FUNCTION(date_create_from_format)
 }
 /* }}} */
 
-/* {{{ Returns new DateTime object formatted according to the specified format */
+/* {{{ Returns new DateTimeImmutable object formatted according to the specified format */
 PHP_FUNCTION(date_create_immutable_from_format)
 {
 	zval           *timezone_object = NULL;
@@ -2586,6 +2620,66 @@ PHP_FUNCTION(date_create_immutable_from_format)
 }
 /* }}} */
 
+/* {{{ Returns new DateTime object from given unix timetamp */
+PHP_FUNCTION(date_create_from_timestamp)
+{
+	php_date_obj *dateobj;
+	zval         *value;
+
+	ZEND_PARSE_PARAMETERS_START(1, 1)
+		Z_PARAM_NUMBER(value)
+	ZEND_PARSE_PARAMETERS_END();
+
+	php_date_instantiate(date_ce_date, return_value);
+	dateobj = Z_PHPDATE_P(return_value);
+
+	switch (Z_TYPE_P(value)) {
+		case IS_LONG:
+			php_date_initialize_from_ts_long(dateobj, Z_LVAL_P(value), 0);
+			break;
+
+		case IS_DOUBLE:
+			if (!php_date_initialize_from_ts_double(dateobj, Z_DVAL_P(value))) {
+				zval_ptr_dtor(return_value);
+				RETURN_FALSE;
+			}
+			break;
+
+		EMPTY_SWITCH_DEFAULT_CASE();
+	}
+}
+/* }}} */
+
+/* {{{ Returns new DateTimeImmutable object from given unix timestamp */
+PHP_FUNCTION(date_create_immutable_from_timestamp)
+{
+	php_date_obj *dateobj;
+	zval         *value;
+
+	ZEND_PARSE_PARAMETERS_START(1, 1)
+		Z_PARAM_NUMBER(value)
+	ZEND_PARSE_PARAMETERS_END();
+
+	php_date_instantiate(date_ce_immutable, return_value);
+	dateobj = Z_PHPDATE_P(return_value);
+
+	switch (Z_TYPE_P(value)) {
+		case IS_LONG:
+			php_date_initialize_from_ts_long(dateobj, Z_LVAL_P(value), 0);
+			break;
+
+		case IS_DOUBLE:
+			if (!php_date_initialize_from_ts_double(dateobj, Z_DVAL_P(value))) {
+				zval_ptr_dtor(return_value);
+				RETURN_FALSE;
+			}
+			break;
+
+		EMPTY_SWITCH_DEFAULT_CASE();
+	}
+}
+/* }}} */
+
 /* {{{ Creates new DateTime object */
 PHP_METHOD(DateTime, __construct)
 {

ext/date/php_date.stub.php

@@ -159,6 +159,12 @@ function date_create_from_format(
 function date_create_immutable_from_format(
     string $format, string $datetime, ?DateTimeZone $timezone = null): DateTimeImmutable|false {}
 
+/** @refcount 1 */
+function date_create_from_timestamp(int|float $timestamp): DateTime|false {}
+
+/** @refcount 1 */
+function date_create_immutable_from_timestamp(int|float $timestamp): DateTimeImmutable|false {}
+
 /**
  * @return array<string, mixed>
  * @refcount 1
@@ -362,6 +368,12 @@ public static function createFromInterface(DateTimeInterface $object): DateTime
      */
     public static function createFromFormat(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTime|false {}
 
+    /**
+     * @tentative-return-type
+     * @alias date_create_from_timestamp
+     */
+    public static function createFromTimestamp(int|float $timestamp): DateTime|false {}
+
     /**
      * @return array<string, int|array>|false
      * @tentative-return-type
@@ -466,6 +478,12 @@ public static function __set_state(array $array): DateTimeImmutable {}
      */
     public static function createFromFormat(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTimeImmutable|false {}
 
+    /**
+     * @tentative-return-type
+     * @alias date_create_immutable_from_timestamp
+     */
+    public static function createFromTimestamp(int|float $timestamp): DateTimeImmutable|false {}
+
     /**
      * @return array<string, int|array>|false
      * @tentative-return-type