Fix YEAR type behavior

Author: JanJakes

tests/WP_SQLite_Driver_Tests.php

@@ -10202,5 +10202,33 @@ public function testCastValuesOnInsert(): void {
 		$this->assertSame( '2025-10-23 18:30:00', $result[4]->value );
 		$this->assertSame( '2025-10-23 18:30:00', $result[5]->value );
 		$this->assertQuery( 'DROP TABLE t' );
+
+		// YEAR
+		$this->assertQuery( 'CREATE TABLE t (value YEAR)' );
+		$this->assertQuery( 'INSERT INTO t VALUES (NULL)' );
+		$this->assertQuery( 'INSERT INTO t VALUES (FALSE)' );
+		$this->assertQuery( 'INSERT INTO t VALUES (TRUE)' );
+		$this->assertQuery( "INSERT INTO t VALUES ('2025')" );
+		$this->assertQuery( "INSERT INTO t VALUES ('2025-10-23')" );
+		$this->assertQuery( "INSERT INTO t VALUES ('2025-10-23 18:30:00')" );
+		$this->assertQuery( "INSERT INTO t VALUES ('2025-10-23 18:30:00.123456')" );
+		$this->assertQuery( 'INSERT INTO t VALUES (1)' );
+		$this->assertQuery( 'INSERT INTO t VALUES (50)' );
+		$this->assertQuery( 'INSERT INTO t VALUES (70)' );
+		$this->assertQuery( 'INSERT INTO t VALUES (99)' );
+
+		$result = $this->assertQuery( 'SELECT * FROM t' );
+		$this->assertSame( null, $result[0]->value );
+		$this->assertSame( '0', $result[1]->value );
+		$this->assertSame( '2001', $result[2]->value );
+		$this->assertSame( '2025', $result[3]->value );
+		$this->assertSame( '2025', $result[4]->value );
+		$this->assertSame( '2025', $result[5]->value );
+		$this->assertSame( '2025', $result[6]->value );
+		$this->assertSame( '2001', $result[7]->value );
+		$this->assertSame( '2050', $result[8]->value );
+		$this->assertSame( '1970', $result[9]->value );
+		$this->assertSame( '1999', $result[10]->value );
+		$this->assertQuery( 'DROP TABLE t' );
 	}
 }

wp-includes/sqlite-ast/class-wp-sqlite-driver.php

@@ -5000,7 +5000,27 @@ private function cast_value_for_insert_or_update(
 				} elseif ( 'datetime' === $mysql_data_type || 'timestamp' === $mysql_data_type ) {
 					$function_call = sprintf( 'DATETIME(%s)', $translated_value );
 				} elseif ( 'year' === $mysql_data_type ) {
-					$function_call = sprintf( "STRFTIME('%%Y', %s)", $translated_value );
+					/*
+					 * The YEAR type in MySQL only uses 1 byte and therefore
+					 * covers only 256 values from 1901 to 2155 included.
+					 * Additionally:
+					 *   - Numbers from 0 to 69 correspond to years 2000 to 2069.
+					 *   - Numbers from 70 to 99 correspond to years 1970 to 1999.
+					 */
+					$function_call = sprintf(
+						"(
+							SELECT CASE
+								WHEN value > 1900 AND value < 2156 THEN value
+								WHEN value = 0 THEN 0
+								WHEN value < 70 THEN 2000 + value
+								WHEN value < 100 THEN 1900 + value
+								ELSE THROW('Out of range value: ''' || %s || '''')
+							END
+							FROM (SELECT CAST(%s AS INTEGER) AS value)
+						)",
+						$translated_value,
+						$translated_value,
+					);
 				}
 
 				// In strict mode, invalid date/time values are rejected.

wp-includes/sqlite/class-wp-sqlite-pdo-user-defined-functions.php

@@ -44,6 +44,7 @@ public static function register_for( PDO $pdo ): self {
 	 * @var array
 	 */
 	private $functions = array(
+		'throw'                        => 'throw',
 		'month'                        => 'month',
 		'monthnum'                     => 'month',
 		'year'                         => 'year',
@@ -88,6 +89,18 @@ public static function register_for( PDO $pdo ): self {
 		'_helper_like_to_glob_pattern' => '_helper_like_to_glob_pattern',
 	);
 
+	/**
+	 * A helper function to throw an error from SQLite expressions.
+	 *
+	 * @param string $message The error message.
+	 *
+	 * @throws Exception The error message.
+	 * @return void
+	 */
+	public function throw( $message ): void {
+		throw new Exception( $message );
+	}
+
 	/**
 	 * Method to return the unix timestamp.
 	 *